Signa is a Slack bot and ChatOps tool written in Go.
It offers built-in commands for Kubernetes and a framework to develop ChatOps tools.
$ go get [-u] github.com/signavio/signa/cmd/signa
Refer to the signa.sample.yaml configuration file to setup Signa.
Find a list of the current built-in commands below.
kubernetes/deployment is a deployment
command that runs on top of kubectl.
Usage example:
!deploy app-backend app-backend-container cluster1 v1.0.1
Where app-backend stands for the application name, app-backend-container for the container name,
cluster1 for the cluster name and v1.0.1 for the desired image tag.
You can define post deployment steps that enable you to execute a command after a successful deployment, e.g. testing. Also, you can access username, component name and cluster of your deployment within the command with the help of Go's template package.
The fields you can access are:
ComponentNameClusterNameUsername
For instance the username can be accesses like this: curl --foo:{{.Username}}
kubernetes/get retrieves information of the resources running in the cluster.
Usage example:
!get pods -n foobar-namespace
Currently it only works for 1 single context, the support to multi-contexts/clusters should be added.
kubernetes/jobs runs kubernetes jobs using a pre-determined configuration.
Usage example:
!run make-pizza cluster1 v0.9.7
Where make-pizza stands for the job name, cluster1 for the cluster name and v0.9.7 for the
image tag.
In this section you may find an overview of the internals of Signa and code organization.
Signa has three main components:
- cmd is the home of the executable code. It's the entrypoint to install Signa.
- ext is where all the native extensions are placed.
- pkg is the Signa core libraries and utils.
- Add test suite with different test cases.
- Add in-depth documentation.
Stephano Zanzin - @microwaves