sourceboat/rancher-deploy repository overview

⁠sourceboat/rancher-deploy

This docker image enables simple deployments to Rancher.

⁠What's included?

• Git CLI⁠ git
• Kubernetes CLI⁠ kubectl
• Rancher CLI⁠ rancher
• Sentry CLI⁠ sentry-cli

It also comes with a custom rancher-redeploy and rancher-exec command helper (see usage section).

⁠Usage

⁠Simple Redeploy via GitLab CI and rancher-redeploy helper

To use this image via GitLab CI add the following to the .gitlab-ci.yml:

deploy:
  stage: deploy
  image: sourceboat/rancher-deploy:latest
  variables:
    RANCHER_URL: https://rancher.example.com
    K8S_NAMESPACE: my-namespace-name
    K8S_DEPLOYMENT: my-deployment-name
  script:
    - rancher login $RANCHER_URL --token $RANCHER_TOKEN
    - rancher-redeploy $K8S_NAMESPACE $K8S_DEPLOYMENT

Don't forget to provide $RANCHER_TOKEN via GitLab CI/CD variable.

This will trigger a redeploy of the given Kubernetes deployment by updating a label and pull the newest image if configured correctly.

⁠Execute Command via rancher-exec helper

You can also execute commands in pods of your deployment via rancher-exec $K8S_NAMESPACE $K8S_DEPLOYMENT 'ls'. This will execute the given command in the first pod of your deployment. Currently this is only tested with single container pods.

⁠Changelog

Check releases⁠ for all notable changes.

⁠Credits

• Phil-Bastian Berndt⁠
• All Contributors⁠

⁠License

The MIT License (MIT). Please see License File⁠ for more information.