IBM / continuous-delivery-go-sdk

Go client library for IBM Cloud Continuous Delivery
Apache License 2.0
4 stars 6 forks source link

IBM Cloud Continuous Delivery Go SDK 2.0.2

Build Status Release Go Reference GitHub go.mod Go version License semantic-release

The Go client library to interact with the IBM Cloud Continuous Delivery Toolchain and Tekton Pipeline APIs.

Table of Contents

Overview

The IBM Cloud Continuous Delivery Go SDK allows developers to programmatically interact with the IBM Cloud services that are listed in Table 1:

Service name Package name
Toolchain API cdtoolchainv2
Tekton Pipeline API cdtektonpipelinev2

Table 1. IBM Cloud services

Prerequisites

Installation

The current version of this SDK: 2.0.2

Go modules

If your application uses Go modules for dependency management (recommended), add an import for each service that you use in your application.

Example:

import (
  "github.com/IBM/continuous-delivery-go-sdk/v2/cdtoolchainv2"
)

Next, run go build or go mod tidy to download and install the new dependencies and update your application's go.mod file.

In the example, the cdtoolchainv2 part of the import path is the package name that is associated with the Toolchain service. See Table 1 to find the appropriate package name for the services that your application uses.

go get command

Alternatively, you can use the go get command to download and install the appropriate packages that your application uses:

go get -u github.com/IBM/continuous-delivery-go-sdk/v2/cdtoolchainv2

Be sure to use the appropriate package name from Table 1 for the services that your application uses.

Using the SDK

For general SDK usage information, see IBM Cloud SDK Common README.

Questions

If you are having difficulties using this SDK or you have a question about the IBM Cloud services, ask a question at Stack Overflow. Alternatively, you can reach out to the IBM Cloud Continuous Delivery development team by joining us on Slack.

Issues

If you have a problem with the project, submit a bug report, but before you do, search for similar problems. Someone else might have already reported the problem.

Open source @ IBM

Find more open source projects on the IBM GitHub Page.

Contributing

For more information, see CONTRIBUTING.

License

This SDK project is released under the Apache 2.0 license. You can find the license's full text in LICENSE.