Personalizzare le immagini container

Le immagini di base preconfigurate fornite da Cloud Workstations contengono solo un ambiente minimo con IDE, strumenti per il linguaggio e il terminale Linux di base e un server sshd. Per accelerare la configurazione dell'ambiente per casi d'uso specifici di sviluppo, puoi creare immagini container personalizzate che estendono queste immagini di base per preinstallare strumenti e dipendenze ed eseguire script di automazione.

Per le immagini container personalizzate, consigliamo di configurare una pipeline per ricreare automaticamente queste immagini quando viene aggiornata l'immagine di base di Cloud Workstations, oltre a eseguire uno strumento di scansione dei container come Artifact Analysis per ispezionare eventuali dipendenze aggiuntive aggiunte. Sei responsabile della manutenzione e dell'aggiornamento dei pacchetti personalizzati e delle dipendenze aggiunte alle immagini personalizzate.

Prima di iniziare

  1. Hai bisogno di una macchina con strumenti per la creazione di immagini container come Docker e per il push delle immagini ad Artifact Registry (o Container Registry) utilizzando Google Cloud CLI. Puoi utilizzare Cloud Workstations o l'editor di Cloud Shell per eseguire questi passaggi, in cui questi strumenti sono preinstallati.

  2. Seleziona l'immagine di base che vuoi utilizzare dal nostro elenco di immagini di base supportate, ad esempio us-central1-docker.pkg.dev/cloud-workstations-images/predefined/code-oss:latest.

    In alternativa, puoi utilizzare la tua immagine container o immagini container esterne seguendo le istruzioni per utilizzare la tua immagine container.

  3. Crea una cartella come CUSTOM_IMAGE_FOLDER e un Dockerfile all'interno di questa cartella che estende l'immagine di base selezionata, come mostrato negli esempi che seguono.

Struttura delle immagini di base di Cloud Workstations

Le immagini di base di Cloud Workstations condividono la seguente struttura definita:

  • Il file del punto di ingresso dell'immagine di base è impostato su /google/scripts/entrypoint.sh.

  • All'avvio, le immagini di base eseguono i file in /etc/workstation-startup.d/* in ordine grammaticale per inizializzare l'ambiente di workstation.

    I file e il relativo comportamento sono i seguenti:

    • 000_configure-docker.sh: configura ed esegue Docker all'interno della workstation.

    • 010_add-user.sh: crea l'utente predefinito in Cloud Workstations.

      Poiché il disco permanente è collegato in modo dinamico al container, gli utenti devono essere aggiunti all'avvio della workstation, non nel Dockerfile.

    • 020_start-sshd.sh: avvia il servizio sshd nel container.

    • 110_start-$IDE.sh: avvia l'IDE per l'immagine.

  • Cloud Workstations archivia le immagini Docker nella home directory all'indirizzo /home/.docker_data, in modo che vengano conservate tra le sessioni.

Per aggiungere funzionalità aggiuntive durante l'avvio della workstation, aggiungi i tuoi script nella directory /etc/workstation-startup.d/:

  • Gli script in questa directory vengono eseguiti come root per impostazione predefinita. Per eseguire gli script come un altro utente, utilizza il comando runuser.

  • Poiché gli script vengono eseguiti in ordine grammaticale, ti consigliamo di precedere con un numero di tre cifre superiore a 200.

Modifiche della home directory

Quando la configurazione della workstation specifica una home directory permanente (che è il comportamento predefinito), un disco permanente che supporta la home directory viene collegato dinamicamente al container in fase di runtime. Questo processo sovrascrive le modifiche apportate alla directory /home al momento della creazione dell'immagine container.

Per mantenere gli aggiornamenti, modifica la directory /home al runtime del container aggiungendo uno script nella directory /etc/workstation-startup.d oppure aggiungendo una configurazione per utente nella directory /etc/profile.d. Per velocizzare il processo, valuta la possibilità di eseguire lo script di configurazione come processo in background (aggiungi una e commerciale, &, alla fine del comando) per evitare di bloccare l'avvio del container.

