Questa pagina è stata tradotta dall'API Cloud Translation.

Personalizza le immagini container di Cloud Shell

In questa pagina viene descritto come creare e utilizzare un'immagine Docker personalizzata come dell'ambiente Cloud Shell.

Per creare un'esperienza Cloud Shell personalizzata, crea un'immagine Docker che funziona come ambiente Cloud Shell personalizzato configurazioni personalizzate e pacchetti aggiuntivi specificati. L'immagine Docker deve sarà basato sulla base Immagine Cloud Shell e ospitati in Container Registry.

crea un'immagine Docker personalizzata

Per seguire una guida passo passo per questa attività direttamente nel Editor di Cloud Shell, fai clic su Procedura guidata:

Procedura guidata

Crea la tua immagine Docker personalizzata seguendo queste istruzioni:

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

In alternativa, se preferisci eseguire il deployment manuale di Container Registry o di utilizzare il tuo flusso di automazione, puoi creare un Dockerfile vuoto e vai al passaggio 3.
Apri il nuovo Dockerfile seguendo le istruzioni stampate sul tuo riga di comando:
```
cd $HOME/NEW_REPO_NAME && cloudshell edit Dockerfile
```
Aggiungi eventuali pacchetti aggiuntivi che vuoi rendere disponibili nel tuo di Cloud Shell al di sotto della prima riga. Ad esempio:
```
FROM gcr.io/cloudshell-images/cloudshell:latest
RUN apt-get -y install lsof
```
La prima riga del Dockerfile, FROM gcr.io/cloudshell-images/cloudshell:latest, fa riferimento alla base dell'immagine di Cloud Shell 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 Apri in Cloud Shell devi prima renderli pubblici. Per conoscere la procedura per creare un'immagine personalizzata pubblicamente, segui la guida al controllo dell'accesso di Container Registry.

Dopo aver configurato le impostazioni di accesso corrette, puoi aggiornare il tuo Link Apri in Cloud Shell per specificare cloudshell_git_repo e cloudshell_image. Ad esempio, per aggiungere una finestra di dialogo Apri in Cloud principale, modifica gli URL nell'esempio seguente e aggiungi un link simile al seguente file Markdown:

[![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 ulteriori informazioni su questi e altri parametri, vedi Apri in Cloud Shell.

Mantenere aggiornata l'immagine container personalizzata

Il tuo container personalizzato deve essere basato sulla versione pubblica più recente Immagine Cloud Shell per lavorare su Cloud Shell. Ti consigliamo di eseguire ricostruzioni settimanali per mantenere aggiornata l'immagine personalizzata.