Einführung in die Lernprogramme für Lösungen

Lernprogramme für Lösungen liefern, basierend auf bewährten Verfahren und praxistauglichen Technologien, schrittweise Anweisungen zum Implementieren einheitlicher Muster mit IBM Cloud.

Bevor Sie sich mit den einzelnen Lernprogrammen beschäftigen, unterstützt Sie diese Anleitung dabei, eine Entwicklungsumgebung einzurichten, in der Sie die Anweisungen aus den Anleitungen dieser Lernprogramme erfolgreich umsetzen können.

Ziele

Gehen Sie wie folgt vor, um die Tools zu installieren, die für das produktive Arbeiten mit IBM Cloud erforderlich sind:

  • IBM Cloud-Befehlszeilenschnittstelle - Die Befehlszeilenschnittstelle für die Interaktion mit der IBM Cloud-API.
  • Docker - Zur Bereitstellung und Ausführung von Software in Paketen, die als Container bezeichnet werden.
  • kubectl - Eine Befehlszeilenschnittstelle zum Ausführen von Befehlen für Kubernetes-Cluster.
  • oc - Verwaltet OpenShift-Anwendungen und stellt Tools bereit, die mit den einzelnen Komponenten des Systems interagieren.
  • Helm 3 - Unterstützt Sie bei der Verwaltung von Kubernetes-Anwendungen. Mithilfe von Helm-Charts können Sie auch hoch komplexe Kubernetes-Anwendungen definieren und installieren und Upgrades durchführen.
  • Terraform - Automatisiert die Ressourcenbereitstellung.
  • jq - Ein einfacher und flexibler JSON-Befehlszeilenprozessor.
  • Git - Ein kostenfreies, verteiltes Open-Source-Versionssteuerungssystem.

Um die Installation dieser Tools zu vermeiden, können Sie auch die Cloud Shell über die IBM Cloud-Konsole verwenden.

Microsoft Windows

In den folgenden Abschnitten wird davon ausgegangen, dass Sie Microsoft Windows 10 (64-Bit) unter einem Benutzer mit Administratorberechtigungen ausführen. Wenn Sie mit den spezifischen Abschnitten fertig sind, fahren Sie mit der für alle Betriebssysteme einheitlichen Konfiguration fort.

IBM Cloud-Befehlszeilenschnittstelle

  1. Laden Sie die IBM Cloud-Befehlszeilenschnittstelle von https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest herunter und installieren Sie sie.

  2. Verifizieren Sie die Installation wie folgt:

    ibmcloud version

    Die Maschine muss möglicherweise nach der Installation neu gestartet werden.

Docker

  1. Der Docker-Desktop unter Windows ist eine Option zum Ausführen von Container-Images in Windows. Lesen Sie unbedingt die Bedingungen der Lizenzvereinbarung, bevor Sie mit der Installation fortfahren.

  2. Falls Sie noch nicht über ein kostenfreies Konto verfügen, führen Sie eine entsprechende Registrierung unter https://hub.docker.com/signup durch.

  3. Laden Sie Docker Desktop on Windows von https://docs.docker.com/docker-for-windows/install/ herunter und installieren Sie es.

  4. Verifizieren Sie die Installation wie folgt:

    docker --version
docker run hello-world

    Möglicherweise müssen Sie sich abmelden und warten, bis der Docker-Dämon gestartet wird.

kubectl

  1. Laden Sie kubectl von https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-windowsherunter.
  2. Verschieben Sie die Binärdatei kubectl.exe in den entsprechenden Pfad.
  3. Verifizieren Sie die Installation wie folgt:
    kubectl version --client=true

oc

  1. Laden Sie die aktuelle 4.x OpenShift-CLI (oc) von der Website 'https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/.' herunter.
  2. Verschieben Sie die Binärdatei oc.exe in den entsprechenden Pfad.
  3. Verifizieren Sie die Installation wie folgt:
    oc version

Helm 3

  1. Laden Sie helm von https://github.com/helm/helm/releases/latest herunter.
  2. Dekomprimieren Sie das heruntergeladene Archiv.
  3. Verschieben Sie die Binärdatei helm.exe in den entsprechenden Pfad.
  4. Verifizieren Sie die Installation wie folgt:
    helm version

Terraform

  1. Laden Sie terraform von https://developer.hashicorp.com/terraform/downloadsherunter.
  2. Dekomprimieren Sie das heruntergeladene Archiv.
  3. Verschieben Sie die Binärdatei terraform.exe in den entsprechenden Pfad.
  4. Verifizieren Sie die Installation wie folgt:
    terraform version

