Programmazione di una funzione

Per pianificare una funzione utilizzando le pagine di OCI Functions Console per creare una pianificazione in Resource Scheduler:

1. Nella pagina di elenco Applicazioni selezionare l'applicazione che contiene la funzione da utilizzare. Per assistenza nella ricerca della pagina elenco o dell'applicazione, vedere Elenco delle applicazioni.

2. Selezionare la scheda Funzioni.

   Viene visualizzata la pagina elenco Funzioni. Tutte le funzioni dell'applicazione selezionata vengono visualizzate in una tabella.

3. Selezionare il nome della funzione che si desidera pianificare, quindi selezionare Pianificazioni per visualizzare la pagina Pianificazioni della funzione.

   Vengono visualizzate tutte le pianificazioni esistenti nel compartimento corrente a cui è già stata aggiunta la funzione.

4. Nella pagina Pianificazioni di OCI Functions Console, selezionare Aggiungi pianificazione per aggiungere la funzione a una pianificazione.

   È possibile aggiungere la funzione a una nuova pianificazione creata (come descritto in questa sezione) o aggiungere la funzione a una pianificazione esistente già creata dall'utente o da un altro utente.

5. Selezionare Crea nuova schedulazione e specificare i dettagli riportati di seguito.
   • Nome: nome scelto per la nuova pianificazione delle risorse. Evitare di fornire informazioni riservate.
   • Descrizione: (facoltativo) una descrizione significativa della nuova pianificazione delle risorse.
   • Compartimento: compartimento in cui creare la nuova pianificazione delle risorse.

6. Specificare la modalità di inserimento dei dettagli per la pianificazione selezionando una delle opzioni riportate di seguito.

   • Interfaccia modulo: selezionare questa opzione per definire la schedulazione utilizzando i campi dell'interfaccia utente.
   • Espressione Cron: selezionare questa opzione per definire la schedulazione immettendo un'espressione Cron.
7. Se è stata selezionata l'opzione Interfaccia modulo per definire la schedulazione, utilizzare il campo Intervallo per selezionare l'intervallo di tempo per la schedulazione e specificare altri dettagli appropriati per l'intervallo di tempo, come indicato di seguito.
   • Una tantum: immettere l'ora e la data UTC in cui la schedulazione deve iniziare.
   • Orario: immettere la frequenza di ripetizione della schedulazione (1 = ogni ora, 2 = ogni due ore, 3 = ogni tre ore), l'ora UTC e la data di inizio della schedulazione e, facoltativamente, la data di fine della schedulazione.
   • Giornaliero: immettere la frequenza di ripetizione della schedulazione (1 = ogni giorno, 2 = ogni due giorni, 3 = ogni tre giorni), l'ora UTC e la data di inizio della schedulazione e, facoltativamente, la data di fine della schedulazione.
   • Settimanale: immettere la frequenza di ripetizione della schedulazione (1 = ogni settimana, 2 = ogni due settimane, 3 = ogni tre settimane), i giorni della settimana in cui la schedulazione deve eseguire la funzione, l'ora e la data UTC in cui deve iniziare la schedulazione e (facoltativamente) la data di fine della schedulazione.
   • Mensile: immettere la frequenza di ripetizione della schedulazione (1 = ogni mese, 2 = ogni due mesi, 3 = ogni tre mesi), i giorni del mese in cui la schedulazione deve eseguire la funzione, l'ora e la data UTC in cui deve iniziare la schedulazione e (facoltativamente) la data di fine della schedulazione.

   Nel campo Riepilogo viene visualizzata una versione di testo della schedulazione immessa.

