Einführung in die Code Engine-CLI

Mit der IBM Cloud® Code Engine-API können Sie Code Engine-Entitäten erstellen und verwalten.

Einrichten Ihrer CLI-Umgebung

Richten Sie Ihre CLI-Umgebung ein, um mit der Befehlszeilenschnittstelle zu arbeiten, um Code Engine-Entitäten zu erstellen und zu verwalten. Stellen Sie sicher, dass Sie die neueste Version der „ IBM Cloud “-CLI installiert haben.

Vorbereitende Schritte

Sie müssen ein IBM Cloud-Kontoerstellen.

  1. Laden Sie die IBM Cloud-Befehlszeilenschnittstelle herunter und installieren Sie diese.

  2. Melden Sie sich bei der IBM Cloud-CLI an.

    1. Melden Sie sich bei der IBM Cloud-CLI an.
        ibmcloud login
    ```
2. Wenn Sie über mehrere Konten verfügen, werden Sie aufgefordert, das Konto auszuwählen, das verwendet werden soll. Gehen Sie gemäß den Eingabeaufforderungen vor oder verwenden Sie den Befehl **`target`**, um das IBM Cloud-Konto auszuwählen.

```txt {: pre}
    ibmcloud target -c <account_id>
    ```
3. Geben Sie eine Region an. Verwenden Sie den **`target`** Befehl, um Regionen auszuwählen oder zu ändern.

```txt {: pre}
    ibmcloud target -r <region>
    ```
4. Geben Sie eine Ressourcengruppe an. Führen Sie den folgenden Befehl aus, um eine Liste der Ressourcengruppen abzurufen.

```txt {: pre}
    ibmcloud resource groups
    ```
    Beispielausgabe

    ```txt {: screen}
    Retrieving all resource groups under account <account_id> as email@ibm.com...
    OK
    Name      ID                                 Default Group   State   
    default   a8a12accd63b437bbd6d58fb8b462ca7   true            ACTIVE
    test      a8a12abbbd63b437cca6d58fb8b462ca7  false           ACTIVE
    ```
5. Führen Sie den folgenden Befehl aus, um eine Ressourcengruppe als Ziel festzulegen.

```txt {: pre}
    ibmcloud target -g <resource_group>
    ```
    Beispielausgabe

    ```txt {: screen}
    Targeted resource group default
    ```

  3. Installieren Sie das Code Engine-Befehlszeilenschnittstellen-Plug-in.

    ibmcloud plugin install code-engine

  4. Stellen Sie sicher, dass das CLI-Plugin „ Code Engine “ installiert ist. Sie können den Befehl ibmcloud code-engine version oder den Befehl ibmcloud plugin list verwenden, um zu bestätigen, dass das Plug-in installiert ist.

    ibmcloud code-engine version

    Beispielausgabe

    OK
version:  v1.54.2
commit:   e4800be63b1077563bdbaee9e656ce1f81c3e08d

  5. Führen Sie den Befehl ibmcloud ce help aus, um die Befehle für die Befehlszeilenschnittstelle Code Engine anzuzeigen. Beispiel:

    ibmcloud ce help

Mit der Befehlszeilenschnittstelle von Code Engine arbeiten

Jetzt, da Ihre Code Engine-CLI-Umgebung eingerichtet ist, können Sie mit Code Engine-Ressourcen wie Anwendungen, Funktionen oder Jobs über die CLI arbeiten.

Bevor Sie mit Ressourcen von Code Engine arbeiten, müssen Sie im Kontext eines Projekts arbeiten.

Ein Projekt ist eine Gruppierung von „ Code Engine “-Objekten wie Anwendungen, Funktionen, Jobs, Flotten und Builds. Ein Projekt basiert auf einem Kubernetes-Namensbereich. Der Name des Projekts muss innerhalb der Ressourcengruppe, des Benutzerkontos und der Region von IBM Cloud® eindeutig sein. Projekte dienen dazu, Ressourcen zu verwalten und Zugriff auf deren Elemente zu gewähren.

Ein Projekt bietet folgende Funktionen:

  • Ein eindeutiger Namensraum für Entitätsnamen.
  • Verwaltung des Zugriffs auf Projektressourcen von außen.
  • Verwaltung des ausgehenden Zugriffs auf Backing-Dienste, Register und Repositorien.
  • Ein automatisch generiertes Zertifikat für den Transport Layer Service ( TLS ).

Weitere Informationen zu Code Engine-Projekten finden Sie unter Projekte verwalten.

  1. Erstellen Sie mit dem Befehl project create ein Projekt. Verwenden Sie einen Projektnamen, der in Ihrer Region eindeutig ist.

    ibmcloud ce project create --name PROJECT_NAME

    Beispielausgabe

    Creating project 'myproject'...
OK

  2. Zeigen Sie Details zu dem Projekt mit dem Befehl project get an.

    ibmcloud ce project get --name PROJECT_NAME

    Beispielausgabe

    Getting project 'myproject'...
OK
Name:                       myproject
ID:                         01234567-abcd-abcd-abcd-abcdabcd1111
Status:                     active
Selected:                   true
Region:                     us-south
Resource Group:             default
Service Binding Service ID: ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f
Age:                        52d
Created:                    Fri, 15 Jan 2021 13:32:30 -0500
Updated:                    Fri, 15 Jan 2021 13:32:45 -0500
Quotas:
Category                                  Used      Limit
App revisions                             1         100
Apps                                      1         100
Build runs                                0         100
Builds                                    0         100
Configmaps                                2         100
CPU                                       1.025     64
Ephemeral storage                         902625Ki  256G
Instances (active)                        1         250
Instances (total)                         2         2500
Job runs                                  1         100
Jobs                                      1         100
Memory                                    4400M     256G
Secrets                                   5         100
Subscriptions (cron)                      0         100
Subscriptions (IBM Cloud Object Storage)  0         100

Alternativ können Sie den Befehl project list verwenden, um eine Liste Ihrer erstellten Projekte anzuzeigen.

Damit Sie mit einem Projekt in der Befehlszeilenschnittstelle arbeiten können, muss das Projekt als aktueller Kontext ausgewählt werden. Ein Projekt wird bei der Erstellung automatisch als aktueller Kontext ausgewählt, es sei denn, die Option --no-select wird angegeben. Wenn Sie ein Projekt auswählen möchten, das derzeit nicht ausgewählt ist, verwenden Sie den Befehl project select.

Weitere Informationen zur Arbeit mit Projekten finden Sie unter Projekte verwalten.

Nächste Schritte

Nachdem Sie Ihre CLI-Umgebung eingerichtet und die ersten Schritte ausgeführt haben, um sicherzustellen, dass Sie im Kontext eines Code Engine-Projekts arbeiten, können Sie die Code Engine-CLI verwenden, um mit Apps, Funktionen und Jobs zu arbeiten.

Informationen zum Einstieg in die Arbeit mit Code Engine-Komponenten über die Befehlszeilenschnittstelle finden Sie in den folgenden Abschnitten.

Weitere Informationen zur Code Engine-CLI finden Sie unter CLI-Umgebung einrichten.

Weitere Informationen zur Arbeit in der Code Engine-CLI-Umgebung finden Sie unter Code Engine CLI Command Reference documentation.

Eine Zusammenfassung der Änderungen für jede Version der Befehlszeilenschnittstelle finden Sie unter CLI-Versionsprotokoll. Achten Sie darauf, dass Ihre Befehlszeilenschnittstelle (CLI) auf dem neuesten Stand ist, sodass Sie alle verfügbaren Befehle und deren Optionen verwenden können.