Prérequis Table des matières Étape 1 : Connectez-vous à AWS Management Console Étape 2 : Sélectionnez une région AWS CloudShell, lancez et choisissez un shell Étape 3 : Téléchargez un fichier depuis AWS CloudShell Étape 4 : Chargez un fichier sur AWS CloudShell Étape 5 : Supprimer un fichier de AWS CloudShell Étape 6 : Création d'une sauvegarde du répertoire de base Étape 7 : Redémarrer une session shell Étape 8 : Supprimer le répertoire d'accueil d'une session shell Étape 9 : Modifiez le code de votre fichier et exécutez-le à l'aide de la ligne de commande Étape 10 : AWS CLI à utiliser pour ajouter le fichier en tant qu'objet dans un compartiment Amazon S3 Rubriques en relation

Commencer avec AWS CloudShell

Ce didacticiel d'introduction explique comment lancer AWS CloudShell et exécuter des tâches clés à l'aide de l'interface de ligne de commande shell.

Tout d'abord, vous vous connectez au AWS Management Console et sélectionnez un Région AWS. Vous lancez CloudShell ensuite une nouvelle fenêtre de navigateur et un type de shell avec lequel vous pouvez travailler.

Ensuite, vous créez un nouveau dossier dans votre répertoire personnel et vous y chargez un fichier depuis votre ordinateur local. Vous travaillez sur ce fichier à l'aide d'un éditeur préinstallé avant de l'exécuter en tant que programme depuis la ligne de commande. Enfin, vous appelez des AWS CLI commandes pour créer un compartiment Amazon S3 et y ajouter votre fichier en tant qu'objet.

Prérequis

Autorisations IAM

Vous pouvez obtenir des autorisations pour AWS CloudShell en associant la politique AWS gérée suivante à votre identité IAM (comme un utilisateur, un rôle ou un groupe) :

AWSCloudShellFullAccess: fournit aux utilisateurs un accès complet AWS CloudShell à ses fonctionnalités.

Pour ce didacticiel, vous interagissez également avec Services AWS. Plus précisément, vous interagissez avec Amazon S3 en créant un compartiment S3 et en y ajoutant un objet. Votre identité IAM nécessite une politique qui accorde, au minimum, les s3:PutObject autorisations s3:CreateBucket et.

Pour plus d'informations, consultez Amazon S3 Actions dans le guide de l'utilisateur d'Amazon Simple Storage Service.

Fichier d'exercices

Cet exercice implique également le téléchargement et la modification d'un fichier qui est ensuite exécuté en tant que programme à partir de l'interface de ligne de commande. Ouvrez un éditeur de texte sur votre ordinateur local et ajoutez l'extrait de code suivant.


import sys
x=int(sys.argv[1])
y=int(sys.argv[2])
sum=x+y
print("The sum is",sum)

Enregistrez le fichier sous le nom add_prog.py.

Table des matières

Étape 1 : Connectez-vous à AWS Management Console
Étape 2 : Sélectionnez une région AWS CloudShell, lancez et choisissez un shell
Étape 3 : Téléchargez un fichier depuis AWS CloudShell
Étape 4 : Chargez un fichier sur AWS CloudShell
Étape 5 : Supprimer un fichier de AWS CloudShell
Étape 6 : Création d'une sauvegarde du répertoire de base
Étape 7 : Redémarrer une session shell
Étape 8 : Supprimer le répertoire d'accueil d'une session shell
Étape 9 : Modifiez le code de votre fichier et exécutez-le depuis la ligne de commande
Étape 10 : AWS CLI à utiliser pour ajouter le fichier en tant qu'objet dans un compartiment Amazon S3

Étape 1 : Connectez-vous à AWS Management Console

Cette étape implique la saisie de vos informations d'utilisateur IAM pour accéder au AWS Management Console. Si vous êtes déjà dans la console, passez à l'étape 2.

Vous pouvez y accéder AWS Management Console en utilisant l'URL de connexion d'un utilisateur IAM ou en accédant à la page de connexion principale.
IAM user sign-in URL
Ouvrez un navigateur et entrez l'URL de connexion suivante. account_alias_or_idRemplacez-le par l'alias de compte ou l'identifiant de compte fourni par votre administrateur.