Ecco alcuni esempi di configurazione in fase di build che dovrebbe essere spostata nel runtime del container:

  • Configurazione di git per utente
  • git repository clonato nella home directory
  • Configurazione diretta dell'utente, ad esempio inserendo file in una directory $HOME/.config
  • Creazione utente

Creazione e modifica degli utenti

Poiché il disco permanente si collega dinamicamente al container in fase di runtime, gli utenti devono essere aggiunti all'avvio della workstation, non nel Dockerfile. Per modificare o creare altri utenti, ti consigliamo di aggiornare /etc/workstation-startup.d/010_add-user.sh o creare il tuo script da eseguire all'avvio.

Inoltre, puoi modificare il profilo bash predefinito per gli utenti aggiornando i file in /etc/profile.d.

Aggiorna chiavi Secure APT preconfigurate

Le immagini di base di Cloud Workstations sono preinstallate con una serie di strumenti ottenuti da vari repository di terze parti utilizzando Secure APT. Nell'ambito della procedura di installazione, le chiavi pubbliche fornite dai proprietari del repository vengono importate utilizzando gpg e inserite in singoli file all'interno di /usr/share/keyrings/. Questi file fanno riferimento ai file list corrispondenti in /etc/apt/sources.list.d/. In questo modo apt può verificare l'integrità di un determinato repository quando interagisce con il repository.

A volte, i proprietari di repository di terze parti possono decidere di cambiare la chiave pubblica utilizzata per convalidare l'integrità del repository; in questo modo apt mostra un errore durante l'interazione con il repository. Per risolvere questo potenziale problema, puoi utilizzare /google/scripts/refresh-preinstalled-apt-keys.sh, che ottiene le versioni più recenti delle chiavi pubbliche preinstallate e le reimporta.

Elenca le versioni IDE installate

Un IDE è preinstallato in diverse immagini base di Cloud Workstations. Per praticità, consulta lo script /google/scripts/preinstalled-ide-versions.sh incluso, che elenca le informazioni sul nome e sulla versione degli IDE installati nell'immagine.

Disattiva i privilegi root di sudo

L'utente della workstation predefinita dispone di sudo privilegi di accesso root in questi container. Per disattivare l'accesso root al container Docker, imposta la variabile di ambiente CLOUD_WORKSTATIONS_CONFIG_DISABLE_SUDO su true durante la creazione della configurazione della workstation.

Per impostare questa variabile di ambiente tramite la console Google Cloud durante la creazione della configurazione della workstation, segui questi passaggi:

  1. Quando crei la configurazione della workstation, completa le informazioni di base e la configurazione della macchina.
  2. Nella finestra di dialogo Personalizzazione dell'ambiente, espandi la sezione Opzioni contenitore avanzate e seleziona Variabili di ambiente.
  3. Fai clic su aggiungiAggiungi variabile.
  4. Inserisci CLOUD_WORKSTATIONS_CONFIG_DISABLE_SUDO e true come valore.

Utilizza la tua immagine container

Puoi anche utilizzare la tua immagine container o utilizzare immagini container esterne, a condizione che siano basate su Linux ed eseguano un processo di blocco all'avvio del container.

Durante la configurazione del Dockerfile, l'istruzione ENTRYPOINT deve eseguire un processo di blocco come sleep infinity in modo che l'esecuzione del container continui, anziché chiudersi immediatamente. In alternativa, nella configurazione della workstation puoi impostare il campo config.container.args per specificare un processo di blocco.

Quando utilizzi la tua immagine container, tieni presente quanto segue:

  • Cloud Workstations non richiede script aggiuntivi dall'immagine di base di Cloud Workstations.

    Tuttavia, puoi esaminare gli script nella directory /etc/workstation-startup.d/ all'interno di un container che esegue l'immagine di base di Cloud Workstations. I nomi file indicano lo scopo di ogni script.

  • Ti consigliamo di eseguire un server SSH nel container. Fai riferimento a /etc/workstation-startup.d/020_start-sshd.sh nell'immagine di base predefinita per scoprire come Cloud Workstations configura questa funzionalità per impostazione predefinita.

  • Ti consigliamo di eseguire l'IDE o il server web predefinito sulla porta 80.

