Introducción a las conexiones - Consola de Developer Tools
Requisitos previosPaso 1: Editar archivo de origenPaso 2: Crear la canalizaciónPaso 3: Asocia tu repositorio a CodeGuru Reviewer

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Introducción a las conexiones

La forma más sencilla de empezar con las conexiones es configurar una conexión que asocie tu repositorio de fuentes de terceros a tus AWS recursos. Si quisieras conectar tu canalización a una AWS fuente, por ejemplo CodeCommit, te conectarías a ella como una acción de origen. Sin embargo, si tiene un repositorio externo, debe crear una conexión para asociar el repositorio a la canalización. En este tutorial, configurará una conexión con su repositorio de Bitbucket y su canalización.

En esta sección, utilizará conexiones con lo siguiente:

  • AWS CodePipeline: en estos pasos, crea una canalización con su repositorio de Bitbucket como origen de canalización.

  • Amazon CodeGuru Reviewer: A continuación, asocias tu repositorio de Bitbucket a tus herramientas de comentarios y análisis en CodeGuru Reviewer.

Requisitos previos

Antes de comenzar, complete los pasos de Configuración. También necesitas un repositorio fuente de terceros que desees conectar a tus AWS servicios y permitir que la conexión gestione la autenticación por ti. Por ejemplo, es posible que desees conectar un repositorio de Bitbucket a tus AWS servicios que se integren con los repositorios de origen.

  • Cree un repositorio de Bitbucket con su cuenta de Bitbucket.

  • Tenga listas las credenciales de Bitbucket. Cuando utilices el AWS Management Console para configurar una conexión, se te pedirá que inicies sesión con tus credenciales de Bitbucket.

Paso 1: Editar archivo de origen

Cuando crea el repositorio de Bitbucket, se incluye un archivo README.md predeterminado, el cual usted editará.

  1. Inicie sesión en su repositorio de Bitbucket y elija Source (Origen).

  2. Elija el archivo README.md y elija Edit (Editar) en la parte superior de la página. Elimine el texto existente y agregue el siguiente texto.

    This is a Bitbucket repository!

  3. Elija Commit (Confirmar).

    Asegúrese de que el archivo README.md está en el nivel raíz del repositorio.

Paso 2: Crear la canalización

En esta sección, debe crear una canalización con las siguientes acciones:

  • una etapa de origen con una conexión a la acción y el repositorio de Bitbucket

  • Una etapa de construcción con una acción de AWS CodeBuild construcción.

Para crear una canalización con el asistente

  1. Inicia sesión en la CodePipeline consola en https://console.aws.amazon.com/codepipeline/.

  2. En la página Bienvenido, Introducción o en la página Canalizaciones, elija Crear canalización.

  3. En Step 1: Choose pipeline settings (Paso 1: Elegir configuración de canalización), en Pipeline name (Nombre de canalización), escriba MyBitbucketPipeline.

  4. En Service role (Rol de servicio), elija New service role (Nuevo rol de servicio).

    nota

    Si opta por utilizar su función de CodePipeline servicio actual, asegúrese de haber añadido el permiso de codeconnections:UseConnection IAM a su política de función de servicio. Para obtener instrucciones sobre la función de CodePipeline servicio, consulte Añadir permisos a la función de CodePipeline servicio.

  5. Para Configuración avanzada deje los valores predeterminados. En Artifact store (Almacén de artefactos), elija Default location (Ubicación predeterminada) para utilizar el almacén de artefactos predeterminado, como el bucket de artefacto de Amazon S3 que se estableció como predeterminado, para la canalización en la región que seleccionó para esta.

    nota

    Este no es el bucket de origen para su código fuente. Este es el almacén de artefactos de la canalización. Cada canalización debe tener su propio almacén de artefactos independiente, como un bucket de S3.

    Elija Siguiente.

  6. En la página Step 2: Add source stage (Paso 2: Agregar etapa de origen), agregue una etapa de origen:

    1. En Source provider (Proveedor de origen), elija Bitbucket.

    2. En Connection (Conexión), elija Connect to Bitbucket (Conectarse a Bitbucket).

    3. En la página Connect to Bitbucket (Conectarse a Bitbucket), en Connection name (Nombre de la conexión), ingrese el nombre de la conexión que desea crear. El nombre le ayudará a identificar esta conexión más adelante.

      En Bitbucket apps (Aplicaciones de Bitbucket), elija Install a new app (Instalar una aplicación nueva).

    4. En la página de instalación de la aplicación, aparece un mensaje que indica que la AWS CodeStar aplicación está intentando conectarse a tu cuenta de Bitbucket. Elija Grant access (Conceder acceso). Una vez que hayas autorizado la conexión, se detectarán tus repositorios en Bitbucket y podrás elegir asociar uno a tu recurso. AWS

    5. Se muestra el ID de conexión de la nueva instalación. Elija Complete connection (Completar conexión). Volverás a la CodePipeline consola.

    6. En Repository name (Nombre del repositorio), elija el nombre de su repositorio de Bitbucket.

    7. En Branch name (Nombre de ramificación), elija la ramificación para su repositorio.

    8. Asegúrese de que la opción Iniciar la canalización en el cambio del código fuente está seleccionada.

    9. En Formato de artefacto de salida, elija una de las siguientes opciones: CodePipeline predeterminado.

      • Elija el formato CodePipeline predeterminado para usar el formato zip predeterminado para los artefactos en proceso.

      • Elija Clonación completa para incluir en la canalización los metadatos de Git sobre el repositorio para artefactos. Esto solo se admite para CodeBuild las acciones.

    Elija Siguiente.

  7. En Add build stage (Añadir etapa de compilación), añada una etapa de compilación:

    1. En Build provider (Proveedor de compilación), elija AWS CodeBuild. En el campo Region (Región) conserve el valor predeterminado de la región de la canalización.

    2. Elija Crear proyecto.

    3. En Project name (Nombre de proyecto), escriba un nombre para este proyecto de compilación.

    4. En Environment image (Imagen de entorno), elija Managed image (Imagen administrada). En Operating system (Sistema operativo), elija Ubuntu.

    5. En Runtime, elija Standard (Estándar). En Imagen, elija aws/codebuild/standard:5.0.

    6. En Service role (Rol de servicio), elija New service role (Nuevo rol de servicio).

    7. En Buildspec, para Build specifications (Especificaciones de la compilación), elija Insert build commands (Insertar comandos de compilación). Elija Switch to editor (Cambiar a editor) y pegue lo siguiente en Build commands (Comandos de compilación):

      version: 0.2

