ppc aas go client

IBM Cloud SDK für Power Private Cloud aaS

Das ppc-aas-go-client-Projekt stellt das Go SDK für IBM® Stratos for Power (Power Private Cloud aaS) bereit.

Voraussetzungen

• Ein IBM Cloud-Konto
• Ein IBM Cloud IAM-API-Schlüssel oder -Token ermöglicht dem SDK den Zugriff auf Ihr Konto
• Gehen Sie 1.17+
  • Homebrew
  • Quelle

Installieren

Installieren Sie das SDK mit den folgenden Methoden.

go get das Kommando

Verwenden Sie diesen Befehl, um das SDK herunterzuladen und zu installieren, damit Ihre Go-Anwendung es verwenden kann:

 go get -u github.com/IBM-Cloud/ppc-aas-go-client

Go-Module

Wenn Ihre Anwendung Go-Module verwendet, können Sie Ihrer Go-Anwendung einen geeigneten Import hinzufügen, etwa so:

 import (
  "github.com/IBM-Cloud/ppc-aas-go-client"
)

Führen Sie dann go mod tidy aus, um die neue Abhängigkeit herunterzuladen und zu installieren und go.mod Datei Ihrer Go-Anwendung zu aktualisieren.

dep Abhängigkeitsmanager

Wenn Ihre Anwendung das dep Abhängigkeitsverwaltungstool verwendet, können Sie Ihrer Gopkg.toml Datei eine Abhängigkeit hinzufügen. Hier ist ein Beispiel:

 [[constraint]]
  name = "github.com/IBM-Cloud/ppc-aas-go-client"
  version = "1.1.0"

Führen Sie dann dep ensure .

Verwendung

Zuerst müssen Sie eine Sitzung erstellen und diese zum Erstellen des Clients verwenden.

 import "github.com/IBM-Cloud/ppc-aas-go-client/ibmpisession"

func main (){
    o := & ibmpisession. IBMPIOptions {
		Authenticator : authenticator ,
		UserAccount :   accountID ,
		Zone :          zone ,
	}
    s , err := ibmpisession . NewIBMPISession ( o )
    ... ..
}

Geben Sie die erforderlichen IBMPIOptions -Felder ein:

• Authenticator : Bitte überprüfen Sie https://github.com/IBM/go-sdk-core/blob/main/Authentication.md für verschiedene Optionen zur Authentifizierung von API-Aufrufen.
• UserAccount : Konto-ID der Power Cloud-Dienstinstanz.
• Zone : Standort der Power Cloud Service-Instanz.

Weitere optionale Felder:

• Debug : HTTP-Transport-Debugging-Protokoll aktivieren/deaktivieren.
• Region : Region der Power Cloud-Dienstinstanz. Dies wird zum Generieren der Standarddienst-URL verwendet. Veraltet : Die Region und der Endpunkt werden basierend auf Zone automatisch generiert.
• URL : Power Virtual Server-Host oder URL-Endpunkt. Standardmäßig wird ppc-aas.cloud.ibm.com verwendet. Im Falle einer Testumgebung können Sie den Wert auf ppc-aas.test.cloud.ibm.com festlegen. Sie können auch die Umgebungsvariable IBMCLOUD_POWER_API_ENDPOINT verwenden. Beachten Sie, dass der Regionswert der Hostzeichenfolge vorangestellt wird, wenn er nicht vorhanden ist, z. B.: <region>.ppc-aas.cloud.ibm.com .

Außerdem finden Sie im Beispielverzeichnis einige Ressourcen, die die Verwendung des SDK veranschaulichen.

Probleme

Wenn Sie auf ein Problem mit dem Projekt stoßen, melden Sie es bitte hier.

Entwicklung

Dieser Abschnitt enthält einige Schritte, die der Entwickler benötigt, um Änderungen am SDK vorzunehmen.

Aktualisieren Sie das Energieverzeichnis

1. Installieren Sie die neueste Go-Swagger-Version auf Ihrem Computer.
2. Laden Sie die letzte veröffentlichte Version der Service Broker-API-Definitionen ( swagger.yaml ) herunter.
3. Führen Sie ./bin/update-swagger.sh im Projektstammverzeichnis aus.