Tutorial: Conexión a un entorno de pruebas mediante SSH - AWS CodeBuild
Paso 1: inicio de un entorno de pruebasPaso 2: modificación de la configuración de SSH localPaso 3: conexión con el entorno de pruebasPaso 4: revisión de los resultados

Tutorial: Conexión a un entorno de pruebas mediante SSH

En este tutorial se muestra cómo conectarse a un entorno de pruebas de CodeBuild mediante un cliente de SSH.

Para completar este tutorial, primero debe:

  • Asegúrese de tener un proyecto de AWS CodeBuild existente.

  • Configure los permisos de IAM adecuados configurados para el rol de proyecto de CodeBuild.

  • Instale y configure AWS CLI en su equipo local.

Paso 1: inicio de un entorno de pruebas

Cómo iniciar un entorno de pruebas de CodeBuild en la consola

  1. Abra la consola de AWS CodeBuild en https://console.aws.amazon.com/codesuite/codebuild/home.

  2. En el panel de navegación, elija Proyectos de compilación. Elija el proyecto de compilación y, a continuación, elija Iniciar depuración.

    Página de detalles del proyecto de compilación en la consola.

  3. En la pestaña Cliente de SSH, seleccione Iniciar entorno de pruebas.

    Pestaña “Cliente de SSH” en la consola con el botón “Iniciar entorno de pruebas”.

  4. El proceso de inicialización del entorno de pruebas puede tardar un poco. Puede conectarse al entorno de pruebas cuando su estado cambie a RUN_SANDDBOX.

    Conexión del entorno de pruebas de SSH después de que el estado cambie a “RUN_SANDDBOX”.

Paso 2: modificación de la configuración de SSH local

Si es la primera vez que se conecta a un entorno de pruebas, debe realizar un proceso de configuración único siguiendo estos pasos:

Cómo modificar la configuración de SSH local en la consola

  1. Busque los comandos de configuración correspondientes a su sistema operativo.

  2. Abra el terminal local y, a continuación, copie y ejecute los comandos proporcionados para descargar y ejecutar el script para configurar la configuración de SSH local. Por ejemplo, si el sistema operativo es macOS, utilice el siguiente comando:

    Comandos de macOS para la conexión de SSH al entorno de pruebas de CodeBuild en la consola.

  3. El script de configuración agregará las configuraciones necesarias para conectarse a los entornos de pruebas. Se le pedirá que acepte estos cambios.

  4. Tras la configuración correcta, se creará una nueva entrada de configuración de SSH para el entorno de pruebas de CodeBuild.

    Conexión correcta del entorno de pruebas de SSH.

Paso 3: conexión con el entorno de pruebas

Cómo modificar la configuración de SSH local en la consola

  1. Configure la autenticación de la AWS CLI y asegúrese de que el usuario de AWS CLI tenga el permiso codebuild:StartSandboxConnection. Para obtener más información, consulte Autenticación mediante credenciales de usuario de IAM para la AWS CLI en la Guía del usuario de Interfaz de línea de comandos de AWS de la versión 1.

  2. Conéctese al entorno de pruebas con el siguiente comando:

    ssh codebuild-sandbox-ssh=arn:aws:codebuild:us-east-1:<account-id>:sandbox/<sandbox-id>
    nota

    Para solucionar problemas de conexión, use la marca -v para habilitar la salida detallada. Por ejemplo, ssh -v codebuild-sandbox-ssh=arn:aws:codebuild:us-east-1:<account-id>:sandbox/<sandbox-id>.

    Para obtener sugerencias adicionales para la solución de problemas, consulte Solución de problemas de conexión de SSH del entorno de pruebas AWS CodeBuild.

Paso 4: revisión de los resultados

Una vez conectado, puede depurar errores de compilación, probar comandos de compilación, experimentar con cambios de configuración y verificar variables de entorno y dependencias con el entorno de pruebas.