Open Source Robotics

고품질 오픈소스 로봇 프로젝트, 도구 및 소프트웨어의 엄선된 컬렉션.

NoDL

ROS 2 노드마다 검토 가능한 인터페이스 파일 하나, 거기서 코드·문서·어긋남 검사를 생성

라이선스

Apache-2.0

개요

NoDL(Node Definition Language)은 ROS 2 노드가 자신의 인터페이스 — 퍼블리셔, 구독, 서비스, 액션, QoS, 파라미터 — 를 하나의 문서로 선언하게 해 주며, 그 문서는 다른 계약과 마찬가지로 리뷰할 수 있다. NoDL은 그 문서에서 노드의 배선을 C++ 추상 기반 클래스나 rclpy 기반 클래스로 생성하고(동작은 손으로 쓴 채로 남긴다), rosdoc2 Sphinx 확장으로 정확한 인터페이스 참조를 렌더링하며, 실행 중인 시스템이 그것에서 벗어났는지 검사한다. 반대 방향도 된다. ros2 nodl describe는 실행 중인 노드를 관찰해 NoDL 초안을 만들어 주므로, 기존 코드베이스도 다시 쓰지 않고 도입할 수 있다. ros-tooling 아래에서 ROS 2의 ROSGraph 워킹 그룹이 개발하며, 현재의 모든 ROS 2 배포판용으로 릴리스되어 있다.

ROS 2 노드의 인터페이스는 딱히 정해진 곳에 있지 않다. 토픽과 서비스는 생성자 코드에서 만들어지고, 파라미터는 누군가 기억난 곳에서 선언되며, QoS는 호출 지점의 세부 사항일 뿐이고, 노드가 무엇을 노출하는지 온전히 설명하는 것은 실행 중인 그래프뿐이다. NoDL은 그 인터페이스를 파일 하나에 담고, 그 파일을 기준으로 삼는다. 저자들은 범위에 신중하다. 검사하는 것은 그래프 계약 — 엔드포인트, 타입, QoS, 파라미터 — 이며, 동작이나 TF 프레임의 의미, 스케줄링, 실시간 보장을 증명하지는 않는다고 분명히 말한다.

같은 문서가 따로따로 도입할 수 있는 세 가지 용도로 쓰인다. 생성은 배관을 써 준다. C++ 생성기는 모든 엔드포인트가 연결된 추상 기반 클래스를 내놓고 파라미터는 generate_parameter_library에 맡기며, Python 생성기는 rclpy에 대해 라이프사이클 노드까지 같은 일을 한다. 문서화는 낡아 가는 주석이 아니라 파일에서 인터페이스 참조를 만든다. 적합성 검사는 선언된 계약과 실행 중인 노드가 실제로 노출하는 것을 비교하고, ros2 nodl diff는 두 문서를 오프라인으로 비교한다. ament_nodl은 문서를 ament 인덱스에 등록하고 실행 중 노드 검사를 colcon test 안에서 돌린다.

프로젝트는 2020년에 시작되었고, 집중적인 작업 끝에 2026년 9월 버전 2가 나왔다. 중첩 파라미터, Python 서비스·액션·라이프사이클 생성, 실행 가능한 더미 로봇 튜토리얼이 모두 릴리스 전 2주 사이에 병합되었다. 진행 상황은 ROS PMC 자체의 회의록에 보고되고 있으며, 버전 2.1은 2027년 4월의 다음 ROS 2 배포판에 맞춰 계획되어 있다.

중요한 이유

인터페이스 배선은 ROS 2에서 많은 시간이 들어가는 곳이자 많은 통합 버그가 숨는 곳이다. 한 노드에서는 바꿨는데 소비하는 쪽에서는 안 바꾼 토픽 이름, 아무도 문서화하지 않은 파라미터, 실행 중에야 드러나는 QoS 불일치. NoDL은 노드 인터페이스를 코드에서 저절로 드러나는 성질이 아니라 명시적인 계약으로 만들려는 ROS 프로젝트 자체의 시도이며, ROS 그래프 도구를 맡은 워킹 그룹에서 나왔다. 그 출신이 이렇게 이른 단계에서도 지켜볼 가치를 만든다. 자리를 잡는다면, 모든 템플릿에 들어가게 될 종류의 것이다.

해결하는 문제

ROS 2 노드의 인터페이스는 생성자 코드 곳곳에 흩어져 있고 실행 중인 그래프에서만 온전히 보이기 때문에, 문서화되지 않고 노드 사이에서 점점 어긋난다. NoDL은 그것을 검토된 파일 하나로 만들고, 거기서 배선과 문서를 생성하며, 더 이상 그것과 맞지 않는 실행 중 시스템을 잡아낸다.

핵심 요점

  • NoDL 문서 하나가 노드의 퍼블리셔, 구독, 서비스, 액션, QoS, 파라미터를 선언한다
  • 인터페이스 배선을 C++ 또는 rclpy 기반 클래스로 생성하고, 동작은 손으로 쓴 채로 둔다
  • rosdoc2 Sphinx 확장으로 정확한 인터페이스 참조를 ROS 문서에 렌더링한다
  • 실행 중인 노드를 선언된 계약과 대조하고, ros2 nodl diff로 문서끼리 오프라인 비교한다
  • ros2 nodl describe가 실행 중인 노드에서 NoDL 초안을 만들어 주므로 기존 코드도 다시 쓰지 않고 도입할 수 있다
  • ROS 2 ROSGraph 워킹 그룹이 개발하며 Humble, Jazzy, Kilted, Lyrical, Rolling용으로 릴리스되었다
  • 버전 2는 2026년 9월에 나왔고 2.1은 2027년 4월 ROS 2 배포판에 맞춰 계획되어 있다

대상

  • 토픽, 타입, QoS, 파라미터를 둘러싼 노드 간 불일치가 통합 버그의 원인인 ROS 2 팀
  • 인터페이스 문서를 손으로 관리하기보다 생성하고 싶은 패키지 관리자
  • 새 노드를 시작하면서 배관을 손으로 쓰기보다 인터페이스를 한 번 선언하고 싶은 사람
  • 실행 중인 노드가 계약에서 벗어나면 실패하는 colcon test를 원하는 CI 담당자

한계

  • 스스로 밝히듯 초기 도입 단계다. v2가 나왔고 스키마는 꽤 안정적이라고 하지만 확정된 것은 아니다
  • 그래프 계약만 검사한다. 동작, TF 프레임의 의미, 스케줄링, 실시간 특성은 증명하지 않는다
  • 코드 생성은 C++와 Python만 지원하며 다른 클라이언트 라이브러리용 생성기는 없다
  • 전체 테스트 의존성 일부는 pip로만 구할 수 있어, 빌드팜 빌드는 축소된 테스트 모음으로 돈다
  • 생성을 도입하면 노드가 생성된 기반 클래스를 상속하게 되어, 기존 코드에는 구조적인 변경이 된다
  • 관리자 층이 얇다. 최근 작업의 대부분은 소수의 기여자에게서 나온다

이 웹사이트는 JavaScript가 필요합니다. 오픈소스 로봇 프로젝트를 탐색하려면 JavaScript를 활성화하세요.