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
<a name="sam-cli-command-reference-sam-pipeline-bootstrap"></a>

Esta página proporciona información de referencia para el AWS Serverless Application Model `sam local pipeline bootstrap` subcomando de la Interfaz de línea de comandos (AWS SAMCLI).

Para obtener una introducción al AWS SAMCLI, consulte [¿Qué es el? AWS SAMCLI](what-is-sam-overview.md#what-is-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 usuario de Pipeline IAM con un identificador de clave de acceso y unas credenciales de acceso con clave secreta que se compartirán con el CI/CD sistema.
**nota**  
Recomendamos rotar periódicamente las claves de acceso de forma regular. Para obtener más información, consulta [ Rotar las claves de acceso periódicamente para casos de uso que requieran credenciales de larga duración ](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#rotate-credentials) en la *Guía del usuario de IAM*.
  +  CI/CD Plataformas compatibles a través del OIDC. Para obtener una introducción sobre el uso de OIDC con la canalización AWS SAM , vaya a [Cómo utilizar la autenticación OIDC con canalizaciones AWS SAM](deploying-with-oidc.md).
+ Función de IAM de CloudFormation ejecución que asume el despliegue de CloudFormation la aplicación. AWS SAM 
+ Un depósito de Amazon S3 para guardar los AWS SAM artefactos.
+ Opcionalmente, un repositorio de imágenes de Amazon ECR para almacenar paquetes de implementación de Lambda con imágenes de contenedor (si tiene un recurso del tipo de paquete `Image`).

## De uso
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-usage"></a>

```
$ sam pipeline bootstrap <options>
```

## Opciones
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-options"></a>

`--bitbucket-repo-uuid TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-bitbucket-repo-uuid"></a>
 El UUID del repositorio de Bitbucket. Esta opción es específica del uso de Bitbucket OIDC para permisos.  
Este valor se encuentra en https://bitbucket.org/*workspace*/*repository*/admin/addon/admin/pipelines/openid-connect 

`--bucket TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-bucket"></a>
El ARN del depósito de Amazon S3 que contiene los AWS SAM artefactos.

`--cicd-provider TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-cicd-provider"></a>
La CI/CD plataforma para la AWS SAM canalización.

`--cloudformation-execution-role TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-cloudformation-execution-role"></a>
El ARN de la función de IAM que debe asumir 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-env TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-config-env"></a>
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 [Archivo de configuración de la CLI de AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-config-file"></a>
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.toml` en la raíz del directorio del proyecto. Para obtener más información sobre los archivos de configuración, consulta [Archivo de configuración de la CLI de AWS SAM](serverless-sam-cli-config.md).

`--confirm-changeset | --no-confirm-changeset`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-confirm-changeset"></a>
Permite solicitar la confirmación de la implementación de los recursos.

`--create-image-repository | --no-create-image-repository`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-create-image-repository"></a>
Especifica si quiere crear un repositorio de imágenes de Amazon ECR si no se proporciona ninguno. En el repositorio de Amazon ECR se encuentran las imágenes de contenedor de las funciones o capas de Lambda que tienen un tipo de paquete de `Image`. El valor predeterminado es `--no-create-image-repository`.

`--debug`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-debug"></a>
Activa el registro de depuración e imprime los mensajes de depuración que genera la CLI de AWS SAM, además de mostrar las marcas de tiempo.

`--deployment-branch TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-deployment-branch"></a>
Nombre de la rama desde la que se realizarán las implementaciones. Esta opción es específica del uso de GitHub Actions OIDC para los permisos.

`--github-org TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-github-org"></a>
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 Actions OIDC para los permisos.

`--github-repo TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-github-repo"></a>
Nombre del GitHub repositorio desde el que se realizarán las implementaciones. Esta opción es específica del uso de GitHub Actions OIDC para los permisos.

`--gitlab-group TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-gitlab-group"></a>
El GitLab grupo al que pertenece el repositorio. Esta opción es específica del uso de GitLab OIDC para los permisos.

`--gitlab-project TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-gitlab-project"></a>
El nombre del GitLab proyecto. Esta opción es específica del uso de GitLab OIDC para los permisos.

`--help, -h`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-help"></a>
Muestra este mensaje y sale.

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-image-repository"></a>
El ARN de un repositorio de imágenes de Amazon ECR en el que se encuentran las imágenes de contenedor de las funciones de Lambda o las capas que tienen un tipo de paquete de `Image`. Si se proporcionan, se ignora la opción `--create-image-repository`. Si no se proporciona y `--create-image-repository` se especifica, el comando crea una.

`--interactive | --no-interactive`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-interactive"></a>
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, `--stage` es el único parámetro requerido.  
Si `--no-interactive` se especifica junto con `--use-oidc-provider`, se deben incluir todos los parámetros necesarios de su proveedor de OIDC.

`--oidc-client-id TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-client-id"></a>
El ID de cliente configurado para su uso con su proveedor de OIDC.

`--oidc-provider [github-actions | gitlab | bitbucket-pipelines]`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-provider"></a>
Nombre del CI/CD proveedor que se utilizará para los permisos de OIDC. GitLab GitHub, y Bitbucket son compatibles.

`--oidc-provider-url TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-provider-url"></a>
La dirección URL del emisor del proveedor OIDC. El valor debe empezar por **https://**.

`--permissions-provider [oidc | iam]`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-permissions-provider"></a>
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-role TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-pipeline-execution-role"></a>
El ARN del rol de IAM que asumirá el usuario de la canalización y que usará en esta etapa. índícalo solo si quiere utilizar su propio rol. Si no se proporciona, este comando creará un nuevo rol.

`--pipeline-user TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-pipeline-user"></a>
El nombre de recurso de Amazon (ARN) del usuario de IAM que comparte con el sistema su ID de clave de acceso y su clave de acceso secreta. CI/CD Se utiliza para conceder permiso a este usuario de IAM para acceder a la cuenta correspondiente. AWS Si no se proporciona, el comando creará un usuario de IAM junto con el ID de clave de acceso y las credenciales de clave de acceso secreta.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-profile"></a>
El perfil específico del archivo de credenciales que recibe AWS las credenciales.

`--region TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-region"></a>
La AWS región en la que se va a realizar el despliegue. Por ejemplo, `us-east-1`.

`--save-params`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-save-params"></a>
Guarde los parámetros que proporcione en la línea de comandos en el archivo AWS SAM de configuración.

`--stage TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-stage"></a>
El nombre de la fase de implementación correspondiente. Se utiliza como sufijo para los recursos de AWS infraestructura creados.

## Resolución de problemas
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-troubleshooting"></a>

### Error: falta el parámetro obligatorio
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-troubleshooting-example1"></a>

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
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-examples"></a>

El siguiente ejemplo crea los AWS recursos necesarios para crear el CI/CD sistema, activa el registro de depuración e imprime los mensajes de depuración generados por AWS SAMCLI: 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
```