Für die Verwaltung von IBM Cloud-Ressourcen mit Terraform muss auch IBM Cloud Provider installiert werden. Beginnend mit Terraform 0.13, kann der Provider automatisch von der Terraform-Plug-in-Registry heruntergeladen werden. Führen Sie die Anweisungen in der Providerdokumentation aus, um die Eigenschaft required_providers in Ihren Terraform-Vorlagen zu konfigurieren.

jq

  1. Laden Sie jq von https://jqlang.github.io/jq/herunter.
  2. Benennen Sie jq-win64.exe in jq.exe um.
  3. Verschieben Sie die Binärdatei jq.exe in den entsprechenden Pfad.
  4. Verifizieren Sie die Installation wie folgt:
    jq --version

Git

  1. Laden Sie git von https://github.com/git-for-windows/git/releases/latest herunter und installieren Sie es.
  2. Verifizieren Sie die Installation wie folgt:
    git --version

Fahren Sie mit der für alle Betriebssysteme einheitlichen Konfiguration fort.

Apple macOS

In den folgenden Abschnitten wird davon ausgegangen, dass Sie macOS High Sierra oder eine neuere Version unter einem Benutzer mit Administratorberechtigungen ausführen. Wenn Sie mit den spezifischen Abschnitten fertig sind, fahren Sie mit der für alle Betriebssysteme einheitlichen Konfiguration fort.

IBM Cloud-Befehlszeilenschnittstelle

  1. Laden Sie die IBM Cloud-Befehlszeilenschnittstelle von https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest herunter und installieren Sie sie.
  2. Verifizieren Sie die Installation wie folgt:
    ibmcloud version

Docker

  1. Der Docker-Desktop unter Mac ist eine Option zum Ausführen von Container-Images auf MacOS. Lesen Sie unbedingt die Bedingungen der Lizenzvereinbarung, bevor Sie mit der Installation fortfahren. Weitere Optionen umfassen Podman.
  2. Falls Sie noch nicht über ein kostenfreies Konto verfügen, führen Sie eine entsprechende Registrierung unter https://hub.docker.com/signup durch.
  3. Laden Sie Docker Desktop on Mac von https://docs.docker.com/docker-for-mac/install/ herunter und installieren Sie es.
  4. Verifizieren Sie die Installation wie folgt:
    docker --version
docker run hello-world

kubectl

  1. Laden Sie kubectl von https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-macosherunter.
  2. Machen Sie die Binärdatei kubectl ausführbar.
    chmod +x ./kubectl
  3. Verschieben Sie die Binärdatei in den entsprechenden Pfad.
    sudo mv ./kubectl /usr/local/bin/kubectl
  4. Verifizieren Sie die Installation wie folgt:
    kubectl version --client=true

oc

  1. Laden Sie die aktuelle 4.x OpenShift-CLI (oc) von der Website 'https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/.' herunter.
  2. Extrahieren Sie openshift-client-mac.tar.gz (Intel) oder openshift-install-mac-arm64.tar.gz (Apple Silicon):
    tar zxvf openshift-client-mac*.tar.gz oc
  3. Verschieben Sie die Binärdatei oc in den entsprechenden Pfad.
    sudo mv ./oc /usr/local/bin/oc
  4. Verifizieren Sie die Installation wie folgt:
    oc version
    macOS Catalina und höher fordert Sie möglicherweise mit einer Nachricht auf, dass der Entwickler nicht verifiziert werden kann. Damit oc trotzdem ausgeführt werden kann, führen Sie sudo xattr -r -d com.apple.quarantine /usr/local/bin/oc aus.

Helm 3

  1. Laden Sie helm von https://github.com/helm/helm/releases/latest herunter.
  2. Dekomprimieren Sie das heruntergeladene Archiv.
  3. Verschieben Sie die Binärdatei helm in den entsprechenden Pfad.
    sudo mv ./darwin-amd64/helm /usr/local/bin/helm
  4. Verifizieren Sie die Installation wie folgt:
    helm version
    macOS Catalina und höher fordert Sie möglicherweise mit einer Nachricht auf, dass der Entwickler nicht verifiziert werden kann. Damit helm trotzdem ausgeführt werden kann, führen Sie sudo xattr -r -d com.apple.quarantine /usr/local/bin/helm aus.

