Tutoriel Docker pour AWS Cloud9

Connectez-vous à l'EC2instance Amazon en cours d'exécution à l'aide d'un SSH client tel que l'sshutilitaire ou PuTTY. Pour ce faire, consultez l'« Étape 3 : Se connecter à l'instance » de la section Lancer une machine virtuelle Linux.

Vérifiez si Docker est installé sur l'instance. Pour ce faire, exécutez la commande docker sur l'instance avec l'option --version.

docker --version

Si Docker est installé, le numéro de version de Docker et le numéro de génération sont affichés. Dans ce cas, passez directement à l'étape 5 ultérieurement dans la procédure.

Installez Docker. Pour ce faire, exécutez la commande yum ou apt avec l'action install , en spécifiant le paquet docker ou docker.io à installer.

Pour Amazon Linux :

sudo yum install -y docker

Pour Ubuntu Server :

sudo apt install -y docker.io

Confirmez que Docker est installé. Pour ce faire, exécutez à nouveau la commande docker --version . Le numéro de version de Docker et le numéro de génération sont affichés.

Exécutez Docker. Pour ce faire, exécutez la commande service avec le service docker et l'action start

sudo service docker start

Confirmez que Docker est en cours d'exécution. Pour ce faire, exécutez la commande docker avec l'action info .

sudo docker info

Si Docker est en cours d'exécution, les informations sur Docker s'affichent.

Sur l'instance, créez le Dockerfile. Pour ce faire, le SSH client étant toujours connecté à l'instance, créez un fichier nommé dans le /tmp répertoire de l'instanceDockerfile. Par exemple, exécutez la commande touch comme suit.

sudo touch /tmp/Dockerfile

Ajoutez le contenu suivant au fichier Dockerfile.

# Build a Docker image based on the Amazon Linux 2 Docker image.
FROM amazonlinux:2

# install common tools
RUN yum install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
RUN yum update -y
RUN yum install -y sudo bash curl wget git man-db nano vim bash-completion tmux  gcc gcc-c++ make tar

# Enable the Docker container to communicate with AWS Cloud9 by
# installing SSH.
RUN yum install -y openssh-server

# Ensure that Node.js is installed.
RUN yum install -y nodejs

# Create user and enable root access
RUN useradd --uid 1000 --shell /bin/bash -m --home-dir /home/ubuntu ubuntu && \
    sed -i 's/%wheel\s.*/%wheel ALL=NOPASSWD:ALL/' /etc/sudoers && \
    usermod -a -G wheel ubuntu

# Add the AWS Cloud9 SSH public key to the Docker container.
# This assumes a file named authorized_keys containing the
# AWS Cloud9 SSH public key already exists in the same
# directory as the Dockerfile.
RUN mkdir -p /home/ubuntu/.ssh
ADD ./authorized_keys /home/ubuntu/.ssh/authorized_keys
RUN chown -R ubuntu /home/ubuntu/.ssh /home/ubuntu/.ssh/authorized_keys && \
chmod 700 /home/ubuntu/.ssh && \
chmod 600 /home/ubuntu/.ssh/authorized_keys

# Update the password to a random one for the user ubuntu.
RUN echo "ubuntu:$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1)" | chpasswd

# pre-install Cloud9 dependencies
USER ubuntu
RUN curl https://d2j6vhu5uywtq3.cloudfront.net/static/c9-install.sh | bash

USER root
# Start SSH in the Docker container.
CMD ssh-keygen -A && /usr/sbin/sshd -D

Pour ajouter le contenu précédent au fichier Dockerfile, vous pouvez utiliser l'utilitaire vi sur l'instance comme suit.

1. Utilisez le AWS Cloud9 pour ouvrir et modifier le /tmp/Dockerfile fichier.

   sudo vi /tmp/Dockerfile

2. Collez le contenu précédent dans le fichier Dockerfile. Si vous ne savez pas comment procéder, consultez la documentation de votre SSH client.

