Creazione di applicazioni

Scopri come creare applicazioni con OCI Functions.

Nelle funzioni OCI, un'applicazione è un raggruppamento logico di funzioni. Le proprietà specificate per un'applicazione determinano l'allocazione e la configurazione delle risorse per tutte le funzioni dell'applicazione. È necessario creare una funzione all'interno di un'applicazione, quindi deve esistere almeno un'applicazione prima di poter creare una funzione in OCI Functions.

Per ulteriori informazioni sulle applicazioni, vedere Applicazioni.

    1. Confermare di aver completato i passi nella Guida alle funzioni QuickStart.
    2. Nella pagina della lista Applicazioni, selezionare il compartimento specificato nel contesto CLI di Fn Project (vedere Creazione di un contesto CLI di Fn Project per connettersi a Oracle Cloud Infrastructure). Per informazioni su come trovare la pagina dell'elenco, vedere Elenco di applicazioni.
    3. Selezionare Crea applicazione e specificare i dettagli riportati di seguito.

      • Nome: un nome per la nuova applicazione, ad esempio acmeapp. Evitare di fornire informazioni riservate.
      • VCN in <compartment-name>: la VCN (rete cloud virtuale) in cui eseguire le funzioni. Ad esempio, una VCN denominata acme-vcn-01
      • Subnet in <compartment-name>: la subnet (o subnet, fino a un massimo di tre) in cui eseguire le funzioni. AD esempio, una subnet pubblica denominata Public Subnet IHsY:US-PHOENIX-AD-1.

        Una subnet pubblica richiede un gateway Internet nella VCN e una subnet privata richiede un gateway di servizi nella VCN. Se è stata definita una subnet regionale, come best practice, seleziona tale subnet per semplificare l'implementazione del failover tra i domini di disponibilità. Se non è stata definita una subnet regionale ed è necessario soddisfare i requisiti di High Availability, selezionare più subnet. Si consiglia di posizionare le subnet nella stessa area del registro Docker specificata nel contesto CLI di Fn Project. Per ulteriori informazioni, vedere Creazione di un contesto CLI del progetto Fn per la connessione a Oracle Cloud Infrastructure.

        La specifica di una subnet privata per un'applicazione non impedisce l'accesso da Internet agli endpoint di richiamo delle funzioni nell'applicazione. Utilizzare i criteri di identità per controllare l'accesso per richiamare gli endpoint delle funzioni. Per ulteriori informazioni, vedere Controllo dell'accesso per richiamare e gestire le funzioni.

      • Forma: l'architettura del processore delle istanze di computazione su cui distribuire ed eseguire le funzioni nell'applicazione. Tutte le funzioni nell'applicazione vengono distribuite ed eseguite su istanze di computazione con la stessa architettura. L'immagine della funzione deve contenere le dipendenze necessarie per l'architettura selezionata, come indicato di seguito.

        • Selezionare la forma Generic_ARM se si desidera che le funzioni dell'applicazione vengano sempre eseguite su istanze di computazione con un'architettura basata su Arm. Se si seleziona questa singola forma di architettura per l'applicazione, l'immagine della funzione deve contenere le dipendenze necessarie per l'architettura Arm (in una singola immagine di architettura o in un'immagine multi-architettura).
        • Selezionare la forma Generic_X86 se si desidera che le funzioni dell'applicazione vengano sempre eseguite sulle istanze di computazione con un'architettura basata su x86. Se si seleziona questa singola forma di architettura per l'applicazione, l'immagine della funzione deve contenere le dipendenze necessarie per l'architettura x86 (in una singola immagine di architettura o in un'immagine multi-architettura).
        • Selezionare la forma Generic_X86_ARM se si desidera che le funzioni vengano eseguite sulle istanze di computazione con la capacità sufficiente di qualsiasi architettura. In questo caso, OCI Functions seleziona l'architettura su cui eseguire le funzioni in base alla capacità disponibile. Se si seleziona questa forma multi-architettura per l'applicazione, l'immagine di ogni funzione deve contenere le dipendenze necessarie sia per l'architettura Arm che per l'architettura x86 (in un'immagine multi-architettura).

        Tenere presente che non è possibile modificare la forma dell'applicazione dopo averla creata. Vedere Selezione di una singola architettura o di una forma applicazione multiarchitettura su cui eseguire una funzione.

      • Opzioni di applicazione tag: se si dispone delle autorizzazioni per creare una risorsa, si dispone anche delle autorizzazioni per applicare le 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 si è certi di applicare le tag, saltare questa opzione o chiedere a un amministratore. È possibile applicare le tag in un secondo momento.
    4. Selezionare una delle opzioni seguenti.

      • Per creare l'applicazione ora, selezionare Crea. La nuova applicazione viene visualizzata nell'elenco delle applicazioni.
      • Per creare l'applicazione in un secondo momento utilizzando Resource Manager e Terraform, selezionare Salva come stack per salvare la definizione della risorsa come configurazione Terraform. Per ulteriori informazioni sul salvataggio degli stack dalle definizioni delle risorse, vedere Creazione di uno stack da una pagina di creazione delle risorse.
  • Utilizzo dell'interfaccia CLI Fn Project

    Suggerimento

    Di tanto in tanto, vengono rilasciate nuove versioni dell'interfaccia CLI di Fn Project. Ti consigliamo di controllare regolarmente che sia installata l'ultima versione. Per ulteriori informazioni, vedere Passi per l'aggiornamento dell'interfaccia CLI di Fn Project.

    Per creare una nuova applicazione in OCI Functions utilizzando l'interfaccia CLI Fn Project:

    1. Accedere all'ambiente di sviluppo come sviluppatore di funzioni.

    2. In una finestra di terminale, creare una nuova applicazione immettendo:

      fn create app <app-name> --annotation oracle.com/oci/subnetIds='["<subnet-ocid>"]'

      Dove:

      • <app-name> è il nome della nuova applicazione. Evitare di fornire informazioni riservate.
      • <subnet-ocid> è l'OCID della subnet (o delle subnet, fino a un massimo di tre) in cui eseguire le funzioni. Tenere presente che una subnet pubblica richiede un gateway Internet nella VCN e una subnet privata richiede un gateway di servizi nella VCN. Se è stata definita una subnet regionale, la procedura migliore consiste nel selezionare tale subnet per semplificare l'implementazione del failover tra i domini di disponibilità. Se non è stata definita una subnet regionale ed è necessario soddisfare i requisiti di High Availability, specificare più subnet (chiudere ogni OCID tra virgolette separate da virgole, nel formato '["<subnet-ocid>","<subnet-ocid>"]'). Oracle consiglia che le subnet si trovino nella stessa area del registro Docker specificato nel contesto CLI di Fn Project (vedere Creazione di un contesto CLI di Fn Project per connettersi a Oracle Cloud Infrastructure).

        Tenere presente che la specifica di una subnet privata per un'applicazione non impedisce l'accesso da Internet agli endpoint di richiamo delle funzioni nell'applicazione. Utilizzare i criteri di identità per controllare l'accesso agli endpoint di richiamo delle funzioni (vedere Controllo dell'accesso per richiamare e gestire le funzioni).

      Ad esempio:

      fn create app acmeapp --annotation oracle.com/oci/subnetIds='["ocid1.subnet.oc1.phx.aaaaaaaacnh..."]'

      Un'applicazione viene creata nelle funzioni OCI, nella tenancy e nell'area implicite dall'OCID della subnet e appartenenti al compartimento specificato nel file di contesto CLI del progetto Fn.

    3. Verificare che la nuova applicazione sia stata creata immettendo:

      fn list apps

      Ad esempio:

      $ fn list apps
                              
      acmeapp

    Uso dell'interfaccia CLI OCI

    Utilizzare il comando oci fn application create e i parametri necessari per creare un'applicazione.

    oci fn application create --compartment-id <compartment-ocid> --display-name <app-name> --subnet-ids <subnet-ocids> [OPTIONS]

    Per una lista completa di flag e opzioni di variabile per i comandi CLI OCI, vedere Riferimento alla riga di comando.

  • Eseguire l'operazione API CreateApplication per creare un'applicazione.