Tutorial Docker per AWS Cloud9

Esegui la connessione all'istanza Amazon EC2 in esecuzione utilizzando un client SSH, ad esempio l'utilità ssh o PuTTY. A tale scopo, consulta "Fase 3: eseguire la connessione all'istanza" in Avvio di macchine virtuali Linux.

Controlla se Docker è installato sull'istanza. Per farlo, esegui il comando docker sull'istanza con l'opzione --version .

docker --version

Se Docker è installato, vengono visualizzati la versione e il numero build del Docker. In questo caso, passa alla fase 5 più avanti in questa procedura.

Installazione di Docker. Per farlo, esegui il comando yum o apt con l'operazione install , specificando il pacchetto docker o docker.io da installare.

Per Amazon Linux:

sudo yum install -y docker

Per Ubuntu Server:

sudo apt install -y docker.io

Conferma che Docker è installato. Per farlo, esegui nuovamente il comando docker --version . Vengono visualizzati la versione e il numero build del Docker.

Esegui il Docker. Per farlo, esegui il comando service con il servizio docker e l'operazione start .

sudo service docker start

Conferma che il Docker è in esecuzione. Per farlo, esegui il comando docker con l'operazione info .

sudo docker info

Se il Docker è in esecuzione, vengono visualizzate informazioni sul Docker.

Nell'istanza, crea il Dockerfile. Per farlo, con il client SSH ancora connesso all'istanza, nella directory /tmp sull'istanza, crea un file denominato Dockerfile. Ad esempio, esegui il comando touch come segue.

sudo touch /tmp/Dockerfile

Aggiungi i seguenti contenuti al file 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

Per aggiungere i contenuti precedenti al file Dockerfile, puoi utilizzare l'utilità vi sull'istanza come segue.

1. Usa il AWS Cloud9 per aprire e modificare il /tmp/Dockerfile file.

   sudo vi /tmp/Dockerfile

2. Incolla il contenuto precedente nel file Dockerfile. In caso di dubbi su come eseguire questa operazione, vedi la documentazione del client SSH.

3. Passa alla modalità di comando. Per eseguire questa operazione, premere Esc (-- INSERT -- scompare dalla parte inferiore della finestra).

4. Digita :wq (per scrivere nel file /tmp/Dockerfile, salvare il file e quindi uscire da vi ), quindi premi Enter.

Nell'istanza, crea un file che contenga la chiave pubblica AWS Cloud9 SSH per il contenitore Docker da utilizzare. Per farlo, nella stessa directory del file Dockerfile, crea un file denominato authorized_keys, ad esempio, eseguendo il comando touch .

sudo touch /tmp/authorized_keys

Aggiungi la chiave pubblica AWS Cloud9 SSH al file. authorized_keys Per ottenere la chiave pubblica AWS Cloud9 SSH, procedi come segue:

1. Apri la AWS Cloud9 console all'indirizzo https://console.aws.amazon.com/cloud9/.

2. Nella barra di AWS navigazione, nel selettore della AWS regione, scegli la AWS regione in cui desideri creare l'ambiente di AWS Cloud9 sviluppo più avanti in questo argomento.

3. Se viene visualizzata una pagina di benvenuto, per Nuovo AWS Cloud9 ambiente, scegli Crea ambiente. Altrimenti, selezionare Create environment (Crea ambiente).

4. Nella pagina Name environment (Nomina ambiente), per Name (Nome), digita un nome per l'ambiente. (Qui il nome non è importante. Sceglierai un nome diverso in seguito).

5. Seleziona Fase successiva.

6. Per Environment type (Tipo di ambiente), scegli Connect and run in remote server (SSH) (Connetti ed esegui nel server remoto (SSH)).

7. Espandi View public SSH key (Visualizza chiave pubblica SSH).

8. Scegliere Copy key to clipboard (Copia chiave negli appunti). (Questa opzione si trova tra View public SSH key (Visualizza chiave pubblica SSH) e Advanced settings (Impostazioni avanzate)).

9. Seleziona Annulla.

10. Incolla il contenuto degli Appunti nel file authorized_keys, quindi salva il file. Ad esempio, puoi utilizzare l'utilità vi , come descritto in precedenza in questa fase.

Costruisci l'immagine eseguendo il comando docker con l'operazione build , aggiungendo il tag cloud9-image:latest all'immagine e specificando il percorso del file Dockerfile da utilizzare.

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

