Creación, despliegue y llamada de una función Hola mundo

Descubre cómo crear, desplegar y llamar a una función helloworld con OCI Functions.

Puede empezar a usar OCI Functions con los comandos de la CLI de Fn Project para:

• Crear una función Hola mundo simple escrita en Java
• Transferir la imagen al registro de Docker configurado para OCI Functions
• desplegar la función en una aplicación en OCI Functions
• Llamar a la función

Para empezar a utilizar OCI Functions:

1. Confirme que ha completado los pasos de las Guías de Functions QuickStart.
2. Inicie sesión en la consola como desarrollador de funciones.

3. Utilice la consola para crear una nueva aplicación en OCI Functions:

   1. Abra el menú de navegación y seleccione Servicios para desarrolladores. En Functions, seleccione Applications.
   2. Seleccione la región que desea utilizar para OCI Functions.

      Recomendamos que utilice la misma región que 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).

   3. Seleccione el compartimento 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).

      La página Aplicaciones muestra las aplicaciones ya definidas en el compartimento.

   4. Seleccione Crear aplicación y especifique:

      • El nombre de la nueva aplicación como helloworld-app.

      • La VCN y la subred (o subredes, hasta un máximo de tres) en las que ejecutar la función. Por ejemplo, una VCN denominada acme-vcn- 01 y una subred pública denominada Public Subnet IHsY:US-PHOENIX-AD- 1). 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. Si se ha definido una subred regional, la práctica recomendada es seleccionar esa subred para que el failover entre los dominios de disponibilidad sea más fácil de implementar. Si no se ha definido una subred regional y debe cumplir requisitos de alta disponibilidad, seleccione varias subredes. Recomendamos que las subredes estén en la misma región que el registro de Docker especificado en el contexto de la CLI de Fn Project (consulte Creating an Fn Project CLI Context to Connect to Oracle Cloud Infrastructure).

   5. Haga clic en Crear.

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

5. En una ventana de terminal, cree una función Hola mundo de Java introduciendo:

   Comando

   CopiarProbar

   fn init --runtime java helloworld-func

   Se crea un directorio denominado helloworld-func, que contiene:

   • Un archivo de definición de la función denominado func.yaml que contiene la cantidad mínima de información necesaria para crear y ejecutar la función. Consulte la documentación de Fn Project para obtener información sobre los parámetros adicionales que puede incluir en un archivo func.yaml.
   • Un directorio /src que contiene archivos y directorios de origen para la función Hola mundo (que incluye /src/main/java/com/example/fn/HelloFunction.java).
   • Un archivo de configuración de Maven denominado pom.xml que especifica los artefactos y las dependencias del proyecto necesarios para compilar la función desde los archivos de origen.
6. Cambie el directorio al directorio helloworld-func creado recientemente.

7. Introduzca el siguiente comando de Fn Project único para crear la función y sus dependencias como una imagen de Docker denominada helloworld-func, envíe la imagen al registro de Docker especificado y despliegue la función en OCI Functions en helloworld-app:

   Comando

   CopiarProbar

   fn -v deploy --app helloworld-app

   La opción -v simplemente muestra más detalles sobre lo que están haciendo los comandos de Fn Project (consulte Uso de la CLI de Fn Project con OCI Functions).

8. (Opcional) Asumiendo que el registro de Docker especificado es Oracle Cloud Infrastructure Registry, utilice la consola para confirmar que la imagen helloworld-func se ha enviado a Oracle Cloud Infrastructure Registry correctamente:
   1. Abra el menú de navegación y seleccione Servicios para desarrolladores. En Containers & Artifacts, seleccione Container Registry.

   2. Seleccione la región del registro.

      Verá todos los repositorios del registro a los que tiene acceso. La imagen transferida se encuentra en nuevo repositorio con un nombre creado a partir de:

      • El prefijo de nombre del repositorio en la dirección del registro de Docker 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.
      • El nombre de la imagen helloworld-func.

      Por ejemplo, el nuevo repositorio puede llamarse acme-repo/helloworld-func.

   3. Seleccione el nombre del nuevo repositorio. Verá detalles de la imagen helloworld-func que se ha transferido a Oracle Cloud Infrastructure Registry.

9. (Opcional) Utilice la consola para confirmar que la función se ha desplegado correctamente en OCI Functions:

   1. Abra el menú de navegación y seleccione Servicios para desarrolladores. En Functions, seleccione Applications.

   2. Seleccione el compartimento 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).

      La página Aplicaciones muestra que se ha creado una aplicación denominada helloworld-app.

   3. Seleccione la aplicación helloworld-app para ver las funciones que contiene.

      La página Funciones muestra que la función helloworld-func se ha desplegado en OCI Functions.

10. En una ventana de terminal, llame a la función helloworld-func introduciendo:

    Comando

    CopiarProbar

    fn invoke helloworld-app helloworld-func

    Aparece el mensaje "Hola mundo".

Enhorabuena. Ha creado y desplegado correctamente su primera función en OCI Functions.