Funktionseinschränkungen

• Keine Unterstützung für die Subskription von Ereignisproduzenten.
• Keine Unterstützung für Terraform.

Wie kann ich meinen Code als Code Engine Funktionskomponente laufen lassen?

Unabhängig davon, ob Ihr Code als Quellcode in einer lokalen Datei oder in einem Git Repository vorhanden ist, oder ob es sich bei Ihrem Code um ein vorhandenes Code-Bundle handelt, das sich in einer öffentlichen oder privaten Registrierung befindet, bietet Code Engine eine optimierte Methode, um Ihren Code als Funktion auszuführen.

• Wenn Sie mit einem Quellcode beginnen, der sich in einem Git Repository befindet, können Sie auf den Speicherort Ihres Quellcodes verweisen. Code Engine erstellt dann das Code-Bundle aus Ihrem Quellcode und erstellt die Funktion mit einem einzigen Vorgang. In diesem Szenario lädt Code Engine Ihren Code auf IBM Cloud® Container Registry hoch. Weitere Informationen finden Sie unter Funktion aus Repository-Quellcode erstellen.

• Wenn Sie mit dem Quellcode auf einer lokalen Workstation beginnen, können Sie auf den Speicherort Ihres Quellcodes verweisen, und Code Engine übernimmt die Erstellung des Abbilds aus Ihrem Quellcode und die Erstellung der Funktion mit einem einzigen CLI-Befehl. In diesem Szenario lädt Code Engine Ihren Code auf IBM Cloud® Container Registry hoch. Weitere Informationen finden Sie unter Funktion aus lokalem Quellcode mit der Befehlszeilenschnittstelle erstellen.

• Wenn Sie mit Quellcode beginnen, können Sie Ihren Quellcode auch inline ausführen. In diesem Szenario fügen Sie Ihren Quellcode ein, wenn Sie Ihre Funktion erstellen. Weitere Informationen finden Sie unter Funktion mit Inline-Code erstellen.

Nachdem Sie Ihre Funktion erstellt und ausgeführt haben, können Sie Ihre Funktion auch auf eine der oben genannten Arten aktualisieren, unabhängig davon, wie Sie Ihre Funktion erstellt oder zuvor aktualisiert haben.

Was passiert, wenn ich meine Funktion aufrufe?

Wenn eine Funktion aufgerufen (gestartet) wird, wird die entsprechende Funktionsinstanz mit den konfigurierten Laufzeitcontainer-und Ressourcenparametern initialisiert. Der Prozess der ersten Initialisierung wird als Kaltstartbezeichnet.

Um die Latenzzeit für den Kaltstart zu reduzieren, optimiert Code Engine den Aufruf, indem bestimmte Laufzeiten mit bestimmten CPU-und Speicherkonfigurationen vorab aktualisiert werden. Zu den vorgewärmten Kombinationen für Funktionen gehören die Laufzeiten Node.js und Python sowie die Standard-CPU- und Speicherkombination für Funktionen, d. h. 0.25 vCPU x 1 GB Speicher. Darüber hinaus soll das System die Wiederverwendung von bereits initialisierten Funktionsinstanzen verbessern. Daher wird eine Funktionsinstanz nach Abschluss des Aufrufs aktiv gehalten, um nachfolgende Aufrufe durch Wiederverwendung derselben Instanz und Wiederverwendung des Status der Instanz nach Abschluss des letzten Aufrufs zuzulassen. Die Wiederverwendung einer Funktionsinstanz ist nicht garantiert.

Kann ich meine Funktionsinstanz länger am Leben halten?

Mit Code Enginewird Ihre Funktion abhängig von der Workload automatisch nach oben und unten skaliert. Wenn Sie Ihre Funktion mit der Standardkombination aus CPU und Speicher erstellen, wird Ihre Funktion in einen vorgewärmten Container injiziert, der für die Verwendung optimiert ist. Wenn Sie eine Funktion mit einer anderen CPU-und Speicherkombination als der Standardkombination erstellen, wird Ihre Funktion in einen neuen Container injiziert. Standardmäßig wird dieser Container nur für einen kurzen Zeitraum nach Abschluss der Funktion aktiv gehalten. Weitere Informationen finden Sie unter Unterstützte CPU-und Speicherkombinationen für Funktionen.

