emilioforrer/ci-tools

CI Tools - Docker Hub镜像

概述

https://github.com/emilioforrer/ci-tools 是一个用于CI/CD部署的https://hub.docker.com/r/emilioforrer/ci-tools%E9%95%9C%E5%83%8F%EF%BC%8C%E9%9B%86%E6%88%90%E4%BA%86curl%E3%80%81dind%E3%80%81docker-compose%E3%80%81kind%E3%80%81kubectl%E3%80%81helm%E3%80%81vault%E3%80%811password%E3%80%81semver-cli%E3%80%81argo-cd%E3%80%81bitwarden%E3%80%81waypoint%E3%80%81earthly%E7%AD%89%E5%A4%9A%E7%A7%8D%E5%B7%A5%E5%85%B7%E3%80%82

工具和依赖

注意：如需查看支持的标签和依赖版本的变更列表，请参阅CHANGELOG.md。

使用方法

Bash

该镜像包含自定义彩色bash，将STERR输出为红色，并提供了额外的命令：

注意：如需设置bash并导入命令，可运行source /scripts/.bashrc;

命令 - generate_service_account_kubeconfig

此命令基于服务账户令牌生成kubeconfig文件，适用于在Pod中运行的场景。

示例：

bash
generate_service_account_kubeconfig;
export KUBECONFIG="$(pwd)/kubeconfig";

带参数（API_SERVER、FILE_NAME）：

bash
generate_service_account_kubeconfig "https://kubernetes.default.svc.cluster.local" "kubeconfig-dev";
export KUBECONFIG="$(pwd)/kubeconfig-dev";

命令 - println

此命令接受第一个参数为颜色，第二个参数为文本（如未指定颜色，则使用默认颜色）。

示例：

以红色打印文本 hello

bash
println r "hello"

以警告色（黄色）打印文本 hello

bash
println warn "hello"

以青色打印文本 hello

bash
println cyan "hello"

以默认颜色打印文本 hello

bash
println "hello"

颜色列表：

DIND（Docker in Docker）

DIND 是在Docker容器中运行Docker的方式（例如，拉取和构建镜像，或运行其他容器），适用于CI/CD系统。

bash
docker run --rm -it \
           -v /var/run/docker.sock:/var/run/docker.sock \
           emilioforrer/ci-tools:latest \
           bash

在镜像内部可运行sudo docker version，或：

bash
docker run --rm -it \
           -v /var/run/docker.sock:/var/run/docker.sock \
           emilioforrer/ci-tools:latest \
           sudo docker version

Docker Compose

Docker Compose 是用于定义和运行多容器Docker应用的工具。通过YAML文件配置应用的服务。

示例：创建docker-compose.yaml文件。

bash
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: 'http://0.0.0.0:7000,http://0.0.0.0:3000,http://0.0.0.0:4000,http://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: 'http://0.0.0.0:3000'
      PHP_URL: 'http://0.0.0.0:7000'
EOF

然后运行：

bash
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 up

现在打开浏览器访问http://localhost:5001/。

KIND（Kubernetes In Docker）

https://github.com/kubernetes-sigs/kind 是使用Docker容器"节点"运行本地Kubernetes集群的工具。主要用于测试Kubernetes，也可用于本地开发或CI。

示例：

bash
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 cluster

Kubectl

Kubectl 是用于控制Kubernetes集群的命令行工具。

示例：

bash
docker run --rm -v "$KUBECONFIG:$KUBECONFIG" \
           -e KUBECONFIG=$KUBECONFIG \
           emilioforrer/ci-tools:latest kubectl version

Helm

Helm 是查找、分享和使用Kubernetes构建软件的最佳方式。

bash
docker run -v $(pwd)/:/home/developer/workspace \
           emilioforrer/ci-tools:latest \
           helm version

GIT

Git 是一个免费开源的分布式版本控制系统，旨在快速高效地处理从小型到大型项目。

示例：在主机当前工作目录克隆仓库。

bash
docker run -v $(pwd)/:/home/developer/workspace \
           emilioforrer/ci-tools:latest \
           git clone https://github.com/emilioforrer/ci-tools.git

yq

yq 是轻量级、可移植的命令行YAML处理器。

示例：创建YAML并获取节点。

bash
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']
EOF

获取容器名称：

bash
docker run -v $(pwd)/:/home/developer/workspace \
           emilioforrer/ci-tools:latest \
           yq '.spec.containers[0].name' pod.yaml

jq

https://stedolan.github.io/jq/ 类似于JSON数据的sed - 可用于切片、过滤、映射和转换结构化数据，如同sed、awk、grep处理文本一样简单。

示例：创建JSON并获取节点。

bash
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"
        ]
      }
    ]
  }
}
EOF

获取容器名称：

bash
docker run -v $(pwd)/:/home/developer/workspace \
           emilioforrer/ci-tools:latest \
           jq '.spec.containers[0].name' pod.json

curl

curl 用于在命令行或脚本中传输数据。广泛应用于汽车、电视、路由器、打印机、音频设备、手机、平板等设备，是数千款软件应用的互联网传输骨干。

示例：

bash
docker run -v $(pwd)/:/home/developer/workspace \
           emilioforrer/ci-tools:latest \
           curl -fG https://raw.githubusercontent.com/emilioforrer/ci-tools/develop/README.md > README.md

Vault CLI

vault 用于安全存储和严格控制对令牌、密码、证书、加密密钥等敏感数据的访问，支持通过UI、CLI或HTTP API操作。

示例：

bash
docker run -v $(pwd)/:/home/developer/workspace \
           emilioforrer/ci-tools:latest \
           vault --version

1Password CLI

1Password 让您只需记住一个主密码，其他密码和重要信息均受主密码保护，仅您可见。

示例：

bash
docker run -it emilioforrer/ci-tools:latest op --version

Bitwarden CLI

Bitwarden 开源密码管理工具，为个人和企业提供在任何设备上安全存储、共享敏感数据的简单方式。

示例：

bash
docker run -it emilioforrer/ci-tools:latest bw --version

Waypoint CLI

waypoint-cli 允许开发人员通过底层基础设施的一致抽象来部署、管理和观察应用。

示例：

bash
docker run -it emilioforrer/ci-tools:latest waypoint --help

Earthly CLI

earthly-cli 是用于定义构建的语法，可与现有构建系统配合使用，提供可重复和可理解的构建流程。

示例：

bash
# 如需在镜像内无需sudo使用`earthly bootstrap`，需添加`--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 --help

Semver CLI

https://github.com/davidrjonas/semver-cli 是用于比较和操作版本字符串的简单命令行工具。

示例：

bash
docker run -it emilioforrer/ci-tools:latest semver --help

开发

脚本

构建Docker镜像

bash
# 构建Docker镜像
./build.sh
# 构建并推送Docker镜像
DOCKER_PUSH=true ./build.sh

注意：推送镜像前，请确保修改VERSION文件中的发布版本。