Questa pagina è stata tradotta dall'API Cloud Translation.

Personalizza le immagini container di Cloud Shell

Questa pagina descrive come creare e utilizzare un'immagine Docker personalizzata come ambiente Cloud Shell.

Per creare un'esperienza Cloud Shell personalizzata, crea un'immagine Docker che funzioni come un ambiente Cloud Shell personalizzato con i tuoi pacchetti aggiuntivi e le configurazioni personalizzate specificate. L'immagine Docker deve essere basata sull'immagine Cloud Shell di base ed essere ospitata in Container Registry.

Crea un'immagine Docker personalizzata

Per seguire le indicazioni dettagliate per questa attività direttamente nell'editor di Cloud Shell, fai clic su Aiuto:

Guidami

Crea la tua immagine Docker personalizzata seguendo queste istruzioni:

In una scheda del terminale Cloud Shell, esegui questo comando per creare un'immagine personalizzata boilerplate in un repository ospitato da Cloud Source Repositories:
```
cloudshell env create-custom-image NEW_REPO_NAME
```
Nota: se vuoi utilizzare un repository esistente, puoi visualizzare un elenco dei tuoi repository eseguendo gcloud source repos list.

In alternativa, se preferisci eseguire il deployment manuale in Container Registry o utilizzare il tuo flusso di automazione, puoi creare un nuovo Dockerfile vuoto e andare al passaggio 3.
Apri il tuo nuovo Dockerfile seguendo le istruzioni stampate nella riga di comando:
```
cd $HOME/NEW_REPO_NAME && cloudshell edit Dockerfile
```
Aggiungi eventuali altri pacchetti che vuoi rendere disponibili nella tua esperienza Cloud Shell sotto la prima riga. Ad esempio:
```
FROM gcr.io/cloudshell-images/cloudshell:latest
RUN apt-get -y install lsof
```
La prima riga nel tuo Dockerfile, FROM gcr.io/cloudshell-images/cloudshell:latest, fa riferimento all'immagine Cloud Shell di base e non deve essere rimossa.
Crea la tua immagine in locale eseguendo:
```
cloudshell env build-local
```
Testa l'immagine in locale e verifica che i pacchetti installati siano presenti eseguendo:
```
cloudshell env run
```
Per uscire dal test, esegui:
```
exit
```

Esegui il commit delle modifiche al codice localmente:

git commit -a -m "Initial custom environment check-in."

Esegui il push delle modifiche al codice in Cloud Source Repositories:
```
git push origin master
```
Infine, esegui il push dell'immagine personalizzata in Container Registry:
```
cloudshell env push
```

Aggiorna il link Apri in Cloud Shell

Per utilizzare l'immagine personalizzata con i collegamenti Apri in Cloud Shell, devi prima renderla pubblica. Per conoscere la procedura per rendere pubblica un'immagine personalizzata, consulta la guida al controllo dell'accesso di Container Registry.

Dopo aver configurato le impostazioni di accesso corrette, puoi aggiornare il collegamento Apri in Cloud Shell per specificare i parametri cloudshell_git_repo e cloudshell_image. Ad esempio, per aggiungere un pulsante Apri in Cloud Shell, modifica gli URL nell'esempio seguente, quindi aggiungi al file Markdown un link simile al seguente:

[![Open in Cloud Shell](https://gstatic.com/cloudssh/images/open-btn.svg)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=REPO_URL&cloudshell_image=DOCKER_IMAGE_URL)

Sostituisci i seguenti valori:

REPO_URL: URL della posizione del repository
DOCKER_IMAGE_URL: URL dell'immagine Docker

Per maggiori informazioni su questi e altri parametri, consulta Aprire in Cloud Shell.

Mantenere aggiornata l'immagine del container personalizzata

Per funzionare su Cloud Shell, il container personalizzato deve essere basato sull'immagine Cloud Shell pubblica più recente. Ti consigliamo di ricreare ogni settimana per mantenere aggiornata l'immagine personalizzata.