Ejemplo de Amazon Elastic File System para AWS CodeBuild - AWS CodeBuild
CodeBuild Utilízalo con Amazon EFS

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.

Ejemplo de Amazon Elastic File System para AWS CodeBuild

Es posible que desee crear sus AWS CodeBuild compilaciones en Amazon Elastic File System, un servicio de archivos compartidos y escalable para EC2 instancias de Amazon. La capacidad de almacenamiento de Amazon EFS es elástica, por lo que aumenta o se reduce a medida que se añaden y eliminan archivos. Tiene una interfaz de servicios web sencilla que puede utilizar para crear y configurar sistemas de archivos. También administra automáticamente toda la infraestructura de almacenamiento de archivos, por lo que no tiene que preocuparse por la implementación, aplicación de parches o el mantenimiento de configuraciones del sistema de archivos. Para obtener más información, consulte ¿Qué es Amazon Elastic File System? en la Guía del usuario de Amazon Elastic File System.

En este ejemplo se muestra cómo configurar un CodeBuild proyecto para que monte y, a continuación, cree una aplicación Java en un sistema de EFS archivos de Amazon. Antes de empezar, debe tener una aplicación Java lista para ser compilada y cargada en un depósito de entrada de S3 o en un AWS CodeCommit GitHub repositorio de GitHub Enterprise Server o Bitbucket.

Los datos en tránsito para su sistema de archivos están cifrados. Para cifrar los datos en tránsito con una imagen distinta, consulte Cifrado de datos en tránsito.

Temas

AWS CodeBuild Utilícelo con Amazon Elastic File System

En este ejemplo, se describen los cuatro pasos de alto nivel necesarios para utilizar Amazon EFS with AWS CodeBuild. Son los siguientes:

  1. Cree una nube privada virtual (VPC) en su AWS cuenta.

  2. Cree un sistema de archivos que lo utiliceVPC.

  3. Cree y cree un CodeBuild proyecto que utilice elVPC. El CodeBuild proyecto utiliza lo siguiente para identificar el sistema de archivos:

    • Un identificador único del sistema de archivos. El identificador se elige al especificar el sistema de archivos en el proyecto de compilación.

    • El ID del sistema de archivos. El ID se muestra cuando visualizas tu sistema de archivos en la EFS consola de Amazon.

    • Un punto de montaje. Se trata de un directorio en el contenedor Docker que monta el sistema de archivos.

    • Opciones de montaje. Incluyen detalles sobre cómo montar el sistema de archivos.

  4. Revise el proyecto de compilación para asegurarse de que se generaron los archivos y variables correctos.

nota

Un sistema de archivos creado en Amazon solo EFS es compatible con las plataformas Linux.

Paso 1: Crear un VPC uso AWS CloudFormation

Crea la tuya VPC con una AWS CloudFormation plantilla.

  1. Siga las instrucciones de uso Plantilla de VPC de AWS CloudFormation AWS CloudFormation para crear unVPC.

    nota

    La VPC creada por esta AWS CloudFormation plantilla tiene dos subredes privadas y dos subredes públicas. Solo debes usar subredes privadas cuando las utilices AWS CodeBuild para montar el sistema de archivos que has creado en AmazonEFS. Si utiliza alguna de las subredes públicas, la compilación genera un error.

  2. Inicia sesión en la VPC consola de Amazon AWS Management Console y ábrela en https://console.aws.amazon.com/vpc/.

  3. Elige la VPC que has creado con AWS CloudFormation.

  4. En la pestaña Descripción, anota tu nombre VPC y tu ID. Ambos serán necesarios cuando cree su proyecto de AWS CodeBuild más adelante en este ejemplo.

Paso 2: Cree un sistema de archivos Amazon Elastic File System con su VPC

Crea un sistema de EFS archivos de Amazon sencillo para este ejemplo con el VPC que creaste anteriormente.

  1. Inicia sesión en la EFS consola de Amazon AWS Management Console y ábrela en https://console.aws.amazon.com/efs/.

  2. Seleccione Crear sistema de archivos.

  3. Desde VPC, elige el VPC nombre que anotaste anteriormente en este ejemplo.

  4. Deje las zonas de disponibilidad asociadas a las subredes seleccionadas.

  5. Elija Paso siguiente.

  6. En Añadir etiquetas, para la clave de nombre predeterminada, en Value, introduce el nombre de tu sistema de EFS archivos de Amazon.

  7. Mantenga Transmisión por ráfagas y Uso general seleccionados como sus modos de desempeño y rendimiento predeterminados, y luego elija Paso siguiente.

  8. En Configurar acceso de cliente, seleccione Paso siguiente.

  9. Seleccione Crear sistema de archivos.

  10. (Opcional) Te recomendamos añadir una política a tu sistema de EFS archivos de Amazon que imponga el cifrado de los datos en tránsito. En la EFS consola de Amazon, selecciona Política del sistema de archivos, selecciona Editar, selecciona la casilla Exigir el cifrado en tránsito para todos los clientes y, a continuación, selecciona Guardar.

Paso 3: Crea un CodeBuild proyecto para usarlo con Amazon EFS

