Installation du kitAWS SAMCLI sous Linux - AWS Serverless Application Model

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.

Installation du kitAWS SAMCLI sous Linux

La .AWS SAMInterface de ligne de commande (CLI) est prise en charge sur les versions 64 bits des distributions récentes de CentOS, Fedora, Ubuntu et Amazon Linux 2. Pour installerAWS SAMCLI, vous devez extraire ou « décompresser » le package téléchargé. Si votre système d'exploitation ne dispose pas de la commande unzip intégrée, utilisez un équivalent.

Pour installer et configurer les conditions préalables à l'utilisation deAWS SAMCLI sur votre hôte Linux, procédez comme suit :

  1. Créez un compte AWS.

  2. ConfigurationAWS Identity and Access Management(IAM) etAWSInformations d'identification .

  3. Installez Docker. Remarque : Docker est une condition préalable uniquement pour tester votre application localement ou utiliser l'outil--use-container.

  4. Installez l'interface de ligne de commande AWS SAM.

Étape 1 : Création d'un compte AWS

Si vous ne disposez pas déjà d'unAWS, voiraws.amazon.comet choisissezCréation d'unAWSCompte. Pour obtenir les instructions complètes, consultez .Quelle est la marche à suivre pour créer et activer un nouveauAWSUn compte ?

Étape 2 : Configuration des autorisations IAM etAWScredentials

L'utilisateur IAM que vous utilisez avecAWS SAMdoit avoir des autorisations suffisantes pour rendre nécessaireAWSappels de service et gestionAWSAWS. Le moyen le plus simple de s'assurer qu'un utilisateur dispose d'autorisations suffisantes consiste à lui accorder des privilèges d'administrateur. Pour de plus amples informations, veuillez consulterCréation de votre premier groupe et utilisateur administrateur IAMdans leGuide de l'utilisateur IAM.

Note

Si vous ne souhaitez pas accorder de privilèges d'administrateur aux utilisateurs qui utilisent leAWS Command Line Interface(AWS CLI), vous pouvez leur accorder des ensembles d'autorisations restreints. Pour plus d'informations, consultez Permissions.

En outre, pour activer leAWS SAMCLI à faireAWSAppels de service, vous devez configurerAWSInformations d'identification . Pour plus d'informations, consultez Configuration d'AWScredentials.

Étape 3 : Installez Docker (facultatif)

Note

Docker est une condition préalable uniquement pour tester votre application localement et pour créer des packages de déploiement à l'aide de l'outil--use-container. Si vous ne prévoyez pas d'utiliser ces fonctionnalités au départ, vous pouvez ignorer cette section ou installer Docker ultérieurement.

Docker est une application qui exécute des conteneurs sur vos machines Linux.AWS SAMfournit un environnement local similaire àAWS LambdaÀ utiliser comme conteneur Docker. Vous pouvez utiliser ce conteneur pour construire, tester et déboguer vos applications sans serveur.

Pour exécuter des projets et des fonctions sans serveur localement avec l'outilAWS SAMCLI, Docker doit être installé et fonctionnel. La .AWS SAML'interface de ligne de commandeDOCKER_HOSTPour contacter le démon Docker. Les étapes suivantes décrivent l'installation, la configuration et la vérification d'une installation Docker pour qu'elle fonctionne avec le kitAWS SAMINTERFACE DE LIGNE DE COMMANDE.

Docker est disponible sur plusieurs systèmes d'exploitation, y compris les distributions Linux les plus modernes, comme CentOS, Debian et Ubuntu. Pour de plus amples informations sur l'installation de Docker sur votre système d'exploitation particulier, veuillez consulterObtenir DockerSur le site web Docker Docker Docker Docker Docker

Si vous utilisez Amazon Linux 2, procédez comme suit pour installer Docker :

  1. Mettez à jour les packages installés et le cache du package sur votre instance.

    sudo yum update -y
  2. Installez le package de Docker Community Edition le plus récent.

    sudo amazon-linux-extras install docker
  3. Lancez le service Docker.

    sudo service docker start
  4. Ajout de l'ec2-userà ladockerafin que vous puissiez exécuter des commandes Docker sans utilisersudo.

    sudo usermod -a -G docker ec2-user
  5. Prenez le nouveaudockeren vous déconnectant et en vous reconnectant. Pour ce faire, fermez votre fenêtre de terminal SSH actuelle et reconnectez-vous à votre instance dans une nouvelle fenêtre. Votre nouvelle session SSH doit disposer desdockerAutorisations de groupe.

  6. Vérifiez que le kitec2-userpeut exécuter des commandes Docker sans utilisersudo.

    docker ps

    La sortie suivante doit s'afficher. Elle confirme que Docker est installé et en cours d'exécution :

     CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES

Si vous rencontrez des problèmes lors de l'installation de Docker, consultez leTroubleshootingPlus loin dans ce guide. Ou, voir leDépannageSection de l'Étapes de post-installation pour LinuxSur le site web Docker Docker Docker Docker Docker

Étape 4 : Installer leAWS SAMCLI

