Merge pull request #1 from NVIDIA-ISAAC-ROS/release-4.0

Isaac ROS CLI 1.0.2

Author: jaiveersinghNV

.gitignore

@@ -0,0 +1,8 @@
+# Debian packaging artifacts
+debian/.debhelper/
+debian/*.debhelper
+debian/isaac-ros-cli/
+debian/*.substvars
+debian/*.debhelper.log
+debian/*-stamp
+debian/files

Makefile

@@ -0,0 +1,54 @@
+# Copyright (c) 2025, NVIDIA CORPORATION. All rights reserved.
+#
+# NVIDIA CORPORATION and its licensors retain all intellectual property
+# and proprietary rights in and to this software, related documentation
+# and any modifications thereto. Any use, reproduction, disclosure or
+# distribution of this software and related documentation without an express
+# license agreement from NVIDIA CORPORATION is strictly prohibited.
+
+# Simple packaging utility for isaac-ros-cli
+
+PACKAGE_NAME := isaac-ros-cli
+
+DISTRIBUTION ?= noble
+COMPONENT ?= main
+ARCHITECTURE ?= all
+
+# Convenience variable for the built .deb (lives one dir up when using dpkg-buildpackage)
+DEB_GLOB := ../$(PACKAGE_NAME)_*.deb
+
+.PHONY: help all build upload clean distclean release print-deb
+
+help:
+	@echo "Targets:"
+	@echo "  make build           - Build Debian package (.deb)"
+	@echo "  make clean           - Remove staged packaging artifacts inside debian/"
+	@echo "  make distclean       - Clean and remove built files in parent dir"
+	@echo "  make print-deb       - Print the path to the built .deb (expects exactly one)"
+	@echo ""
+	@echo "Variables (override with VAR=value):"
+	@echo "  DISTRIBUTION=$(DISTRIBUTION)  COMPONENT=$(COMPONENT)  ARCHITECTURE=$(ARCHITECTURE)"
+
+all: build
+
+build:
+	@echo "Building Debian package for $(PACKAGE_NAME)..."
+	DEB_BUILD_OPTIONS=nocheck dpkg-buildpackage -us -uc -b
+	@echo "Build complete. Use 'make print-deb' to locate the .deb file."
+
+print-deb:
+	@set -e; \
+	count=$$(ls -1 $(DEB_GLOB) 2>/dev/null | wc -l | tr -d ' '); \
+	if [ "$$count" -ne 1 ]; then \
+		echo "Error: expected exactly one .deb matching $(DEB_GLOB), found $$count" 1>&2; \
+		exit 1; \
+	fi; \
+	ls -1 $(DEB_GLOB)
+
+clean:
+	@echo "Removing staged packaging artifacts under debian/..."
+	rm -rf debian/$(PACKAGE_NAME) debian/.debhelper debian/debhelper-build-stamp debian/files
+
+distclean: clean
+	@echo "Removing built artifacts in parent directory (if any)..."
+	rm -f ../$(PACKAGE_NAME)_*.deb ../$(PACKAGE_NAME)_*.buildinfo ../$(PACKAGE_NAME)_*.changes

README.md

@@ -1,2 +1,29 @@
-# My Repository
-This is my new repository.
+# Isaac ROS CLI
+
+A command-line interface for managing Isaac ROS development environments.
+
+## Installation
+
+```bash
+sudo apt-get install isaac-ros-cli
+```
+
+## Usage
+
+```bash
+# Show help
+isaac-ros --help
+
+# Initialize environment (pick a mode)
+sudo isaac-ros init docker
+
+# Activate environment
+isaac-ros activate
+```
+
+## Rebuilding Debian Package
+
+To build a new local copy:
+```bash
+make build
+```

bin/isaac-ros

@@ -0,0 +1,14 @@
+#!/usr/bin/python3
+# Copyright (c) 2025, NVIDIA CORPORATION. All rights reserved.
+#
+# NVIDIA CORPORATION and its licensors retain all intellectual property
+# and proprietary rights in and to this software, related documentation
+# and any modifications thereto. Any use, reproduction, disclosure or
+# distribution of this software and related documentation without an express
+# license agreement from NVIDIA CORPORATION is strictly prohibited.
+
+import sys
+from isaac_ros_cli.cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

config/.build_image_layers.yaml

@@ -0,0 +1,6 @@
+image_key_order:
+  - noble.ros2_jazzy.realsense.nova_carter
+cache_to_registry_names: []
+cache_from_registry_names:
+  - nvcr.io/nvidia/isaac/ros
+remote_builder: []

config/.isaac_ros_common-config

@@ -0,0 +1 @@
+CONFIG_DOCKER_SEARCH_DIRS=(docker)

config/.isaac_ros_dev-dockerargs

@@ -0,0 +1,6 @@
+-v `realpath ~/.ssh`:/home/admin/.ssh:ro
+-v `realpath ~/.aws`:/home/admin/.aws:ro
+-v `realpath ~/.cache`:/home/admin/.cache
+-v `realpath ~/.config`:/home/admin/.config
+-v `realpath ~/.gitconfig`:/home/admin/.gitconfig
+-v `realpath ~/.bash_history`:/home/admin/.bash_history

config/config.yaml

@@ -0,0 +1,19 @@
+version: 1
+
+environment:
+  mode: uninitialized
+
+docker:
+  image:
+    base_image_keys: 
+      - noble
+      - ros2_jazzy
+    additional_image_keys: []
+
+  run:
+    container_name: isaac_ros_dev_container
+    entrypoint: /usr/local/bin/scripts/workspace-entrypoint.sh
+    workdir: "/workspaces/isaac_ros-dev"
+    platform: auto
+    use_cached_build_image: false
+

debian/changelog

@@ -0,0 +1,19 @@
+isaac-ros-cli (1.0.2-1) noble; urgency=high
+
+  * Fix local-only build behavior using `--build-local` flag
+
+ -- Isaac ROS Maintainers <[email protected]>  Wed, 5 Nov 2025 12:00:00 +0000
+
+isaac-ros-cli (1.0.1-1) noble; urgency=high
+
+  * Security update for base Docker container
+
+ -- Isaac ROS Maintainers <[email protected]>  Wed, 29 Oct 2025 12:00:00 +0000
+
+isaac-ros-cli (1.0.0-1) noble; urgency=low
+
+  * Initial release for Ubuntu 24.04 (noble)
+  * Isaac ROS CLI tool for managing development environments
+  * Support for Docker containers
+
+ -- Isaac ROS Maintainers <[email protected]>  Fri, 24 Oct 2025 12:00:00 +0000

debian/control

@@ -0,0 +1,23 @@
+Source: isaac-ros-cli
+Section: utils
+Priority: optional
+Maintainer: Isaac ROS Maintainers <[email protected]>
+Build-Depends: debhelper-compat (= 13), dh-sequence-python3
+Standards-Version: 4.7.2
+Homepage: https://nvidia-isaac-ros.github.io
+Rules-Requires-Root: no
+
+Package: isaac-ros-cli
+Architecture: all
+Depends: ${misc:Depends},
+         ${python3:Depends},
+         python3,
+         python3-click (>= 8),
+         python3-yaml,
+         python3-termcolor
+Recommends: docker.io | docker-ce,
+            nvidia-container-toolkit,
+            git,
+            git-lfs
+Description: CLI for NVIDIA Isaac ROS
+ A command-line interface for managing Isaac ROS development and deployment.