Crea un AWS CodeBuild proyecto que utilice lo que VPC creaste anteriormente en este ejemplo. Cuando se ejecuta la compilación, monta el sistema de EFS archivos de Amazon creado anteriormente. A continuación, se almacena el archivo .jar que la aplicación Java ha creado en el directorio de puntos de montaje del sistema de archivos.

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

  2. En el panel de navegación, elija Build projects (Proyectos de compilación) y después Create build project (Crear proyecto de compilación).

  3. En Nombre del proyecto, introduzca un nombre para el proyecto.

  4. En Source provider (Proveedor de código fuente), elija el repositorio que contiene la aplicación Java que desea compilar.

  5. Introduzca la información, como un repositorioURL, que se CodeBuild utiliza para localizar la aplicación. Las opciones son diferentes para cada proveedor de código fuente. Para obtener más información, consulte Choose source provider.

  6. En Imagen de entorno, elija Imagen administrada.

  7. En Sistema operativo, elija Amazon Linux 2.

  8. En Tiempo(s) de ejecución, elija Estándar.

  9. En Imagen, elija aws/codebuild/amazonlinux2-x86_64-standard:4.0.

  10. En Tipo de entorno, elija Linux.

  11. En Rol de servicio, elija Nuevo rol de servicio. En Nombre del rol, introduzca un nombre para el rol que CodeBuild cree para usted.

  12. Expanda Configuración adicional.

  13. Seleccione Enable this flag if you want to build Docker images or want your builds to get elevated privileges (Habilite este indicador si desea compilar imágenes de Docker o que sus compilaciones tengan privilegios elevados).

    nota

    De forma predeterminada, el daemon de Docker está habilitado para las versiones que no son compiladas. VPC Si quieres usar contenedores de Docker para VPC compilaciones, consulta Runtime Privilege y Linux Capabilities en el sitio web de Docker Docs y habilita el modo privilegiado. Además, Windows no admite el modo privilegiado.

  14. Desde VPC, elija el VPC ID.

  15. En Subredes, elija una o más de las subredes privadas asociadas a su. VPC Debe usar subredes privadas en una compilación que monte un sistema de EFS archivos de Amazon. Si utiliza una subred pública, la compilación genera un error.

  16. En Security groups (Grupos de seguridad), elija el grupo de seguridad predeterminado.

  17. En File systems (Sistemas de archivos), escriba la siguiente información:

    • En Identifier (Identificador), introduzca un identificador único del sistema de archivos. El identificador debe tener menos de 129 caracteres y solo debe contener caracteres alfanuméricos y guiones bajos. CodeBuild utiliza este identificador para crear una variable de entorno que identifique el sistema de archivos elástico. El formato de la variable de entorno es CODEBUILD_<file_system_identifier>, en mayúsculas. Por ejemplo, si introduce my_efs, la variable de entorno es CODEBUILD_MY_EFS.

    • En ID, elija el ID del sistema de archivos.

    • (Opcional) Introduzca un directorio en el sistema de archivos. CodeBuild monta este directorio. Si deja la ruta del directorio en blanco, CodeBuild monta todo el sistema de archivos. La ruta es relativa a la raíz del sistema de archivos.

    • En Punto de montaje, introduzca la ruta absoluta del directorio en el contenedor de compilación donde se monta el sistema de archivos. Si este directorio no existe, lo CodeBuild crea durante la compilación.

    • (Opcional) Introduzca las opciones de montaje. Si deja las opciones de montaje en blanco, CodeBuild utiliza sus opciones de montaje predeterminadas:

      nfsvers=4.1
rsize=1048576
wsize=1048576
hard
timeo=600
retrans=2

      Para obtener más información, consulte las opciones de NFS montaje recomendadas en la Guía del usuario de Amazon Elastic File System.

  18. En Build specification (Especificación de compilación), elija Insert build commands (Insertar comandos de compilación) y, a continuación, elija Switch to editor (Cambiar a editor).

  19. Introduzca los siguientes comandos de especificaciones de compilación en el editor. Reemplace <file_system_identifier> por el identificador que ha especificado en el paso 17. Use letras mayúsculas (por ejemplo, CODEBUILD_MY_EFS).

    version: 0.2
phases:
  install:
    runtime-versions:
      java: corretto11    
  build:
    commands:
      - mvn compile -Dgpg.skip=true -Dmaven.repo.local=$CODEBUILD_<file_system_identifier>

  20. Utilice los valores predeterminados para el resto de opciones y, a continuación, elija Create build project (Crear proyecto de compilación). Cuando la compilación se haya completado, se muestra la página de la consola para su proyecto.

  21. Seleccione Iniciar la compilación.

Paso 4: Revise el proyecto de compilación

Una vez creado el AWS CodeBuild proyecto:

  • Tienes un archivo.jar creado por tu aplicación Java que está integrado en tu sistema de EFS archivos de Amazon en tu directorio de puntos de montaje.

  • Se crea una variable de entorno que identifica el sistema de archivos con el identificador de sistema de archivos que especificó al crear el proyecto.

Para obtener más información, consulte Montaje de sistemas de archivos en la Guía del usuario de Amazon Elastic File System.