bitgrip/cattlectl repository overview

⁠cattlectl

Cattlectl is a tool for managing Rancher 2⁠ projects

Use cattlectl to:

• Apply project descriptors to a rancher managed kubernetes cluster
• Use one configuration as code to install to multiple stages
• Automate deployments to rancher managed kubernetes clusters from your CI server.

⁠Install

• Binary download of cattlectl can be found on the Release page.⁠
• Unpack the cattlectl binary and add it to your PATH and you are good to go!

⁠Usage as docker image

• You need to mount your descriptor to the directory /data in your container.
• cattlectl is the ENTRYPOINT so that you can use the cattlectl commands directly.

docker run --rm \
-v $(pwd):/data \
bitgrip/cattlectl apply

⁠Build from source

⁠cattlectl

go install \
-ldflags "-X github.com/bitgrip/cattlectl/internal/pkg/ctl.Version=$(git describe --tags) -s -w" \
-a -tags netgo -installsuffix netgo -mod=vendor

⁠Ansible modules

go build -mod=vendor -o ~/.ansible/plugins/modules/ ./ansible/...

⁠Docs

• Get started with the usage documentation⁠
• Read the command documentation⁠

⁠License

Copyright © 2018 - 2019 bitgrip GmbH⁠

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.