In caso di esito positivo, le ultime due righe dell'output di compilazione visualizzano Successfully built e Successfully tagged.

Per confermare che l'immagine è stata creata dal Docker, esegui il comando docker con l'operazione image ls.

sudo docker image ls

In caso di esito positivo, l'output visualizza una voce in cui il campo REPOSITORY è impostato su cloud9-image e il campo TAG è impostato su latest.

Prendi nota dell'indirizzo IP pubblico dell'istanza Amazon EC2. Questo sarà necessario nella Fase 4: creare l'ambiente. In caso di dubbi sull'indirizzo IP pubblico dell'istanza, puoi eseguire il seguente comando sull'istanza per ottenerlo.

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

Per eseguire il container Docker, esegui il comando docker sull'istanza con l'operazione run e le seguenti opzioni.

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

Per confermare che Docker esegue correttamente il container, esegui il comando docker con l'operazione container ls.

sudo docker container ls

In caso di esito positivo, l'output visualizza una voce in cui il campo IMAGE è impostato su cloud9-image:latest e il campo NAMES è impostato su cloud9.

Accedi al container in esecuzione. Per farlo, esegui il comando docker con l'operazione exec e le seguenti opzioni.

sudo docker exec -it cloud9 bash

In caso di esito positivo, il prompt del terminale cambia per visualizzare il nome dell'utente collegato per il container e l'ID del container.

Per la directory sul contenitore in esecuzione da cui desideri AWS Cloud9 iniziare dopo l'accesso, imposta le relative autorizzazioni di accesso su. rwxr-xr-x Ciò significa read-write-execute autorizzazioni per il proprietario, autorizzazioni di lettura-esecuzione per il gruppo e autorizzazioni di lettura-esecuzione per altri. Ad esempio, se il percorso della directory è ~, puoi impostare queste autorizzazioni per la directory eseguendo il comando chmod nel container in esecuzione, come descritto di seguito.

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

Prendi nota del percorso alla directory sul container in esecuzione che contiene il binario Node.js, poiché sarà necessario nella Fase 4: creare l'ambiente. In caso di dubbi sul percorso, esegui il comando seguente sul container in esecuzione per ottenerlo.

which node

Assicurati di aver soddisfatto i prerequisiti precedenti.

Se non l'hai già fatto, connettiti all'istanza esistente o al server utilizzando un client SSH. Avrai così la certezza di poter aggiungere il valore della chiave SSH pubblica necessaria all'istanza o al server. Questa parte è descritta più avanti in questa procedura.

Accedi alla AWS Cloud9 console all'indirizzo https://console.aws.amazon.com/cloud9/.

Dopo aver effettuato l'accesso alla AWS Cloud9 console, nella barra di navigazione in alto scegli un ambiente in cui Regione AWS creare l'ambiente. Per un elenco di quelli disponibili Regioni AWS, AWS Cloud9consulta Riferimenti generali di AWS.

Se è la prima volta che crei un ambiente di sviluppo, viene visualizzata una pagina di benvenuto. Nel pannello Nuovo AWS Cloud9 ambiente, scegli Crea ambiente.

Se in precedenza hai creato ambienti di sviluppo, puoi anche espandere il riquadro a sinistra della schermata. Scegli Your environments (I tuoi ambienti), quindi Create environment (Crea ambiente).

Nella pagina di benvenuto:

Oppure nella pagina Your environments (Ambienti):

Nella pagina Create environment (Crea ambiente), inserisci un nome per l'ambiente.

In Description (Descrizione), inserire qualcosa nell'ambiente. Per questo tutorial, utilizza This environment is for the AWS Cloud9 tutorial.

Per Environment type (Tipo ambiente), scegli Existing Compute (Elaborazione esistente) tra le opzioni seguenti:

Nel pannello Existing compute (Elaborazione esistente), in User (Utente) inserisci il nome di accesso che hai utilizzato per connetterti all'istanza o al server in precedenza in questa procedura. Ad esempio, per un'istanza di calcolo Cloud AWS , potrebbe essere ec2-user, ubuntu o root.

Per Host, immetti l'indirizzo IP pubblico (preferito) o il nome host dell'istanza o del server.

In Port, inserisci la porta che desideri utilizzare AWS Cloud9 per provare a connetterti all'istanza o al server. In alternativa, puoi lasciare indicata la porta predefinita.

Scegli Additional details - optional (Dettagli aggiuntivi: facoltativo) per visualizzare il percorso dell'ambiente, il percorso per il binario node.js e le informazioni sul jump host SSH.

