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 ambiente Cloud Shell personalizzato con i pacchetti aggiuntivi e le configurazioni personalizzate specificati. 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 Procedura guidata:

Procedura guidata


Crea la tua immagine Docker personalizzata seguendo queste istruzioni:

  1. 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
    

    In alternativa, se preferisci eseguire il deployment manuale su Container Registry o utilizzare il tuo flusso di automazione, puoi creare un nuovo Dockerfile vuoto e andare al passaggio 3.

  2. Apri il nuovo Dockerfile seguendo le istruzioni stampate sulla riga di comando:

    cd $HOME/NEW_REPO_NAME && cloudshell edit Dockerfile
    
  3. Aggiungi sotto la prima riga eventuali pacchetti aggiuntivi che vuoi rendere disponibili nell'esperienza Cloud Shell. Ad esempio:

    FROM gcr.io/cloudshell-images/cloudshell:latest
    RUN apt-get -y install lsof
    

    La prima riga nel Dockerfile, FROM gcr.io/cloudshell-images/cloudshell:latest, fa riferimento all'immagine Cloud Shell di base e non deve essere rimossa.

  4. Crea la tua immagine in locale eseguendo:

    cloudshell env build-local
    
  5. Testa l'immagine in locale e verifica che i pacchetti installati siano presenti eseguendo:

    cloudshell env run
    

    Per uscire dal test, esegui:

    exit
    
  6. Esegui il commit delle modifiche al codice localmente:

    git commit -a -m "Initial custom environment check-in."
    
  7. Esegui il push delle modifiche al codice in Cloud Source Repositories:

    git push origin master
    
  8. Infine, esegui il push dell'immagine personalizzata in Container Registry:

    cloudshell env push
    

Per utilizzare l'immagine personalizzata con i link Apri in Cloud Shell, devi prima renderla pubblica. Per la procedura per rendere pubblica un'immagine personalizzata, segui 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 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 ulteriori informazioni su questi e altri parametri, consulta Aprire in Cloud Shell.

Mantenere aggiornata l'immagine container personalizzata

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