Configuration du AWS SAM CLI

L'un des avantages AWS SAM est qu'il optimise le temps du développeur en supprimant les tâches répétitives. AWS SAM CLI inclut un fichier de configuration nommé samconfig à cet effet. Par défaut, aucune configuration pour le AWS SAM CLI est nécessaire, mais vous pouvez mettre à jour votre fichier de configuration pour vous permettre d'exécuter des commandes avec moins de paramètres en AWS SAM permettant de référencer vos paramètres personnalisés dans votre fichier de configuration. Les exemples présentés dans le tableau suivant montrent comment optimiser vos commandes :

Original	Optimisé avec samconfig
sam build --cached --parallel --use-containers	sam build
sam local invoke --env-vars locals.json	sam local invoke
sam local start-api --env-vars locals.json --warm-containers EAGER	sam local start-api

Le AWS SAM CLI fournit un ensemble de commandes pour aider les développeurs à créer, développer et déployer des applications sans serveur. Chacune de ces commandes est configurable avec des indicateurs facultatifs en fonction des préférences de l'application et du développeur. Pour de plus amples informations, veuillez consulter le AWS SAM. CLI contenu dans GitHub

Les rubriques de cette section vous montrent comment créer AWS SAM CLI Fichier de configuration   et personnaliser ses paramètres par défaut afin d'optimiser le temps de développement de votre application sans serveur.

Comment créer votre fichier de configuration (le samconfig fichier)

Le AWS SAM CLI le fichier de configuration (nom de fichiersamconfig) est un fichier texte qui utilise généralement la structure TOML, mais qui peut également être au format YAML. Lorsque vous utilisez un modèle de démarrage AWS rapide, ce fichier est créé lorsque vous exécutez la sam init commande. Vous pouvez mettre à jour ce fichier lorsque vous déployez une application à l'aide de la sam deploy -\-guided commande.

Une fois le déploiement terminé, le samconfig fichier contient un profil nommé default si vous avez utilisé les valeurs par défaut. Lorsque vous réexécutez la deploy commande, AWS SAM applique les paramètres de configuration enregistrés à partir de ce profil.

L'avantage du samconfig fichier est qu'il AWS SAM stocke les paramètres de configuration pour toutes les autres commandes disponibles en plus de la commande de déploiement. Au-delà de ces valeurs créées lors d'un nouveau déploiement, vous pouvez définir un certain nombre d'attributs dans le samconfig fichier qui peuvent simplifier d'autres aspects du flux de travail des développeurs avec AWS SAM CLI.

Configuration des paramètres de projet

Vous pouvez définir des paramètres spécifiques au projet, tels que AWS SAM CLI valeurs des paramètres de commande, dans un fichier de configuration à utiliser avec le AWS SAM CLI. Pour plus d'informations sur ce fichier de configuration, consultezAWS SAM CLI Fichier de configuration  .

Utilisation des fichiers de configuration

Les fichiers de configuration sont structurés par environnement, commande et valeur de paramètre. Pour de plus amples informations, veuillez consulter Principes de base relatifs au fichier de configuration.

Pour configurer un nouvel environnement

1. Spécifiez votre nouvel environnement dans votre fichier de configuration.

   Voici un exemple de spécification d'un nouvel environnement prod :

   TOML

   [prod.global.parameters]

   YAML

   prod:
     global:
       parameters:

2. Spécifiez les valeurs des paramètres sous forme de paires clé-valeur dans la section des paramètres du fichier de configuration.

   Voici un exemple de spécification du nom de la pile de votre application pour l'environnement prod.

   TOML

   [prod.global.parameters]
   stack_name = "prod-app"

   YAML

   prod:
     global:
       parameters:
         stack_name: prod-app

3. Utilisez l'option --config-env pour spécifier l'environnement à utiliser.

   Voici un exemple :

   $ sam deploy --config-env "prod"

Pour configurer et utiliser des valeurs de paramètres