Estendi le immagini di base di Cloud Workstations

Quando estendi un'immagine di base di Cloud Workstations per creare un'immagine personalizzata per il tuo ambiente di workstation, puoi adottare tre approcci:

  1. Aggiorna Dockerfile per includere eventuali altri asset statici che vuoi aggiungere.
  2. Aggiungi altri file eseguibili in /etc/workstation-startup.d/ per personalizzare il container in esecuzione. I file in questa directory vengono eseguiti automaticamente in ordine lessicografico all'avvio del container, quindi puoi specificare il nome del file come prefisso per eseguirlo nel momento appropriato durante l'avvio della workstation.
  3. Esegui l'override di ENTRYPOINT nel Dockerfile per personalizzare completamente l'avvio del container.

Dockerfile personalizzati di esempio

Questa sezione fornisce scenari di esempio e istruzioni per la creazione di Dockerfile.

Immagine container con emacs preinstallato

Per creare un'immagine container con emacs preinstallato, esegui questi comandi:

FROM us-central1-docker.pkg.dev/cloud-workstations-images/predefined/code-oss:latest

RUN sudo apt update
RUN sudo apt install -y emacs

Immagine container con personalizzazione dell'utente

Per personalizzare un'immagine container:

  1. Crea uno script in /etc/workstation-startup.d/* che venga eseguito dopo 010_add-user.sh, ad esempio 011_customize-user.sh:

    #!/bin/bash
# Create new group
groupadd $GROUP
# Add the user to a new group
usermod -a -G $GROUP $USERNAME

    Sostituisci $GROUP con il nuovo nome del gruppo e $USERNAME con il nome utente dell'utente.

  2. Supponendo che tu abbia denominato lo script 011_customize-user.sh, aggiungi quanto segue all'immagine nel Dockerfile e rendila eseguibile:

    FROM us-central1-docker.pkg.dev/cloud-workstations-images/predefined/code-oss:latest

COPY 011_customize-user.sh /etc/workstation-startup.d/

RUN chmod +x /etc/workstation-startup.d/011_customize-user.sh

Immagine container che imposta le variabili di ambiente del container nelle sessioni SSH

Le variabili di ambiente impostate a livello di configurazione della workstation o di workstation vengono passate ai processi secondari diretti utilizzando il comando del punto di ingresso. Questo include l'IDE nelle immagini di base preconfigurate. Tuttavia, le sessioni SSH non sono processi figlio del punto di ingresso e non hanno queste variabili di ambiente personalizzate impostate.

Per impostare queste variabili di ambiente nelle sessioni SSH, configura un'immagine container personalizzata che inoltri queste variabili di ambiente dal comando entrypoint del container al file /etc/environment.

Per farlo, segui questi passaggi:

  1. Crea uno script in /etc/workstation-startup.d/* che venga eseguito dopo 010_add-user.sh, ad esempio 011_add-ssh-env-variables.sh:

    #!/bin/bash
#
echo "CUSTOM_ENV_VAR=$CUSTOM_ENV_VAR" >> /etc/environment

    Sostituisci CUSTOM_ENV_VAR con il nome della variabile di ambiente previsto.

  2. Supponendo che tu abbia denominato lo script 011_add-ssh-env-variables.sh, aggiungi quanto segue all'immagine nel Dockerfile e rendila eseguibile:

    FROM us-central1-docker.pkg.dev/cloud-workstations-images/predefined/code-oss:latest

COPY 011_add-ssh-env-variables.sh /etc/workstation-startup.d/

RUN chmod +x /etc/workstation-startup.d/011_add-ssh-env-variables.sh

Immagine container che abilita l'inoltro X11 per le sessioni SSH

L'inoltro X11 consente di avviare applicazioni remote e inoltrare la visualizzazione dell'applicazione a una macchina locale.

Per creare un'immagine container che abilita il forwarding X11, modifica il file di configurazione del daemon OpenSSH (/etc/ssh/sshd_config) fornito dalle immagini di base di Cloud Workstations aggiungendo X11Forwarding yes (per consentire l'inoltro X11) e AddressFamily inet (per garantire che venga utilizzato solo IPv4). Per maggiori informazioni su queste parole chiave, consulta le pagine web di OpenBSD su AddressFamily e X11Forwarding.

Ecco un Dockerfile di esempio, che apporta le modifiche necessarie:

FROM us-central1-docker.pkg.dev/cloud-workstations-images/predefined/code-oss:latest

# Permit X11 forwarding using only IPv4
RUN cat >> /etc/ssh/sshd_config <<-EOF

AddressFamily inet
X11Forwarding yes
EOF

Copia OSS del codice per Cloud Workstations in un'altra immagine container

Una build in più fasi consente di utilizzare più istruzioni FROM nel Dockerfile. Ogni istruzione FROM può utilizzare una base diversa e consente di copiare gli artefatti tra le fasi di build. Per aggiungere Code OSS per Cloud Workstations a un'altra immagine container, utilizza una build in più fasi per copiare la cartella dell'applicazione /opt/code-oss nell'immagine. Se vuoi avviare Code OSS per Cloud Workstations al momento dell'avvio del container, copia anche lo script /etc/workstation-startup.d/110_start-code-oss.sh nel container.

Ecco un Dockerfile di esempio che copia il codice OSS nell'immagine JetBrains IntelliJ Ultimate. Puoi quindi interagire con uno dei due IDE:

FROM us-central1-docker.pkg.dev/cloud-workstations-images/predefined/code-oss:latest as code-oss-image

FROM us-central1-docker.pkg.dev/cloud-workstations-images/predefined/jetbrains-intellij:latest

# Copy Code OSS for Cloud Workstations and startup scripts into our custom image
COPY --from=code-oss-image /opt/code-oss /opt/code-oss
COPY --from=code-oss-image /etc/workstation-startup.d/110_start-code-oss.sh /etc/workstation-startup.d/110_start-code-oss.sh

# Use the existing entrypoint script which will execute all scripts in /etc/workstation-startup.d/
ENTRYPOINT ["/google/scripts/entrypoint.sh"]

Immagine container che preinstalla le estensioni IDE in Code OSS per Cloud Workstations per lo sviluppo Java

Per creare un'immagine container che preinstalla le estensioni IDE in Code OSS per Cloud Workstations per lo sviluppo Java al momento della creazione, esegui questi comandi:

FROM us-central1-docker.pkg.dev/cloud-workstations-images/predefined/code-oss:latest

RUN wget https://open-vsx.org/api/vscjava/vscode-java-debug/0.40.1/file/vscjava.vscode-java-debug-0.40.1.vsix && \
unzip vscjava.vscode-java-debug-0.40.1.vsix "extension/*" &&\
mv extension /opt/code-oss/extensions/java-debug

RUN wget https://open-vsx.org/api/vscjava/vscode-java-dependency/0.19.1/file/vscjava.vscode-java-dependency-0.19.1.vsix && \
unzip vscjava.vscode-java-dependency-0.19.1.vsix "extension/*" &&\
mv extension /opt/code-oss/extensions/java-dependency

RUN wget https://open-vsx.org/api/redhat/java/1.6.0/file/redhat.java-1.6.0.vsix && \
unzip redhat.java-1.6.0.vsix "extension/*" &&\
mv extension /opt/code-oss/extensions/redhat-java

RUN wget https://open-vsx.org/api/vscjava/vscode-maven/0.35.2/file/vscjava.vscode-maven-0.35.2.vsix && \
unzip vscjava.vscode-maven-0.35.2.vsix "extension/*" &&\
mv extension /opt/code-oss/extensions/java-maven

RUN wget https://open-vsx.org/api/vscjava/vscode-java-test/0.35.0/file/vscjava.vscode-java-test-0.35.0.vsix && \
unzip vscjava.vscode-java-test-0.35.0.vsix "extension/*" &&\
mv extension /opt/code-oss/extensions/java-test

Le estensioni preinstallate sono considerate estensioni integrate. Non potrai aggiornare queste estensioni, che potrebbero non essere visualizzate nella sezione dedicata alle estensioni del marketplace delle estensioni. Tuttavia, puoi trovare le estensioni integrate cercando @builtin.

Un altro modo per installare le estensioni all'avvio è eseguire uno script di avvio. Ad esempio, includi il seguente script di avvio in /etc/workstation-startup.d/120_install_extensions.sh:

/opt/code-oss/bin/codeoss-cloudworkstations --install-extension vscjava.vscode-java-debug@0.40.1 \
--install-extension vscjava.vscode-java-dependency@0.19.1  \
--install-extension redhat.java@1.6.0 \
--install-extension vscjava.vscode-maven@0.35.2 \
--install-extension vscjava.vscode-java-test@0.35.0

Con questo metodo, l'estensione viene visualizzata su Estensioni Marketplace e puoi eseguire l'aggiornamento da lì.

Installa gli IDE e i plug-in JetBrains nelle immagini di base

Quando personalizzi le immagini Docker per le configurazioni di workstation, puoi installare gli IDE e i plug-in JetBrains, come Cloud Code for IntelliJ, nell'immagine di base. Le immagini di base di Cloud Workstations per i prodotti JetBrains includono i seguenti script per aiutarti:

  • jetbrains-installer.sh: installa gli IDE JetBrains
  • plugin-installer.sh: installa plug-in, ad esempio Cloud Code for IntelliJ

Utilizza questi script in base alle esigenze per personalizzare l'immagine di base, chiamarli con uno script di avvio o eseguirli dopo aver avviato la workstation.

Script del programma di installazione

Per visualizzare i file di origine per gli script jetbrains-installer.sh e plugin-installer.sh, avvia una workstation utilizzando una configurazione di workstation che utilizzi una delle immagini predefinite di JetBrains, connettiti alla workstation tramite il gateway JetBrains o mediante SSH, quindi sfoglia i file di script nella directory installer-scripts, che si trova nella directory principale.

Ti consigliamo di eseguire questi script al momento della creazione del container. Evita di eseguirli su una workstation già avviata.

Utilizza lo script del programma di installazione del plug-in

Lo script plugin-installer.sh utilizza la seguente sintassi:

plugin-installer.sh [-v VERSION] [-d DESTINATION-DIRECTORY] [-c CHECKSUM] [-f] PLUGIN_ID

Sostituisci quanto segue:

  • VERSION: numero di versione facoltativo del plug-in da installare.
  • DESTINATION-DIRECTORY: directory facoltativa in cui deve essere installato il plug-in. Se non specificato, viene utilizzata la directory di lavoro.
  • CHECKSUM: checksum SHA-256 facoltativo del plug-in richiesto.
  • -f: se specificato, tutti i plug-in esistenti verranno sovrascritti.
  • PLUGIN_ID: l'identificatore numerico del plug-in richiesto dal marketplace JetBrains. Ad esempio, per aggiungere Dart, utilizza 6351 come PLUGIN_ID. Per aggiungere Cloud Code for IntelliJ utilizza 8079 come PLUGIN_ID.

Ad esempio, per installare la versione più recente del plug-in Dart in IntelliJ, esegui questo comando:

plugin-installer.sh -d /opt/ideaIU/plugins/ 6351

Usa lo script del programma di installazione di JetBrains

Ti consigliamo di utilizzare lo script del programma di installazione JetBrains quando estende un'immagine di base preconfigurata per gli IDE JetBrains.

Lo script jetbrains-installer.sh utilizza la seguente sintassi:

jetbrains-installer.sh IDE [ pinned|latest ]

Sostituisci quanto segue:

  • IDE: l'IDE JetBrains da installare. Devi utilizzare una delle seguenti abbreviazioni dell'IDE:

    IDE Prodotto installato
    cl CLion
    clion CLion
    go GoLand
    goland GoLand
    iiu Intellij Ultimate
    intellij Intellij Ultimate
    pcp Professionista PyCharm
    pycharm Professionista PyCharm
    ps PHPStorm
    phpstorm PHPStorm
    rd Passeggero
    rider Passeggero
    rm RubyMine
    rubymine RubyMine
    ws WebStorm
    webstorm WebStorm

  • pinned|latest: facoltativo - Utilizza la versione bloccata o l'ultima dell'IDE. Il valore predefinito è latest.

Ad esempio, per installare la versione più recente di Clion, esegui questo comando:

jetbrains-installer.sh clion

Personalizza i file di configurazione dell'IDE JetBrains

Se nella configurazione delle workstation viene specificata una home directory permanente, le immagini di base di Cloud Workstations con gli IDE JetBrains memorizzano automaticamente i file di configurazione $IDE.vmoptions e $IDE.properties. Per eseguire l'override della posizione predefinita di questi file, specifica la variabile di ambiente CLOUD_WORKSTATIONS_JETBRAINS_PERISTED_CONFIG_DIR.

Per saperne di più, consulta /etc/workstation-startup.d/120_persist-jetbrains-configs.sh in qualsiasi immagine di base di JetBrains per scoprire in che modo Cloud Workstations esegue la configurazione per impostazione predefinita.

Estendi un'immagine Docker di base con Cloud Code for IntelliJ

Il seguente snippet Dockerfile estende un'immagine Docker di base con Cloud Code for IntelliJ includendo 8079 come identificatore del plug-in richiesto. Facoltativamente, l'esempio specifica version 22.9.3-222 come numero di versione, /opt/ideaIU/plugins/ come directory di destinazione e 89628279ed9042c526a81facc09bf53f8fb8b83b4595b0d329d94c1611e0c379 come checksum:

...
# Install IDE and Plugins
RUN bash /installer-scripts/jetbrains-installer.sh intellij pinned && \
  # Install Cloud Code - https://plugins.jetbrains.com/plugin/8079-cloud-code
  bash /installer-scripts/plugin-installer.sh \
      -v 22.9.3-222 \
      -d /opt/ideaIU/plugins/ \
      -c 89628279ed9042c526a81facc09bf53f8fb8b83b4595b0d329d94c1611e0c379 \
      8079

# Register IDE with JetBrains Gateway
RUN echo 'runuser user -c "/opt/ideaIU/bin/remote-dev-server.sh registerBackendLocationForGateway"' > /etc/workstation-startup.d/110_register-intellij-with-gateway.sh \
    echo 'echo "IntelliJ-Ultimate ready for incoming gateway connection"' >> /etc/workstation-startup.d/110_register-intellij-with-gateway.sh
...

Installa estensioni IDE aggiuntive in Code OSS per Cloud Workstations

Puoi trovare altre estensioni IDE in Open VSX Registry. Puoi trovare l'URL del file .vsix anche copiandolo dal link Scarica di qualsiasi estensione.

Apri la pagina VSX per l&#39;estensione della lingua Go in cui è visualizzato il pulsante Scarica.

Se apri Estensioni Marketplace da una workstation, viene visualizzata l'opzione Installa anziché Scarica.

Impostazioni del sistema operativo del codice predefinito per Cloud Workstations

Per informazioni dettagliate sull'archiviazione delle impostazioni in Code OSS per Cloud Workstations, consulta Personalizzare le impostazioni.

Se specifichi una home directory permanente nella configurazione delle workstation, puoi configurare le impostazioni predefinite per Code OSS per Cloud Workstations aggiungendo uno script di avvio che scrive le impostazioni in $HOME/.codeoss-cloudworkstations/data/Machine/settings.json.

Ad esempio, se vuoi impostare il tema cromatico predefinito su Scuro, estendi l'immagine dell'editor di base per includere il seguente script in /etc/workstation-startup.d/150_default-ide-color-theme.sh

cat <<< $(jq '. += {"workbench.colorTheme": "Default Dark Modern"}' settings.json) > settings.json

Crea un'immagine container personalizzata

Per informazioni dettagliate sui comandi Docker, consulta la documentazione di riferimento di Docker. Inserisci questo comando per creare il tuo container:

docker build CUSTOM_IMAGE_FOLDER -t TARGET_IMAGE

Tieni presente che la sostituzione del testo che precede l'icona Modifica Modifica aggiorna gli altri esempi in questa pagina.

Sostituisci quanto segue:

  • CUSTOM_IMAGE_FOLDER: il percorso della cartella creata per archiviare l'immagine personalizzata.

  • TARGET_IMAGE: il percorso dell'immagine in Artifact Registry (o Container Registry).

    Ad esempio, TARGET_IMAGE potrebbe puntare a un percorso dell'immagine di destinazione simile a uno dei seguenti percorsi:

    *.pkg.dev/cloud-workstations-external/customimage:latest

*.gcr.io/cloud-workstations-external/customimage:latest

    Se necessario, sostituisci * con il nome della regione ed eventuali identificatori aggiuntivi.

Puoi anche aggiornare la variabile di ambiente CLOUD_WORKSTATIONS_CUSTOM_IMAGE in modo che punti al repository.

Per ulteriori informazioni sull'archiviazione di immagini Docker in Artifact Registry, consulta le seguenti sezioni:

Ospita l'immagine container personalizzata

Per ospitare immagini container personalizzate, consigliamo e supportiamo Artifact Registry. Se utilizzi GitHub o qualsiasi altro repository pubblico o privato, Cloud Workstations potrebbe non funzionare come previsto. Per ulteriori informazioni, consulta la nota importante nella sezione Utilizzare un'immagine container personalizzata.

Testa l'immagine container personalizzata

Al termine della creazione del container, puoi testarlo con il seguente comando:

docker run --privileged -p LOCAL_PORT:CONTAINER_PORT TARGET_IMAGE

Sostituisci quanto segue:

  • LOCAL_PORT: il numero di porta locale
  • CONTAINER_PORT: il numero di porta del container

Ad esempio, se sostituisci LOCAL_PORT:CONTAINER_PORT con 8080:80, viene assegnata la porta 8080 da utilizzare localmente e la porta 80 da utilizzare nel container.

Se stai estendendo l'immagine dell'editor di base di Cloud Workstations, esegui il comando docker e poi testa l'immagine della workstation connettendoti alla workstation tramite il browser locale o eseguendo ssh per connetterti al container:

  • Se ti connetti tramite browser, assicurati di passare -p 8080:80 al tuo comando docker run, quindi apri localhost:8080.
  • Se preferisci connetterti tramite SSH, assicurati di passare -p 2222:22 al comando docker run ed esegui ssh user@localhost -p 2222.

Utilizza un'immagine container personalizzata

Per utilizzare l'immagine container personalizzata dopo averla creata e testata localmente, esegui il push del container ad Artifact Registry (o Container Registry) con il seguente comando:

docker push TARGET_IMAGE

Ora puoi creare una configurazione di workstation utilizzando l'immagine container che hai appena creato e di cui hai eseguito il push.

Per maggiori informazioni, vedi Creare un repository Docker con Artifact Registry.

Eseguire il debug dei problemi

Per trovare ed eseguire il debug dei problemi che eseguono l'immagine container, esamina i log di output del container sulle workstation in esecuzione.

Sei responsabile della manutenzione e dell'aggiornamento dei pacchetti personalizzati e delle dipendenze aggiunte alle immagini personalizzate.

Se stai creando immagini personalizzate, ti consigliamo quanto segue:

Passaggi successivi