Limitazioni della funzione

• Nessun supporto per la sottoscrizione ai produttori eventi.
• Nessun supporto per Terraform.

Come posso eseguire il codice come un componente della funzione Code Engine ?

Se il codice esiste come origine in un file locale o in un repository Git o se il tuo codice è un bundle di codice esistente che si trova in un registro pubblico o privato, Code Engine fornisce un modo semplificato per eseguire il codice come una funzione.

• Se stai iniziando con il codice sorgente che si trova in un repository Git, puoi scegliere di puntare all'ubicazione della tua origine e Code Engine si occupa della creazione del bundle del codice dalla tua origine e della creazione della funzione con una singola operazione. In questo scenario, Code Engine carica il codice in IBM Cloud® Container Registry. Per ulteriori informazioni, consultare Creazione di una funzione dal codice sorgente del repository.

• Se stai iniziando con il codice sorgente su una workstation locale, puoi scegliere di puntare all'ubicazione della tua origine e Code Engine si occupa di creare l'immagine dalla tua origine e creare la funzione con un singolo comando della CLI. In questo scenario, Code Engine carica il codice in IBM Cloud® Container Registry. Per ulteriori informazioni, vedi Creazione della tua funzione dal codice di origine locale con la CLI.

• Se si sta iniziando con il codice sorgente, è anche possibile eseguire il codice sorgente in linea. In questo scenario, incolla il codice sorgente quando crei la tua funzione. Per ulteriori informazioni, consultare Creazione della funzione con codice in linea.

Dopo aver creato ed eseguito la funzione, è anche possibile aggiornare la funzione utilizzando uno qualsiasi dei modi precedenti, indipendentemente dal modo in cui è stata creata o precedentemente aggiornata la funzione.

Cosa succede quando richiamo la funzione?

Quando una funzione viene richiamata (avviata), l'istanza della funzione corrispondente viene inizializzata con il contenitore di runtime configurato e i parametri Resource. Il processo della prima inizializzazione viene definito avvio a freddo.

Per ridurre la latenza di avvio a freddo, Code Engine ottimizza il richiamo pre - riscaldando determinati runtime con specifiche configurazioni di CPU e memoria. Le combinazioni preriscaldate per le funzioni includono i runtime Node.js e Python e la combinazione predefinita di CPU e memoria per le funzioni, ovvero 0.25 vCPU x 1 GB di memoria. Inoltre, il sistema è progettato per migliorare il riutilizzo delle istanze della funzione già inizializzate. Pertanto, un'istanza della funzione viene mantenuta attiva una volta terminata la chiamata per consentire le chiamate successive riutilizzando la stessa istanza e riutilizzando lo stato dell'istanza al completamento dell'ultima chiamata. Il riutilizzo di un'istanza di funzione non è garantito.

Posso mantenere la mia istanza di funzione più a lungo?

Con Code Engine, la funzione si adatta automaticamente, in base al carico di lavoro. Quando crei la tua funzione con la combinazione di CPU e memoria predefinita, la tua funzione viene inserita in un contenitore "preriscaldato", ottimizzato per l'utilizzo. Quando si crea una funzione con una combinazione di CPU e memoria diversa da quella predefinita, la funzione viene inserita in un nuovo contenitore. Per impostazione predefinita, questo contenitore viene mantenuto attivo solo per un breve periodo di tempo dopo il completamento della funzione. Per ulteriori informazioni, vedi Supported CPU and memory combination for functions.

Puoi modificare la quantità di tempo per cui il tuo contenitore viene mantenuto attivo con l'opzione --scale-down-delay nella CLI o l'opzione Ritardo di ridimensionamento inferiore nella console. Tieni presente che mentre mantenere attivo il tuo contenitore riduce i tempi di avvio a freddo per qualsiasi esecuzione successiva della tua funzione, ti viene anche addebitato il periodo di tempo in cui il contenitore della funzione personalizzata esiste.

Richieste e risposte

Le funzioni vengono invocate con il protocollo HTTP. Quando si richiama la funzione, si possono specificare i parametri della richiesta personalizzata, il corpo e le intestazioni della richiesta personalizzata, nonché il metodo HTTP. I parametri della richiesta sono resi disponibili al codice funzione come parametri di input. Il codice funzione può impostare il corpo della risposta, le intestazioni della risposta e il codice della risposta, che vengono restituiti al chiamante dall'endpoint delle funzioni.

  function main(params) {
      var msg = 'You did not tell me who you are.';
      if (params.name) {
          msg = `Hello, ${params.name}!`
       } else {
          msg = `Hello, FaaS on CodeEngine!`
      }
      return {
          headers: { 'Content-Type': 'text/html; charset=utf-8' },
          body: `<html><body><h3>${msg}</h3></body></html>`
       }
  }

  module.exports.main = main;

function main(params) {
    return {
        headers: { location: 'https://cloud.ibm.com/docs/codeengine' },
        statusCode: 302
    }
}

function main(params) {
    var msg = 'You did not tell me who you are.';
    if (params.name !== "") {
        msg = `Hello, ${params.name}!`
    }
    return {
        headers: { 'Content-Type': 'text/plain;charset=utf-8' },
        body: `${msg}`
    }
}

Gestione degli errori e debug

I richiami della funzione possono restituire errori di sistema o dell'applicazione. Ad esempio, gli errori di sistema indicano che il codice funzione non è stato eseguito correttamente, mentre gli errori dell'applicazione indicano un problema nel codice funzione stesso.

