Conexiones de Bitbucket Cloud - AWS CodePipeline
Creación de una conexión a Bitbucket Cloud (consola)Creación de una conexión a Bitbucket Cloud (CLI)

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.

Conexiones de Bitbucket Cloud

Las conexiones te permiten autorizar y establecer configuraciones que asocien a tu proveedor externo con tus AWS recursos. Para asociar su repositorio de terceros como origen de su canalización, debe usar una conexión.

nota

Esta función no está disponible en las regiones Asia Pacífico (Hong Kong), Asia Pacífico (Hyderabad), Asia Pacífico (Yakarta), Asia Pacífico (Melbourne), Asia Pacífico (Osaka), África (Ciudad del Cabo), Oriente Medio (Bahréin), Oriente Medio (Emiratos Árabes Unidos), Europa (España), Europa (Zúrich), Israel (Tel Aviv) o AWS GovCloud (EE. UU. Oeste). Para hacer referencia a otras acciones disponibles, consulte Integraciones de productos y servicios con CodePipeline. Para ver consideraciones sobre esta acción en la región de Europa (Milán), consulte la nota que aparece en CodeStarSourceConnection para Bitbucket Cloud GitHub, GitHub Enterprise Server, GitLab .com y acciones GitLab autogestionadas.

Para añadir una acción fuente de Bitbucket Cloud CodePipeline, puedes elegir entre las siguientes opciones:

nota

También puede crear una conexión mediante la consola de Herramientas para desarrolladores, en Configuración. Consulte Crear una conexión.

Antes de empezar

  • Debe haber creado una cuenta con el proveedor del repositorio de terceros, como Bitbucket Cloud.

  • Debe haber creado un repositorio de código de terceros, como un repositorio de Bitbucket Cloud.

nota

Las conexiones de Bitbucket Cloud solo proporcionan acceso a los repositorios que son propiedad de la cuenta de Bitbucket Cloud que se utilizó para crear la conexión.

Si la aplicación se va a instalar en un espacio de trabajo de Bitbucket Cloud, necesita permisos Administrar espacio de trabajo. De lo contrario, no se mostrará la opción de instalar la aplicación.

Creación de una conexión a Bitbucket Cloud (consola)

Sigue estos pasos para usar la CodePipeline consola y añadir una acción de conexión a tu repositorio de Bitbucket.

nota

Puede crear conexiones a un repositorio de Bitbucket Cloud. Los tipos de proveedores de Bitbucket instalados, como Bitbucket Server, no son compatibles.

Paso 1: Crear o editar la canalización

Para crear o editar la canalización

  1. Inicia sesión en la CodePipeline consola.

  2. Elija una de las siguientes opciones.

    • Elija Crear canalización. Siga los pasos de Crear una canalización para completar la primera pantalla y seleccione Siguiente. En la página origen, en Proveedor de origen, seleccione Bitbucket.

    • Elija editar una canalización existente. Elija Editar y, a continuación, elija Editar etapa. Elija añadir o editar su acción de origen. En la página Editar acción, en Nombre de la acción, introduzca el nombre de la acción. En Proveedor de acciones, seleccione Bitbucket.

  3. Realice una de las siguientes acciones siguientes:

    • En Conexión, si aún no ha creado una conexión con su proveedor, seleccione Conectar a Bitbucket. Continúe con el Paso 2: Crear una conexión a Bitbucket.

    • En Conexión, si ya ha creado una conexión con su proveedor, seleccione la conexión. Continúe con el Paso 3: Guardar la acción de origen para la conexión.

Paso 2: Crear una conexión a Bitbucket Cloud

Para crear una conexión a Bitbucket Cloud

  1. En la página de configuración de Conectar a Bitbucket, introduzca el nombre de su conexión y seleccione Conectar a Bitbucket.

    Captura de pantalla de la consola donde se muestra el botón Conectar a Bitbucket.

    Aparece el campo Aplicaciones de Bitbucket.

  2. En Bitbucket apps (Aplicaciones de Bitbucket), elija la instalación de una aplicación o elija Install a new app (Instalar una aplicación nueva) para crear una.

    nota

    Solo instale la aplicación una vez para cada espacio de trabajo o cuenta de Bitbucket Cloud. Si ya ha instalado la aplicación de Bitbucket, elíjala y diríjase al paso 4.

    Captura de pantalla de la consola en la que se muestra el cuadro de diálogo «Conectarse a Bitbucket Cloud» con el botón para instalar una nueva aplicación.

  3. Si se muestra la página de inicio de sesión de Bitbucket Cloud, inicie sesión con sus credenciales y luego elija continuar.

  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.

    Si utiliza un espacio de trabajo de Bitbucket, cambie la opción Authorize for (Autorizar para) para el espacio de trabajo. Solo se mostrarán los espacios de trabajo en los que tenga acceso de administrador.

    Elija Grant access (Conceder acceso).

  5. En Bitbucket apps (Aplicaciones de Bitbucket), se muestra el ID de conexión de la instalación nueva. Elija Conectar. La conexión creada se muestra en la lista de conexiones.

    Captura de pantalla de la consola en la que se muestran las solicitudes de acceso.

