ROS2 Jazzy で franka_description の visualize_franka.sh を実行する方法

これを書いている時点 (2025-01-12) では、franka_description バージョン 0.4.0 の visualize_franka.sh スクリプトは Docker イメージと ros2 Humble をベースにしています。

私は Jazzy を使っており、互換性の問題を避けたいので、スクリプトを Jazzy に更新する方法を紹介します。

リポジトリの私のフォークを直接クローンできます:

clone-and-run.sh
git clone -b jazzy https://github.com/ulikoehler/franka_description.git

これで通常どおりスクリプトを実行できます:

run-visualize-franka.sh
cd franka_description
./scripts/visualize_franka.sh arm_id:=fr3

この変更は、humble Docker イメージでは UID 1000 が使用されていなかったのに対し、Jazzy では ubuntu ユーザーによって使用されているという事実に基づいています。そのため、実行ユーザーの UID が 1000 の場合、同じ UID/GID でユーザー/グループを作成しようとすると失敗するため、スクリプトは既存の UID と GID を再利用する必要があります。この修正方法の詳細については、シェルロジック: その UID/GID のユーザー/グループが存在しない場合に作成する方法 を参照してください

自分で変更したい場合、変更する必要があるのは .docker/Dockerfile だけです:

Dockerfile.jazzy
FROM osrf/ros:jazzy-desktop

ARG DEBIAN_FRONTEND=noninteractive

ARG USER_UID=1001
ARG USER_GID=1001
ARG USERNAME=user

WORKDIR /workspaces

# そのようなユーザー/グループが存在しない場合のみユーザー/グループを作成
RUN (getent group $USER_GID || groupadd --gid $USER_GID $USERNAME) \
    && (getent passwd $USER_UID || useradd --uid $USER_UID --gid $USER_GID -m $USERNAME) \
    && mkdir -p -m 0700 /run/user/"${USER_UID}" \
    && mkdir -p -m 0700 /run/user/"${USER_UID}"/gdm \
    && chown $USER_UID:$USER_GID /run/user/"${USER_UID}" \
    && chown $USER_UID:$USER_GID /workspaces \
    && chown $USER_UID:$USER_GID /run/user/"${USER_UID}"/gdm

RUN apt-get update && \
    DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends \
    ros-jazzy-xacro \
    ros-jazzy-joint-state-publisher-gui \
    && rm -rf /var/lib/apt/lists/*

ENV XDG_RUNTIME_DIR=/run/user/"${USER_UID}"

# このスクリプトが正確なユーザー名に依存しないよう、
# UID と GID でユーザーを指定
USER $USER_UID:$USER_GID

RUN echo "source /ros_entrypoint.sh" >>~/.bashrc
ARG MAX_ROS_DOMAIN_ID=232
RUN echo "export ROS_DOMAIN_ID=100" >>~/.bashrc
RUN echo "set +e" >>~/.bashrc

同じカテゴリの類似記事をチェック: ロボティクス ROS