8. Se è stata selezionata l'espressione Cron come modalità di definizione della schedulazione, immettere i dettagli riportati di seguito.
   • Espressione Cron: immettere un'espressione Cron valida per impostare l'intervallo di pianificazione. Ad esempio:
     • Per impostare il programma per eseguire la funzione ogni settimana alle 13:30 UTC di lunedì, martedì, mercoledì, giovedì e venerdì, immettere:

       30 13 * * mon-fri

     • Per impostare la pianificazione per eseguire la funzione ogni 2 ore il 15° giorno di ogni mese, immettere:

       0 */2 15 * *

   • Ora: immettere l'ora UTC in cui deve iniziare la schedulazione.
   • Data inizio: immettere la data di inizio della schedulazione.
   • Data fine: (facoltativo) immettere la data di fine del programma.

   Per ulteriori informazioni sulle espressioni Cron, vedere Uso di un'espressione Cron nella documentazione di Resource Scheduler.

9. (Facoltativo) Per passare argomenti e valori alla funzione, selezionare l'opzione Aggiungi payload di richiamo e immettere gli argomenti e i valori in un formato previsto dalla funzione. Se la funzione prevede argomenti e valori come JSON, utilizzare un formato JSON valido.
10. (Facoltativo) Per applicare le tag alla risorsa, selezionare Aggiungi tag. Se si dispone delle autorizzazioni per creare una risorsa, si dispone anche delle autorizzazioni per applicare tag in formato libero a tale risorsa. Per applicare una tag defined, è necessario disporre delle autorizzazioni per utilizzare la tag namespace. Per ulteriori informazioni sull'applicazione di tag, vedere Tag risorsa. Se non sei sicuro di applicare i tag, salta questa opzione o chiedi a un amministratore. È possibile applicare le tag in un secondo momento.

11. Selezionare Crea per creare la schedulazione e aggiungervi la funzione.

    La nuova pianificazione delle risorse viene visualizzata nella pagina Pianificazioni per la funzione nella console delle funzioni OCI.

    Dopo aver creato la pianificazione delle risorse e avervi aggiunto una funzione, è necessario creare sia un gruppo dinamico con una regola che includa l'OCID della pianificazione delle risorse, sia un'istruzione dei criteri che conceda al gruppo dinamico l'accesso alla funzione:

12. Selezionare la pianificazione delle risorse per visualizzarne i dettagli nella console dello scheduler risorse e copiare l'OCID della pianificazione. Ad esempio, ocid1.resourceschedule.oc1.phx.amaaaaaa3______owq.
13. Creare un gruppo dinamico seguendo le istruzioni riportate in Per creare un gruppo dinamico, assegnare al gruppo dinamico un nome (ad esempio, resource-scheduler-prod-dynamic-group) e specificare una regola per il gruppo dinamico come indicato di seguito.

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

    dove <resource-schedule-OCID> è l'OCID della pianificazione delle risorse copiata in precedenza. Ad esempio:

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

14. Creare un criterio per concedere al nuovo gruppo dinamico l'accesso alle funzioni in OCI Functions seguendo le istruzioni riportate in Per creare un criterio, assegnare un nome al criterio (ad esempio, resource-scheduler-prod-dyn-grp-policy) e specificare un'istruzione di criterio simile alla seguente:

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

    dove <dynamic-group-name> è il nome del gruppo dinamico creato nel passo precedente. Ad esempio:

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

La funzione viene richiamata in base alla pianificazione delle risorse definita.

Per pianificare una funzione utilizzando le pagine della console di Scheduler risorse per creare una pianificazione nello scheduler risorse:

1. Accedere alla console come sviluppatore di funzioni.
2. Aprire il menu di navigazione e selezionare Governance & Administration. In Programmazione risorse, selezionare Programmi.
3. Selezionare l'area in uso con OCI Functions.

   Si consiglia di utilizzare la stessa area del registro Docker specificata nel contesto CLI di Fn Project. Vedere Creazione di un contesto CLI di progetto Fn per la connessione a Oracle Cloud Infrastructure.

