go-cruise-control

It's client library (written in Golang) for interacting with Linkedin Cruise Control using its HTTP API.

Supported Cruise Control versions: 2.5.x (tested with v2.5.80)

How to use it

go get github.com/banzaicloud/go-cruise-control@latest

package main

import (
	"fmt"

	"github.com/banzaicloud/go-cruise-control/client"
	"github.com/banzaicloud/go-cruise-control/api"
)

func main() {
    // Initializing Cruise Control client with default configuration
    cruisecontrol, err := client.NewDefaultClient()
    if err != nil {
        panic(err)
    }
    
    // Assembling the request using default values
    req := api.StateRequestWithDefaults()
    // Sending the request to the State API
    resp, err := cruisecontrol.State(req)
    if err != nil {
        panic(err)
    }
    // Getting the state of the Executor
    fmt.Println(resp.Result.ExecutorState.State)
}

Development

Prerequisites

golang 1.17
docker
docker-compose

Development environment

Starting local development environment

make env-up

Tearing down the local development environment

make env-clean

Testing

Running integration tests creates a new test environment prior executing the test suite and tears down at the end.

make integration-test

Set the USE_EXISTING=true environment variable if reusing the existing development/test environment for integration testing is the desired behaviour.

export USE_EXISTING=true
make integration-test

Support

If you encounter problems while using this project than open an issue or talk to us on #kafka-operator channel on the Banzai Cloud Community Slack.

Contributing

If you find this project useful, help us:

Support the development of this project and star this repo! ⭐
Help new users with issues they may encounter 💪
Send a pull request with your new features and bug fixes 🚀

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Trademarks

The Banzai Cloud name, the Banzai Cloud logo, and all Banzai Cloud trademarks and logos are registered trademarks of Cisco.

isabella232 / go-cruise-control Goto Github PK