phases:
  install:
    #If you use the Ubuntu standard image 2.0 or later, you must specify runtime-versions.
    #If you specify runtime-versions and use an image other than Ubuntu standard image 2.0, the build fails.
    runtime-versions:
      nodejs: 12
      # name: version
    #commands:
      # - command
      # - command
  pre_build:
    commands:
      - ls -lt
      - cat README.md
  # build:
    #commands:
      # - command
      # - command
  #post_build:
    #commands:
      # - command
      # - command
#artifacts:
  #files:
    # - location
    # - location
  #name: $(date +%Y-%m-%d)
  #discard-paths: yes
  #base-directory: location
#cache:
  #paths:
    # - paths

    8. Selecciona Continuar a CodePipeline. Esto vuelve a la CodePipeline consola y crea un CodeBuild proyecto que utiliza los comandos de compilación para la configuración. El proyecto de compilación usa un rol de servicio para administrar los permisos AWS del servicio. Es posible que este paso tarde un par de minutos.

    9. Elija Siguiente.

  8. En la página Step 4: Add deploy stage (Paso 4: Añadir etapa de implementación), elija Skip deploy stage (Omitir etapa de implementación) y, a continuación, acepte el mensaje de advertencia eligiendo Skip (Omitir) una vez más. Elija Siguiente.

  9. En Step 5: Review (Paso 5: Revisar), seleccione Create pipeline (Crear canalización).

  10. Cuando su canalización se crea correctamente, se inicia la ejecución de una canalización.

    Captura de pantalla de la consola que muestra que la canalización se completó correctamente con el origen de Bitbucket.

  11. En la etapa de compilación exitosa, elija Details (Detalles).

    En Detalles de ejecución, consulta el resultado de la CodeBuild compilación. Los comandos generan el contenido del archivo README.md de la siguiente manera:

    This is a Bitbucket repository!
    Captura de pantalla de la consola que muestra un ejemplo de salida de compilación que se completó correctamente.

Paso 3: Asocia tu repositorio a CodeGuru Reviewer

Tras crear una conexión, puede utilizarla para todos los AWS recursos de la misma cuenta. Por ejemplo, puedes usar la misma conexión de Bitbucket para una acción de CodePipeline origen en una canalización y tu repositorio confirmar el análisis en CodeGuru Reviewer.

  1. Inicia sesión en la consola de CodeGuru Reviewer.

  2. En CodeGuru Reviewer, selecciona Asociar repositorio.

    Se abre el asistente de una página.

  3. En Select source provider (Seleccionar el proveedor de origen), elija Bitbucket.

  4. En Conectar a Bitbucket (con AWS CodeConnections), elige la conexión que creaste para tu canalización.

  5. En Repository location (Ubicación del repositorio), elija el nombre de su repositorio de Bitbucket y elija Associate (Asociar).

    Puede continuar configurando revisiones de código. Para obtener más información, consulta Conectarse a Bitbucket para asociar un repositorio a CodeGuru Reviewer en la Guía del usuario de Amazon CodeGuru Reviewer.