3. Basculez en mode commande. Pour ce faire, appuyez sur la touche Esc. (-- INSERT -- disparaît de bas de la fenêtre.)

4. Tapez :wq (pour écrire dans le fichier /tmp/Dockerfile, enregistrer le fichier et quitter vi ), puis appuyez sur Enter.

Sur l'instance, créez un fichier contenant la clé AWS Cloud9 SSH publique à utiliser par le conteneur Docker. Pour ce faire, dans le même répertoire que le fichier Dockerfile, créez un fichier nommé authorized_keys, par exemple, en exécutant la commande touch .

sudo touch /tmp/authorized_keys

Ajoutez la clé AWS Cloud9 SSH publique au authorized_keys fichier. Pour obtenir la clé AWS Cloud9 SSH publique, procédez comme suit :

1. Ouvrez la AWS Cloud9 console à l'adresse https://console.aws.amazon.com/cloud9/.

2. Dans la barre de AWS navigation, dans le sélecteur de AWS région, choisissez la AWS région dans laquelle vous souhaitez créer l'environnement de AWS Cloud9 développement plus loin dans cette rubrique.

3. Si une page de bienvenue s'affiche, pour Nouvel AWS Cloud9 environnement, choisissez Créer un environnement. Sinon, choisissez Create environment (Créer un environnement).

4. Dans la page Nom de l'environnement, pour le champ Nom, tapez un nom pour votre environnement. (Le nom n'est pas important ici. Vous choisirez un autre nom plus tard.)

5. Choisissez Next step (Étape suivante).

6. Pour le type d'environnement, choisissez Connect et exécutez sur un serveur distant (SSH).

7. Élargir Afficher la SSH clé publique.

8. Choisissez Copier la clé vers le presse-papiers). (Cela se situe entre Afficher la SSH clé publique et les paramètres avancés.)

9. Choisissez Cancel (Annuler).

10. Collez le contenu du Presse-papiers dans le fichier authorized_keys, puis enregistrez le fichier. Par exemple, vous pouvez utiliser l'utilitaire vi , comme décrit plus haut dans cette étape.

Créez l'image en exécutant la commande docker avec l'action build , en ajoutant la balise cloud9-image:latest à l'image et en spécifiant le chemin d'accès au fichier Dockerfile à utiliser.

sudo docker build -t cloud9-image:latest /tmp

En cas de réussite, les deux dernières lignes de la sortie de génération affichent Successfully built et Successfully tagged.

Pour confirmer que Docker a correctement créé l'image, exécutez la commande docker avec l'action image ls.

sudo docker image ls

En cas de réussite, la sortie affiche une entrée où le champ REPOSITORY a la valeur cloud9-image et le champ TAG la valeur latest.

Notez l'adresse IP publique de l'EC2instance Amazon. Vous en aurez besoin pour l'Étape 4 : Créer l'environnement. Si vous avez des doutes sur l'adresse IP publique de l'instance, vous pouvez exécuter la commande suivante sur l'instance pour l'obtenir.

curl http://169.254.169.254/latest/meta-data/public-ipv4

Pour exécuter le conteneur Docker, exécutez la commande docker sur l'instance avec l'action run et les options suivantes.

sudo docker run -d -it --expose 9090 -p 0.0.0.0:9090:22 --name cloud9 cloud9-image:latest

Pour confirmer que Docker exécute correctement le conteneur, exécutez la commande docker avec l'action container ls.

sudo docker container ls

En cas de réussite, la sortie affiche une entrée où le champ IMAGE a la valeur cloud9-image:latest et le champ NAMES la valeur cloud9.

Connectez-vous au conteneur en cours d'exécution. Pour ce faire, exécutez la commande docker avec l'action exec et les options suivantes.

sudo docker exec -it cloud9 bash

En cas de réussite, l'invite du terminal est modifiée et affiche le nom de l'utilisateur connecté comme nom du conteneur, ainsi que l'ID du conteneur.