Terraform

  1. Laden Sie terraform von https://developer.hashicorp.com/terraform/downloadsherunter.
  2. Dekomprimieren Sie das heruntergeladene Archiv.
  3. Verschieben Sie die Binärdatei terraform in den entsprechenden Pfad.
    sudo mv ./terraform /usr/local/bin/terraform
  4. Verifizieren Sie die Installation wie folgt:
    terraform version

Für die Verwaltung von IBM Cloud-Ressourcen mit Terraform muss auch IBM Cloud Provider installiert werden. Beginnend mit Terraform 0.13, kann der Provider automatisch von der Terraform-Plug-in-Registry heruntergeladen werden. Führen Sie die Anweisungen in der Providerdokumentation aus, um die Eigenschaft required_providers in Ihren Terraform-Vorlagen zu konfigurieren.

jq

  1. Laden Sie jq von https://jqlang.github.io/jq/herunter.
  2. Benennen Sie die heruntergeladene Datei in jq um.
  3. Machen Sie die Binärdatei jq ausführbar.
    chmod +x ./jq
  4. Verschieben Sie die Binärdatei jq in den entsprechenden Pfad.
    sudo mv ./jq /usr/local/bin/jq
  5. Verifizieren Sie die Installation wie folgt:
    jq --version
    macOS Catalina und höher fordert Sie möglicherweise mit einer Nachricht auf, dass der Entwickler nicht verifiziert werden kann. Damit jq trotzdem ausgeführt werden kann, führen Sie sudo xattr -r -d com.apple.quarantine /usr/local/bin/jq aus.

Git

  1. Überprüfen Sie, ob git installiert ist:
    git --version
    Möglicherweise werden Sie von macOS dazu aufgefordert, die Entwicklertools zu installieren. Zu diesen Tools gehört die git-Befehlszeile.

Fahren Sie mit der für alle Betriebssysteme einheitlichen Konfiguration fort.

Ubuntu Linux

In den folgenden Abschnitten wird davon ausgegangen, dass Sie Ubuntu Linux als Benutzer ohne Rootberechtigung ausführen, der über Zugriff auf Rootberechtigungen verfügt. Wenn Sie mit den spezifischen Abschnitten fertig sind, fahren Sie mit der für alle Betriebssysteme einheitlichen Konfiguration fort. Wenn Sie die Linux-basierte Cloud-Shell verwenden, fahren Sie mit dem Abschnitt zur Cloud-Shell fort.

IBM Cloud-Befehlszeilenschnittstelle

  1. Laden Sie die IBM Cloud-Befehlszeilenschnittstelle von https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest herunter und installieren Sie sie.
  2. Verifizieren Sie die Installation wie folgt:
    ibmcloud version

Docker

  1. Falls Sie noch nicht über ein kostenfreies Konto verfügen, führen Sie eine entsprechende Registrierung unter https://hub.docker.com/signup durch.
  2. Installieren Sie Docker Engine unter Ubuntu gemäß den Anweisungen in https://docs.docker.com/engine/install/ubuntu/.
  3. Verifizieren Sie die Installation wie folgt:
    docker --version
sudo docker run hello-world
    Führen Sie die Schritte nach der Installation aus, um Docker unter Ihrem eigenen Benutzer anstelle des Rootbenutzers auszuführen.

kubectl

  1. Laden Sie kubectl von https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-linuxherunter.
  2. Machen Sie die Binärdatei kubectl ausführbar.
    chmod +x ./kubectl
  3. Verschieben Sie die Binärdatei in den entsprechenden Pfad.
    sudo mv ./kubectl /usr/local/bin/kubectl
  4. Verifizieren Sie die Installation wie folgt:
    kubectl version --client=true

oc

  1. Laden Sie die aktuelle 4.x OpenShift-CLI (oc) von der Website 'https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/.' herunter.
  2. Extrahieren Sie openshift-client-linux.tar.gz:
    tar zxvf openshift-client-linux.tar.gz oc
  3. Verschieben Sie die Binärdatei oc in den entsprechenden Pfad.
    sudo mv ./oc /usr/local/bin/oc
  4. Verifizieren Sie die Installation wie folgt:
    oc version

Helm 3

  1. Laden Sie helm von https://github.com/helm/helm/releases/latest herunter.
  2. Dekomprimieren Sie das heruntergeladene Archiv.
  3. Verschieben Sie die Binärdatei helm in den entsprechenden Pfad.
    sudo mv ./linux-amd64/helm /usr/local/bin/helm
  4. Verifizieren Sie die Installation wie folgt:
    helm version

