القائمة
Swiss-army utilities in apecloud-cd: utils.sh --type operations, webhook_utils.sh, send_mesage.py, remove_ansi.py. Use as a reference when unsure which script/type to use, combining delete/release/test helpers, or adding new generic helper functions.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | utils-common |
| description | Swiss-army utilities in apecloud-cd: utils.sh --type operations, webhook_utils.sh, send_mesage.py, remove_ansi.py. Use as a reference when unsure which script/type to use, combining delete/release/test helpers, or adding new generic helper functions. |
This skill is the overview entry for .github/utils, explaining the multi-purpose design of utils.sh.
| Script | Purpose |
|---|---|
.github/utils/utils.sh | 47+ operation entry points, invoked via --type <number> |
.github/utils/webhook_utils.sh | Webhook/message notification helpers |
.github/utils/send_mesage.py | Message sending script |
.github/utils/remove_ansi.py | Remove ANSI color codes |
.github/utils/remove_ansi_file.py | File-level ANSI color code cleanup |
Invocation:
./.github/utils/utils.sh --type <number> [options]
| Type | Operation | Common params | Example |
|---|---|---|---|
| 1 | Strip leading v from version | --tag-name | bash ./.github/utils/utils.sh --type 1 --tag-name v0.4.0 |
| 2 | Replace - with . in version | --tag-name | bash ./.github/utils/utils.sh --type 2 --tag-name 0-4-0 |
| 3 | Get release asset upload URL | --github-repo, --tag-name, --github-token | bash ./.github/utils/utils.sh --type 3 --github-repo apecloud/helm-charts --tag-name v0.4.0 --github-token $TOKEN |
| 4 | Get latest release tag | --github-repo, --github-token | bash ./.github/utils/utils.sh --type 4 --github-repo apecloud/kubeblocks --github-token $TOKEN |
| 5 | Set release as latest | --github-repo, --tag-name, --github-token | bash ./.github/utils/utils.sh --type 5 --github-repo apecloud/kubeblocks --tag-name v0.4.0 --github-token $TOKEN |
| 6 | Get trigger mode | --github-repo, --branch-name, --github-token | bash ./.github/utils/utils.sh --type 6 --github-repo apecloud/kubeblocks --branch-name main --github-token $TOKEN |
| 7 | Trigger repo workflow | --github-repo, --workflow-id, --branch-name, --github-token | bash ./.github/utils/utils.sh --type 7 --github-repo apecloud/kubeblocks --workflow-id release.yml --branch-name main --github-token $TOKEN |
| 8 | Delete GitHub release | --github-repo, --tag-name, --github-token, --delete-force | bash ./.github/utils/utils.sh --type 8 --github-repo apecloud/kubeblocks --tag-name v0.4.0 --github-token $TOKEN |
| 9 | Delete KubeBlocks release charts | --tag-name | bash ./.github/utils/utils.sh --type 9 --tag-name v0.4.0 |
| 10 | Delete Docker images | --tag-name, --user, --password, --images | bash ./.github/utils/utils.sh --type 10 --tag-name v0.4.0 --user $USER --password $PASS |
| 11 | Delete Aliyun images | --tag-name, --user, --password | bash ./.github/utils/utils.sh --type 11 --tag-name v0.4.0 --user $USER --password $PASS |
| 12 | Get test result | --github-repo, --github-token, --test-result, --run-id | bash ./.github/utils/utils.sh --type 12 --github-repo apecloud/kubeblocks --test-result "$TEST_RESULT" --run-id $RUN_ID --github-token $TOKEN |
| 13 | helm dependency update | --chart-path | bash ./.github/utils/utils.sh --type 13 --chart-path deploy |
| 14 | Get alpha/beta releases to delete | --github-repo, --tag-name, --github-token, --delete-force | bash ./.github/utils/utils.sh --type 14 --github-repo apecloud/kubeblocks --tag-name v0.4.0 --github-token $TOKEN |
| 15 | Comment on issue | --github-repo, --issue-number, --issue-comment, --github-token | bash ./.github/utils/utils.sh --type 15 --github-repo apecloud/kubeblocks --issue-number 123 --issue-comment "hello" --github-token $TOKEN |
| 16 | Delete runner | --github-repo, --github-token | bash ./.github/utils/utils.sh --type 16 --github-repo apecloud/kubeblocks --github-token $TOKEN |
| 17 | Get job URL | --github-repo, --github-token, --run-id, --job-name | bash ./.github/utils/utils.sh --type 17 --github-repo apecloud/kubeblocks --run-id 123 --job-name test --github-token $TOKEN |
| 18 | Delete Aliyun images (new domain) | --tag-name, --user, --password | bash ./.github/utils/utils.sh --type 18 --tag-name v0.4.0 --user $USER --password $PASS |
| 19 | Delete chart index | --github-repo, --github-token | bash ./.github/utils/utils.sh --type 19 --github-repo apecloud/helm-charts --github-token $TOKEN |
| 20 | Get incremental chart package | --github-repo, --github-token, --branch-name | bash ./.github/utils/utils.sh --type 20 --github-repo apecloud/helm-charts --branch-name main --github-token $TOKEN |
| 21 | Set PR size label | --github-repo, --github-token, --pr-number | bash ./.github/utils/utils.sh --type 21 --github-repo apecloud/kubeblocks --pr-number 123 --github-token $TOKEN |
| 22 | Set PR milestone | --github-repo, --github-token, --pr-number | bash ./.github/utils/utils.sh --type 22 --github-repo apecloud/kubeblocks --pr-number 123 --github-token $TOKEN |
| 23 | Set issue milestone | --github-repo, --github-token, --issue-number | bash ./.github/utils/utils.sh --type 23 --github-repo apecloud/kubeblocks --issue-number 123 --github-token $TOKEN |
| 24 | Move PR/issue to next milestone | --github-repo, --github-token, --pr-number, --issue-number | bash ./.github/utils/utils.sh --type 24 --github-repo apecloud/kubeblocks --pr-number 123 --issue-number 456 --github-token $TOKEN |
| 25 | Delete runner (alt) | --github-repo, --runner-name, --github-token | bash ./.github/utils/utils.sh --type 25 --github-repo apecloud/kubeblocks --runner-name runner1 --github-token $TOKEN |
| 26 | Set image list | --images-list | bash ./.github/utils/utils.sh --type 26 --images-list images.txt |
| 27 | Generate image YAML | --github-repo, --github-token, --version | bash ./.github/utils/utils.sh --type 27 --github-repo apecloud/kubeblocks --version 0.4.0 --github-token $TOKEN |
| 28 | Get release branch | --version, --branch-name | bash ./.github/utils/utils.sh --type 28 --version 0.4.0 --branch-name main |
| 29 | Delete tag | --github-repo, --github-token, --tag-name | bash ./.github/utils/utils.sh --type 29 --github-repo apecloud/kubeblocks --tag-name v0.4.0 --github-token $TOKEN |
| 30 | Delete actions cache | --github-repo, --github-token | bash ./.github/utils/utils.sh --type 30 --github-repo apecloud/kubeblocks --github-token $TOKEN |
| 31 | Check release version | --version | bash ./.github/utils/utils.sh --type 31 --version v0.4.0 |
| 32 | Generate apecloud image YAML | --github-repo, --version | bash ./.github/utils/utils.sh --type 32 --github-repo apecloud/kubeblocks --version 0.4.0 |
| 33 | Set label | --github-repo, --github-token, --pr-number, --label-name, --label-ops | bash ./.github/utils/utils.sh --type 33 --github-repo apecloud/kubeblocks --pr-number 123 --label-name bug --label-ops add --github-token $TOKEN |
| 34 | Get cloud E2E test result | --github-repo, --github-token, --test-result, --run-id | bash ./.github/utils/utils.sh --type 34 --github-repo apecloud/kubeblocks --test-result "$R" --run-id 123 --github-token $TOKEN |
| 35 | Bump chart version | --branch-name | bash ./.github/utils/utils.sh --type 35 --branch-name main |
| 36 | Parse test result | --test-result, --test-ret, --test-type-name | bash ./.github/utils/utils.sh --type 36 --test-result "$R" --test-ret "0" --test-type-name postgresql |
| 37 | Update k3d coredns configmap | --version | bash ./.github/utils/utils.sh --type 37 --version 0.4.0 |
| 38 | Get cloud test result | --github-repo, --github-token, --test-result | bash ./.github/utils/utils.sh --type 38 --github-repo apecloud/kubeblocks --test-result "$R" --github-token $TOKEN |
| 39 | Get cloud pre-version | --github-repo, --github-token | bash ./.github/utils/utils.sh --type 39 --github-repo apecloud/kubeblocks --github-token $TOKEN |
| 40 | Get ginkgo test result | --test-result, --test-ret | bash ./.github/utils/utils.sh --type 40 --test-result "$R" --test-ret "0" |
| 41 | Get ginkgo test result total | --test-result | bash ./.github/utils/utils.sh --type 41 --test-result "$R" |
| 42 | Set API coverage result URL | --github-repo, --github-token, --coverage-result, --run-id | bash ./.github/utils/utils.sh --type 42 --github-repo apecloud/kubeblocks --coverage-result "$R" --run-id 123 --github-token $TOKEN |
| 43 | Set engine summary result URL | --github-repo, --github-token, --test-result, --run-id | bash ./.github/utils/utils.sh --type 43 --github-repo apecloud/kubeblocks --test-result "$R" --run-id 123 --github-token $TOKEN |
| 44 | Get GitHub Actions job URL | --github-repo, --github-token, --run-id, --job-name | bash ./.github/utils/utils.sh --type 44 --github-repo apecloud/kubeblocks --run-id 123 --job-name test --github-token $TOKEN |
| 45 | Set engine summary result URL v2 | --github-repo, --github-token, --test-result, --run-id | bash ./.github/utils/utils.sh --type 45 --github-repo apecloud/kubeblocks --test-result "$R" --run-id 123 --github-token $TOKEN |
| 46 | Get playwright test result | --test-result | bash ./.github/utils/utils.sh --type 46 --test-result "$R" |
| 47 | Get playwright test result total | --test-result | bash ./.github/utils/utils.sh --type 47 --test-result "$R" |
| 48 | Get cloud releases to delete | --github-repo, --github-token | bash ./.github/utils/utils.sh --type 48 --github-repo apecloud/kubeblocks --github-token $TOKEN |
| 49 | Delete release charts all | --github-repo, --github-token, --tag-name | bash ./.github/utils/utils.sh --type 49 --github-repo apecloud/kubeblocks --tag-name v0.4.0 --github-token $TOKEN |
| 50 | Delete cloud Docker images | --tag-name, --user, --password | bash ./.github/utils/utils.sh --type 50 --tag-name v0.4.0 --user $USER --password $PASS |
| 51 | Delete cloud Aliyun images | --tag-name, --user, --password | bash ./.github/utils/utils.sh --type 51 --tag-name v0.4.0 --user $USER --password $PASS |
# Get release branch
./.github/utils/utils.sh --type 28 --version 0.4.0 --branch-name main
# Bump chart version
./.github/utils/utils.sh --type 35 --branch-name <branch>
# Parse E2E test result (send-message)
./.github/utils/utils.sh --type 36 \
--test-result "..." \
--test-ret "..." \
--test-type-name "..."
utils.sh parses long options in parse_command_line and dispatches via case $TYPE in main.uname -s to distinguish Linux/macOS, using sed -i vs sed -i ''.--delete-force guard to avoid accidental stable release deletion.GitHub repository automation: PR label, PR size label, PR milestone, issue milestone, auto cherry-pick, comment issue, GitHub Actions runner enable/delete, actions cache cleanup, feishu-message, webhook_utils.sh Use when changing label rules, milestone policies, cherry-pick targets, runner management, or bot message formats.
Cross-registry image mirroring and copy: skopeo sync, skopeo copy, docker.io, apecloud-registry.cn-zhangjiakou.cr.aliyuncs.com, infracreate-registry.cn-zhangjiakou.cr.aliyuncs.com, ECR, set_registry_and_repo.sh. Use when syncing images to Aliyun, copying images between registries, retagging images, or preparing offline image packages.
Container image build, check, push, and manifest management: release-image.yml, buildx, multi-arch amd64 arm64 manifest, helm_image_check.sh, manifests_image_check.sh, skopeo sync, image cache, push_images.sh. Use when image release fails, a new engine image is added, manifest image check fails, or amd64/arm64 platform support is missing.
Handle auxiliary CI/CD workflows in apecloud-cd: workflow trigger, database migration, OpenShift preflight, Red Hat certification. Use for migrate-database.yml, openshift-preflight.yml, or other workflows that do not fit into chart, image, e2e, or release domains.
Helm chart release workflow: helm package, chart-releaser cr, gh-pages index update, Jihulab chart upload, update_chart_values.sh, update_chart_annotations.sh, bump chart version. Use when packaging charts, publishing to helm-charts release, fixing chart index failures, or injecting release metadata into values.yaml and Chart.yaml.
ApeCloud / KubeBlocks Cloud multi-cluster deployment and cleanup: deploy-cloud.yml, cloud-cluster-clear.yml, IDC cleanup, terraform-init.yml, terraform-destroy.yml. Use when deploying to cloud environments, cleaning up IDC/IDC1/IDC2/IDC4 clusters, or debugging deployment failures.