https://account_alias_or_id.signin.aws.amazon.com/console/

Entrez vos informations de connexion IAM et choisissez Se connecter.
Main sign-in page
Ouvrez https://aws.amazon.com/console/.

Si vous ne vous êtes pas connecté auparavant à l'aide de ce navigateur, la page de connexion principale apparaît. Choisissez un utilisateur IAM, entrez l'alias ou l'ID du compte, puis choisissez Next.

Si vous vous êtes déjà connecté en tant qu'utilisateur IAM auparavant. Votre navigateur se souvient peut-être de l'alias du compte ou de l'identifiant de compte du Compte AWS. Dans ce cas, entrez vos informations de connexion IAM et choisissez Se connecter.
Note
Vous pouvez également vous connecter en tant qu'utilisateur root. Cette identité donne un accès complet à toutes Services AWS les ressources du compte. Nous vous recommandons vivement de ne pas utiliser l'utilisateur root pour les tâches quotidiennes, même administratives. Respectez plutôt la bonne pratique qui consiste à avoir recours à l'utilisateur racine uniquement pour créer le premier utilisateur IAM.

Étape 2 : Sélectionnez une région AWS CloudShell, lancez et choisissez un shell

Au cours de cette étape, vous lancez AWS CloudShell depuis l'interface de la console Région AWS, choisissez un shell disponible et passez à votre shell préféréBash, tel que PowerShell, ouZ shell.

Pour choisir une Région AWS région dans laquelle travailler, allez dans le menu Sélectionnez une région et sélectionnez une AWS région prise en charge dans laquelle travailler. (Les régions disponibles sont surlignées.)

Important
Si vous changez de région, l'interface est actualisée et le nom de la région sélectionnée Région AWS s'affiche au-dessus du texte de la ligne de commande. Tous les fichiers que vous ajoutez au stockage persistant ne sont disponibles que dans celui-ci Région AWS. Si vous changez de région, différents types de stockage et de fichiers sont accessibles.

Important
Si elle CloudShell n'est pas disponible dans la région sélectionnée lorsque vous lancez CloudShell leConsole Toolbar, en bas à gauche de la console, la région par défaut est définie sur la région la plus proche de la région sélectionnée. Vous pouvez exécuter la commande qui fournit des autorisations pour gérer les ressources dans une région différente de la région par défaut. Pour plus d'informations, consultez la section Travailler dans Régions AWS.
Exemple
Si vous choisissez Europe (Espagne) eu-south-2 mais que cette option CloudShell n'est pas disponible en Europe (Espagne)eu-south-2, la région par défaut est définie sur Europe (Irlande)eu-west-1, la plus proche de l'Europe (Espagne)eu-south-2.
Vous utiliserez les quotas de service pour la région par défaut, Europe (Irlande), eu-west-1 et la même CloudShell session sera rétablie dans toutes les régions. La région par défaut peut être modifiée et vous en serez informé dans la fenêtre du CloudShell navigateur.
À partir de AWS Management Console, vous pouvez lancer le CloudShell jeu en choisissant l'une des options suivantes :
1. Dans la barre de navigation, choisissez l'CloudShellicône.
2. Dans la zone de recherche, tapez « CloudShell », puis choisissez CloudShell.
3. Dans le widget Visites récentes, sélectionnez CloudShell.
4. Choisissez CloudShellsur leConsole Toolbar, en bas à gauche de la console.
  - Pour régler la hauteur de votre CloudShell session, faites glisser le pointeur=.
  - Pour passer en CloudShell mode plein écran, cliquez sur l'icône Ouvrir dans un nouvel onglet du navigateur.
Lorsque l'invite de commandes s'affiche, le shell est prêt pour l'interaction.

Note
Si vous rencontrez des problèmes qui vous empêchent de lancer ou d'interagir avec succès AWS CloudShell, consultez les informations permettant d'identifier et de résoudre ces problèmes dansRésolution des problèmes AWS CloudShell.
Pour choisir un shell préinstallé avec lequel travailler, entrez le nom du programme à l'invite de la ligne de commande.