Sie können die Zeit, die Ihr Container aktiv bleibt, mit der Option --scale-down-delay in der Befehlszeilenschnittstelle oder mit der Option Scale-down-Verzögerung in der Konsole ändern. Beachten Sie, dass die Beibehaltung des Containers zwar die Kaltstartzeiten für jede nachfolgende Ausführung Ihrer Funktion reduziert, Sie jedoch auch die Zeit in Rechnung stellen, die der angepasste Funktionscontainer vorhanden ist.

Anforderungen und Antworten

Die Funktionen werden über das Protokoll HTTP aufgerufen. Wenn Sie Ihre Funktion aufrufen, können Sie die benutzerdefinierten Anforderungsparameter, den benutzerdefinierten Anforderungskörper und die Kopfzeilen sowie die Methode HTTP angeben. Die Anforderungsparameter werden dem Funktionscode als Eingabeparameter zur Verfügung gestellt. Der Funktionscode kann den Antworthauptteil, Antwortheader und Antwortcode festlegen, die vom Funktionsendpunkt an den Aufrufenden zurückgegeben werden.

  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}`
    }
}

Fehlerbehandlung und Debugging

Funktionsaufrufe können System-oder Anwendungsfehler zurückgeben. Systemfehler geben beispielsweise an, dass der Funktionscode nicht erfolgreich ausgeführt wurde, während Anwendungsfehler auf ein Problem im Funktionscode selbst hinweisen.

Wenn ein Systemfehler auftritt, wird ein HTTP Antwortcode ähnlich den folgenden Codes zurückgegeben.

Wenn Code Engine den Funktionscode ausführen kann, antwortet er auf den Aufruf mit einem der folgenden Statuscodes.

Als Entwickler einer Funktion können Sie jeden beliebigen HTTP Statuscode erzeugen, auch die zuvor aufgeführten. Daher gibt ein Antwortheader an, dass der Statuscode vom Funktionscode generiert wurde.

Die Funktionen von Code Engine fügen der Funktionsaufrufantwort die folgenden Antwortheader hinzu.

Ein-/Ausgabemerkmale für Funktionsdaten

Zum Ausführen Ihrer Funktion in Code Enginemuss Ihr Code einen Laufzeitvertrag mit den folgenden Merkmalen implementieren.

• Muss von einem öffentlichen Webanwendungsendpunkt aus aufrufbar sein, so dass er in Webseiten eingebettet und dann von einer beliebigen Code Engine Eventing-Quelle, einem Webbrowser oder einem anderen HTTPS-fähigen Client aufgerufen werden kann.
• Sie müssen eine main-Prozedur als Eingangspunkt implementieren. Die Prozedur main kann Eingabeparameter in Form einer JSON-formatierten Datenstruktur empfangen und Ausgabeparameter zurückgeben, auch in Form einer JSON-formatierten Datenstruktur.
• Kann einen optionalen Unterpfad empfangen, sodass die Funktion basierend auf dem angegebenen Pfad unterschiedliche Versionen implementieren kann Die Prozedur main der Funktion empfängt den Pfad als Eingabeparameter __ce_path.
• Kann optionale Abfrageparameter empfangen, die verwendet werden können, um die Funktion zur Laufzeit zu konfigurieren. Die Prozedur main der Funktion empfängt die Parameter als Schlüssel/Wert-Paare in der Eingabedatenstruktur im JSON-Format.
• Kann Anforderungsheader empfangen, sodass Clientcode akzeptierte Codierungen angeben kann
• Kann einen optionalen Inhaltstyp-Anforderungsheader empfangen.
• Kann optionale Anforderungsnutzdaten (Hauptteil) empfangen, die die Funktion zur Laufzeit verarbeitet. Abhängig vom ausgewählten Inhaltstyp der Anforderung werden die Datennutzdaten an den Haupteingangspunkt der Funktion übergeben, entweder in Base64-codierter Form oder als Teil der JSON-Eingabedatenstruktur. Sonderzeichen in Schlüsselwertpaaren von application/x-www-form-urlencoded input sind percent-encoded-Werte.
• Kann einen beliebigen HTTP Statuscode definieren (optional), der dann an den aufrufenden Client zurückgegeben wird.
• Kann beliebige Antwortheader festlegen, z. B. eine Umleitungsposition, eine Antwortcodierung oder Cookiewerte.
• Kann einen beliebigen Antworthauptteil mit einer ausgewählten binären oder nicht binären Codierung zurückgeben, z. B. application/octet-stream, application/json, text/*, image/* oder audio/*. Wenn kein content-type-Antwortheader festgelegt ist, wird standardmäßig text/plain verwendet.
• Unterstützt die folgenden Inhaltstypen für Anforderungen: application/x-www-form-urlencoded (Standardeinstellung), text/plain, application/json, application/octet-stream, image/*, audio/*
• Unterstützt den Anforderungsheader multipart/form-data nicht.

Optionen für die Sichtbarkeit einer Funktion Code Engine

Mit Code Engine können Sie den richtigen Grad an Sichtbarkeit für Ihre Funktion bestimmen, indem Sie die Endpunkte oder Systemdomänenzuordnungen definieren, die für den Empfang von Anfragen verfügbar sind.

Jede Funktion hat eine interne Systemdomänenzuordnung, die für alle Komponenten innerhalb desselben Code Engine Projekts, aber nicht außerhalb des Projekts sichtbar ist. Zusätzlich zur Zuordnung der internen Systemdomäne wählen Sie aus, dass die Funktion im öffentlichen Internet oder im privaten Netz von IBM Cloud sichtbar gemacht werden soll.

Bei öffentlicher oder privater Sichtbarkeit wird die Funktion auf einem HTTPS Endpunkt ausgesetzt. Einzelheiten über das verwendete TLS-Zertifikat finden Sie unter TLS-Zertifikate für Code Engine Projekte.

Sie können Ihre Funktion mit den folgenden Sichtbarkeitsebenen bereitstellen:

Sie können die Endpunkteinstellungen für die Sichtbarkeit einer Funktion über die Konsole oder die Befehlszeilenschnittstelle festlegen, wenn Sie Ihre Funktion erstellen und bereitstellen oder aktualisieren.

Optionen zum Erstellen von Funktionen

Informieren Sie sich über die Optionen, die Sie beim Erstellen Ihrer Funktion angeben können. Je nachdem, ob Sie die Konsole oder die Befehlszeilenschnittstelle verwenden, sind möglicherweise andere Optionen verfügbar.

Hinweise zu Funktionskontingenten

Wenn Sie mit Anwendungen, Funktionen und Stapeljobs arbeiten, werden diese Ressourcen im Kontext eines Code Engine-Projekts ausgeführt. Ressourcenkontingente werden pro Projekt definiert und Grenzwerte gelten für Anwendungen, Funktionen und Stapeljobs.

Weitere Informationen zu Code Engine-Grenzwerte finden Sie unter Grenzwerte und Kontingente für Code Engine.

Nächste Schritte

Da Sie nun mit den Schlüsselkonzepten der Arbeit mit Code Engine-Funktionen vertraut sind, können Sie Funktionen erstellen und mit ihnen arbeiten? Weitere Informationen finden Sie in den folgenden Abschnitten.

• Funktionsworkloads mit Inline-Code erstellen.
• Funktionsworkloads mit Repository-Quellcode erstellen.
• Funktionsworkloads aus lokalem Quellcode erstellen

Weitere Informationen zur Arbeit mit Funktionen finden Sie in den folgenden Themen.

• Funktionsworkloads.
• IBM Cloud-Services mit Servicebindungen integrieren
• Arbeiten mit Umgebungsvariablen, configmaps und geheimen Schlüsseln.
• Fehlerbehebungsfunktionen.