Per Environment path, inserisci il percorso della directory sull'istanza o sul server da cui AWS Cloud9 vuoi iniziare. Questo lo hai identificato in precedenza nei prerequisiti di questa procedura. Se lasci questa opzione vuota, AWS Cloud9 utilizza la directory da cui solitamente inizia l'istanza o il server dopo il login. In genere si tratta di una directory home o predefinita.

In Path to Node.js binary path Percorso per binario Node.js), immetti le informazioni sul percorso per specificare il percorso del binario Node.js sull'istanza o sul server. Per ottenere il percorso, puoi eseguire il comando which node (o nvm which node se utilizzi nvm) sull'istanza o sul server. Ad esempio, il percorso potrebbe essere /usr/bin/node. Se lasci vuota la casella, quando tenta di connettersi, AWS Cloud9 prova a indovinare dove si trova il file binario Node.js.

Per SSH jump host (Jum host SSH), immetti le informazioni sul jump host utilizzato dall'istanza o dal server. Utilizza il formato USER_NAME@HOSTNAME:PORT_NUMBER (ad esempio, ec2-user@:ip-192-0-2-0:22).

Il jump host deve soddisfare i seguenti requisiti:

Aggiungi fino a 50 tag fornendo una chiave e un valore per ogni tag. Per farlo, seleziona Add new tag (Aggiungi nuovo tag). I tag vengono allegati all' AWS Cloud9 ambiente come tag di risorse e vengono propagati alle seguenti risorse sottostanti: lo AWS CloudFormation stack, l'istanza Amazon EC2 e i gruppi di sicurezza Amazon EC2. Per ulteriori informazioni sui tag, consulta Control Access Using AWS Resource Tags nella IAM User Guide e le informazioni avanzate sui tag in questa guida.

Scegli Create (Crea) per creare il tuo ambiente; verrai quindi reindirizzato alla home page. Quando l'account viene creato correttamente, nella parte superiore della AWS Cloud9 console viene visualizzata una barra flash verde. Puoi selezionare il nuovo ambiente e scegliere Open in Cloud9 (Apri in Cloud9) per avviare l'IDE.

Se l'account non viene creato correttamente, viene visualizzata una barra flash rossa nella parte superiore della console AWS Cloud9 . La creazione dell'account potrebbe non riuscire a causa di un problema con il browser Web, le autorizzazioni di AWS accesso, l'istanza o la rete associata. Per informazioni sulle possibili soluzioni ai problemi di creazione dell'account, consulta la sezione Risoluzione dei problemi di AWS Cloud9 .

Con l' AWS Cloud9 IDE visualizzato per il contenitore in esecuzione, avvia il server di chat di esempio. Per farlo, nella finestra Environment (Ambiente), fai clic con il pulsante destro del mouse sul file workspace/server.js di esempio e scegli Run (Esegui).

Visualizza l'anteprima dell'applicazione di esempio. Per farlo, nella finestra Environment (Ambiente), apri il file workspace/client/index.html. Quindi, nella barra dei menu, scegli Tools, Preview, Preview Running Application (Strumenti, Anteprima, Anteprima applicazione in esecuzione).

Nella scheda di anteprima dell'applicazione, per Your Name (Nome), digita il tuo nome. In Message (Messaggio), digita un messaggio. Quindi, scegli Send (Invia). Il nome e il messaggio vengono aggiunti dal server di chat all'elenco.

Rimuovi il container Docker dall'istanza. Per farlo, esegui il comando docker sull'istanza con le operazioni di interruzione stop e rm e il nome del container leggibile.

sudo docker stop cloud9
sudo docker rm cloud9

Rimuovi l'immagine Docker dall'istanza. Per farlo, esegui il comando docker sull'istanza con l'operazione image rm e il tag dell'immagine.

sudo docker image rm cloud9-image:latest

Rimuovi eventuali file di supporto Docker aggiuntivi che potrebbero ancora esistere. Per farlo, esegui il comando docker sull'istanza con l'operazione system prune .

sudo docker system prune -a

Disinstalla Docker. Per farlo, esegui il comando yum sull'istanza con l'operazione remove , specificando il pacchetto docker da disinstallare.

Per Amazon Linux:

sudo yum -y remove docker

Per Ubuntu Server:

sudo apt -y remove docker

Puoi anche rimuovere i file Dockerfile e authorized_keys creati in precedenza. Ad esempio, esegui il comando rm sull'istanza.

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