Bash

bash

Si vous passez àBash. Le symbole affiché à l'invite de commande devient$.

Note
Bashest le shell par défaut qui s'exécute lors du lancement AWS CloudShell.

PowerShell

pwsh

Si vous passez à PowerShell. Le symbole affiché à l'invite de commande devientPS>.

Z shell

zsh

Si vous passez àZ shell. Le symbole affiché à l'invite de commande devient%.

Pour plus d'informations sur les versions préinstallées dans votre environnement shell, consultez le tableau des shells dans la section relative à l'environnement de CloudShell calcul AWS.

Étape 3 : Téléchargez un fichier depuis AWS CloudShell

Note

Cette option n'est pas disponible pour les environnements VPC.

Cette étape explique le processus de téléchargement d'un fichier.

Pour télécharger un fichier, allez dans Actions et choisissez Télécharger le fichier dans le menu.

La boîte de dialogue Télécharger le fichier s'affiche.
Dans la boîte de dialogue Télécharger le fichier, entrez le chemin du fichier à télécharger.
Note
Vous pouvez utiliser des chemins absolus ou relatifs lorsque vous spécifiez un fichier à télécharger. Avec des chemins relatifs, /home/cloudshell-user/ il est ajouté automatiquement au début par défaut. Ainsi, pour télécharger un fichier appelémydownload-file, les deux chemins suivants sont valides :
- Trajectoire absolue : /home/cloudshell-user/subfolder/mydownloadfile.txt
- Chemin relatif : subfolder/mydownloadfile.txt
Choisissez Téléchargement.

Si le chemin du fichier est correct, une boîte de dialogue s'affiche. Vous pouvez utiliser cette boîte de dialogue pour ouvrir le fichier avec l'application par défaut. Vous pouvez également enregistrer le fichier dans un dossier de votre ordinateur local.

Note

L'option de téléchargement n'est pas disponible lorsque vous lancez CloudShell leConsole Toolbar. Vous pouvez télécharger un fichier depuis CloudShell la console ou à l'aide du navigateur Web Chrome. Pour plus d'informations sur le téléchargement d'un fichier, voir Étape 3 : Télécharger un fichier depuis AWS CloudShell.

Étape 4 : Chargez un fichier sur AWS CloudShell

Note

Cette option n'est pas disponible pour les environnements VPC.

Cette étape décrit comment télécharger un fichier, puis le déplacer vers un nouveau répertoire de votre répertoire personnel.

Pour vérifier votre répertoire de travail actuel, entrez la commande suivante à l'invite :

pwd

Lorsque vous appuyez sur Entrée, le shell renvoie votre répertoire de travail actuel (par exemple,/home/cloudshell-user).
Pour télécharger un fichier dans ce répertoire, allez dans Actions et choisissez Charger le fichier dans le menu.

La boîte de dialogue Télécharger le fichier s'affiche.
Choisissez Parcourir.
Dans la boîte de dialogue de téléchargement de fichiers de votre système, sélectionnez le fichier texte que vous avez créé pour ce didacticiel (add_prog.py) et choisissez Ouvrir.
Dans la boîte de dialogue Charger un fichier, choisissez Charger.

Une barre de progression permet de suivre le téléchargement. Si le téléchargement est réussi, un message confirme qu'il add_prog.py a été ajouté à la racine de votre répertoire personnel.
Pour créer un répertoire pour le fichier, entrez la commande make directories :mkdir mysub_dir.
Pour déplacer le fichier téléchargé de la racine de votre répertoire personnel vers le nouveau répertoire, utilisez la mv commande suivante :

mv add_prog.py mysub_dir.
Pour remplacer votre répertoire de travail par le nouveau répertoire, entrezcd mysub_dir.

L'invite de commande est mise à jour pour indiquer que vous avez changé de répertoire de travail.
Pour afficher le contenu du répertoire en coursmysub_dir, entrez la ls commande.

