Artifact Registry ti consente di autenticare i repository remoti su Docker Hub. Sebbene il pull di immagini pubbliche non richieda l'autenticazione, l'autenticazione aumenta il limite di frequenza di download. Per l'autenticazione, configura il repository remoto con il tuo nome utente Docker Hub e un token di accesso personale salvato come secret.
Prima di iniziare
Verifica i seguenti requisiti:
- Hai creato un repository remoto Docker di Artifact Registry
- Hai un account Docker Hub.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per configurare l'autenticazione in Docker Hub per i repository remoti, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:
- Artifact Registry Admin (
roles/artifactregistry.admin) - Secret Manager Admin (
roles/secretmanager.admin)
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Crea un token di accesso personale Docker Hub
- Accedi a Docker Hub.
- Crea un token di accesso personale con autorizzazioni di sola lettura.
Copia il token di accesso.
Salva il token di accesso in un file di testo in locale o in Cloud Shell.
Salva il tuo token di accesso personale in una versione del secret
- Crea un secret in Secret Manager.
- Salva il tuo token di accesso personale Docker Hub come versione del secret.
Concedi al account di servizio Artifact Registry l'accesso al tuo secret
L'agente di servizio Artifact Registry agisce per conto di Artifact Registry quando interagisce con i servizi Google Cloud . Per consentire all'agente di servizio di utilizzare i secret archiviati in Secret Manager, devi concedergli l'autorizzazione per visualizzare la versione del secret.
L'identificatore dell'agente di servizio è:
service-PROJECT-NUMBER@gcp-sa-artifactregistry.iam.gserviceaccount.com
PROJECT-NUMBER è il numero di progetto del progetto Google Cloud in cui è in esecuzione Artifact Registry.
Per concedere all'agente di servizio Artifact Registry il ruolo Secret Manager Secret Accessor:
Console
-
Vai alla pagina Secret Manager nella console Google Cloud .
-
Nella pagina Secret Manager, fai clic sulla casella di controllo accanto al nome del secret.
-
Se non è già aperto, fai clic su Mostra riquadro informazioni per aprire il riquadro.
-
Nel riquadro informazioni, fai clic su Aggiungi entità.
-
Nell'area di testo Nuove entità, inserisci gli indirizzi email dei membri da aggiungere.
-
Nel menu a discesa Seleziona un ruolo, scegli Secret Manager e poi Secret Manager Secret Accessor.
gcloud
$ gcloud secrets add-iam-policy-binding secret-id \
--member="member" \
--role="roles/secretmanager.secretAccessor"
Dove member è un membro IAM, ad esempio un utente, un gruppo o un account di servizio.
C#
Per eseguire l'autenticazione in Artifact Registry, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per eseguire l'autenticazione in Artifact Registry, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per eseguire l'autenticazione in Artifact Registry, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per eseguire l'autenticazione in Artifact Registry, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per eseguire l'autenticazione in Artifact Registry, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per eseguire l'autenticazione in Artifact Registry, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per eseguire l'autenticazione in Artifact Registry, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
API
Nota: a differenza degli altri esempi, questo sostituisce l'intera policy IAM.
$ curl "https://secretmanager.googleapis.com/v1/projects/project-id/secrets/secret-id:setIamPolicy" \
--request "POST" \
--header "authorization: Bearer $(gcloud auth print-access-token)" \
--header "content-type: application/json" \
--data "{\"policy\": {\"bindings\": [{\"members\": [\"member\"], \"role\": \"roles/secretmanager.secretAccessor\"}]}}"
Per saperne di più sulla concessione o sulla revoca dell'accesso ai secret, consulta Gestisci l'accesso ai secret.
Aggiungi le credenziali di Docker Hub al tuo repository remoto
Per aggiornare il repository remoto con le tue credenziali Docker Hub:
Console
Apri la pagina Repository nella console Google Cloud .
Nell'elenco dei repository, seleziona il repository e fai clic su Modifica repository.
Nella sezione Modalità di autenticazione del repository remoto, aggiorna o aggiungi il tuo nome utente Docker Hub e la versione del secret contenente il token di accesso Docker Hub.
gcloud CLI
Per aggiornare il repository remoto con le tue credenziali Docker Hub, esegui il seguente comando:
gcloud artifacts repositories update REPOSITORY \
--project=PROJECT_ID \
--location=LOCATION \
--remote-username=USERNAME \
--remote-password-secret-version=projects/SECRET_PROJECT_ID/secrets/SECRET_ID/versions/SECRET_VERSION
Sostituisci quanto segue:
REPOSITORY: il nome del tuo repository remoto Artifact Registry.PROJECT_ID: il tuo ID progetto Google Cloud .LOCATION: la località regionale o multiregionale del repository. Puoi omettere questo flag se imposti un valore predefinito. Per visualizzare un elenco delle località supportate, esegui il comandogcloud artifacts locations list.USERNAME: il tuo nome utente Docker Hub.SECRET_PROJECT_ID: l'ID progetto del progettoGoogle Cloud in cui hai creato il secret.SECRET_ID: il nome che hai assegnato al secret.SECRET_VERSION: la versione del secret in cui hai salvato il token di accesso a Docker Hub.
Le tue credenziali vengono utilizzate la volta successiva che il repository remoto invia una richiesta per un artefatto dall'origine upstream.
Passaggi successivi
- Scopri di più sui repository di Artifact Registry.
- Esegui il pull delle immagini con Docker.
- Consulta la guida rapida per il repository remoto di Docker Hub.