Quando si verifica un errore di sistema, viene restituito un codice di risposta HTTP simile ai codici seguenti.

Se Code Engine può eseguire il codice delle funzioni, risponde al richiamo con uno dei seguenti codici di stato.

Come sviluppatore di una funzione, è possibile generare qualsiasi codice di stato HTTP arbitrario, anche quelli elencati in precedenza. Pertanto, un'intestazione di risposta indica che il codice di stato è stato generato dal codice funzione.

Le funzioni Code Engine aggiungono le seguenti intestazioni di risposta alla risposta di richiamo della funzione.

Caratteristiche di immissione / emissione dei dati della funzione

Per eseguire la funzione in Code Engine, il tuo codice deve implementare un contratto di runtime con le seguenti caratteristiche.

• Deve essere richiamabile da un endpoint pubblico di un'applicazione web, in modo da poter essere incorporato nelle pagine web e quindi invocato da qualsiasi sorgente di Code Engine Eventing, da un browser web o da qualsiasi altro client compatibile con HTTPS.
• È necessario implementare una procedura main come punto di ingresso. La procedura main può ricevere parametri di input sotto forma di una struttura dati formattata JSON e può restituire parametri di output, anche sotto forma di struttura dati formattata JSON.
• Può ricevere un percorso secondario facoltativo, in modo che la funzione possa implementare diverse caratteristiche, in base al percorso specificato. La procedura main della funzione riceve il percorso come parametro di input __ce_path.
• Può ricevere parametri di query facoltativi, che possono essere utilizzati per configurare la funzione al runtime. La procedura main della funzione riceve i parametri come coppie chiave - valore all'interno della struttura dati di input formattata JSON.
• Può ricevere le intestazioni della richiesta, in modo che il codice client possa specificare le codifiche accettate.
• Può ricevere un'intestazione di richiesta di tipo contenuto facoltativa.
• Può ricevere un payload di richiesta facoltativo (corpo), che la funzione elabora al runtime. A seconda del tipo di contenuto della richiesta selezionato, il payload dei dati viene passato al punto di ingresso principale della funzione, in formato codificato in base 64 o "sviluppato in piano" come parte della struttura dei dati di input JSON. I caratteri speciali nelle coppie di valori chiave di application/x-www-form-urlencoded input sono valori percent-encoded.
• Può definire un codice di stato arbitrario HTTP (opzionale), che viene restituito al client che lo invoca.
• Può impostare intestazioni di risposta arbitrarie, come un'ubicazione di reindirizzamento, una codifica di risposta o valori cookie.
• Può restituire un corpo di risposta arbitrario con una codifica binaria o non binaria selezionata; ad esempio, application/octet-stream, application/json, text/*, image/* o audio/*. Se non è impostata alcuna intestazione di risposta content-type, il valore predefinito è text/plain.
• Supporta i seguenti tipi di contenuto della richiesta: application/x-www-form-urlencoded (predefinito), text/plain, application/json, application/octet-stream, image/*, audio/*
• Non supporta l'intestazione della richiesta multipart/form-data.

Opzioni per la visibilità per la funzione Code Engine

Con Code Engine, puoi stabilire il giusto livello di visibilità per la tua funzione definendo gli endpoint o le associazioni del dominio di sistema disponibili per ricevere le richieste.

Ogni funzione ha una mappatura interna del dominio del sistema che è visibile a tutti i componenti dello stesso progetto Code Engine, ma non all'esterno del progetto. In aggiunta all'associazione del dominio di sistema interno, scegli di rendere la funzione visibile a internet pubblico o alla rete privata IBM Cloud.

Per la visibilità pubblica o privata, la funzione viene esposta su un endpoint HTTPS. Per informazioni sul certificato TLS utilizzato, vedere Certificati TLS per i progetti Code Engine.

È possibile distribuire la propria funzione con i seguenti livelli di visibilità:

Puoi configurare le impostazioni dell'endpoint per la visibilità di una funzione dalla console o con la CLI quando crei e distribuisci o aggiorni la tua funzione.

Opzioni per la creazione di funzioni

Informazioni sulle opzioni che è possibile specificare quando si crea la funzione. Tieni presente che le opzioni possono variare tra console e CLI.

Considerazioni per le quote di funzioni

Quando lavori con applicazioni, funzioni e lavori batch, tali risorse vengono eseguite nel contesto di un progetto Code Engine. Le quote di risorse vengono definite in base al progetto e vengono applicati limiti per applicazioni, funzioni e lavori batch.

Per ulteriori informazioni sui limiti di Code Engine, vedi Limiti e quote per Code Engine.

Passi successivi

Ora che hai familiarità con i concetti chiave di utilizzo delle funzioni Code Engine, sei pronto a creare e gestire le funzioni? Vedi i seguenti argomenti.

• Creazione di carichi di lavoro della funzione con codice seriale.
• Creazione di carichi di lavoro della funzione con codice sorgente del repository.
• Creazione di carichi di lavoro della funzione dal codice sorgente locale.

Per ulteriori informazioni sull'utilizzo delle funzioni, vedere i seguenti argomenti.

• Carichi di lavoro funzione.
• Integrazione dei servizi IBM Cloud con i bind del servizio.
• Utilizzo delle variabili di ambiente, delle configmap e dei segreti.
• Funzioni di risoluzione dei problemi.