Le contenu du répertoire de travail est répertorié. Cela inclut le fichier que vous venez de télécharger.

Étape 5 : Supprimer un fichier de AWS CloudShell

Cette étape décrit comment supprimer un fichier de AWS CloudShell.

Pour supprimer un fichier AWS CloudShell, utilisez les commandes shell standard telles que rm (remove).

rm my-file-for-removal
Pour supprimer plusieurs fichiers répondant aux critères spécifiés, exécutez la find commande.

L'exemple suivant supprime tous les fichiers dont le nom contient le suffixe « .pdf ».
```
find -type f -name '*.pdf' -delete
```

Note

Supposons que vous arrêtiez de l'utiliser AWS CloudShell dans un domaine spécifique Région AWS. Ensuite, les données qui se trouvent dans le stockage permanent de cette région sont automatiquement supprimées après une période spécifiée. Pour plus d'informations, consultez la section Stockage persistant.

Étape 6 : Création d'une sauvegarde du répertoire de base

Création d'un fichier de sauvegarde

Créez un dossier temporaire en dehors du répertoire de base.


HOME_BACKUP_DIR=$(mktemp --directory)

Vous pouvez utiliser l'une des options suivantes pour créer une sauvegarde :

Création d'un fichier de sauvegarde à l'aide de tar

Pour créer un fichier de sauvegarde à l'aide de tar, entrez la commande suivante :


tar \
    --create \
    --gzip \
    --verbose \
    --file=${HOME_BACKUP_DIR}/home.tar.gz \
    [--exclude ${HOME}/.cache] \ // Optional
    ${HOME}/
echo "Home directory backed up to this file: ${HOME_BACKUP_DIR}/home.tar.gz"

Création d'un fichier de sauvegarde à l'aide de zip

Pour créer un fichier de sauvegarde à l'aide du format zip, entrez la commande suivante :


zip \
    --recurse-paths \
    ${HOME_BACKUP_DIR}/home.zip \
    ${HOME} \
    [--exclude ${HOME}/.cache/\*] // Optional
echo "Home directory backed up to this file: ${HOME_BACKUP_DIR}/home.zip"

Transférez le fichier de sauvegarde à l'extérieur CloudShell

Vous pouvez utiliser l'une des options suivantes pour transférer le fichier de sauvegarde à l'extérieur CloudShell :
1. Téléchargez le fichier de sauvegarde sur votre ordinateur local
  
  Vous pouvez télécharger le fichier créé à l'étape précédente. Pour plus d'informations sur le téléchargement d'un fichier depuis CloudShell, voir Télécharger un fichier depuis AWS CloudShell.
  
  Dans la boîte de dialogue de téléchargement du fichier, entrez le chemin du fichier à télécharger (par exemple,/tmp/tmp.iA99tD9L98/home.tar.gz).
2. Transférez le fichier de sauvegarde vers S3
  
  Pour générer un bucket, entrez la commande suivante :
```
aws s3 mb s3://${BUCKET_NAME}
```
  Utilisez l'AWS CLI pour copier le fichier dans le compartiment S3 :
```
aws s3 cp ${HOME_BACKUP_DIR}/home.tar.gz s3://${BUCKET_NAME}
```
  Note
  Des frais de transfert de données peuvent s'appliquer.
Backup directement dans un compartiment S3

Pour effectuer une sauvegarde directement dans un compartiment S3, entrez la commande suivante :
```
aws s3 cp \
    ${HOME}/ \
    s3://${BUCKET_NAME} \
    --recursive \
    [--exclude .cache/\*] // Optional
```

Étape 7 : Redémarrer une session shell

Note

Par mesure de sécurité, si vous n'interagissez pas avec le shell à l'aide du clavier ou du pointeur pendant une période prolongée, la session s'arrête automatiquement. Les sessions de longue durée sont également automatiquement arrêtées. Pour plus d’informations, consultez Sessions Shell.

Pour redémarrer une session shell, choisissez Actions, Redémarrer AWS CloudShell.