4. Nella pagina Pianificazioni della console di Scheduler risorse, selezionare Crea una pianificazione per creare una nuova pianificazione risorse.
5. Nella pagina Informazioni basilari specificare i valori riportati di seguito per la pianificazione delle risorse.
   • Nome programma: il nome scelto per il programma delle risorse. Evitare di fornire informazioni riservate.
   • Descrizione del programma: (facoltativo) una descrizione significativa del programma delle risorse.
   • Azione da eseguire: selezionare Inizio.
   • Compartimento: il compartimento in cui creare la pianificazione delle risorse.
   • Mostra opzioni avanzate: selezionare questa opzione per applicare le tag alla risorsa. Se si dispone delle autorizzazioni per creare una risorsa, si dispone anche delle autorizzazioni per applicare tag in formato libero a tale risorsa. Per applicare una tag defined, è necessario disporre delle autorizzazioni per utilizzare la tag namespace. Per ulteriori informazioni sull'applicazione di tag, vedere Tag risorsa. Se non sei sicuro di applicare i tag, salta questa opzione o chiedi a un amministratore. È possibile applicare le tag in un secondo momento.
6. Selezionare Successivo.
7. Nella pagina Risorse, selezionare la funzione che si desidera pianificare come indicato di seguito.
   1. Nelle opzioni Metodo di selezione delle risorse selezionare l'opzione Statico - Applica pianificazione a risorse specifiche.
   2. Nella casella Cerca e filtra, utilizzare il filtro predefinito (Compartimento tutto) per cercare le risorse in tutti i compartimenti oppure selezionare Compartimento per selezionare un compartimento specifico in cui cercare le risorse.
   3. Nella casella Cerca e filtra selezionare Tipo di risorsa.
   4. Selezionare FunctionsFunction dalla lista dei tipi di risorsa (deselezionare qualsiasi altro tipo di risorsa selezionato) e selezionare Applica.

      Vengono visualizzate le funzioni del compartimento selezionato.

   5. Selezionare la funzione che si desidera programmare.
8. Selezionare Successivo.
9. Nella pagina Pianifica specificare quando e con quale frequenza si desidera che la funzione venga eseguita e quando la pianificazione delle risorse deve iniziare e finire.

   Per informazioni sull'impostazione di un programma risorse, vedere Aggiunta di informazioni sul programma.

10. Selezionare Successivo.
11. Nella pagina Rivedi, confermare le informazioni immesse e selezionare Crea pianificazione per pianificare la funzione.

    La nuova pianificazione delle risorse viene visualizzata nella pagina Pianificazioni della console Scheduler risorse.

    Dopo aver creato la pianificazione delle risorse e avervi aggiunto una funzione, è necessario creare sia un gruppo dinamico con una regola che includa l'OCID della pianificazione delle risorse, sia un'istruzione dei criteri che conceda al gruppo dinamico l'accesso alla funzione:

12. Selezionare la pianificazione delle risorse per visualizzarne i dettagli e copiare l'OCID della pianificazione. Ad esempio, ocid1.resourceschedule.oc1.phx.amaaaaaa3______owq.
13. Creare un gruppo dinamico seguendo le istruzioni riportate in Per creare un gruppo dinamico, assegnare al gruppo dinamico un nome (ad esempio, resource-scheduler-prod-dynamic-group) e specificare una regola per il gruppo dinamico come indicato di seguito.

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

    dove <resource-schedule-OCID> è l'OCID della pianificazione delle risorse copiata in precedenza. Ad esempio:

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

14. Creare un criterio per concedere al nuovo gruppo dinamico l'accesso alle funzioni in OCI Functions seguendo le istruzioni riportate in Per creare un criterio, assegnare un nome al criterio (ad esempio, resource-scheduler-prod-dyn-grp-policy) e specificare un'istruzione di criterio simile alla seguente:

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

    dove <dynamic-group-name> è il nome del gruppo dinamico creato nel passo precedente. Ad esempio:

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

La funzione viene richiamata in base alla pianificazione delle risorse definita.