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 tutorial e attività di apprendimento.

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: 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 passare al passaggio 3.
Apri il nuovo Dockerfile seguendo le istruzioni stampate sulla 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 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 link 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 e poi aggiungi un link simile al seguente al tuo 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 saperne di più su questi e altri parametri, consulta Apri in Cloud Shell.

Mantenere aggiornata l'immagine del container personalizzato

Il container personalizzato deve essere basato sull'immagine Cloud Shell pubblica più recente per funzionare su Cloud Shell. Ti consigliamo di eseguire ricostruzioni settimanali per mantenere aggiornata l'immagine personalizzata.