ROSでペッパーを動かすためのDockerイメージ

PepperのIPは、192.168.100.3で同じネットワーク内にこのDockerファイルを動かすサーバがある設定を仮定。 tiryoh/ros-desktop-vncをベースとしたDockerイメージを採用しています。 このイメージは、novncを採用しているため、ブラウザ経由と、ssh経由の両方からアクセス可能。

Build

> ./buildPEPPER.sh

最初のビルトで実行する場合、マシンスペックによるが、起動に時間がかかる。 これは、Dockerファイルは、マルチレイヤーでイメージが構成されているためである。 シングルレイヤーにするため、一度実行し、メモリに展開した状態で、再度キャプチャーし シングルレイヤーのイメージを作る。

Run Build Image

~/pepper$ ./runPEPPER.sh
* enable custom user: ubuntu
useradd: user 'ubuntu' already exists
  set default password to "ubuntu"
Please execute -> sudo apt install ros-kinetic-peper-meshes
2021-03-27 14:34:06,554 CRIT Supervisor running as root (no user in config file)
2021-03-27 14:34:06,554 WARN Included extra file "/etc/supervisor/conf.d/supervisord.conf" during parsing
2021-03-27 14:34:06,560 INFO RPC interface 'supervisor' initialized
2021-03-27 14:34:06,560 CRIT Server 'unix_http_server' running without any HTTP authentication checking
2021-03-27 14:34:06,560 INFO supervisord started with pid 18
2021-03-27 14:34:07,563 INFO spawned: 'nginx' with pid 21
2021-03-27 14:34:07,564 INFO spawned: 'web' with pid 22
2021-03-27 14:34:07,565 INFO spawned: 'novnc' with pid 23
2021-03-27 14:34:07,567 INFO spawned: 'wm' with pid 24
2021-03-27 14:34:07,567 INFO spawned: 'pcmanfm' with pid 25
2021-03-27 14:34:07,568 INFO spawned: 'lxpanel' with pid 27
2021-03-27 14:34:07,569 INFO spawned: 'xvfb' with pid 28
2021-03-27 14:34:07,570 INFO spawned: 'x11vnc' with pid 30
2021-03-27 14:34:07,574 INFO exited: wm (exit status 1; not expected)
2021-03-27 14:34:07,648 INFO  Listening on http://localhost:6079 (run.py:87)
2021-03-27 14:34:08,566 INFO success: nginx entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)
2021-03-27 14:34:08,566 INFO success: web entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)
2021-03-27 14:34:08,566 INFO success: novnc entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)
2021-03-27 14:34:08,576 INFO spawned: 'wm' with pid 87
2021-03-27 14:34:08,576 INFO success: pcmanfm entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)
2021-03-27 14:34:08,576 INFO success: lxpanel entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)
2021-03-27 14:34:08,576 INFO success: xvfb entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)
2021-03-27 14:34:08,576 INFO success: x11vnc entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)
2021-03-27 14:34:10,570 INFO success: wm entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)
127.0.0.1 - - [2021-03-27 14:34:17] "GET /api/health HTTP/1.0" 200 141 0.091562
127.0.0.1 - - [2021-03-27 14:34:47] "GET /api/health HTTP/1.0" 200 141 0.091615

Export Image and Capture Rebuild Image

マルチレイヤ―イメージをメモリ展開し、コンテナがスタンバイ状態（"GET /api/health HTTP/1.0" が表示される状態）になってから、 別ターミナルを開いてコンテナIDを調べる。コンテナIDを元に、docker イメージをキャプチャーし、シングルレイヤー化 （起動の高速化とイメージサイズの圧縮に効果あり）したイメージpepper-lite.tazを作る。

~/pepper$ ./exportPEPPER.sh
Open a new terminal and run . /runPEPPER.sh and wait until you see GET /api/health HTTP/1.0. Press enter key.
-------------------------
Current running docker ontainer id is
-------------------------
28a1487ec5d2
-------------------------
Make sure that only one container ID is running and after that press enter key to capture single layered container image to pepper-lite.taz.
~/pepper$

Import Captured Image and Run

高速化した、イメージpepper-lite.tazをインポートし、実行する。

~/pepper$ ./importPEPPERLITE.sh
~/pepper$ ./runPEPPERLITE.sh

Open

ブラウザ経由

http://docker_ip:6080
http://localhost:6080

Ssh password is ubuntu

SSH経由

$ ssh ubuntu@docker_ip -p 2222

Manegement

本レポジトリでは、GitHub flowに従います. clone, push, pull, mergeの流れを説明しておきます。

Clone

本レポジトリは、/home/kbknにcloneしてください。

cd /home/kbkn
git clone https://www.ikko-lab.k.hosei.ac.jp/gitbucket/git/ikko/pepper.git

Branchを作成

masterブランチ直下に作業内容がわかるような、任意の名前のブランチを作成してください。 尚、以下のには、任意のブランチ名が入ります。

git checkout maser
git checkout -b <hogehoge>

Cording

git add .
git commit -m "fix bug"

開発してください。

Push

自分で作成したブランチにPushしてください。

git push origin <hogehoge>

Pull Request

https://www.ikko-lab.k.hosei.ac.jp/gitbucket/

Gitbucket上で、Pull Requestを作成してください。

Pull Requestの結果、

許可されたら（リーダが、masterブランチへmergeします。） もし、開発が終了していなければ、再び手順3. へ。 開発が終了していれば、ブランチを削除してください。

git checkout master
git branch -d <hogehoge>
git push --delete origin <hogehoge>

許可されなかったら（GitHub上のPullRequestに、いちゃもんメッセージが付けられます。） 手順3. へ。頑張ってください。

Pull 手順5. が終わっている方のみ、Pullしてください。

git pull origin master

以上が、GitHub-flowの手順です。参考リンクにわかりやすいフローチャートがあります。ぜひ見てください。

How to upload docker image

/home/kbkn# git clone https://gitbucket.ikko-lab.k.hosei.ac.jp/git/ikko/pepper.git
/home/kbkn# cd pepper/
/home/kbkn/pepper# rm -rf .git
/home/kbkn/pepper# git config --global user.email "ikko@ikko-lab.k.hosei.ac.jp"
/home/kbkn/pepper# git config --global user.name "ikko.k.kobayashi"
/home/kbkn/pepper# git commit -m "migration from gitbucket"
/home/kbkn/pepper# git checkout -b main

/home/kbkn/pepper# git add .
/home/kbkn/pepper# git commit -m "migration from gitbucket"
/home/kbkn/pepper# git push -u origin main
Username for 'https://forgejo.ikko-lab.k.hosei.ac.jp': ikko
Password for 'https://ikko@forgejo.ikko-lab.k.hosei.ac.jp':
/home/kbkn/pepper# ./buildPEPPER.sh
/home/kbkn/pepper# docker images
REPOSITORY                      TAG                 IMAGE ID       CREATED          SIZE
pepper                          latest              677083ae24a0   19 minutes ago   6.93GB

home/kbkn/pepper# docker login forgejo.ikko-lab.k.hosei.ac.jp/ikko/pepper
Username: ikko
Password:
Login Succeeded
root@kvm00:/home/kbkn/pepper# docker push forgejo.ikko-lab.k.hosei.ac.jp/ikko/pepper:latest

How to download docker image

docker pull forgejo.ikko-lab.k.hosei.ac.jp/ikko/pepper:latest