Executando um aplicativo de amostra com ROS Melodic e Gazebo 9 - AWS RoboMaker

Aviso de fim do suporte: em 10 de setembro de 2025, AWS interromperá o suporte para AWS RoboMaker. Depois de 10 de setembro de 2025, você não poderá mais acessar o AWS RoboMaker console ou AWS RoboMaker os recursos. Para obter mais informações sobre como fazer a transição para ajudar AWS Batch a executar simulações em contêineres, visite esta postagem no blog.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Executando um aplicativo de amostra com ROS Melodic e Gazebo 9

O tutorial a seguir mostra como usar imagens de contêiner para desenvolver com ROS e Gazebo 9 criando e executando o aplicativo robótico Hello World e o aplicativo de simulação. Você pode fazer com que o aplicativo de amostra funcione executando os comandos descritos neste documento.

Para este tutorial, criamos e usamos três imagens de contêiner. A seguir, mostramos a estrutura de diretórios que usamos para esse aplicativo de exemplo.

├── HelloWorldSampleAppROSMelodicGazebo9 // Base Image │ └── Dockerfile ├── HelloWorldSampleAppROSMelodicGazebo9RobotApp // Image for Robot App │ ├── Dockerfile │ └── robot-entrypoint.sh ├── HelloWorldSampleAppROSMelodicGazebo9SimApp // Image for Simulation App │ ├── Dockerfile │ └── simulation-entrypoint.sh

Cada Dockerfile tem as instruções necessárias para criar cada imagem.

  • O Dockerfile da imagem base tem os comandos para configurar o ROS e o Gazebo.

  • O Dockerfile para o aplicativo de robô tem os comandos para configurar o aplicativo de robô “Hello World”.

  • O Dockerfile do aplicativo de simulação tem os comandos para configurar o aplicativo de simulação “Hello World”.

Tanto o aplicativo de robô quanto o aplicativo de simulação têm scripts de ponto de entrada. Esses scripts fornecem os ambientes para seus respectivos aplicativos. Eles configuram o caminho para você executar comandos que permitem executar seu robô e aplicativos de simulação.

Criação de uma imagem base

Para criar uma imagem base, salve os comandos no exemplo para criar seu ambiente em um Dockerfile. Em seguida, crie o Dockerfile.

  1. Salve os comandos a seguir em um Dockerfile.

    # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. # SPDX-License-Identifier: MIT-0 FROM ros:melodic ENV DEBIAN_FRONTEND noninteractive RUN apt-get clean RUN apt-get update && apt-get install -y \ lsb \ unzip \ wget \ curl \ sudo \ python-vcstool \ python-rosinstall \ python3-colcon-common-extensions \ ros-melodic-rviz \ ros-melodic-rqt \ ros-melodic-rqt-common-plugins \ devilspie \ xfce4-terminal \ ros-melodic-gazebo-ros-pkgs \ ros-melodic-gazebo-ros-control \ ros-melodic-turtlebot3 ENV QT_X11_NO_MITSHM=1 ARG USERNAME=robomaker RUN groupadd $USERNAME RUN useradd -ms /bin/bash -g $USERNAME $USERNAME RUN sh -c 'echo "$USERNAME ALL=(root) NOPASSWD:ALL" >> /etc/sudoers' USER $USERNAME RUN sh -c 'cd /home/$USERNAME' # Download and build our Robot and Simulation application RUN sh -c 'mkdir -p /home/robomaker/workspace' RUN sh -c 'cd /home/robomaker/workspace && wget https://github.com/aws-robotics/aws-robomaker-sample-application-helloworld/archive/ros1.zip && unzip ros1.zip' RUN sh -c 'cd /home/robomaker/workspace/aws-robomaker-sample-application-helloworld-ros1' RUN sudo rosdep fix-permissions RUN rosdep update
  2. Depois de criar o Dockerfile, crie-o usando os seguintes comandos no seu terminal.

    cd ../HelloWorldSampleAppROSMelodicGazebo9 docker build -t helloworldsampleapprosmelodicgazebo9:latest .

A construção da imagem base instala o ROS Melodic e o Gazebo 9. Você precisa de ambas as bibliotecas instaladas para executar seus aplicativos com êxito.

Criação de uma imagem para o aplicativo de robô

Depois de criar a imagem base, crie a imagem para seu aplicativo de robô.

  1. Salve o script a seguir em um Dockerfile e crie-o. Esse script baixa o aplicativo de robô “Hello World” e o configura.

    # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. # SPDX-License-Identifier: MIT-0 FROM helloworldsampleapprosmelodicgazebo9:latest # Build the Robot application RUN cd /home/robomaker/workspace/aws-robomaker-sample-application-helloworld-ros1/robot_ws && \ /bin/bash -c "source /opt/ros/melodic/setup.bash && vcs import < .rosinstall && rosdep install --rosdistro melodic --from-paths src --ignore-src -r -y && colcon build" COPY robot-entrypoint.sh /home/robomaker/robot-entrypoint.sh RUN sh -c 'sudo chmod +x /home/robomaker/robot-entrypoint.sh' RUN sh -c 'sudo chown robomaker:robomaker /home/robomaker/robot-entrypoint.sh' CMD roslaunch hello_world_robot rotate.launch ENTRYPOINT [ "/home/robomaker/robot-entrypoint.sh" ]
  2. Use o comando a seguir para criar a imagem para o aplicativo do robô a partir do Dockerfile.

    cd HelloWorldSampleAppROSMelodicGazebo9RobotApp/HelloWorldSampleAppROSMelodicGazebo9RobotApp docker build -t helloworldsampleapprosmelodicgazebo9robotapp:latest image/.
  3. Veja a seguir o conteúdo do script que você pode salvar como robot-entrypoint.sh. Esse script fornece o ambiente do aplicativo do robô.

    #!/bin/bash if [ ! -z $GAZEBO_MASTER_URI ]; then tmp_GAZEBO_MASTER_URI=$GAZEBO_MASTER_URI fi cd /home/robomaker/workspace/aws-robomaker-sample-application-helloworld-ros1/robot_ws source /opt/ros/melodic/setup.bash source /usr/share/gazebo-9/setup.sh source ./install/setup.sh if [ ! -z $tmp_GAZEBO_MASTER_URI ]; then export GAZEBO_MASTER_URI=$tmp_GAZEBO_MASTER_URI unset tmp_GAZEBO_MASTER_URI fi printenv exec "${@:1}"