Terraform

  1. Laden Sie terraform von https://developer.hashicorp.com/terraform/downloadsherunter.
  2. Dekomprimieren Sie das heruntergeladene Archiv.
  3. Verschieben Sie die Binärdatei terraform in den entsprechenden Pfad.
    sudo mv ./terraform /usr/local/bin/terraform
  4. Verifizieren Sie die Installation wie folgt:
    terraform version

Für die Verwaltung von IBM Cloud-Ressourcen mit Terraform muss auch IBM Cloud Provider installiert werden. Beginnend mit Terraform 0.13, kann der Provider automatisch von der Terraform-Plug-in-Registry heruntergeladen werden. Führen Sie die Anweisungen in der Providerdokumentation aus, um die Eigenschaft required_providers in Ihren Terraform-Vorlagen zu konfigurieren.

jq

  1. Installieren Sie jq wie folgt:
    sudo apt install jq
  2. Verifizieren Sie die Installation wie folgt:
    jq --version

Git

  1. Installieren Sie git wie folgt:
    sudo apt install git
  2. Verifizieren Sie die Installation wie folgt:
    git --version

Fahren Sie mit der für alle Betriebssysteme einheitlichen Konfiguration fort.

Für alle Betriebssysteme einheitlich

Die Informationen in den folgenden Abschnitten sind für alle Betriebssysteme einheitlich.

Plug-ins der IBM Cloud-Befehlszeilenschnittstelle

Plug-ins erweitern die Funktionalität der IBM Cloud-Befehlszeilenschnittstelle mit Befehlen, die für einen Service spezifisch sind.

  1. Installieren Sie die folgenden Plug-ins:
    ibmcloud plugin install container-registry
ibmcloud plugin install cloud-object-storage
ibmcloud plugin install kubernetes-service
ibmcloud plugin install vpc-infrastructure
ibmcloud plugin install code-engine
    Um alle verfügbaren Plug-ins anzuzeigen, führen Sie ibmcloud plugin repo-plugins aus und installieren Sie ein Plug-in ibmcloud plugin install <PLUGIN_NAME>

GitHub-Konto

  1. Führen Sie eine Registrierung für ein kostenfreies Konto unter https://github.com/ durch.
  2. Erstellen Sie ein neues öffentliches Repository unter https://github.com/new, um sich mit GitHub vertraut zu machen.

IBM Cloud GitLab

IBM Cloud stellt gehostete Git-Repositorys bereit, die in GitLab Community Edition erstellt wurden und auf die mit denselben Berechtigungsnachweisen zugegriffen werden kann, die auch für die Anmeldung bei IBM Cloud verwendet werden. Es wird empfohlen, den öffentlichen SSH-Schlüssel zu konfigurieren, um die Befehlszeileninteraktionen mit den Git-Repositorys zu vereinfachen.

  1. Verwenden Sie diese Anweisungen, um ein neues SSH-Schlüsselpaar zu generieren, wenn Sie nicht über eines verfügen.
  2. Fügen Sie Ihren öffentlichen SSH-Schlüssel zu Ihren Git-Einstellungen in der Region hinzu, in der Sie Ihre Git-Repositorys hosten möchten, z. B. Dallas(us-south.git.cloud.ibm.com), London(eu-gb.git.cloud.ibm.com) oder Frankfurt(eu-de.git.cloud.ibm.com).

Gehen Sie wie folgt vor, um die Konfiguration zu verifizieren:

  1. Erstellen Sie ein neues privates Projekt in GitLab und wählen Sie die Option zur Initialisierung des Repositorys mit einer Readme-Datei aus.
  2. Führen Sie ein Check-out für das Projekt über die Befehlszeile durch, indem Sie es klonen. Verwenden Sie hierzu den SSH-Link.
  3. Aktualisieren Sie die Readme-Datei.
  4. Schreiben Sie die Änderungen fest und übertragen Sie sie per Push-Operation.

Cloud Shell

oc

Führen Sie die folgenden Schritte aus, wenn Sie eine andere Version der OpenShift-Befehlszeilenschnittstelle als die vorinstallierte Version verwenden müssen:

  1. Laden Sie die neueste stabile 4.x OpenShift-CLI (oc) herunter.
    curl https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/openshift-client-linux.tar.gz --output oc.tar.gz
  2. Extrahieren Sie oc.tar.gz:
    tar zxvf oc.tar.gz oc
  3. Fügen Sie das aktuelle Verzeichnis zu PATH hinzu.
    export PATH=$PWD:$PATH
  4. Verifizieren Sie die Installation wie folgt:
    oc version