Inicio rápido de Functions en Cloud Shell

Si aún no existen usuarios y grupos adecuados:

1. Conéctese a la consola como administrador de arrendamiento.
2. Abra el menú de navegación y seleccione Identidad y seguridad. En Identidad, seleccione Dominios.
3. Seleccione un dominio y seleccione el separador Gestión de usuarios.
4. Cree un nuevo grupo seleccionando Crear grupo en la sección Grupos.
5. Cree un nuevo usuario seleccionando Crear en la sección Usuarios.
6. Para agregar un usuario a un grupo, seleccione el nombre del grupo y, a continuación, Asignar usuario a grupo en el separador Usuarios.

Consulte Notas de configuración para obtener más información.

Si aún no existe un compartimento adecuado en el que crear recursos de red y recursos de OCI Functions:

1. Conéctese a la consola como administrador de arrendamiento.
2. Abra el menú de navegación y seleccione Identidad y seguridad. En Identidad, seleccione Compartimentos.
3. Seleccione Create Compartment.

Consulte Notas de configuración para obtener más información.

Si aún no existe una VCN adecuada en la que crear recursos de red:

Consulte Notas de configuración para obtener más información.

Si uno o más usuarios de OCI Functions no son administradores de arrendamiento:

1. Conéctese a la consola como administrador de arrendamiento.
2. Abra el menú de navegación y seleccione Identidad y seguridad. En Identidad, seleccione Políticas.

3. Seleccione Crear política, especifique un nombre y una descripción para la nueva política y seleccione el compartimento raíz del arrendamiento.

4. Utilice el creador de políticas para crear la política. Seleccione Funciones en la lista de casos de uso de políticas y base la política en la plantilla de política Permitir a los usuarios crear, desplegar y gestionar funciones y aplicaciones.

   La plantilla de política incluye las siguientes sentencias de política:

   • Allow group <group-name> to use cloud-shell in tenancy
   • Allow group <group-name> to manage repos in tenancy
   • Allow group <group-name> to read objectstorage-namespaces in tenancy
   • Allow group <group-name> to manage logging-family in tenancy
   • Allow group <group-name> to read metrics in tenancy
   • Allow group <group-name> to manage functions-family in tenancy
   • Allow group <group-name> to use virtual-network-family in tenancy
   • Allow group <group-name> to use apm-domains in tenancy
   • Allow group <group-name> to read vaults in tenancy
   • Allow group <group-name> to use keys in tenancy
   • Allow service faas to use apm-domains in tenancy
   • Allow service faas to read repos in tenancy where request.operation='ListContainerImageSignatures'
   • Allow service faas to {KEY_READ} in tenancy where request.operation='GetKeyVersion'
   • Allow service faas to {KEY_VERIFY} in tenancy where request.operation='Verify'

   Si es necesario, puede restringir estas sentencias de política por compartimento.

Consulte Notas de configuración para obtener más información.

1. Inicie sesión en la consola como desarrollador de funciones.
2. Abra el menú de navegación y seleccione Servicios para desarrolladores. En Functions, seleccione Applications.
3. Seleccione la región que está utilizando con OCI Functions.
4. Seleccione Create application.
5. Especifique:
   • el nombre de la nueva aplicación. Desplegará su primera función en esta aplicación y especificará esta aplicación al llamar a la función.
   • La VCN y la subred en la que ejecutar la función. Tenga en cuenta que una subred pública necesita un gateway de Internet en la VCN, y una subred privada necesita un gateway de servicio en la VCN.
6. Haga clic en Crear.

Consulte instrucciones detalladas para obtener más información.

En la página de lista Aplicaciones de la consola:

1. Seleccione la aplicación helloworld-app que acaba de crear para mostrar la página de detalles de la aplicación.

2. Vaya a la sección Introducción y, a continuación, seleccione Ver guía junto a Configuración de Cloud Shell.

   Consejo: el panel Configuración de Cloud Shell ahora muestra comandos personalizados específicamente para usted. Copie y pegue estos comandos para configurar el entorno de Cloud Shell para el desarrollo de funciones.

3. Seleccione Iniciar Cloud shell para mostrar la ventana de terminal de Cloud Shell.

Copie y pegue comandos del panel Configuración de Cloud Shell en la ventana de terminal de Cloud Shell para configurar el entorno, de la siguiente manera:

1. Busque el nombre del contexto de Fn Project creado previamente para la región actual en la que ha creado la aplicación:

   fn list context

   Se devuelven al menos dos contextos de Fn Project, un contexto por defecto y un contexto para la región actual (por ejemplo, denominado us-phoenix-1).

2. Defina el contexto de Fn Project para utilizar el contexto de región:

   fn use context <region-context>

   donde <region-context> es el contexto de la región actual. Por ejemplo:

   fn use context us-phoenix-1

3. Configure el contexto de Fn Project con el OCID del compartimento actual que poseerá las funciones desplegadas:

   fn update context oracle.compartment-id <compartment-ocid>

   Por ejemplo:

   fn update context oracle.compartment-id ocid1.compartment.oc1..aaaaaaaarvdfa72n...

