CI Tools is a Docker Hub image for CI/CD deployments, with tools like curl, dind, docker-compose, kind, kubectl, helm, vault, 1password, semver-cli, argo-cd, bitwarden, waypoint, earthly etc.
| Name | Version | Command |
|---|---|---|
| git | 2.34.1 | git version |
| bash | 5.1.8(1)-release | bash --version |
| yq | 2.13.0 | yq --version |
| jq | v3.15.0_alpha20210804-4073 | jq --version |
| curl | 7.80.0 | curl --version |
| docker | 20.10.12 | docker --version |
| docker-compose | 1.29.2 | docker-compose --version |
| kind | 0.11.1 | kind --version |
| kubectl | v1.23.3 | kubectl version --client |
| helm | v3.8.0 | helm version |
| vault | v1.9.3 | vault --version |
| 1password | 1.12.4 | op --version |
| bitwarden | 1.21.0 | bw --version |
| semver-cli | 1.1.0 | -- |
| argocd | v2.2.5+8f981cc | argocd version --client |
| waypoint | v0.7.1 | waypoint --version |
| earthly | v0.6.7 | earthly --version |
Note: to see a list of changes for supported tags and dependency versions, please see the CHANGELOG.md
This image has a custom colored bash and prints the STERR in red color and new extra commands:
Note: in order to set up the bash and import the commands, you can run source /scripts/.bashrc;
Is a new command that generates a kubeconfig file based on the service account token, while running in a pod.
e.g.
generate_service_account_kubeconfig;
export KUBECONFIG="$(pwd)/kubeconfig";With parameters (API_SERVER, FILE_NAME)
generate_service_account_kubeconfig "https://kubernetes.default.svc.cluster.local" "kubeconfig-dev";
export KUBECONFIG="$(pwd)/kubeconfig-dev";Is a new command that accepts as a first parameter a color and a second parameter a text to print (if no color given, it prints the text with the default color).
e.g.
Print the text in red color hello
println r "hello"Print the text as warning (yellow) color hello
println warn "hello"Print the text in cyan color hello
println cyan "hello"Print the text in default color hello
println "hello"List of colors
| Name | Short name |
|---|---|
| black | bk |
| red | r |
| green | g |
| yellow | y |
| blue | b |
| purple | p |
| cyan | c |
| white | wh |
| info | i |
| warn (yellow) | w |
| error (red) | e |
| sucsess (green) | ok |
DIND is a way to run Docker inside a Docker container (for example, to pull and build images, or to run other containers) in your CI/CD system.
docker run --rm -it \
-v /var/run/docker.sock:/var/run/docker.sock \
emilioforrer/ci-tools:latest \
bashInside the image you can run sudo docker version or
docker run --rm -it \
-v /var/run/docker.sock:/var/run/docker.sock \
emilioforrer/ci-tools:latest \
sudo docker versionDocker compose is a tool for defining and running multi-container Docker applications. With Compose, you use a YAML file to configure your application's services.
e.g. Create a docker-compose.yaml file.
cat << EOF > docker-compose.yaml
version: "3.7"
services:
nginx-hello:
image: emilioforrer/nginx-hello
ports:
- '8000:80'
ruby-hello:
image: emilioforrer/ruby-hello
network_mode: "host"
ports:
- '5000:5000'
python-hello:
image: emilioforrer/python-hello
network_mode: "host"
ports:
- '5000:5000'
nodejs-hello:
image: emilioforrer/nodejs-hello
network_mode: "host"
environment:
URLS: 'https://0.0.0.0:7000,https://0.0.0.0:3000,https://0.0.0.0:4000,https://0.0.0.0:5000'
ports:
- '9000:9000'
php-hello:
image: emilioforrer/php-hello
network_mode: "host"
ports:
- '7000:7000'
elixir-hello:
image: emilioforrer/elixir-hello
network_mode: "host"
ports:
- '4000:4000'
environment:
RUBY_URL: 'https://0.0.0.0:3000'
PHP_URL: 'https://0.0.0.0:7000'
EOFAnd then run
docker run --rm -it \
-v /var/run/docker.sock:/var/run/docker.sock \
-v $(pwd)/:/home/developer/workspace \
emilioforrer/ci-tools:latest \
sudo docker-compose upNow open your favorite browser and visit https://localhost:5001/
KIND kind is a tool for running local Kubernetes clusters using Docker container "nodes". kind was primarily designed for testing Kubernetes itself, but may be used for local development or CI.
e.g.
docker run --rm -it \
-v /var/run/docker.sock:/var/run/docker.sock \
-v $(pwd)/:/home/developer/workspace \
emilioforrer/ci-tools:latest \
sudo kind create clusterKubectl Kubectl is a command line tool for controlling Kubernetes clusters.
e.g.
docker run --rm -v "$KUBECONFIG:$KUBECONFIG" \
-e KUBECONFIG=$KUBECONFIG \
emilioforrer/ci-tools:latest kubectl versionHelm Helm is the best way to find, share, and use software built for Kubernetes.
docker run -v $(pwd)/:/home/developer/workspace \
emilioforrer/ci-tools:latest \
helm versionGit is a free and open source distributed version control system designed to handle everything from small to very large projects with speed and efficiency.
e.g. Clonning a repository in the current working directory of the host.
docker run -v $(pwd)/:/home/developer/workspace \
emilioforrer/ci-tools:latest \
git clone https://github.com/emilioforrer/ci-tools.gityq is a lightweight and portable command-line YAML processor
e.g. Create a yaml and get a node.
cat <<EOF > pod.yaml
apiVersion: v1
kind: Pod
metadata:
name: myapp-pod
labels:
app: myapp
spec:
containers:
- name: myapp-container
image: busybox
command: ['sh', '-c', 'echo Hello Kubernetes! && sleep 3600']
EOFGet the container name
docker run -v $(pwd)/:/home/developer/workspace \
emilioforrer/ci-tools:latest \
yq '.spec.containers[0].name' pod.yamljq is like sed for JSON data - you can use it to slice and filter and map and transform structured data with the same ease that sed, awk, grep and friends let you play with text.
e.g. Create a json and get a node.
cat <<EOF > pod.json
{
"apiVersion": "v1",
"kind": "Pod",
"metadata": {
"name": "myapp-pod",
"labels": {
"app": "myapp"
}
},
"spec": {
"containers": [
{
"name": "myapp-container",
"image": "busybox",
"command": [
"sh",
"-c",
"echo Hello Kubernetes! && sleep 3600"
]
}
]
}
}
EOFGet the container name
docker run -v $(pwd)/:/home/developer/workspace \
emilioforrer/ci-tools:latest \
jq '.spec.containers[0].name' pod.jsoncurl is used in command lines or scripts to transfer data. It is also used in cars, television sets, routers, printers, audio equipment, mobile phones, tablets, settop boxes, media players and is the internet transfer backbone for thousands of software applications affecting billions of humans daily.
e.g
docker run -v $(pwd)/:/home/developer/workspace \
emilioforrer/ci-tools:latest \
curl -fG https://raw.githubusercontent.com/emilioforrer/ci-tools/develop/README.md > README.mdvault is a secure, store and tightly control access to tokens, passwords, certificates, encryption keys for protecting secrets and other sensitive data using a UI, CLI, or HTTP API.
e.g
docker run -v $(pwd)/:/home/developer/workspace \
emilioforrer/ci-tools:latest \
vault --version1Password with 1Password you only ever need to memorize one password. All your other passwords and important information are protected by your Master Password, which only you know. e.g
docker run -it emilioforrer/ci-tools:latest op --versionBitwarden Open Source Password Management for You and Your Business. he easiest and safest way for individuals and businesses to store, share, and secure sensitive data on any device e.g
docker run -it emilioforrer/ci-tools:latest bw --versionwaypoint-cli allows developers to deploy, manage, and observe their applications through a consistent abstraction of underlying infrastructure. e.g
docker run -it emilioforrer/ci-tools:latest waypoint --helpearthly-cli is a syntax for defining your build. It works with your existing build system. Get repeatable and understandable builds today. e.g
# In order to use `earthly bootstrap` inside the image without sudo, you need to add `--group-add $(stat -c '%g' /var/run/docker.sock)`
docker run -it -v /var/run/docker.sock:/var/run/docker.sock --group-add $(stat -c '%g' /var/run/docker.sock) emilioforrer/ci-tools:latest earthly --helpsemver-cli is a simple command line tool to compare and manipulate version strings. e.g
docker run -it emilioforrer/ci-tools:latest semver --help# Build Docker image
./build.sh
# Build and push Docker image
DOCKER_PUSH=true ./build.shNote: Before pushing an image, make sure to change the release version in the VERSION file.