Documentación de Oracle Cloud Infrastructure

Conexión a Oracle Cloud Infrastructure Registry

Descubra cómo conectarse a Oracle Cloud Infrastructure Registry para utilizarlo con OCI Functions.

Antes de utilizar OCI Functions, debe conectar Docker al registro de Docker en el que almacenará las funciones como imágenes de Docker. Este es el registro de Docker especificado en el contexto de la CLI de Fn Project (consulte Creación de un contexto de la CLI de Fn Project para conectarse a Oracle Cloud Infrastructure).

Puede almacenar funciones en repositorios públicos y privados en Oracle Cloud Infrastructure Registry, un registro gestionado por Oracle incorporado en Oracle Cloud Infrastructure.

Al conectar Docker a un registro de Docker, debe proporcionar los detalles de autenticación correspondientes. Por ejemplo, en el caso de Oracle Cloud Infrastructure Registry, tiene que proporcionar el espacio de nombres de Object Storage del arrendamiento, el nombre de usuario y el token de autenticación del usuario.

Si utiliza Cloud Shell como entorno de desarrollo, solo tiene que copiar y pegar comandos de la página Introducción en la ventana de Cloud Shell. Para obtener más información, consulte la guía QuickStart de OCI Functions on Cloud Shell.

En las instrucciones de este tema se supone que:

  • no utilice Cloud Shell como entorno de desarrollo
  • Está utilizando Linux.
  • Ya ha completado los pasos de Inicio de Docker

Para conectar Docker a Oracle Cloud Infrastructure Registry:

  1. Conéctese al entorno de desarrollo como desarrollador de funciones.

  2. En una ventana de terminal, conéctese a Oracle Cloud Infrastructure Registry; para ello, introduzca:

    docker login <region-key>.ocir.io

    donde <region-key> es la clave para la región de Oracle Cloud Infrastructure Registry especificada en el contexto de la CLI de Fn Project (consulte Creación de un contexto de la CLI de Fn Project para conectarse a Oracle Cloud Infrastructure). Por ejemplo, phx para Phoenix. Consulte Disponibilidad por región.

    Por ejemplo:

    docker login phx.ocir.io

  3. Cuando se le solicite el nombre de usuario, introduzca el nombre del usuario que utilizará con OCI Functions para crear y desplegar funciones, con el formato:

    <tenancy-namespace>/<username>

    donde <tenancy-namespace> es la cadena de espacio de nombres de Object Storage generada automáticamente del arrendamiento en el que crear repositorios (como se muestra en la página Información de arrendamiento). Por ejemplo, ansh81vru1zp/jdoe@acme.com.

    Tenga en cuenta que para algunos arrendamientos más antiguos, la cadena de espacios de nombres puede ser la misma que el nombre de arrendamiento en letras minúsculas (por ejemplo, acme-dev).

    Si su arrendamiento está federado con Oracle Identity Cloud Service, utilice el formato <tenancy-namespace>/<domain-name>/<username>. Para los usuarios federados, <domain-name>/<username> se muestra en el menú Perfil Icono de menú de perfil de la consola. Por ejemplo, si la cadena de espacio de nombres de su arrendamiento es ansh81vru1zp y su arrendamiento está federado con Oracle Identity Cloud Service, y su nombre de usuario es jdoe@acme.com, introduzca ansh81vru1zp/oracleidentitycloudservice/jdoe@acme.com.

    Ya debe haber generado un token de autenticación de Oracle Cloud Infrastructure para el usuario que especifique (consulte Generación de un token de autenticación para conectarse a Oracle Cloud Infrastructure Registry).

  4. Cuando se le solicite la conexión, introduzca el token de autenticación de Oracle Cloud Infrastructure del usuario. Si ha introducido la contraseña, Docker puede advertirle de que la contraseña se almacena sin cifrar en el archivo de configuración de Docker. La advertencia incluye un enlace a la documentación de Docker en la que puede encontrar cómo configurar la aplicación auxiliar de credenciales. Recomendamos revisar la información de la documentación de Docker y considerar el uso de un almacén externo de credenciales para una mayor seguridad.

Cuando haya realizado los pasos de este tema, habrá completado las tareas de configuración para el entorno de cliente. Vaya a Verificación de su configuración para el desarrollo de función para confirmar que la CLI de Fn Project puede comunicarse con el punto final de la API.