GoCD Golang SDK

Golang client library for GoCD API (Supports Most of the APIs).

Introduction

This Library could be helpful while building any tools around GoCD or while interacting with GoCD to perform certain daily activities.

This could include checking the health of all agents connected to GoCD or status of a job and many more.

Installation

Get the latest version of GoCD sdk using go get command. Example:

go get github.com/nikhilsbhat/gocd-sdk-go@latest

Get specific version of the same. Example:

go get github.com/nikhilsbhat/[email protected]

Usage

package main

import (
	"fmt"
	"log"

	"github.com/nikhilsbhat/gocd-sdk-go"
)

func main() {
	client := gocd.NewClient("http://localhost:8153/go", "admin", "admin", "info", nil)
	env, err := client.GetEnvironments()
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(env)
}

More examples can be found here.

Supported APIs

Below are the list of supported APIs:

Agents
- Get All Agents
- Get Specific Agent
- Update Agent
- Update Agents bulk
- Delete Agent
- Delete Agents bulk
- Kill running tasks iin Agent
- Agent job run history
ConfigRepo
- Get All Config repo
- Get Specific Config repo
- Create Config repo
- Update Config repo
- Delete Config repo
- Get Config repo status
- Trigger config repo update
- Preflight check of config repo configurations
- Export pipeline config to config repo format
- Definitions defined in config repo
Maintenance Mode
- Enable Maintenance Mode
- Disable Maintenance Mode
- Get Maintenance Mode info
PipelineGroup
- Get All pipeline groups
- Get specific pipeline group
- Update pipeline group
- Create pipeline group
- Delete pipeline group
Environment Config
- Get All Environments
- Get specific Environment
- Create Environment
- Update Environment
- Patch Environment
- Delete Environment
Backup-config
- Get Backup Info
- Create or Update Backup
- Delete Backup Info
Backup
- Schedule Backup
- Get Backup
Pipeline
- Get pipeline status
- Pause Pipeline
- UnPause Pipeline
- UnLock Pipeline
- Schedule Pipeline
- Get Pipeline Schedules
- Compare pipeline instances
Pipeline Instances
- Get Pipeline Instance
- Get Pipeline History
- Comment on Pipeline
Pipeline Config
- Get pipeline config
- Edit pipeline config
- Create a pipeline
- Delete a pipeline
- Extract template from pipeline
- Validate pipeline config syntax
Stage Instances
- Cancel stage
- Get stage instance
- Get stage history
- Run failed jobs
- Run selected jobs
Stages
- Run stage
Jobs
- Get job instance
- Get job history
Feeds
- Get All pipelines
- Get Pipeline
- Get Stage
- Get Job
- Get Material
- Scheduled Jobs
Artifact Config
- Get Artifact Config
- Update Artifact Config
Artifact Store
- Get Artifact Stores
- Get Artifact Store
- Create Artifact Stores
- Update Artifact Stores
- Delete Artifact Stores
Cluster Profiles
- Get Cluster Profiles
- Get Cluster Profile
- Create Cluster Profile
- Update Cluster Profile
- Delete Cluster Profile
Elastic Agent Profiles
- Get Elastic Agent Profiles
- Get Elastic Agent Profile
- Create Elastic Agent Profile
- Update Elastic Agent Profile
- Delete Elastic Agent Profile
- Get Elastic Agent Profile Usage
Secret Configs
- Get Secret Configs
- Get Secret Config
- Create Secret Config
- Update Secret Config
- Delete Secret Config
Package Repositories
- Get Package repositories
- Get Package Repository
- Create Package Repository
- Update Package Repository
- Delete Package Repository
Package
- Get Package Materials
- Get Package Material
- Create Package Material
- Update Package Material
- Delete Package Material
Materials
- Get All Materials
- Get Materials Usage
- Get material modifications
Site URL
- Get Site URL
- Create or Update Site URL
Mail server config
- Get Mail server config
- Create or Update Mail server config
- Update Mail server config
Default Job timeout
- Get Default Job timeout
- Update Default Job timeout
Plugin settings
- Get Plugin settings
- Create Plugin settings
- Update Plugin settings
Plugin Info
- Get all plugin info
- Get plugin info
Auth Configs
- Get All Auth configs
- Get Specific Auth config
- Create Auth config
- Update Auth config
- Delete Auth config
System Admin
- Get All system admins
- Update system Admin
- ~~Bulk update system admins~~
Role
- Get all roles
- Get all roles by type
- Get Specific role
- Create a GoCD role
- Create a plugin role
- Update a role
- Delete a role
- ~~Bulk update roles~~
access-tokens
- Get all tokens for current user
- Get one token for current user
- Create token for current user
- Revoke token for current user
- Get all tokens for all users
- Get one token for any user
- Revoke token for any user
current-user
- Get current user
- Update current user info
Local Users
- Get all users
- Get a user
- Create a user
- Update a user
- Delete a user
- Bulk delete users
- Bulk enable/disable users
Notification Filter
- Get all notification filters
- Get a notification filter
- Create a notification filter
- Update a notification filter
- Delete a notification filter
Server Health Messages
- Get Server Health messages
Version
- Get Version
Encryption
- Encrypt plain text value
- Decrypt encrypted text value
Permission
- Show permissions one has

