Diferentes opciones para los entornos de desarrollo de funciones

Descubra las opciones de entorno de desarrollo para crear y desplegar funciones en OCI Functions mediante la CLI de Fn Project.

Al configurar un entorno de desarrollo para crear y desplegar funciones en OCI Functions, tiene diferentes opciones. Para la mayoría de los usuarios, la configuración de una máquina local es la forma recomendada de trabajar con OCI Functions.

Utilice funciones de solo código cuando la función se pueda ejecutar en un tiempo de ejecución gestionado soportado y desee desplegar el código de función sin crear ni publicar una imagen de contenedor. Utilice funciones basadas en imágenes cuando necesite un control total sobre el sistema operativo, los paquetes, el tiempo de ejecución o el contenido de la imagen.

• Opción 1: Configuración de una máquina local. (Recomendado) Para la mayoría de los usuarios, la configuración de una máquina local es la forma preferida de crear, desplegar y llamar a funciones. Puede utilizar una máquina local para crear funciones de solo código a partir de archivos o para crear funciones basadas en imágenes a partir de imágenes de contenedor.

  • Para las funciones de solo código, proporciona un archivo de funciones y selecciona un tiempo de ejecución gestionado soportado. OCI Functions comprueba que el archivo utiliza el formato y la estructura de directorios necesarios y gestiona el entorno de ejecución que se utiliza para ejecutar la función.
  • Para las funciones basadas en imágenes, cree una imagen de contenedor, transfiera la imagen a Oracle Cloud Infrastructure Registry y despliegue la función desde la imagen.

  Si configura una máquina local, deberá especificar --provider oracle al crear un nuevo contexto de CLI de Fn Project. Esta opción permite a OCI Functions realizar la autenticación y autorización mediante firma, claves privadas, grupos de usuario y políticas que otorgan permisos a esos grupos de usuarios.

  Utilice Functions QuickStart on Local Host Using Archives (Code-only Functions) si desea configurar una máquina local como entorno de desarrollo y crear una función de solo código.

  Utilice Inicio rápido de funciones en el host local mediante imágenes de contenedor si desea configurar una máquina local como entorno de desarrollo y crear una función basada en imágenes.

• Opción 2: configuración de Cloud Shell. Utilice Cloud Shell cuando desee probar funciones basadas en imágenes rápidamente sin instalar herramientas de desarrollo locales. Al copiar y pegar algunos comandos de la consola en la ventana de Cloud Shell, puede configurar un entorno para el desarrollo de OCI Functions en tan solo unos minutos.

  Si configura Cloud Shell, se proporcionan dos contextos de CLI de Fn Project listos para usar. Si desea crear su propio contexto de la CLI de Fn Project, especifique --provider oracle-cs al crear el contexto.

  Esta opción le permite experimentar con la creación, el despliegue y la llamada de funciones basadas en imágenes. También puede explorar OCI Functions mediante los ejemplos de GitHub. Tenga en cuenta que Cloud Shell asigna 5 GB para el directorio raíz de cada usuario, que no se puede ampliar ni montar en el almacenamiento externo. Usted es responsable de realizar tareas de limpieza regulares para mantener el uso de espacio por debajo de 5 GB.

  Utilice Inicio rápido de funciones en Cloud Shell mediante imágenes de contenedor si desea configurar Cloud Shell como entorno de desarrollo para funciones basadas en imágenes.

• Opción 3: Configuración de una instancia informática de de Oracle Cloud Infrastructure. Para algunos usuarios, la configuración de una instancia informática de OCI es más cómoda que la configuración de una máquina local. Si configura una instancia informática de OCI, deberá especificar --provider oracle-ip al crear un nuevo contexto de las CLI de Fn Project.

  Esta opción permite a OCI Functions realizar la autenticación y autorización mediante OCID de instancia, grupos dinámicos y políticas que otorguen permisos a esos grupos dinámicos. Este enfoque elimina el requisito de que los usuarios gestionen claves privadas.

  Para configurar un entorno de desarrollo de OCI Functions en una instancia informática de OCI, debe tener permiso para crear grupos dinámicos, crear un grupo dinámico que incluya el OCID de la instancia informática, crear una política para otorgar al grupo dinámico acceso a recursos de funciones y recursos de red y especificar --provider oracle-ip al crear un nuevo contexto de la CLI de Fn Project.

  Utilice Inicio rápido de Functions en una instancia informática de OCI que utilice imágenes de contenedor si desea configurar una instancia informática de OCI como entorno de desarrollo.

Configuración del contexto de la CLI de Fn Project para diferentes entornos de desarrollo

La CLI de Fn Project utiliza un contexto para conectarse a su arrendamiento de OCI. El contexto especifica los puntos finales de OCI Functions y el OCID del compartimento al que pertenecerán las funciones desplegadas. En el caso de las funciones de solo código que utilizan el flujo de desarrollador implícito, el contexto también puede especificar detalles de Object Storage para la carga del archivo. En el caso de las funciones basadas en imágenes, el contexto también especifica la dirección del registro de contenedores hacia y desde la que transferir y extraer imágenes.

Al configurar un entorno de desarrollo de máquinas local o un entorno de desarrollo de instancias informáticas de OCI, debe crear su propio contexto de la CLI de Fn Project. El entorno de desarrollo de Cloud Shell proporciona dos contextos listos para usar, aunque puede crear el suyo propio.

Al crear un contexto de la CLI de Fn Project, utiliza el comando fn create context y especifica un proveedor de autenticación. El proveedor que se va a especificar depende del entorno de desarrollo que utilice, como se muestra en la siguiente tabla:

Entorno de Desarrollo	Comando para crear el contexto de la CLI de Fn Project
Máquina Local	fn create context <my-context> --provider oracle
Cloud Shell	fn create context <my-context> --provider oracle-cs
Instancia informática de OCI	fn create context <my-context> --provider oracle-ip