Documentazione di Oracle Cloud Infrastructure

Pull delle immagini mediante l'interfaccia CLI Docker

Scopri come estrarre le immagini da Container Registry utilizzando l'interfaccia CLI Docker.

Puoi utilizzare l'interfaccia CLI Docker per estrarre immagini da Oracle Cloud Infrastructure Registry (noto anche come Container Registry).

Le autorizzazioni controllano le immagini che è possibile estrarre da Container Registry (vedere Criteri per il controllo dell'accesso al repository). È possibile estrarre le immagini dai repository creati, dai repository pubblici e dai repository ai quali i criteri di identità hanno concesso l'accesso ai gruppi ai quali si appartiene. Se si appartiene al gruppo Administrators, è possibile estrarre le immagini da qualsiasi repository della tenancy.

Nota

Container Registry è un registro conforme a Open Container Initiative. Di conseguenza, è possibile memorizzare tutti gli artifact conformi alle specifiche di Open Container Initiative, ad esempio immagini Docker, elenchi di manifesti (a volte noti come immagini multi-architettura) e grafici Helm. Le istruzioni riportate in questo argomento presuppongono la memorizzazione delle immagini Docker e l'utilizzo dell'interfaccia CLI Docker.

Per estrarre le immagini da Container Registry utilizzando l'interfaccia CLI Docker:

  1. Se si dispone già di un token di autenticazione, andare al passo successivo. Altrimenti:

    1. Nell'angolo superiore destro della console aprire il menu Profilo Icona menu Profilo, quindi selezionare Impostazioni utente (o Profilo personale o nome account) per visualizzare i dettagli.

    2. Nella pagina Token di autenticazione selezionare Genera token.

    3. Immettere una descrizione per il token di autenticazione. Evitare di inserire informazioni riservate.

    4. Selezionare Genera token. Viene visualizzato il nuovo token di autenticazione.

    5. Copiare immediatamente il token di autenticazione in una posizione sicura da cui è possibile recuperarlo in seguito, poiché il token di autenticazione non verrà più visualizzato nella console.

    6. Chiudere la finestra di dialogo Genera token.

  2. In una finestra terminale sul computer client su cui è in esecuzione Docker, eseguire il login a Container Registry immettendo docker login <registry-domain>, dove <registry-domain> include una chiave dell'area o un identificativo dell'area per l'area Container Registry in uso. Ad esempio, docker login ocir.us-ashburn-1.oci.oraclecloud.com. Vedere Disponibilità per area.

  3. Quando viene richiesto un nome utente, immettere il nome utente nel formato <tenancy-namespace>/<username>, dove <tenancy-namespace> è la stringa dello spazio di nomi dello storage degli oggetti generata automaticamente della tenancy (come mostrato nella pagina Informazioni sulla tenancy). Ad esempio, ansh81vru1zp/jdoe@acme.com.

    Se la tenancy è federata con Oracle Identity Cloud Service, utilizzare il formato <tenancy-namespace>/<domain-name>/<username>. Per gli utenti federati, <domain-name>/<username> viene visualizzato nel menu Profilo Icona menu Profilo nella console. Ad esempio, se la stringa dello spazio di nomi della tenancy è ansh81vru1zp e la tenancy è federata con Oracle Identity Cloud Service, il nome utente è jdoe@acme.com, quindi immettere ansh81vru1zp/oracleidentitycloudservice/jdoe@acme.com.

  4. Quando viene richiesta una password, immettere il token di autenticazione copiato in precedenza.

  5. Estrarre l'immagine Docker da Container Registry al computer client immettendo:

    docker pull <registry-domain>/<tenancy-namespace>/<repo-name>:<version>

    Dove:

    • <registry-domain> include la chiave dell'area o l'identificativo dell'area per l'area Container Registry in uso. Ad esempio, ocir.us-ashburn-1.oci.oraclecloud.com. Vedere dominio di registro.

    • <tenancy-namespace> è la stringa dello spazio di nomi dello storage degli oggetti generata automaticamente della tenancy che possiede il repository da cui si desidera estrarre l'immagine (come mostrato nella pagina Informazioni sulla tenancy). Ad esempio, lo spazio di nomi della tenancy acme-dev potrebbe essere ansh81vru1zp. Tenere presente che per alcune tenancy meno recenti, la stringa dello spazio di nomi potrebbe essere uguale al nome della tenancy in tutte le lettere minuscole (ad esempio, acme-dev). Tenere inoltre presente che l'utente deve avere accesso alla tenancy.

    • <repo-name> è il nome di un repository da cui si desidera estrarre l'immagine (ad esempio, project01/acme-web-app). Tenere presente che l'utente deve disporre dell'accesso al repository (vedere Repository).

    • <version> è l'identificativo della versione dell'immagine che si desidera estrarre da Container Registry (ad esempio, v2.0.test).

    Ad esempio:

    docker pull ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp/project01/acme-web-app:v2.0.test

    Se non si specifica un valore <version> nel comando docker pull, Docker estrae l'immagine con l'identificativo della versione latest.

  6. Verificare che l'immagine sia stata estratta da Container Registry immettendo docker images e verificando che l'elenco delle immagini sul computer client ora includa l'immagine appena estratta.

    Ad esempio:

    
$ docker images
REPOSITORY                                                                TAG                   IMAGE ID      CREATED       SIZE
ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp/project01/acme-web-app v2.0.test             8e0506e14874  1 minute ago  162.6 MB
acme-web-app                                                              latest                8e0506e14874  2 hours ago   162.6 MB
acme-web-app                                                              v1.0                  7d9495d03763  2 hours ago   162.6 MB
<none>                                                                    <none>                6ebd328f833d  5 hours ago   162.6 MB
hello-world                                                               latest                80b84820d442  5 weeks ago   890 B