Voraussetzungen installieren

Da die erforderlichen Kubernetes-Artefakte als Helm-Diagramme in Kubernetes zur Ausführung der Stacks bereitgestellt werden, müssen Sie kubectl sowie Helm installieren. Darüber hinaus benötigen Sie die Oracle Cloud Infrastructure-Befehlszeilenschnittstelle (CLI), die für kubectl erforderlich ist und für andere Aufgaben hilfreich ist.

In diesem Schritt installieren Sie die folgenden Komponenten:
  1. Die OCI-Befehlszeilenschnittstelle.
  2. Wenn sie noch nicht vorhanden ist, kubectl Version 1.18 oder höher.
  3. Helm 3.x

Oracle Cloud Infrastructure -Befehlszeilenschnittstelle installieren

Zuerst installieren Sie die Oracle Cloud Infrastructure-Befehlszeilenschnittstelle (CLI).

  1. Um die OCI-CLI unter Linux oder Mac OS X zu installieren, führen Sie den folgenden Befehl aus:
    bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)"

    Drücken Sie die Eingabetaste, um die Standardwerte für alle Optionen zu übernehmen.

  2. Starten Sie die Shell neu.
    exec -l $SHELL
  3. Mandanten- und Benutzer-OCIDs erfassen:
    1. Rufen Sie die Mandanten-OCID in der Oracle Cloud-Konsole ab, indem Sie auf das Benutzersymbol (oben rechts) und dann auf Mandant klicken. Kopieren Sie die OCID des Mandanten (Feld Mandant).
    2. Rufen Sie die Benutzer-OCID aus der Konsole ab, indem Sie auf Benutzer und dann auf Benutzereinstellungen klicken. Kopieren Sie dann die OCID des Benutzers.
  4. OCI-CLI konfigurieren.
    oci setup config
    Sie werden zur Eingabe folgender Parameter aufgefordert:
    • Speicherort der Konfiguration: Drücken Sie die Eingabetaste.
    • user_ocid: Geben Sie die Benutzer-OCID ein.
    • tenancy_ocid: Geben Sie die Mandanten-OCID ein.
    • region: Geben Sie in der angegebenen Liste Ihre Region ein.
    • RSA-Schlüsselpaar generieren: Drücken Sie die Eingabetaste für "Ja" (Standard).
    • Verzeichnis für Tasten: Drücken Sie die Eingabetaste, um den Standardwert zu erhalten.
    • Name für den Schlüssel: Drücken Sie die Eingabetaste, um den Standardwert zu übernehmen.
    • Passphrase: Drücken Sie die Eingabetaste, um keine Passphrase zu verwenden.
    Eine Ausgabe wie folgt sollte angezeigt werden:
    Private key written to: /home/oracle/.oci/oci_api_key.pem
    Fingerprint: 21:d4:f1:a0:55:a5:c2:ce:...
    Config written to ~/.oci/config
  5. Um die CLI verwenden zu können, müssen Sie den generierten Public Key in Ihr Benutzerkonto hochladen. Rufen Sie den wichtigsten Inhalt ab, indem Sie Folgendes eingeben:
    cat ~/.oci/oci_api_key_public.pem 

    Optional können Sie die Datei mit Ihrem bevorzugten Editor öffnen und die gesamte gedruckte Ausgabe in die Zwischenablage kopieren.

  6. Fügen Sie in der OCI-Webkonsole den im vorherigen Schritt generierten Schlüssel hinzu:
    1. Klicken Sie unter Benutzer auf Benutzereinstellungen.
    2. Klicken Sie auf API-Schlüssel.
    3. Klicken Sie auf Public Key hinzufügen.
    4. Klicken Sie auf Public Key einfügen.
    5. Fügen Sie den oben kopierten Schlüssel ein.
    6. Klicken Sie auf Hinzufügen.
    7. Prüfen Sie, ob der generierte Fingerprint mit der Fingerprintausgabe der Konfiguration übereinstimmt.
  7. Testen Sie die CLI, indem Sie Folgendes eingeben:
    oci os ns get
    Dieser Befehl muss den Namespace Ihres Mandanten (in der Regel den Namen des Mandanten oder eine zufällige Zeichenfolge) ausgeben. Beispiel:
    {
        "data": "your-tenancy-namespace"
    }
    

kubectl installieren

Als Nächstes installieren Sie das Kubernetes-Befehlszeilentool kubectl.

Hinweis:

Wenn Sie Docker Desktop unter Mac OS X oder Windows verwenden, sollte kubectl bereits installiert sein, und Sie können diesen Schritt überspringen.

Im Folgenden finden Sie eine allgemeine Prozedur zur Installation von kubectl. Detaillierte Anweisungen zu Ihrem Betriebssystem finden Sie unter "Tools installieren" in der Kubernetes-Onlinedokumentation, die im Thema "Bevor Sie beginnen" aufgeführt ist.

  1. Führen Sie den folgenden Befehl aus, um kubectl zu installieren:
    PLATFORM=$(uname)
    curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/${PLATFORM,,}/amd64/kubectl"
    chmod +x ./kubectl
    sudo mv ./kubectl /usr/local/bin/kubectl
    
    Verwenden Sie unter Windows:
    curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.20.0/bin/windows/amd64/kubectl.exe
  2. Fügen Sie die Binärdatei zu Ihrem Pfad hinzu.
  3. Stellen Sie sicher, dass Sie eine kubectl-Version von 1.18 oder höher verwenden, indem Sie Folgendes eingeben:
    kubectl version --client

Helm installieren

Jetzt installieren Sie die Helm-CLI.

Im Folgenden finden Sie ein allgemeines Verfahren zur Installation von Helm. Ausführlichere Anweisungen zu Ihrem Betriebssystem finden Sie unter "Helm installieren", die im Thema "Bevor Sie beginnen" aufgeführt sind.

Um das Helm auf Mac OS X und Linux zu installieren, geben Sie Folgendes ein:
curl https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3 | bash

Terraform installieren

Wenn es noch nicht installiert ist, müssen Sie Terraform installieren.

Hinweis:

Links zur Installationsdokumentation, auf die in diesem Thema verwiesen wird, finden Sie im Thema "Bevor Sie beginnen".
Wenn Sie sich auf einem Linux-basierten Rechner oder Mac OS X befinden, wird empfohlen, Terraform mit tfswitch zu installieren, wie in der Dokumentation "Installieren" unter tfswitch beschrieben, da ein einfacher Wechsel zwischen Terraform-Versionen möglich ist. Wenn Sie tfswitch installiert haben, wählen Sie eine Version mit:
tfswitch

Dieses Handbuch wurde mit Terraform-Version 0.14.11 getestet

Wenn Sie Anweisungen zum Einrichten von Terraform benötigen, besuchen Sie andernfalls die Terraform-Installationsdokumentation, und wählen Sie den Pfad aus, der Ihrer Umgebung entspricht.