Programación de una función

Para programar una función mediante las páginas de la consola de OCI Functions para crear una planificación en el programador de recursos:

1. En la página de lista Aplicaciones, seleccione la aplicación que contiene la función con la que desea trabajar. Si necesita ayuda para buscar la página de lista o la aplicación, consulte Listado de aplicaciones.

2. Seleccione el separador Funciones.

   Se abre la página de lista Funciones. Todas las funciones de la aplicación seleccionada se muestran en una tabla.

3. Seleccione el nombre de la función que desea programar y, a continuación, seleccione Programas para mostrar la página Programas para la función.

   Se muestran todos los programas existentes en el compartimento actual al que ya se ha agregado la función.

4. En la página Programas de la consola de OCI Functions, seleccione Agregar programa para agregar la función a un programa.

   Puede agregar la función a un nuevo programa que cree (como se describe en esta sección) o agregar la función a un programa existente que ya haya creado (u otra persona).

5. Seleccione Crear nuevo programa y especifique los siguientes detalles:
   • Nombre: nombre que se elige para el nuevo programa de recursos. Evite introducir información confidencial.
   • Descripción: (opcional) descripción significativa del nuevo programa de recursos.
   • Compartimento: compartimento en la que se va a crear el nuevo programa de recursos.

6. Especifique cómo desea introducir los detalles del programa seleccionando una de las siguientes opciones:

   • Interfaz de formulario: seleccione esta opción para definir el programa mediante campos de la interfaz de usuario.
   • Expresión cron: seleccione esta opción para definir el programa introduciendo una expresión cron.
7. Si ha seleccionado la interfaz de formulario como forma de definir el programa, utilice el campo Intervalo para seleccionar el intervalo de tiempo del programa y especifique otros detalles adecuados para el intervalo de tiempo de la siguiente forma:
   • Una vez: introduzca la hora y la fecha UTC en la que se iniciará el programa.
   • Por hora: introduzca la frecuencia con la que se va a repetir el programa (1 = cada hora, 2 = cada dos horas, 3 = cada tres horas), la hora y fecha UTC en la que se va a iniciar el programa y (opcionalmente) la fecha en la que va a finalizar el programa.
   • Diario: introduzca la frecuencia con la que se va a repetir el programa (1 = todos los días, 2 = cada dos días, 3 = cada tres días), la hora y fecha UTC en la que se va a iniciar el programa y (opcionalmente) la fecha en la que se va a finalizar el programa.
   • Semanal: introduzca la frecuencia con la que se va a repetir el programa (1 = cada semana, 2 = cada dos semanas, 3 = cada tres semanas), los días de la semana en los que se va a ejecutar la función, la hora y fecha UTC en la que se va a iniciar el programa y (opcionalmente) la fecha en la que va a finalizar el programa.
   • Mensual: introduzca la frecuencia con la que se va a repetir el programa (1 = cada mes, 2 = cada dos meses, 3 = cada tres meses), los días del mes en que se va a ejecutar la función, la hora y fecha UTC en la que se va a iniciar el programa y (opcionalmente) la fecha en la que se va a finalizar el programa.

   El campo Resumen muestra una versión de texto del programa que introduzca.

8. Si ha seleccionado Expresión cron como forma de definir el programa, introduzca los siguientes detalles:
   • Expresión cron: introduzca una expresión cron válida para definir el intervalo de programación. Por ejemplo:
     • Para establecer el programa para ejecutar la función cada semana a las 13:30 UTC del lunes, martes, miércoles, jueves y viernes, introduzca:

       30 13 * * mon-fri

     • Para configurar el programa para que ejecute la función cada 2 horas el día 15 de cada mes, introduzca:

       0 */2 15 * *

   • Hora: introduzca la hora UTC en la que se iniciará el programa.
   • Fecha de inicio: introduzca la fecha en la que se iniciará el programa.
   • Fecha de finalización: (opcional) introduzca la fecha en la que debe finalizar el programa.

   Para obtener más información sobre las expresiones Cron, consulte Uso de una expresión Cron en la documentación del programador de recursos.

9. (Opcional) Para transferir argumentos y valores a la función, seleccione la opción Agregar carga útil de llamada e introduzca los argumentos y valores en un formato esperado por la función. Si la función espera argumentos y valores como JSON, utilice un formato JSON válido.
10. (Opcional) Para aplicar etiquetas al recurso, seleccione Agregar etiqueta. Si tiene permisos para crear un recurso, también tiene permisos para aplicar etiquetas de formato libre a dicho recurso. Para aplicar una etiqueta defined, debe tener permisos para utilizar el espacio de nombres de la etiqueta. Para obtener más información sobre el etiquetado, consulte Etiquetas de recursos. Si no está seguro de si desea aplicar etiquetas, omita esta opción o pregunte a un administrador. Puede aplicar etiquetas más tarde.

11. Seleccione Crear para crear el programa y agregarle la función.

    El nuevo programa de recursos se muestra en la página Programas para la función en la consola de OCI Functions.

    Una vez creada la programación de recursos y agregada una función a ella, debe crear un grupo dinámico con una regla que incluya el OCID de la programación de recursos y una sentencia de política que otorgue al grupo dinámico acceso a la función:

12. Seleccione el programa de recursos para mostrar sus detalles en la consola del programador de recursos y copie el OCID del programa. Por ejemplo, ocid1.resourceschedule.oc1.phx.amaaaaaa3______owq.
13. Cree un grupo dinámico siguiendo las instrucciones de Para crear un grupo dinámico, asigne un nombre al grupo dinámico (por ejemplo, resource-scheduler-prod-dynamic-group) y especifique una regla para el grupo dinámico de la siguiente manera:

    ALL {resource.type='resourceschedule', resource.id='<resource-schedule-OCID>'}

    donde <resource-schedule-OCID> es el OCID del programa de recursos que ha copiado anteriormente. Por ejemplo:

    ALL {resource.type='resourceschedule', resource.id='ocid1.resourceschedule.oc1.phx.amaaaaaa3______owq'}

14. Cree una política para otorgar al nuevo grupo dinámico acceso a funciones de OCI Functions siguiendo las instrucciones de Para crear una política, asigne un nombre a la política (por ejemplo, resource-scheduler-prod-dyn-grp-policy) y especifique una sentencia de política similar a la siguiente:

    Allow dynamic-group <dynamic-group-name> to manage functions-family in tenancy

    Donde <dynamic-group-name> es el nombre del grupo dinámico que ha creado en el paso anterior. Por ejemplo:

    Allow dynamic-group resource-scheduler-prod-dynamic-group to manage functions-family in tenancy

La función ahora se llama según la programación de recursos que haya definido.

Para programar una función mediante las páginas de la consola del programador de recursos para crear una planificación en el programador de recursos:

1. Inicie sesión en la consola como desarrollador de funciones.
2. Abra el menú de navegación y seleccione Gobernanza y administración. En Programador de recursos, seleccione Programas.
3. Seleccione la región que está utilizando con 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 Creating an Fn Project CLI Context to Connect to Oracle Cloud Infrastructure.

4. En la página Programas de la consola del programador de recursos, seleccione Crear un programa para crear un nuevo programa de recursos.
5. En la página Información básica, especifique los siguientes valores para la programación de recursos:
   • Nombre de programa: nombre que elija para el programa de recursos. Evite introducir información confidencial.
   • Descripción de la programación: (opcional) descripción significativa de la programación de recursos.
   • Acción que se va a ejecutar: seleccione Iniciar.
   • Compartimento: compartimento en la que se va a crear el programa de recursos.
   • Mostrar opciones avanzadas: seleccione esta opción para aplicar etiquetas al recurso. Si tiene permisos para crear un recurso, también tiene permisos para aplicar etiquetas de formato libre a dicho recurso. Para aplicar una etiqueta defined, debe tener permisos para utilizar el espacio de nombres de la etiqueta. Para obtener más información sobre el etiquetado, consulte Etiquetas de recursos. Si no está seguro de si desea aplicar etiquetas, omita esta opción o pregunte a un administrador. Puede aplicar etiquetas más tarde.
6. Seleccione Siguiente.
7. En la página Recursos, seleccione la función que desea programar de la siguiente forma:
   1. En las opciones de Método de selección de recursos, seleccione la opción Estática: aplicar programa a recursos específicos.
   2. En el cuadro Buscar y filtrar, utilice el filtro por defecto (Compartimento todo) para buscar recursos en todos los compartimentos o seleccione Compartimento para seleccionar un compartimento específico en el que buscar recursos.
   3. En el cuadro Buscar y filtrar, seleccione Tipo de recurso.
   4. Seleccione FunctionsFunction en la lista de tipos de recursos (anule la selección de cualquier otro tipo de recurso seleccionado) y seleccione Aplicar.

      Se muestran las funciones del compartimento seleccionado.

   5. Seleccione la función que desea programar.
8. Seleccione Siguiente.
9. En la página Programar, especifique cuándo y con qué frecuencia desea que se ejecute la función, y cuándo se debe iniciar y finalizar la programación del recurso.

   Para obtener más información sobre la configuración de una programación de recursos, consulte Adición de información de programación.

10. Seleccione Siguiente.
11. En la página Revisar, confirme la información que ha introducido y seleccione Crear programa para programar la función.

    El nuevo programa de recursos se muestra en la página Programas de la consola del programador de recursos.

    Una vez creada la programación de recursos y agregada una función a ella, debe crear un grupo dinámico con una regla que incluya el OCID de la programación de recursos y una sentencia de política que otorgue al grupo dinámico acceso a la función:

12. Seleccione el programa de recursos para mostrar sus detalles y copie el OCID del programa. Por ejemplo, ocid1.resourceschedule.oc1.phx.amaaaaaa3______owq.
13. Cree un grupo dinámico siguiendo las instrucciones de Para crear un grupo dinámico, asigne un nombre al grupo dinámico (por ejemplo, resource-scheduler-prod-dynamic-group) y especifique una regla para el grupo dinámico de la siguiente manera:

    ALL {resource.type='resourceschedule', resource.id='<resource-schedule-OCID>'}

    donde <resource-schedule-OCID> es el OCID del programa de recursos que ha copiado anteriormente. Por ejemplo:

    ALL {resource.type='resourceschedule', resource.id='ocid1.resourceschedule.oc1.phx.amaaaaaa3______owq'}

14. Cree una política para otorgar al nuevo grupo dinámico acceso a funciones de OCI Functions siguiendo las instrucciones de Para crear una política, asigne un nombre a la política (por ejemplo, resource-scheduler-prod-dyn-grp-policy) y especifique una sentencia de política similar a la siguiente:

    Allow dynamic-group <dynamic-group-name> to manage functions-family in tenancy

    Donde <dynamic-group-name> es el nombre del grupo dinámico que ha creado en el paso anterior. Por ejemplo:

    Allow dynamic-group resource-scheduler-prod-dynamic-group to manage functions-family in tenancy

La función ahora se llama según la programación de recursos que haya definido.