Pour le répertoire du conteneur en cours d'exécution à partir duquel vous AWS Cloud9 souhaitez démarrer une fois qu'il s'est connecté, définissez ses autorisations d'accès sur rwxr-xr-x. Cela signifie read-write-execute des autorisations pour le propriétaire, des autorisations de lecture-exécution pour le groupe et des autorisations de lecture-exécution pour les autres. Par exemple, si le chemin d'accès du répertoire est ~, vous pouvez définir ces autorisations sur le répertoire en exécutant la commande chmod dans le conteneur en cours d'exécution comme suit.

sudo chmod u=rwx,g=rx,o=rx ~

Notez le chemin d'accès du répertoire sur le conteneur en cours d'exécution qui contient le fichier binaire Node.js, car vous en aurez besoin pour l'Étape 4 : Créer l'environnement. Si vous avez des doutes sur le chemin d'accès, exécutez la commande suivante sur le conteneur en cours d'exécution pour l'obtenir.

which node

Assurez-vous d'avoir suivi les prérequis précédents.

Connectez-vous à votre instance existante ou à votre propre serveur à l'aide d'un SSH client, si vous n'y êtes pas déjà connecté. Cela garantit que vous pouvez ajouter la valeur de SSH clé publique nécessaire à l'instance ou au serveur. Cette opération est détaillée plus loin dans cette procédure.

Connectez-vous à la AWS Cloud9 console, à l'adresse https://console.aws.amazon.com/cloud9/.

Une fois connecté à la AWS Cloud9 console, dans la barre de navigation supérieure, choisissez un dans lequel Région AWS créer l'environnement. Pour obtenir la liste des produits disponibles Régions AWS, consultez AWS Cloud9le Références générales AWS.

Si vous créez un environnement de développement pour la première fois, une page d'accueil s'affiche. Dans le panneau Nouvel AWS Cloud9 environnement, sélectionnez Créer un environnement.

Si vous avez déjà créé des environnements de développement, vous pouvez également développer le volet situé à gauche de l'écran. Sélectionnez Your environments (Vos environnements), puis sélectionnez Create environment (Créer un environnement).

Dans la page d'accueil :

Ou dans la page Vos environnements :

Sur la page Create environment (Créer un environnement), saisissez un nom pour votre environnement.

Pour Description, saisissez des informations concernant votre environnement. Dans le cadre de ce tutoriel, utilisez This environment is for the AWS Cloud9 tutorial.

