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.
sam pipeline bootstrap
Esta página proporciona información de referencia para la interfaz de línea de AWS Serverless Application Model comandos (AWS SAM CLI) sam local pipeline bootstrap subcomando.
Para una introducción al AWS SAM CLI, consulte ¿Qué es la AWS SAM CLI?
El sam pipeline bootstrap subcomando genera los recursos de AWS infraestructura necesarios para conectarse a su sistema de CI/CD. Este paso debe ejecutarse en cada etapa de implementación de la canalización antes de ejecutar el comando sam pipeline init.
Este subcomando configura los siguientes recursos de infraestructura: AWS
-
Opción de configurar los permisos de canalización mediante:
-
Un IAM usuario de canalización con un identificador de clave de acceso y credenciales de acceso con clave secreta que se compartirán con el sistema CI/CD.
nota
Recomendamos rotar periódicamente las claves de acceso de forma regular. Para obtener más información, consulte Rotar las claves de acceso con regularidad para los casos de uso que requieran credenciales de larga duración en la Guía del IAMusuario.
-
Plataformas CI/CD compatibles hasta. OIDC Para obtener una introducción sobre el uso OIDC con AWS SAM Pipeline, vaya a. Cómo usar de la autenticación OIDC con canalización de AWS SAM
-
-
Una IAM función de AWS CloudFormation ejecución que asume AWS CloudFormation el despliegue de la AWS SAM aplicación.
-
Un depósito de Amazon S3 para guardar los AWS SAM artefactos.
-
Opcionalmente, un repositorio de ECR imágenes de Amazon para almacenar paquetes de despliegue de Lambda con imágenes de contenedor (si tiene un recurso del tipo
Imagepaquete).
Uso
$sam pipeline bootstrap<options>
Opciones
--bitbucket-repo-uuidTEXT-
El UUID del repositorio de Bitbucket. Esta opción es específica del uso de Bitbucket OIDC como permiso.
nota
Este valor se encuentra en https://bitbucket.org/
workspace/repository/admin/addon/admin/pipelines/openid-conectar --bucketTEXT-
El ARN del depósito de Amazon S3 que contiene los AWS SAM artefactos.
--cicd-providerTEXT-
La plataforma de CI/CD para la AWS SAM canalización.
--cloudformation-execution-roleTEXT-
La ARN IAM función que debe asumir AWS CloudFormation al implementar la pila de aplicaciones. índícalo solo si quiere utilizar su propio rol. De lo contrario, el comando creará un nuevo rol.
--config-envTEXT-
El nombre del entorno que especifica los valores de los parámetros predeterminados del archivo de configuración que se va a utilizar. El valor predeterminado es
default. Para obtener más información sobre los archivos de configuración, consulta AWS SAM CLI Archivo de configuración de la de . --config-filePATH-
La ruta y el nombre del archivo de configuración que contiene los valores de los parámetros predeterminados que se van a utilizar. El valor por defecto es
samconfig.tomlen la raíz del directorio del proyecto. Para obtener más información sobre los archivos de configuración, consulta AWS SAM CLI Archivo de configuración de la de . --confirm-changeset | --no-confirm-changeset-
Permite solicitar la confirmación de la implementación de los recursos.
--create-image-repository | --no-create-image-repository-
Especifique si desea crear un repositorio de ECR imágenes de Amazon si no se proporciona ninguno. El ECR repositorio de Amazon contiene las imágenes de contenedor de las funciones o capas de Lambda que tienen un tipo de paquete de.
ImageEl valor predeterminado es--no-create-image-repository. --debug-
Activa el registro de depuración e imprime los mensajes de depuración que AWS SAM CLI genera y muestra las marcas de tiempo.
--deployment-branchTEXT-
Nombre de la rama desde la que se realizarán las implementaciones. Esta opción es específica del uso de GitHub Acciones OIDC para los permisos.
--github-orgTEXT-
La GitHub organización a la que pertenece el repositorio. Si no existe ninguna organización, escriba el nombre de usuario del propietario del repositorio. Esta opción es específica del uso de GitHub Acciones OIDC para los permisos.
--github-repoTEXT-
Nombre del GitHub repositorio desde el que se realizarán las implementaciones. Esta opción es específica del uso de GitHub Acciones OIDC para los permisos.
--gitlab-groupTEXT-
El GitLab grupo al que pertenece el repositorio. Esta opción es específica para su uso con GitLab OIDC permisos.
--gitlab-projectTEXT-
El nombre GitLab del proyecto. Esta opción es específica para su uso con GitLab OIDC permisos.
--help, -h-
Muestra este mensaje y sale.
--image-repositoryTEXT-
El ARN de un repositorio de ECR imágenes de Amazon que contiene las imágenes del contenedor de las funciones de Lambda o capas que tienen un tipo de paquete de.
ImageSi se proporcionan, se ignora la opción--create-image-repository. Si no se proporciona y--create-image-repositoryse especifica, el comando crea una. --interactive | --no-interactive-
Se deshabilita la solicitud interactiva de los parámetros de arranque y devuelve un error si falta alguno de los parámetros necesarios. El valor predeterminado es
--interactive. Para este comando,--stagees el único parámetro requerido.nota
Si
--no-interactivese especifica junto con--use-oidc-provider, se deben incluir todos los parámetros necesarios para su OIDC proveedor. --oidc-client-idTEXT-
El ID de cliente configurado para usarlo con su OIDC proveedor.
--oidc-provider[github-actions | gitlab | bitbucket-pipelines]-
Nombre del proveedor de CI/CD que se utilizará para OIDC los permisos. GitLab GitHub, y Bitbucket son compatibles.
--oidc-provider-urlTEXT-
El URL para el OIDC proveedor. El valor debe empezar por
https://. --permissions-provider[oidc | iam]-
Elija un proveedor de permisos para que asuma la función de ejecución de la canalización. El valor predeterminado es
iam. --pipeline-execution-roleTEXT-
La ARN IAM función que debe asumir el usuario de la tubería para operar en esta etapa. índícalo solo si quiere utilizar su propio rol. Si no se proporciona, este comando creará un nuevo rol.
--pipeline-userTEXT-
El nombre del recurso de Amazon (ARN) del IAM usuario que comparte su ID de clave de acceso y su clave de acceso secreta con el sistema CI/CD. Se utiliza para conceder a este IAM usuario permiso para acceder a la cuenta correspondiente AWS . Si no se proporciona, el comando creará un IAM usuario junto con el ID de la clave de acceso y las credenciales de la clave de acceso secreta.
--profileTEXT-
El perfil específico del archivo de credenciales que recibe AWS las credenciales.
--regionTEXT-
La AWS región en la que se va a realizar el despliegue. Por ejemplo,
us-east-1. --save-params-
Guarde los parámetros que proporcione en la línea de comandos en el archivo AWS SAM de configuración.
--stageTEXT-
El nombre de la fase de implementación correspondiente. Se utiliza como sufijo para los recursos de AWS infraestructura creados.
Resolución de problemas
Error: falta el parámetro obligatorio
Si --no-interactive se especifica junto con --use-oidc-provider y ninguno de los parámetros requeridos se proporciona, se mostrará este mensaje de error junto con una descripción de los parámetros que faltan.
Ejemplo
En el ejemplo siguiente se crean los AWS recursos necesarios para crear el sistema de CI/CD, se activa el registro de depuración y se imprimen los mensajes de depuración generados por el AWS SAM CLI: usa un evento generado para pruebas locales mediante el uso de un s3.json evento para invocar una función Lambda localmente
$sam pipeline bootstrap --debug