Criação de uma imagem para o aplicativo de simulação

Depois de criar a imagem base e a imagem para o aplicativo do robô, você pode criar a imagem para o seu aplicativo de simulação.

  1. Salve o script a seguir em um Dockerfile e crie-o. Esse script baixa o aplicativo de robô “Hello World” e o configura.

    # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. # SPDX-License-Identifier: MIT-0 FROM helloworldsampleapprosmelodicgazebo9:latest # Build the Simulation application RUN cd /home/robomaker/workspace/aws-robomaker-sample-application-helloworld-ros1/simulation_ws && \ /bin/bash -c "source /opt/ros/melodic/setup.bash && vcs import < .rosinstall && rosdep install --rosdistro melodic --from-paths src --ignore-src -r -y && colcon build" COPY simulation-entrypoint.sh /home/robomaker/simulation-entrypoint.sh RUN sh -c 'sudo chmod +x /home/robomaker/simulation-entrypoint.sh' RUN sh -c 'sudo chown robomaker:robomaker /home/robomaker/simulation-entrypoint.sh' CMD roslaunch hello_world_simulation empty_world.launch ENTRYPOINT [ "/home/robomaker/simulation-entrypoint.sh" ]
  2. Salve o script simulation-entrypoint.sh a seguir. Esse script fornece o ambiente do aplicativo de simulação.

    #!/bin/bash if [ ! -z $GAZEBO_MASTER_URI ]; then tmp_GAZEBO_MASTER_URI=$GAZEBO_MASTER_URI fi cd /home/robomaker/workspace/aws-robomaker-sample-application-helloworld-ros1/simulation_ws source /opt/ros/melodic/setup.bash source /usr/share/gazebo-9/setup.sh source ./install/setup.sh if [ ! -z $tmp_GAZEBO_MASTER_URI ]; then export GAZEBO_MASTER_URI=$tmp_GAZEBO_MASTER_URI unset tmp_GAZEBO_MASTER_URI fi printenv exec "${@:1}"

Executando o aplicativo e enviando-o para o ECR

Depois de criar suas imagens, certifique-se de que elas sejam executadas corretamente em seu ambiente Linux local. Depois de verificar se a imagem do Docker é executada, você pode enviá-la para o Amazon ECR e criar um trabalho de simulação.

  1. Use os comandos a seguir para executar o aplicativo Hello World em seu ambiente Linux local.

    docker run -it -e DISPLAY -v /tmp/.X11-unix/:/tmp/.X11-unix/ \ -u robomaker -e ROBOMAKER_GAZEBO_MASTER_URI=http://localhost:5555 \ -e ROBOMAKER_ROS_MASTER_URI=http://localhost:11311 \ helloworldsampleapprosmelodicgazebo9robotapp:latest
    docker run -it -e DISPLAY -v /tmp/.X11-unix/:/tmp/.X11-unix/ \ -u robomaker -e ROBOMAKER_GAZEBO_MASTER_URI=http://localhost:5555 \ -e ROBOMAKER_ROS_MASTER_URI=http://localhost:11311 \ helloworldsampleapprosmelodicgazebo9simapp:latest
  2. Execute o aplicativo do robô e os contêineres do aplicativo de simulação para visualizar a simulação usando a ferramenta Gazebo GUI. Use os comandos a seguir para:

    1. Conectar-se ao contêiner executando o aplicativo de simulação.

    2. Visualizar seu aplicativo executando a interface gráfica do usuário (GUI) do Gazebo.

    # Enable access to X server to launch Gazebo from docker container $ xhost + # Check that the robot_app and sim_app containers are running. The command should list both containers $ docker container ls # Connect to the sim app container $ docker exec -it sim_app bash # Launch Gazebo from within the container $ rosrun gazebo_ros gzclient
  3. Adicione tags às suas imagens para mantê-las organizadas. Use os comandos a seguir para marcar suas imagens.

    docker tag helloworldsampleapprosmelodicgazebo9robotapp:latest accountID.dkr.ecr.us-west-2.amazonaws.com/helloworldsampleapprosmelodicgazebo9robotapp:latest
    docker tag helloworldsampleapprosmelodicgazebo9simapp:latest accountID.dkr.ecr.us-west-2.amazonaws.com/helloworldsampleapprosmelodicgazebo9simapp:latest
  4. Depois de verificar se o aplicativo está funcionando corretamente, você pode enviar para o Amazon ECR usando os seguintes comandos.

    aws ecr get-login-password --region us-west-2 | docker login --username AWS --password-stdin accountID.dkr.ecr.us-west-2.amazonaws.com docker push accountID.dkr.ecr.us-west-2.amazonaws.com/helloworldsampleapprosmelodicgazebo9robotapp:latest docker push accountID.dkr.ecr.us-west-2.amazonaws.com/helloworldsampleapprosmelodicgazebo9simapp:latest

Em seguida, você pode executar um trabalho de simulação na imagem. Para obter mais informações sobre trabalhos de simulação, consulte Simulação com o AWS RoboMaker.