Enhancements

If any of the API's are missed, feel free to raise the PR or create issues for the same.

Name		Name	Last commit message	Last commit date
Latest commit History 113 Commits
examples		examples
internal/fixtures		internal/fixtures
pkg		pkg
scripts		scripts
.gitignore		.gitignore
.golangci.yml		.golangci.yml
.goreleaser.yml		.goreleaser.yml
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
admins.go		admins.go
admins_test.go		admins_test.go
agents.go		agents.go
agents_test.go		agents_test.go
artifact_store.go		artifact_store.go
artifact_store_test.go		artifact_store_test.go
artifacts.go		artifacts.go
artifacts_test.go		artifacts_test.go
authorization.go		authorization.go
authorization_test.go		authorization_test.go
backup.go		backup.go
backup_test.go		backup_test.go
configrepo.go		configrepo.go
configrepo_test.go		configrepo_test.go
constants.go		constants.go
encryption.go		encryption.go
encryption_test.go		encryption_test.go
environment.go		environment.go
environment_test.go		environment_test.go
go.mod		go.mod
go.sum		go.sum
gocd.go		gocd.go
gocd_test.go		gocd_test.go
health.go		health.go
health_test.go		health_test.go
job_timeout.go		job_timeout.go
job_timeout_test.go		job_timeout_test.go
jobs.go		jobs.go
jobs_test.go		jobs_test.go
lib_test.go		lib_test.go
mail_server.go		mail_server.go
mail_server_test.go		mail_server_test.go
main.go		main.go
maintenance.go		maintenance.go
maintenance_test.go		maintenance_test.go
materials.go		materials.go
materials_test.go		materials_test.go
package_repositories.go		package_repositories.go
package_repositories_test.go		package_repositories_test.go
packages.go		packages.go
packages_test.go		packages_test.go
permissions.go		permissions.go
permissions_test.go		permissions_test.go
pipeline.go		pipeline.go
pipeline_config.go		pipeline_config.go
pipeline_config_test.go		pipeline_config_test.go
pipeline_group.go		pipeline_group.go
pipeline_group_test.go		pipeline_group_test.go
pipeline_syntax.go		pipeline_syntax.go
pipeline_test.go		pipeline_test.go
plugins_info.go		plugins_info.go
plugins_info_test.go		plugins_info_test.go
plugins_settings.go		plugins_settings.go
plugins_settings_test.go		plugins_settings_test.go
profiles_cluster.go		profiles_cluster.go
profiles_cluster_test.go		profiles_cluster_test.go
profiles_elastic.go		profiles_elastic.go
profiles_elastic_test.go		profiles_elastic_test.go
responses.go		responses.go
roles.go		roles.go
roles_test.go		roles_test.go
secret_configs.go		secret_configs.go
secret_configs_test.go		secret_configs_test.go
siteurl.go		siteurl.go
siteurl_test.go		siteurl_test.go
stages.go		stages.go
stages_test.go		stages_test.go
types.go		types.go
users.go		users.go
users_test.go		users_test.go
utils.go		utils.go
utils_test.go		utils_test.go
version.go		version.go
version_test.go		version_test.go
vsm.go		vsm.go
vsm_test.go		vsm_test.go

License

nikhilsbhat/gocd-sdk-go

Folders and files

Latest commit

History