Inicio rápido de Functions en host local

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. Cree un nuevo grupo seleccionando Grupos y, a continuación, Crear grupo.
   
4. Cree un nuevo usuario seleccionando Usuarios y, a continuación, Crear usuario.
   
5. Para agregar un usuario a un grupo, seleccione Grupos, el nombre del grupo y, a continuación, Agregar usuario a grupo.
   

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 Crear aplicación.
   
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 una ventana de terminal del entorno de desarrollo:

1. Confirme que Docker está instalado introduciendo:

   docker version

   Si aparece un mensaje de error que indica que Docker no está instalado, debe instalar Docker antes de continuar. Consulte la documentación de Docker para su plataforma (para Oracle Linux, consulte aquí).

   Si Docker está instalado, vaya a la sección Requisitos previos de la página inicial de Fn Project en GitHub y confirme que la versión de Docker instalada es la versión mínima especificada en ella. Si no es así, vuelva a instalar Docker antes de continuar.

2. Inicie la imagen estándar hello-world de Docker como un contenedor para confirmar que Docker se está ejecutando. Para ello, introduzca:

   docker run hello-world

   Si ve un mensaje de error que indica que Docker no se está ejecutando, debe iniciar el daemon de Docker antes de continuar. Consulte la documentación de Docker.

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

1. Inicie sesión en la consola como desarrollador de funciones.
2. En el menú de navegación , seleccione el menú Perfil y, a continuación, seleccione Configuración de usuario o Mi perfil, según la opción que vea.
3. En Recursos, seleccione Claves de API y, a continuación, seleccione Agregar clave de API.
4. Seleccione Generar par de claves de API en el cuadro de diálogo Agregar clave de API.
   
5. Seleccione Descargar clave privada y guarde el archivo de clave privada (como un archivo .pem) en el directorio ~/.oci. (Si el directorio ~/.oci aún no existe, créelo ahora).
6. Seleccione Agregar para agregar la nueva clave de firma de API a la configuración de usuario.

   Se muestra el cuadro de diálogo Vista previa de archivo de configuración, que contiene un fragmento de archivo de configuración con información de autenticación básica para un perfil denominado DEFAULT (incluida la huella de la clave de firma de API que acaba de crear).

   

7. Copie el fragmento del archivo de configuración que se muestra en el cuadro de texto y cierre el cuadro de diálogo Vista previa de archivo de configuración.
8. En un editor de texto, abra el archivo ~/.oci/config y pegue el fragmento en el archivo. (Si el archivo ~/.oci/config aún no existe, créelo ahora).
9. En el editor de texto, cambie el perfil del fragmento que acaba de pegar, de la siguiente manera:
   • Cambie el nombre del perfil de [DEFAULT] a uno que desee (por ejemplo, [functions-developer-profile]). Tenga en cuenta que el archivo ~/.oci/config no puede contener dos perfiles con el mismo nombre.
   • Cambie el valor del parámetro key_file del perfil para especificar la ruta del archivo de clave privada (el archivo .pem) que ha descargado anteriormente.
10. En el editor de texto, guarde los cambios realizados en el archivo ~/.oci/config y cierre el editor de texto.
11. En una ventana de terminal, cambie los permisos en el archivo de clave privada (el archivo .pem) para asegurarse de que solo usted pueda leerlo, introduciendo:

    chmod go-rwx ~/.oci/<private-key-file-name>.pem

Consulte las notas de configuración para obtener más información sobre la configuración de una clave de firma de API y la creación de un perfil.

En una ventana de terminal del entorno de desarrollo:

1. Instale la CLI de Fn Project siguiendo las instrucciones correspondientes de su entorno:
   • Linux o MacOS: introduzca:

     curl -LSs https://raw.githubusercontent.com/fnproject/cli/master/install | sh

   • MacOS mediante Homebrew: introduzca:

     brew update && brew install fn

   • Windows: siga las instrucciones de instalación de Fn Client en GitHub.
   • Linux, MacOS o Windows: descargue y ejecute el binario desde la página Versiones de proyecto de Fn en GitHub.
2. Confirme que la CLI de Fn Project se haya instalado introduciendo:

   fn version

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

En una ventana de terminal del entorno de desarrollo:

1. Para crear un nuevo contexto de la CLI de Fn Project, introduzca:

   fn create context <my-context> --provider oracle

   Tenga en cuenta que especifica --provider oracle para activar la autenticación y autorización mediante firma de solicitudes, claves privadas, grupos de usuarios y políticas que otorgan permisos a esos grupos de usuarios de Oracle Cloud Infrastructure.

2. Para especificar que la CLI de Fn Project debe utilizar el nuevo contexto, introduzca:

   fn use context <my-context>

3. Configure el nuevo contexto de la CLI de Fn Project con el nombre del perfil de OCI que ha creado para su uso con OCI Functions (por ejemplo, [functions-developer-profile]), introduciendo:

   fn update context oracle.profile <profile-name>

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

En una ventana de terminal del entorno de desarrollo:

1. Configure el nuevo contexto de la CLI de Fn Project con el OCID del compartimento del que desea poseer funciones desplegadas

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

2. Para configurar el nuevo contexto con el punto final API-url que se va a utilizar al llamar a la API de OCI, introduzca:

   fn update context api-url <api-endpoint>

   donde <api-endpoint> es uno de los puntos finales de la lista de puntos finales de Functions en la API de Functions, en el formato https://functions.<region-identifier>.oci.oraclecloud.com. Por ejemplo:

   fn update context api-url https://functions.us-phoenix-1.oci.oraclecloud.com

3. Configure el contexto de la CLI 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

4. Configure el contexto de la CLI 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.

1. Inicie sesión en la consola como desarrollador de funciones.
2. En el menú de navegación , seleccione el menú Perfil y, a continuación, seleccione Configuración de usuario o Mi perfil, según la opción que vea.
3. En la página Tokens de autenticación, seleccione Generar token.
4. 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.
5. 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.
6. Cierre el cuadro de diálogo Generar token.

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

En la página Introducción 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 Functions (en Resources, 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á!