4. Configure el contexto de Fn Project con la dirección de Oracle Cloud Infrastructure Registry en la región y el arrendamiento actuales que desea utilizar con OCI Functions:

   fn update context registry <region-key>.ocir.io/<tenancy-namespace>/<repo-name-prefix>

   donde <repo-name-prefix> es un prefijo de su elección para el repositorio de Oracle Cloud Infrastructure Registry en el que almacenar imágenes para la función. Por ejemplo:

   fn update context registry phx.ocir.io/ansh81vru1zp/acme-repo

5. Configure el contexto de Fn Project con el OCID del compartimento para los repositorios a los que desea que OCI Functions transfiera y extraiga imágenes de función introduciendo:

   fn update context oracle.image-compartment-id <compartment-ocid>

   Por ejemplo:

   fn update context oracle.image-compartment-id ocid1.compartment.oc1..aaaaaaaaquqe______z2q

   Si no especifica un valor para oracle.image-compartment-id, OCI Functions transfiere y extrae imágenes desde y hacia los repositorios del compartimento raíz.

Consulte Notas de configuración para obtener más información.

En el panel Configuración de Cloud Shell de la consola:

1. Seleccione Generar un token de autenticación para mostrar la página Tokens de autenticación y seleccione Generar token.
2. Introduzca una descripción significativa para el token de autenticación en el cuadro de diálogo Generar token y seleccione Generar token. Aparece el nuevo token de autenticación (por ejemplo, 6aN...6MqX).
3. Copie el token de autenticación inmediatamente en una ubicación segura desde donde pueda recuperarlo más tarde, ya que no verá el token de autenticación de nuevo en la consola.
4. Cierre el cuadro de diálogo Generar token.

Consulte Notas de configuración para obtener más información.

En el panel Configuración de Cloud Shell de la consola:

1. Copie el siguiente comando:

   docker login -u '<tenancy-namespace>/<user-name>' <region-key>.ocir.io

   Por ejemplo:

   docker login -u 'ansh81vru1zp/jdoe@acme.com' phx.ocir.io

   Si su arrendamiento está federado con Oracle Identity Cloud Service, el formato será ligeramente diferente. Por ejemplo:

   docker login -u 'ansh81vru1zp/oracleidentitycloudservice/jdoe@acme.com' phx.ocir.io

2. En la ventana de terminal, pegue el comando que acaba de copiar y ejecútelo.

3. Cuando se le solicite una contraseña, introduzca el token de autenticación de Oracle Cloud Infrastructure que ha creado y copiado anteriormente. Por ejemplo, 6aN...6MqX

   Ya está listo para empezar a crear, desplegar y llamar a funciones.

Consulte Notas de configuración para obtener más información.

En la ventana de terminal:

1. Cree una función java helloworld introduciendo:

   fn init --runtime java hello-java

   Se crea un directorio denominado hello-java que contiene:

   • un archivo de definición de función denominado func.yaml
   • un directorio /src que contiene archivos y directorios de origen para la función helloworld
   • un archivo de configuración de Maven denominado pom.xml que especifica las dependencias necesarias para compilar la función

   Java es solo uno de los varios lenguajes soportados.

   Consulte instrucciones detalladas para obtener más información.

En la ventana de terminal:

1. Cambie el directorio al directorio hello-java creado en el paso anterior:

   cd hello-java

2. Introduzca el siguiente comando de Fn Project único para crear la función y sus dependencias como una imagen de Docker denominada hello-java, envíe la imagen al registro de Docker especificado y despliegue la función en OCI Functions en la aplicación helloworld-app que ha creado anteriormente:

   fn -v deploy --app helloworld-app

3. (Opcional) Confirme que la función se ha desplegado en OCI Functions seleccionando el separador Funciones (en la página de detalles de la aplicación helloworld-app) y observando que ahora aparece la función hello-java.

Consulte instrucciones detalladas para obtener más información.

En la ventana de terminal:

1. Llame a la función hello-java introduciendo:

   fn invoke helloworld-app hello-java

   Se muestra el mensaje "Hola mundo".

2. Llame a la función hello-java con el parámetro 'John' introduciendo:

   echo -n 'John' | fn invoke helloworld-app hello-java

   Aparece el mensaje "Hola John".

Enhorabuena. Acaba de crear, desplegar y llamar a su primera función mediante OCI Functions.

Consulte instrucciones detalladas para obtener más información.

Ahora que ha creado, desplegado y llamado a una función, aprenda a:

• Ver logs de funciones en el servicio Oracle Cloud Infrastructure Logging o mediante la configuración de una URL de syslog (consulte Almacenamiento y visualización de logs de funciones)
• explorar OCI Functions mediante ejemplos en GitHub (consulte ejemplos de Oracle Functions)
• Llamada a una función mediante SDK (consulte Uso de SDK para llamar a funciones)

¡Ya está!