Vous êtes averti que le redémarrage AWS CloudShell arrête toutes les sessions actives en cours Région AWS.
Pour confirmer, choisissez Redémarrer.

Une interface affiche un message indiquant que l'environnement CloudShell informatique s'arrête. Après l'arrêt et le redémarrage de l'environnement, vous pouvez commencer à travailler avec la ligne de commande dans une nouvelle session.

Note
Dans certains cas, le redémarrage de votre environnement peut prendre quelques minutes.

Étape 8 : Supprimer le répertoire d'accueil d'une session shell

Note

Cette option n'est pas disponible pour les environnements VPC. Lorsque vous redémarrez un environnement VPC, son répertoire de base est supprimé.

Avertissement

La suppression de votre répertoire personnel est une action irréversible dans laquelle toutes les données stockées dans votre répertoire personnel sont supprimées définitivement. Toutefois, vous pouvez envisager cette option dans les situations suivantes :

Vous avez modifié un fichier de manière incorrecte et vous ne pouvez pas accéder à l'environnement AWS CloudShell informatique. La suppression de votre répertoire personnel AWS CloudShell rétablit ses paramètres par défaut.
Vous souhaitez supprimer toutes vos données AWS CloudShell immédiatement. Si vous arrêtez de l'utiliser AWS CloudShell dans une AWS région, le stockage persistant est automatiquement supprimé à la fin de la période de conservation, sauf si vous le AWS CloudShell relancez dans la région.

Si vous avez besoin d'un stockage à long terme pour vos fichiers, pensez à un service tel qu'Amazon S3 ou CodeCommit.

Pour supprimer une session shell, choisissez Actions, puis Supprimer le répertoire d' CloudShell accueil AWS.

Vous êtes informé que la suppression du AWS CloudShell répertoire de base entraîne la suppression de toutes les données actuellement stockées dans votre AWS CloudShell environnement.

Note
Vous ne pouvez pas annuler cette action.
Pour confirmer la suppression, saisissez Supprimer dans le champ de saisie de texte, puis choisissez Supprimer.

AWS CloudShell arrête toutes les sessions actives en cours Région AWS et crée immédiatement un nouvel environnement.

Quitter manuellement les sessions shell

Avec la ligne de commande, vous pouvez quitter une session shell et vous déconnecter à l'aide de la exit commande. Vous pouvez ensuite appuyer sur n'importe quelle touche pour vous reconnecter et continuer à utiliser AWS CloudShell.

Étape 9 : Modifiez le code de votre fichier et exécutez-le à l'aide de la ligne de commande

Cette étape montre comment utiliser l'Viméditeur préinstallé pour travailler avec un fichier. Vous exécutez ensuite ce fichier en tant que programme à partir de la ligne de commande.

Pour modifier le fichier que vous avez chargé à l'étape précédente, entrez la commande suivante :
vim add_prog.py

L'interface shell est actualisée pour afficher l'Viméditeur.
Pour modifier le fichierVim, appuyez sur la I touche. Modifiez maintenant le contenu pour que le programme ajoute trois chiffres au lieu de deux.
```
import sys
x=int(sys.argv[1])
y=int(sys.argv[2])
z=int(sys.argv[3])
sum=x+y+z
print("The sum is",sum)
```
Note
Si vous collez le texte dans l'éditeur et que la fonction de collage sécurisé est activée, un avertissement s'affiche. Le texte multiligne copié peut contenir des scripts malveillants. Grâce à la fonction Safe Paste, vous pouvez vérifier le texte complet avant qu'il ne soit collé. Si vous êtes convaincu que le texte est sécurisé, choisissez Coller.
Après avoir modifié le programme, appuyez sur Esc ce bouton pour passer en mode Vim commande. Entrez ensuite la :wq commande pour enregistrer le fichier et quittez l'éditeur.

