Connexion à Oracle Cloud Infrastructure Registry

Découvrez comment vous connecter à Oracle Cloud Infrastructure Registry pour l'utiliser avec OCI Functions.

Avant d'utiliser OCI Functions, vous devez connecter Docker au registre Docker dans lequel vous allez stocker vos fonctions sous forme d'images Docker. Il s'agit du registre Docker indiqué dans le contexte de l'interface de ligne de commande du projet Fn (reportez-vous à Création d'un contexte d'interface de ligne de commande de projet Fn pour la connexion à Oracle Cloud Infrastructure).

Vous pouvez stocker des fonctions dans des référentiels publics et privés dans Oracle Cloud Infrastructure Registry, un registre géré par Oracle et construit sur Oracle Cloud Infrastructure.

Lorsque vous connectez Docker à un registre Docker, vous devez fournir les détails d'authentification appropriés. Par exemple, dans le cas d'Oracle Cloud Infrastructure Registry, vous devez fournir l'espace de noms Object Storage de la location, le nom utilisateur et le jeton d'authentification de l'utilisateur.

Si vous utilisez Cloud Shell en tant qu'environnement de développement, il vous suffit de copier et de coller des commandes à partir de la page Introduction dans la fenêtre Cloud Shell. Pour plus d'informations, reportez-vous au guide QuickStart d'OCI Functions on Cloud Shell.

Les instructions de cette rubrique sont basées sur les principes suivants :

• vous n'utilisez pas Cloud Shell en tant qu'environnement de développement
• Vous utilisez Linux.
• vous avez déjà effectué les étapes de Démarrage de Docker

Pour connecter Docker à Oracle Cloud Infrastructure Registry, procédez comme suit :

1. Connectez-vous à votre environnement de développement en tant que développeur de fonctions.

2. Dans une fenêtre de terminal, connectez-vous à Oracle Cloud Infrastructure Registry en saisissant la commande suivante :

   docker login <region-key>.ocir.io

   où <region-key> représente la clé de la région Oracle Cloud Infrastructure Registry indiquée dans le contexte d'interface de ligne de commande du projet Fn (reportez-vous à Création d'un contexte d'interface de ligne de commande de projet Fn pour la connexion à Oracle Cloud Infrastructure). Par exemple : phx pour Phoenix. Reportez-vous à Disponibilité par région.

   Par exemple :

   docker login phx.ocir.io

3. Lorsque le nom utilisateur vous est demandé, saisissez le nom de l'utilisateur que vous utiliserez avec OCI Functions pour créer et déployer les fonctions, au format :

   <tenancy-namespace>/<username>

   où <tenancy-namespace> représente la chaîne d'espace de noms Object Storage générée automatiquement pour la location dans laquelle créer les référentiels (comme indiquée sur la page Informations sur la location). Par exemple : ansh81vru1zp/jdoe@acme.com.

   Pour certaines locations antérieures, la chaîne d'espace de noms peut être identique au nom de la location en minuscules (par exemple, acme-dev).

   Si votre location est fédérée avec Oracle Identity Cloud Service, utilisez le format <tenancy-namespace>/<domain-name>/<username>. Pour les utilisateurs fédérés, <domain-name>/<username> est affiché dans le menu Profil de la console. Par exemple, si la chaîne d'espace de noms de votre location est ansh81vru1zp et que votre location est fédérée avec Oracle Identity Cloud Service, et que votre nom utilisateur est jdoe@acme.com, entrez ansh81vru1zp/oracleidentitycloudservice/jdoe@acme.com.

   Vous avez déjà généré un jeton d'authentification Oracle Cloud Infrastructure pour l'utilisateur indiqué (reportez-vous à Génération d'un jeton d'authentification afin d'autoriser la connexion à Oracle Cloud Infrastructure Registry).

4. Saisissez le mot de passe Oracle Cloud Infrastructure de l'utilisateur lorsque vous lui demandez de le faire. Une fois le mot de passe saisi, Docker peut vous avertir que le mot de passe est stocké de façon non cryptée dans le fichier de configuration Docker. Cet avertissement inclut un lien vers la documentation Docker où vous pouvez trouver comment configurer une application d'aide relative aux informations d'identification. Nous vous recommandons de consulter les informations dans la documentation Docker et d'utiliser une banque d'informations d'identification externe pour renforcer la sécurité.

Une fois les étapes de cette rubrique terminées, vous avez effectué les tâches de configuration de votre environnement client. Accédez à Vérification de la configuration pour le développement de fonctions pour vérifier que l'interface de ligne de commande du projet Fn peut communiquer avec l'adresse d'API.