Login a Oracle Cloud Infrastructure Registry

Scopri come eseguire il login a Oracle Cloud Infrastructure Registry per l'uso con OCI Functions.

Prima di utilizzare OCI Functions, devi registrare Docker nel registro Docker in cui memorizzerai le tue funzioni come immagini Docker. Registro di sistema Docker specificato nel contesto CLI di Fn Project (vedere Creazione di un contesto CLI di Fn Project per connettersi a Oracle Cloud Infrastructure).

Puoi memorizzare le funzioni in repository pubblici e privati in Oracle Cloud Infrastructure Registry, un registro gestito da Oracle e basato su Oracle Cloud Infrastructure.

Quando registri Docker in un registro Docker, devi fornire i dettagli di autenticazione appropriati. Ad esempio, nel caso di Oracle Cloud Infrastructure Registry, è necessario fornire lo spazio di nomi dello storage degli oggetti della tenancy, il nome utente e il token di autenticazione dell'utente.

Se si utilizza Cloud Shell come ambiente di sviluppo, è sufficiente copiare e incollare i comandi dalla pagina Guida introduttiva nella finestra Cloud Shell. Per ulteriori informazioni, vedere il manuale OCI Functions on Cloud Shell QuickStart Guide.

Le istruzioni riportate in questo argomento presuppongono quanto segue.

• non si utilizza Cloud Shell come ambiente di sviluppo
• stai usando Linux
• è già stata completata la procedura descritta in Avvio di Docker

Per registrare Docker in Oracle Cloud Infrastructure Registry:

1. Accedere all'ambiente di sviluppo come sviluppatore di funzioni.

2. In una finestra del terminale, eseguire il login a Oracle Cloud Infrastructure Registry immettendo:

   docker login <region-key>.ocir.io

   dove <region-key> è la chiave per l'area Oracle Cloud Infrastructure Registry specificata nel contesto CLI di Fn Project (vedere Creazione di un contesto CLI di un progetto Fn per connettersi a Oracle Cloud Infrastructure). Ad esempio, phx per Phoenix. Vedere Disponibilità per area.

   Ad esempio:

   docker login phx.ocir.io

3. Quando viene richiesto di immettere il nome utente, immettere il nome dell'utente che si utilizzerà con OCI Functions per creare e distribuire le funzioni nel formato:

   <tenancy-namespace>/<username>

   dove <tenancy-namespace> è la stringa dello spazio di nomi dello storage degli oggetti generata automaticamente della tenancy in cui creare i repository (come mostrato nella pagina Informazioni sulla tenancy). Ad esempio, ansh81vru1zp/jdoe@acme.com.

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

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

   È necessario aver già generato un token di autenticazione Oracle Cloud Infrastructure per l'utente specificato (vedere Generazione di un token di autenticazione per abilitare il login a Oracle Cloud Infrastructure Registry).

4. Quando viene richiesto di immettere la password, immettere il token di autenticazione di Oracle Cloud Infrastructure dell'utente. Dopo aver immesso la password, Docker potrebbe avvisare che la password viene memorizzata non cifrata nel file di configurazione Docker. L'avvertenza include un collegamento alla documentazione Docker in cui è possibile scoprire come configurare un'applicazione di supporto per le credenziali. Si consiglia di esaminare le informazioni contenute nella documentazione Docker e di utilizzare un'area di memorizzazione delle credenziali esterna per aumentare la sicurezza.

Dopo aver completato i passi di questo argomento, sono stati completati i task di configurazione per l'ambiente client. Passare a Verifica della configurazione per lo sviluppo delle funzioni per confermare che l'interfaccia CLI di Fn Project può comunicare con l'endpoint API.