Note
Si le mode Vim commande est nouveau pour vous, il se peut que vous trouviez difficile au début de passer du mode commande au mode insertion. Le mode commande est utilisé lors de l'enregistrement des fichiers et de la sortie de l'application. Le mode Insertion est utilisé lors de l'insertion d'un nouveau texte. Pour passer en mode insertion, appuyez surI, et pour passer en mode commande, appuyez surEsc. Pour plus d'informations sur Vim les autres outils disponibles dans AWS CloudShell, voirOutils de développement et utilitaires shell.
Sur l'interface de ligne de commande principale, exécutez le programme suivant et spécifiez trois nombres à saisir. La syntaxe est la suivante.

python3 add_prog.py 4 5 6

La ligne de commande affiche le résultat du programme :The sum is 15.

Étape 10 : AWS CLI à utiliser pour ajouter le fichier en tant qu'objet dans un compartiment Amazon S3

Au cours de cette étape, vous créez un compartiment Amazon S3, puis vous utilisez la PutObjectméthode pour ajouter votre fichier de code en tant qu'objet dans ce compartiment.

Note

Dans la plupart des cas, vous pouvez utiliser un service tel que la validation CodeCommit d'un fichier logiciel dans un référentiel contrôlé par version. Ce didacticiel explique comment utiliser AWS CLI in AWS CloudShell pour interagir avec d'autres services AWS. Avec cette méthode, vous n'avez pas besoin de télécharger ou d'installer de ressource supplémentaire. De plus, comme vous êtes déjà authentifié dans le shell, vous n'avez pas besoin de configurer les informations d'identification avant d'effectuer des appels.

Pour créer un bucket dans un compartiment spécifié Région AWS, entrez la commande suivante :
```
aws s3api create-bucket --bucket insert-unique-bucket-name-here --region us-east-1
```
Note
Si vous créez un bucket en dehors de la us-east-1 région, ajoutez-le create-bucket-configuration avec le LocationConstraint paramètre pour spécifier la région. Voici un exemple de syntaxe.
```
$ aws s3api create-bucket --bucket my-bucket --region eu-west-1 --create-bucket-configuration LocationConstraint=eu-west-1
```
Si l'appel aboutit, la ligne de commande affiche une réponse du service similaire à la sortie suivante.
```
{
    "Location": "/insert-unique-bucket-name-here"
}                    
```
Note
Si vous ne respectez pas les règles de dénomination des compartiments, le message d'erreur suivant s'affiche : Une erreur s'est produite (InvalidBucketName) lors de l'appel de l' CreateBucketopération : Le compartiment spécifié n'est pas valide.
Pour télécharger un fichier et l'ajouter en tant qu'objet au bucket que vous venez de créer, appelez la PutObject méthode.
```
aws s3api put-object --bucket insert-unique-bucket-name-here --key add_prog --body add_prog.py
```
Une fois l'objet chargé dans le compartiment Amazon S3, la ligne de commande affiche une réponse du service similaire à la sortie suivante :
```
{"ETag": "\"ab123c1:w:wad4a567d8bfd9a1234ebeea56\""}
```
ETagIl s'agit du hachage de l'objet qui a été stocké. Vous pouvez utiliser ce hachage pour vérifier l'intégrité de l'objet chargé sur Amazon S3.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

FAQ

Didacticiels

Commencer avec AWS CloudShell

Prérequis

Table des matières

Étape 1 : Connectez-vous à AWS Management Console

Note

Étape 2 : Sélectionnez une région AWS CloudShell, lancez et choisissez un shell

Important

Important

Note

Note

Étape 3 : Téléchargez un fichier depuis AWS CloudShell

Note

Note

Note

Étape 4 : Chargez un fichier sur AWS CloudShell

Note

Étape 5 : Supprimer un fichier de AWS CloudShell

Note

Étape 6 : Création d'une sauvegarde du répertoire de base

Note

Étape 7 : Redémarrer une session shell

Note

Note

Étape 8 : Supprimer le répertoire d'accueil d'une session shell

Note

Avertissement

Note

Étape 9 : Modifiez le code de votre fichier et exécutez-le à l'aide de la ligne de commande

Note

Note

Étape 10 : AWS CLI à utiliser pour ajouter le fichier en tant qu'objet dans un compartiment Amazon S3

Note

Note

Note

Rubriques en relation