ppc aas go client

Kit SDK IBM Cloud pour Power Private Cloud aaS

Le projet ppc-aas-go-client fournit le SDK Go pour IBM® Stratos for Power (Power Private Cloud aaS).

Conditions préalables

• Un compte IBM Cloud
• Une clé API ou un jeton IBM Cloud IAM permet au SDK d'accéder à votre compte
• Allez 1.17+
  • Homebrew
  • Source

Installer

Installez le SDK en utilisant les méthodes suivantes.

go get le commandement

Utilisez cette commande pour télécharger et installer le SDK afin de permettre à votre application Go de l'utiliser :

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

Aller aux modules

Si votre application utilise des modules Go, vous pouvez ajouter une importation appropriée à votre application Go, comme ceci :

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

puis exécutez go mod tidy pour télécharger et installer la nouvelle dépendance et mettre à jour le fichier go.mod de votre application Go.

gestionnaire de dépendances dep

Si votre application utilise l'outil de gestion des dépendances dep , vous pouvez ajouter une dépendance à votre fichier Gopkg.toml . Voici un exemple :

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

puis exécutez dep ensure .

Usage

Vous devez d’abord créer une session et l’utiliser pour créer le client.

 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 )
    ... ..
}

Saisissez les champs obligatoires IBMPIOptions :

• Authenticator : veuillez consulter https://github.com/IBM/go-sdk-core/blob/main/Authentication.md pour connaître les différentes options disponibles pour authentifier les appels d'API.
• UserAccount : ID de compte de l'instance de service Power Cloud.
• Zone : emplacement de l'instance de service Power Cloud.

Autres champs optionnels :

• Debug : Activer/Désactiver le journal de débogage du transport http.
• Region : région de l'instance de service Power Cloud. Ceci est utilisé pour générer l’URL du service par défaut. Obsolète : la région et le point de terminaison sont générés automatiquement en fonction de Zone .
• URL : hôte Power Virtual Server ou point de terminaison d'URL. Par défaut, il utilise ppc-aas.cloud.ibm.com . Dans le cas d'un environnement de test, vous pouvez définir la valeur sur ppc-aas.test.cloud.ibm.com . Vous pouvez également utiliser la variable d'environnement IBMCLOUD_POWER_API_ENDPOINT . Notez que la valeur de la région est ajoutée au début de la chaîne hôte si elle n'est pas présente, par exemple : <region>.ppc-aas.cloud.ibm.com .

Vous pouvez également vous référer au répertoire d'exemples pour certaines ressources qui montrent comment utiliser le SDK.

Problèmes

Si vous rencontrez un problème avec le projet, veuillez le signaler ici.

Développement

Cette section contient certaines étapes requises par le développeur pour apporter des modifications au SDK.

Mettre à jour le répertoire power

1. Installez la dernière version de Go-Swagger sur votre ordinateur.
2. Téléchargez la dernière version publiée des définitions de l'API du courtier de services ( swagger.yaml ).
3. Exécutez ./bin/update-swagger.sh à partir de la racine du projet.