Pour installerAWS SAMCLI, procédez comme suit :

  1. Télécharger leAWS SAMFichier ZIPDans le répertoire de votre choix.

  2. Vérifiez l'intégrité et l'authenticité des fichiers d'installation téléchargés en générant une valeur de hachage à l'aide de la commande suivante :

    sha256sum aws-sam-cli-linux-x86_64.zip

    Le résultat doit ressembler à l'exemple suivant :

     <64-character SHA256 hash value> aws-sam-cli-linux-x86_64.zip

    Comparez la valeur de hachage SHA256 64 caractères avec celle de votre choixAWS SAMCLI dans l'interface de ligne de commandeAWS SAMNotes de mise à jour CLIsur GitHub.

  3. Décompressez les fichiers d'installation danssam-installation/sous-répertoire.

    unzip aws-sam-cli-linux-x86_64.zip -d sam-installation
  4. Installez l'interface de ligne de commande AWS SAM.

    sudo ./sam-installation/install
  5. Vérifiez l'installation.

    sam --version

    En cas d'installation réussie, vous devez voir une sortie semblable à la suivante :

     SAM CLI, version 1.18.0

Vous êtes maintenant prêt à démarrer le développement.

Upgrading

Pour mettre à jourAWS SAMCLI, exécutez les mêmes étapes que celles décrites dansInstaller leAWS SAMCLIplus tôt dans cette rubrique, mais ajoutez la--updateà la commande install, comme suit :

sudo ./sam-installation/install --update

Uninstalling

Pour désinstaller leAWS SAMCLI, vous devez supprimer le lien symbolique et le répertoire d'installation en exécutant les commandes suivantes :

  1. Localisez le lien symbolique et les chemins d'installation.

    • Recherchez le lien symbolique à l'aide de l'outilwhichCommande de l' :

      which sam

      Le résultat affiche le chemin d'accès oùAWS SAMsont situés, par exemple :

       /usr/local/bin/sam
    • Localisez le répertoire vers lequel pointe le lien symbolique à l'aide de l'lsCommande de l' :

      ls -l /usr/local/bin/sam

      Dans l'exemple suivant, le répertoire d'installation est/usr/local/aws-sam-cli.

       lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/sam -> /usr/local/aws-sam-cli/current/bin/sam
  2. Supprimez le lien symbolique.

    sudo rm /usr/local/bin/sam
  3. Supprimez le répertoire d'installation.

    sudo rm -rf /usr/local/aws-sam-cli

Construction de nuit

Une construction nocturne duAWS SAML'interface de ligne de commande est disponible pour vous permettre d'installer. Une fois installé, vous pouvez utiliser la construction nocturne à l'aide de l'sam-nightlyCommande de l' Vous pouvez installer et utiliser à la fois les versions de production et de construction nocturne duAWS SAMCLI à la fois.

La version nocturne contient une version pré-sortie deAWS SAMCode CLI qui peut être moins stable que la version de production. Notez que la construction nocturne ne contient pas de version pré-version de l'image de construction, donc la construction d'une application sans serveur avec le--use-containerutilise la dernière version de production de l'image de construction.

La construction nocturne est disponible avec ce lien de téléchargement :AWS SAM CLI construction nocturne. Pour installer la version de construction nocturne duAWS SAMCLI, exécutez les mêmes étapes que celles décrites dansÉtape 4 : Installer leAWS SAMCLIplus tôt dans cette rubrique, mais utilisez plutôt le lien de téléchargement de construction nocturne. Vous pouvez trouver les valeurs de hachage pour les fichiers du programme d'installation de construction nocturne dans leAWS SAMNotes de mise à jour de CLI pour les versions nocturnessur GitHub.

Pour vérifier que vous avez installé la version de construction nocturne, exécutez la commandesam-nightly --versionCommande de l' Le résultat de cette commande est sous la forme1.X.Y.dev<YYYYMMDDHHmm>, par exemple :

SAM CLI, version 1.20.0.dev202103151200

Troubleshooting

Erreur Docker : « Impossible de se connecter au démon Docker. Le démon docker fonctionne-t-il sur cet hôte ? »

Dans certains cas, pour fournir des autorisations pour leec2-userpour accéder au démon Docker, vous devrez peut-être redémarrer votre instance. Si vous recevez cette erreur, essayez de redémarrer votre instance.

Erreur de shell : « commande introuvable »

Si vous recevez cette erreur, votre shell ne peut pas localiser leAWS SAMCLI exécutable dans le chemin d'accès. Vérifiez l'emplacement du répertoire dans lequel vous avez installé l'kitAWS SAMCLI, puis vérifiez que le répertoire se trouve sur votre chemin.

AWS SAMErreur CLI : « /lib64/libc.so.6 : version `GLIBC_2.14' introuvable (requise par /usr/local/aws-sam-cli/dist/libz.so.1) »

Si vous recevez cette erreur, vous utilisez une version non prise en charge de Linux et la version glibc intégrée est obsolète. Essayez l'une des actions suivantes :

Étapes suivantes

Vous êtes maintenant prêt à créer vos propres applications sans serveur à l'aide deAWS SAM. Pour commencer avec un exemple d'application sans serveur, choisissez l'un des liens suivants :