Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Cette page fournit des informations de référence pour la AWS Serverless Application Model `sam local pipeline bootstrap` sous-commande Command Line Interface (AWS SAMCLI).

Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)

La `sam pipeline bootstrap` sous-commande génère les ressources AWS d'infrastructure requises pour se connecter à votre système CI/CD. Cette étape doit être exécutée pour chaque étape de déploiement du pipeline, avant d'exécuter la commande **sam pipeline init**.

Cette sous-commande configure les ressources AWS d'infrastructure suivantes :
+ Option de configuration des autorisations du pipeline via :
  + Un utilisateur IAM du pipeline avec un identifiant de clé d'accès et des informations d'identification d'accès par clé secrète à partager avec le CI/CD système.
**Note**  
Nous vous recommandons d'effectuer une rotation régulière des clés d'accès. Pour plus d'informations, consultez [Rotation régulière des clés d'accès pour les cas d'utilisation nécessitant des informations d'identification](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#rotate-credentials) dans le *Guide de l'utilisateur IAM*.
  +  CI/CD Plateformes prises en charge via OIDC. Pour obtenir une présentation de l'utilisation d'OIDC avec un pipeline AWS SAM , consultez [Comment utiliser l'authentification OIDC avec les pipelines AWS SAM](deploying-with-oidc.md).
+ Rôle IAM d' CloudFormation exécution assumé par CloudFormation pour déployer l' AWS SAM application.
+ Un compartiment Amazon S3 pour contenir les AWS SAM artefacts.
+ Le cas échéant, un référentiel d’images Amazon ECR pour contenir des packages de déploiement Lambda de conteneur d’images (si vous disposez d’une ressource avec le type de package `Image`).

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

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

## Options
<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>
 L'UUID du référentiel Bitbucket. Cette option est spécifique à l'utilisation d'OIDC avec Bitbucket pour les autorisations.  
Cette valeur se trouve à l'adresse 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>
L'ARN du compartiment Amazon S3 qui contient les AWS SAM artefacts.

`--cicd-provider TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-cicd-provider"></a>
La CI/CD plate-forme pour le AWS SAM pipeline.

`--cloudformation-execution-role TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-cloudformation-execution-role"></a>
L'ARN du rôle IAM à assumer CloudFormation lors du déploiement de la pile de l'application. Fournissez-le uniquement si vous voulez utiliser votre propre rôle. Sinon, la commande crée un nouveau rôle.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-config-env"></a>
Le nom d'environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est **default**. Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-config-file"></a>
Le chemin d'accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est `samconfig.toml` à la racine du répertoire du projet. Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI 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>
Invitation à confirmer le déploiement de vos ressources.

`--create-image-repository | --no-create-image-repository`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-create-image-repository"></a>
Indiquez si vous souhaitez créer un référentiel d’images Amazon ECR si aucun n’est fourni. Le référentiel Amazon ECR contient les images de conteneur des fonctions Lambda ou des couches présentant un type de package `Image`. La valeur par défaut est `--no-create-image-repository`.

`--debug`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-debug"></a>
Active la journalisation de débogage, imprime les messages de débogage générés par la CLI  AWS SAM et affiche les horodatages.

`--deployment-branch TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-deployment-branch"></a>
Nom de la branche à partir de laquelle les déploiements seront effectués. Cette option est spécifique à l'utilisation d' GitHub Actions OIDC pour les autorisations.

`--github-org TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-github-org"></a>
L' GitHub organisation à laquelle appartient le référentiel. Si aucune organisation n'existe, saisissez le nom d'utilisateur du propriétaire du référentiel. Cette option est spécifique à l'utilisation d' GitHubActions OIDC pour les autorisations.

`--github-repo TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-github-repo"></a>
Nom du GitHub référentiel à partir duquel les déploiements seront effectués. Cette option est spécifique à l'utilisation d' GitHub Actions OIDC pour les autorisations.

`--gitlab-group TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-gitlab-group"></a>
Le GitLab groupe auquel appartient le référentiel. Cette option est spécifique à l'utilisation de l' GitLab OIDC pour les autorisations.

`--gitlab-project TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-gitlab-project"></a>
Le nom GitLab du projet. Cette option est spécifique à l'utilisation de l' GitLab OIDC pour les autorisations.

`--help, -h`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-help"></a>
Affiche ce message, puis se ferme.

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-image-repository"></a>
L'ARN d'un référentiel d'images Amazon ECR contenant les images de conteneur des fonctions Lambda ou des couches avec un type de package `Image`. S’il est fourni, l’option `--create-image-repository` est ignorée. S'il n'est pas fourni et que `--create-image-repository` est spécifié, la commande en crée un.

`--interactive | --no-interactive`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-interactive"></a>
Désactivez l'invite interactive pour les paramètres d'amorçage et attendez si des paramètres requis sont manquants. La valeur par défaut est `--interactive`. Avec cette commande, `--stage` est le seul paramètre obligatoire.  
S'il `--no-interactive` est spécifié en même temps que`--use-oidc-provider`, tous les paramètres requis pour votre fournisseur OIDC doivent être inclus.

`--oidc-client-id TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-client-id"></a>
L'ID client configuré pour être utilisé avec votre fournisseur OIDC.

`--oidc-provider [github-actions | gitlab | bitbucket-pipelines]`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-provider"></a>
Nom du CI/CD fournisseur qui sera utilisé pour les autorisations OIDC. GitLab, GitHub, et Bitbucket sont pris en charge.

`--oidc-provider-url TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-provider-url"></a>
URL du fournisseur OIDC. La valeur doit commencer par **https://**.

`--permissions-provider [oidc | iam]`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-permissions-provider"></a>
Choisissez un fournisseur d'autorisations pour assumer le rôle d'exécution du pipeline. La valeur par défaut est **iam**.

`--pipeline-execution-role TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-pipeline-execution-role"></a>
L’ARN du rôle IAM devant être assumé par l’utilisateur de pipeline pour fonctionner sur cette étape. Fournissez-le uniquement si vous voulez utiliser votre propre rôle. S'il n'est pas fourni, cette commande crée un nouveau rôle.

`--pipeline-user TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-pipeline-user"></a>
Nom de ressource Amazon (ARN) de l'utilisateur IAM dont l'ID de clé d'accès et la clé d'accès secrète sont partagés avec le CI/CD système. Il est utilisé pour accorder à cet utilisateur IAM l'autorisation d'accéder au AWS compte correspondant. S'il n'est pas fourni, la commande crée un utilisateur IAM avec l'identifiant de la clé d'accès et les informations d'identification de clé d'accès secrète.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-profile"></a>
Le profil spécifique de votre fichier d'informations d'identification qui obtient les AWS informations d'identification.

`--region TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-region"></a>
La AWS région dans laquelle le déploiement doit être effectué. Par exemple, `us-east-1`.

`--save-params`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-save-params"></a>
Enregistrez les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

`--stage TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-stage"></a>
Le nom de l’étape de déploiement correspondante. Il est utilisé comme suffixe pour les ressources AWS d'infrastructure créées.

## Résolution des problèmes
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-troubleshooting"></a>

### Error: Missing required parameter (Erreur : paramètre requis manquant)
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-troubleshooting-example1"></a>

Quand `--no-interactive` est spécifié avec `--use-oidc-provider` et qu'aucun des paramètres requis n'est fourni, ce message d'erreur s'affiche avec une description des paramètres manquants.

## Exemple
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-examples"></a>

L'exemple suivant crée les AWS ressources nécessaires à la création de votre CI/CD système, active la journalisation du débogage et imprime les messages de débogage générés par AWS SAMCLI : utilise un événement généré pour les tests locaux en utilisant un `s3.json` événement pour appeler une fonction Lambda localement

```
$ sam pipeline bootstrap --debug
```