Paso 3: Guardar la acción origen de Bitbucket Cloud

Siga estos pasos del asistente o de la página de Editar acción para guardar la acción de origen con la información de conexión.

Para completar y guardar la acción de origen con la conexión

  1. En Repository name (Nombre del repositorio), elija el nombre del repositorio de terceros.

  2. En los activadores de Pipeline, puedes añadir activadores si tu acción es una CodeConnections acción. Para configurar la configuración de los activadores de canalización y, de forma opcional, filtrar con activadores, consulta más información enFiltra los activadores en las solicitudes de inserción o extracción de código.

  3. En Output artifact format (Formato del artefacto de salida), debe elegir el formato de los artefactos.

    • Para almacenar los artefactos de salida de la acción de Bitbucket Cloud mediante el método predeterminado, selecciona CodePipeline predeterminado. La acción obtiene acceso a los archivos del repositorio de Bitbucket Cloud y almacena los artefactos en un archivo ZIP en el almacén de artefactos de canalización.

    • Para almacenar un archivo JSON que contiene una referencia URL al repositorio de manera que las acciones posteriores puedan ejecutar comandos Git directamente, elija Clonación completa. Esta opción solo la pueden utilizar las acciones CodeBuild posteriores.

      Si elige esta opción, tendrá que actualizar los permisos de su función de servicio de CodeBuild proyectos, tal y como se muestra en Añade CodeBuild GitClone permisos para las conexiones a Bitbucket, Enterprise Server o .com GitHub GitHub GitLab la siguiente.

  4. Seleccione Siguiente en el asistente o Guardar en la página Editar acción.

Creación de una conexión a Bitbucket Cloud (CLI)

Puedes usar AWS Command Line Interface (AWS CLI) para crear una conexión.

nota

Puede crear conexiones a un repositorio de Bitbucket Cloud. Los tipos de proveedores de Bitbucket instalados, como Bitbucket Server, no son compatibles.

Para ello, utilice el comando create-connection.

importante

Una conexión creada a través del AWS CLI o AWS CloudFormation está en PENDING estado de forma predeterminada. Después de crear una conexión con la CLI o AWS CloudFormation, utilice la consola para editar la conexión y establecer su estadoAVAILABLE.

Para crear una conexión

  1. Abra un terminal (Linux, macOS o Unix) o un símbolo del sistema (Windows). Utilice el AWS CLI para ejecutar el create-connection comando, especificando el --provider-type y --connection-name para la conexión. En este ejemplo, el nombre del proveedor de terceros es Bitbucket y el nombre especificado para la conexión es MyConnection.

    aws codestar-connections create-connection --provider-type Bitbucket --connection-name MyConnection

    Si se ejecuta correctamente, este comando devuelve la información del ARN de la conexión, que será similar a lo siguiente.

    {
    "ConnectionArn": "arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
}

  2. Utilice la consola para completar la conexión. Para obtener más información, consulte Actualización de una conexión pendiente.

  3. De forma predeterminada, la canalización detecta los cambios al enviar el código al repositorio de origen de conexión. Para configurar la configuración del desencadenador de canalización para la publicación manual o para las etiquetas de Git, realiza una de las siguientes acciones:

    • Para configurar la configuración de los desencadenadores de canalización para que comience únicamente con una versión manual, añade la siguiente línea a la configuración: 

      "DetectChanges": "false",

    • Para configurar la configuración de los activadores de canalización para filtrar con activadores, consulte más detalles enFiltra los activadores en las solicitudes de inserción o extracción de código. Por ejemplo, lo siguiente añade etiquetas Git al nivel de canalización de la definición de JSON de canalización. En este ejemplo, release-v0 y release-v1 son las etiquetas de Git que se deben incluir y release-v2 es la etiqueta de Git que se debe excluir.

      "triggers": [
            {
                "providerType": "CodeStarSourceConnection",
                "gitConfiguration": {
                    "sourceActionName": "Source",
                    "push": [
                        {
                            "tags": {
                                "includes": [
                                    "release-v0", "release-v1"
                                ],
                                "excludes": [
                                    "release-v2"
                                ]
                            }
                        }
                    ]
                }
            }
        ]