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.
Alwin Abraham, Amazon Web Services
AWS Amplify le ayuda a implementar y probar sitios web estáticos rápidamente sin tener que configurar la infraestructura que normalmente se requiere. Puede implementar el enfoque de este patrón si su organización quiere usar Bitbucket como control de código fuente, ya sea para migrar el código de una aplicación existente o para crear una nueva aplicación. Al utilizar AWS CloudFormation para configurar Amplify automáticamente, proporciona visibilidad de las configuraciones que utiliza.
Este patrón describe cómo crear un entorno de canalización e implementación continuas de front-end (CI/CD) e implementación continuas mediante AWS CloudFormation para integrar un repositorio de Bitbucket con AWS Amplify. El enfoque del patrón significa que puede crear una canalización de frontend de Amplify para implementaciones repetibles.
Requisitos previos
Una cuenta de Amazon Web Services (AWS) activa
Una cuenta de Bitbucket activa con acceso de administrador
Acceder a un terminal que usa cURL o la aplicación Postman
Familiaridad con Amplify
Familiaridad con AWS CloudFormation
Familiaridad con los archivos YAML-formatted
Pila de tecnología
Amplify
AWS CloudFormation
Bitbucket
AWS Amplify: Amplify ayuda a los desarrolladores a desarrollar e implementar aplicaciones móviles y web impulsadas por la nube.
AWS CloudFormation: AWS CloudFormation es un servicio que le ayuda a modelar y configurar sus recursos de AWS para que pueda dedicar menos tiempo a gestionarlos y más a centrarse en las aplicaciones que se ejecutan en AWS.
Bitbucket: Bitbucket es una solución de gestión de repositorios de Git diseñada para equipos profesionales. Le brinda un lugar central para administrar los repositorios de Git, colaborar en su código fuente y guiarle a través del flujo de desarrollo.
Código
El bitbucket-amplify.yml archivo (adjunto) contiene la CloudFormation plantilla de AWS para este patrón.
| Tarea | Descripción | Habilidades requeridas |
|---|
| (Opcional) Cree un repositorio de Bitbucket. | Inicie sesión en su cuenta de Bitbucket y crea un repositorio nuevo. Para obtener más información al respecto, consulte Crear un repositorio de Git en la documentación de Bitbucket. Registrar el nombre del espacio de trabajo.
También puede utilizar un repositorio de Bitbucket ya existente. | DevOps ingeniero |
| Abra la configuración del espacio de trabajo. | Abra el espacio de trabajo y seleccione la pestaña Repositorio. Seleccione el repositorio que desee integrar con AmplifyAmplify. Seleccione el nombre del espacio de trabajo que está por encima del nombre del repositorio. En la barra lateral, seleccione Configuración.
| DevOps ingeniero |
| Crear un consumidor de OAuth. | En la sección Aplicaciones y funciones, seleccione Consumidores de OAuth y, a continuación, Agregar consumidor. Escriba un nombre para la secuencia, por ejemplo, Amplify Integration. Introduzca una URL de devolución de llamada. Aunque este campo es obligatorio, no se utiliza para completar la integración, por lo que el valor podría ser http://localhost:3000 Marque la casilla Se trata de un consumidor privado. Elija los siguientes permisos: Deje las opciones predeterminadas para todos los demás campos y elija Enviar. Registra la clave y el secreto que se generan.
| DevOps ingeniero |
| Obtenga el token de acceso de OAuth. | Abra una ventana del terminal y ejecute el siguiente comando:
curl -X POST -u "KEY:SECRET" https://bitbucket.org/site/oauth2/access_token -d grant_type=client_credentials
Sustituya KEY y SECRET por la clave y el secreto que registró anteriormente. 2. Registre el token de acceso sin utilizar las comillas. El token solo es válido durante un tiempo limitado y el tiempo predeterminado es de dos horas. Debe ejecutar la CloudFormation plantilla de AWS en este período de tiempo. | DevOps ingeniero |
| Tarea | Descripción | Habilidades requeridas |
|---|
| Descargue la CloudFormation plantilla de AWS. | Descargue la CloudFormation plantilla de bitbucket-amplify.yml AWS (adjunta). Esta plantilla crea la CI/CD canalización en Amplify, además del proyecto y la sucursal de Amplify. | |
| Cree e implemente la CloudFormation pila de AWS. | Inicie sesión en la consola de administración de AWS en la región de AWS en la que desee realizar la implementación y abra la CloudFormation consola de AWS. Seleccione Crear pila (con nuevos recursos) y, a continuación, Cargar un archivo de plantilla. Cargue el archivo bitbucket-amplify.yml. Seleccione Siguiente, introduzca un nombre de pila y, a continuación, introduzca los siguientes parámetros: Token de acceso: pegue el token de acceso de OAuth que creó anteriormente. URL del repositorio: añada la URL del repositorio del proyecto de Bitbucket. La URL tiene el siguiente formato: https://bitbucket.org/<WORKSPACE_NAME>/<REPO_NAME> Nombre de la sucursal: debe coincidir con el nombre de una rama de su repositorio de Bitbucket. No es necesario que esta rama exista cuando ejecute la CloudFormation pila de AWS, pero es necesaria para implementar el código en el entorno. Nombre del proyecto: este es el nombre que se debe asociar al proyecto Amplify.
5. Seleccione Siguiente y después Crear pilas. | DevOps ingeniero |
| Tarea | Descripción | Habilidades requeridas |
|---|
| Implementar el código en la rama de su repositorio. | Clone su repositorio de Bitbucket ejecutando el siguiente comando: git clone https://bitbucket.org/<WORKSPACE_NAME>/<REPO_NAME> Consulte el nombre de la rama que se utilizó al ejecutar el CloudFormation script de AWS. Para crear y comprobar una nueva rama, ejecute el comando git checkout -b <BRANCH_NAME>. Para revisar una rama existente, ejecute el comando git checkout <BRANCH_NAME> Introduzca el código en la rama y envíelo a la rama remota ejecutando los comandos git commit y git push. Amplify luego crea e implementa la aplicación.
Para obtener más información sobre esto, consulte Comandos básicos de Git en la documentación de Bitbucket. | Desarrollador de aplicaciones |
Métodos de autenticación (documentación de Atlassian)
Archivos adjuntos
Para acceder al contenido adicional asociado a este documento, descargue y descomprima el siguiente archivo: attachment.zip