Pour Environment type (Type d'environnement), sélectionnez Existing Compute (Calcul existant) parmi les options suivantes :

Sur le panneau Existing compute (Calcul existant), pour User (Utilsiateur), entrez le nom de connexion que vous avez utilisé pour vous connecter à l'instance ou au serveur plus tôt dans cette procédure. Par exemple, pour une instance de calcul AWS Cloud , cela peut être ec2-user, ubuntu ou root.

Pour Host (Hôte), saisissez l'adresse IP publique (préférée) ou le nom d'hôte de l'instance ou du serveur.

Pour Port, entrez le port que vous souhaitez utiliser AWS Cloud9 pour essayer de vous connecter à l'instance ou au serveur. Vous pouvez également conserver le port par défaut.

Choisissez Détails supplémentaires : facultatif pour afficher le chemin de l'environnement, le chemin d'accès au fichier binaire node.js et les informations sur l'hôte de SSH saut.

Dans le champ Environment path, entrez le chemin d'accès au répertoire de l'instance ou du serveur AWS Cloud9 à partir duquel vous souhaitez démarrer. Vous l'avez identifié plus tôt dans les conditions préalables à cette procédure. Si vous laissez ce champ vide, AWS Cloud9 utilise le répertoire à partir duquel votre instance ou serveur démarre généralement une fois connecté. Il s'agit généralement d'un répertoire de base ou par défaut.

Pour Path to Node.js binary path (Chemin d'accès au binaire Node.js), entrez les informations de chemin d'accès pour spécifier le chemin d'accès au binaire Node.js sur l'instance ou le serveur. Pour obtenir le chemin, vous pouvez exécuter la commande which node (ou nvm which node si vous utilisez nvm) sur votre instance ou serveur. Par exemple, le chemin peut être /usr/bin/node. Si vous laissez ce champ vide, AWS Cloud9 tente de deviner l'emplacement du fichier binaire Node.js quand il essaie de se connecter.

Pour SSHJump Host, entrez les informations relatives à l'hôte de saut utilisé par l'instance ou le serveur. Utilisez le format USER_NAME@HOSTNAME:PORT_NUMBER (par exemple, ec2-user@:ip-192-0-2-0:22).

Le serveur de saut doit satisfaire aux exigences suivantes :

Ajoutez jusqu'à 50 identifications en fournissant une clé et une valeur pour chaque identification. Pour ce faire, sélectionnez Add new tag (Ajouter une nouvelle balise). Les balises sont attachées à l' AWS Cloud9 environnement sous forme de balises de ressources et sont propagées aux ressources sous-jacentes suivantes : la AWS CloudFormation pile, l'EC2instance Amazon et les groupes de EC2 sécurité Amazon. Pour en savoir plus sur les balises, consultez la section Contrôler l'accès à l'aide de balises de AWS ressources dans le guide de l'IAMutilisateur et les informations avancées sur les balises dans ce guide.

Choisissez Create (Créer) pour créer votre environnement, et vous êtes ensuite redirigé vers la page d'accueil. Lorsque le compte est créé avec succès, une barre flash verte apparaît en haut de la AWS Cloud9 console. Vous pouvez sélectionner le nouvel environnement et choisir Ouvrir dans Cloud9 pour lancer le. IDE

Si la création du compte échoue, une barre d'éclair rouge apparaît en haut de la console AWS Cloud9 . La création de votre compte peut échouer en raison d'un problème lié à votre navigateur Web, AWS à vos autorisations d'accès, à l'instance ou au réseau associé. Vous trouverez des informations sur les solutions possibles aux problèmes qui peuvent entraîner l'échec du compte dans la section Résolution des problèmes de AWS Cloud9.

Avec le message AWS Cloud9 IDE affiché pour le conteneur en cours d'exécution, démarrez l'exemple de serveur de chat. Pour ce faire, dans la fenêtre Environment (Environnement), cliquez avec le bouton droit sur l'exemple de fichier workspace/server.js, puis choisissez Run (Exécuter).

Affichez un aperçu de l'exemple d'application. Pour ce faire, dans la fenêtre Environment (Environnement), ouvrez le fichier workspace/client/index.html. Ensuite, dans la barre des menus, choisissez Tools, Preview, Preview Running Application (Outils, Aperçu, Aperçu de l'application en cours d'exécution).

Dans l'onglet d'aperçu de l'application, pour Your Name (Votre nom), tapez votre nom. Tapez un message dans le champ Message. Puis, choisissez Send (Envoyer). Le serveur de chat instantanée ajoute votre nom et votre message à la liste.

Supprimez le conteneur Docker de l'instance. Pour ce faire, exécutez la commande docker sur l'instance avec les actions d'arrêt stop et rm , et le nom complet du conteneur.

sudo docker stop cloud9
sudo docker rm cloud9

Supprimez l'image Docker de l'instance. Pour ce faire, exécutez la commande docker sur l'instance avec l'action image rm et la balise de l'image.

sudo docker image rm cloud9-image:latest

Supprimez les éventuels fichiers de support Docker toujours existants. Pour ce faire, exécutez la commande docker sur l'instance avec l'action system prune.

sudo docker system prune -a

Désinstallez Docker. Pour ce faire, exécutez la commande yum sur l'instance avec l'action remove , en spécifiant le paquet docker à désinstaller.

Pour Amazon Linux :

sudo yum -y remove docker

Pour Ubuntu Server :

sudo apt -y remove docker

Vous pouvez également supprimer les fichiers Dockerfile et authorized_keys que vous avez créés précédemment. Par exemple, exécutez la commande rm sur l'instance.

sudo rm /tmp/Dockerfile
sudo rm /tmp/authorized_keys