docs: Update docker SITL docs

This commit is contained in:
sfalexrog
2019-03-19 14:49:33 +03:00
parent c22f8b2a7c
commit 03584e410b

View File

@@ -25,6 +25,8 @@
Для запуска симулятора можно использовать следующую команду:
```bash
docker pull sfalexrog/clever-sitl:slim
docker run \
-it \
--rm \
@@ -32,23 +34,23 @@ docker run \
-p 14557:14557 \
-p 8080:8080 \
-p 8081:8081 \
-p 8082:8082 \
-p 57575:57575 \
-p 9090:9090 \
-p 35602:35602 \
-p 2222:22 \
--name clever_sitl \
sfalexrog/clever-sitl:latest
sfalexrog/clever-sitl:slim
```
> **Note** Здесь и далее предполагается, что при настройке Docker на своей системе Вы [настроили запуск Docker от обычного пользователя](https://docs.docker.com/install/linux/linux-postinstall/) (раздел "Manage Docker as a non-root user")
Данная команда запускает контейнер ```sfalexrog/clever-sitl:latest```, содержащий последнюю версию контейнера с симулятором. Ключ ```-p``` позволяет задать соответствие между портом компьютера, на котором запущен контейнер, и портом "внутри" контейнера. Порты 14556 и 14557 нужны для подключения к симулятору с помощью [QGroundControl](http://qgroundcontrol.com/), порт 8080 - для просмотра топиков ROS с изображениями и видеопотоками, порт 8081 - для подключения к визуализации симуляции Gazebo, порт 8082 - для доступа к web-терминалу Butterfly.
Первая команда загружает последнюю версию контейнера с симулятором ```sfalexrog/clever-sitl:slim```, вторая его запускает. Ключ ```-p``` позволяет задать соответствие между портом компьютера, на котором запущен контейнер, и портом "внутри" контейнера. Порты 14556 и 14557 нужны для подключения к симулятору с помощью [QGroundControl](http://qgroundcontrol.com/), порт 8080 - для просмотра топиков ROS с изображениями и видеопотоками, порт 8081 - для подключения к визуализации симуляции Gazebo, порт 57575 - для доступа к web-терминалу Butterfly.
После запуска контейнера можно перейти по следующим ссылкам в браузере для доступа к сервисам симулятора:
* [http://localhost:8080](http://localhost:8080) - просмотр топиков с камеры (аналогично тому, как это сделано в Клевере)
* [http://localhost:8081](http://localhost:8081) - визуализация текущего состояния симулятора через Gzweb
* [http://localhost:8082](http://localhost:8082) - Web-терминал Butterfly с запущенным сеансом [tmux](https://github.com/tmux/tmux/wiki)
* [http://localhost:57575](http://localhost:57575) - Web-терминал Butterfly с запущенным сеансом [tmux](https://github.com/tmux/tmux/wiki)
Доступ к этим сервисам также есть с других компьютеров, расположенных в той же локальной сети; для этого в ссылках, указанных выше, следует ```localhost``` поменять на IP-адрес компьютера с запущеным контейнером.
@@ -84,13 +86,13 @@ docker run \
-p 14557:14557 \
-p 8080:8080 \
-p 8081:8081 \
-p 8082:8082 \
-p 57575:57575 \
-p 9090:9090 \
-p 35602:35602 \
-p 2222:22 \
-v $(pwd):/home/user/data:rw \
--name clever_sitl \
sfalexrog/clever-sitl:latest
sfalexrog/clever-sitl:slim
```
> **Note** В команде для запуска контейнера ключ ```-v``` может встречаться многократно. Это позволяет указать несколько общих директорий.
@@ -130,11 +132,11 @@ docker run \
-p 14557:14557 \
-p 8080:8080 \
-p 8081:8081 \
-p 8082:8082 \
-p 57575:57575 \
-p 9090:9090 \
-p 35602:35602 \
-p 2222:22 \
sfalexrog/clever-sitl:latest
sfalexrog/clever-sitl:slim
```
При этом на компьютере с контейнером должна быть запущена графическая среда, использующая X Server.