1. Spécifiez le AWS SAM CLI commande pour laquelle vous souhaitez configurer les valeurs des paramètres. Pour configurer les valeurs des paramètres pour tous AWS SAM CLI commandes, utilisez l'globalidentifiant.

   Voici un exemple de spécification des valeurs de paramètres pour la commande sam deploy de l'environnement default :

   TOML

   [default.deploy.parameters]
   confirm_changeset = true

   YAML

   default:
     deploy:
       parameters:
         confirm_changeset: true

   Voici un exemple de spécification de valeurs de paramètres pour tous AWS SAM CLI commandes dans l'defaultenvironnement :

   TOML

   [default.global.parameters]
   stack_name = "sam-app"

   YAML

   default:
     global:
       parameters:
         stack_name: sam-app

2. Vous pouvez également spécifier des valeurs de paramètres et modifier votre fichier de configuration via le AWS SAM CLI flux interactif.

   Vous trouverez ci-dessous un exemple du flux interactif sam deploy --guided :

   $ sam deploy --guided
   
   Configuring SAM deploy
   ======================
   
       Looking for config file [samconfig.toml] :  Found
       Reading default arguments  :  Success
   
       Setting default arguments for 'sam deploy'
       =========================================
       Stack Name [sam-app]: ENTER
       AWS Region [us-west-2]: ENTER
       #Shows you resources changes to be deployed and require a 'Y' to initiate deploy
       Confirm changes before deploy [Y/n]: n
       #SAM needs permission to be able to create roles to connect to the resources in your template
       Allow SAM CLI IAM role creation [Y/n]: ENTER
       #Preserves the state of previously provisioned resources when an operation fails
       Disable rollback [y/N]: ENTER
       HelloWorldFunction may not have authorization defined, Is this okay? [y/N]: y
       Save arguments to configuration file [Y/n]: ENTER
       SAM configuration file [samconfig.toml]: ENTER
       SAM configuration environment [default]: ENTER

Pour de plus amples informations, veuillez consulter Création et modification de fichiers de configuration.

Exemples

Base TOML exemple

Voici un exemple de fichier de configuration samconfig.toml :

...
version = 0.1

[default]
[default.global]
[default.global.parameters]
stack_name = "sam-app"

[default.build.parameters]
cached = true
parallel = true

[default.deploy.parameters]
capabilities = "CAPABILITY_IAM"
confirm_changeset = true
resolve_s3 = true

[default.sync.parameters]
watch = true

[default.local_start_api.parameters]
warm_containers = "EAGER"

[prod]
[prod.sync]
[prod.sync.parameters]
watch = false

Base YAML exemple

Voici un exemple de fichier de configuration samconfig.yaml :

version 0.1
default:
  global:
    parameters:
      stack_name: sam-app
  build:
    parameters:
      cached: true
      parallel: true
  deploy:
    parameters:
      capabilities: CAPABILITY_IAM
      confirm_changeset: true
      resolve_s3: true
  sync:
    parameters:
      watch: true
  local_start_api:
    parameters:
      warm_containers: EAGER
prod:
  sync:
    parameters:
      watch: false

Configuration des informations d'identification et des paramètres de base

Utilisez le AWS Command Line Interface (AWS CLI) pour configurer les paramètres de base tels que les AWS informations d'identification, le nom de région par défaut et le format de sortie par défaut. Une fois configurés, vous pouvez utiliser ces paramètres avec le AWS SAM CLI. Pour en savoir plus, consultez les informations suivantes du guide de AWS Command Line Interface l'utilisateur :

• Principes de base de la configuration

• Paramètres des fichiers de configuration et d'informations d'identification

• Profils nommés pour le AWS CLI

• Utilisation d'un profil nommé activé par IAM Identity Center

Pour des instructions de configuration rapides, consultez Étape 5 : utilisez le AWS CLI pour configurer les AWS informations d'identification.