К основному содержанию
скилл CX Codex

deploying-go-sdk-bundles — скилл для Claude Code: сборка и установка

Скилл deploying-go-sdk-bundles помогает собрать Go-бандл для Airflow, упаковать его и развернуть там, где его найдёт ExecutableCoordinator. Пригодится при настройке Go-задач и их доставки на воркеры.

Apache-2.0 217 установок ★ 463 обновлён 2026-10-14

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add astronomer/agents --skill deploying-go-sdk-bundles -a claude-code
Открыть на GitHub

Что делает deploying-go-sdk-bundles

Скилл описывает сборку и упаковку Go-бандла командой go tool airflow-go-pack, проверку через inspect и размещение в каталоге executables_root. Упакованный файл содержит исполняемый бинарник, исходный код и манифест. Обычный go build не создаёт подходящий для координатора бандл: без трейлера AFBNDL01 он пропустит файл.

Дальше нужно настроить ExecutableCoordinator и маршрутизацию очереди, а затем развернуть Python stub DAG с совпадающими dag_id и task_id. Скилл разбирает доставку через Docker, Kubernetes и Astro, а также версии модуля go-sdk. Бандл — нативный исполняемый файл, поэтому его собирают под ОС и архитектуру воркера; при несовпадении он завершится с exec format error. Go SDK экспериментальный и требует Go 1.24+.

Какие задачи решает

  • собрать и упаковать Go-бандл для Airflow
  • проверить содержимое упакованного бандла
  • разместить исполняемый файл в executables_root
  • настроить координатор и связать очередь с Go
  • собрать бандл под ОС и архитектуру воркера

Примеры запросов агенту

  • Собери и упакуй Go-бандл для задачи Airflow командой go tool airflow-go-pack.
  • Проверь бандл ./bin/sample-dag-bundle и объясни, как подключить его к ExecutableCoordinator.
  • Подготовь бандл для Linux и amd64 и опиши его доставку в Docker-образе Airflow.

Как установить deploying-go-sdk-bundles

1Через Skills CLI (Vercel)

npx skills add astronomer/agents --skill deploying-go-sdk-bundles -a claude-code

2Вручную: положить файлы

~/.claude/skills/deploying-go-sdk-bundles/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/deploying-go-sdk-bundles/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о deploying-go-sdk-bundles

Как установить deploying-go-sdk-bundles в Claude Code?

Выполните npx skills add astronomer/agents --skill deploying-go-sdk-bundles -a claude-code. Скилл появится в ~/.claude/skills/deploying-go-sdk-bundles/SKILL.md.

Что делает deploying-go-sdk-bundles?

Помогает собрать и упаковать Go-бандл для Airflow, настроить его обнаружение через ExecutableCoordinator и доставить на воркер.

Какие требования есть у Go SDK для этого скилла?

Go SDK экспериментальный и требует Go 1.24+. Бандл нужно собирать под ОС и архитектуру воркера.

Исходный текст

SKILL.md · Apache-2.0
---
name: deploying-go-sdk-bundles
description: Builds, packs, and deploys compiled Airflow Go SDK bundles so the ExecutableCoordinator can run them. Use when the user wants to compile a Go task bundle, asks about `go build`, `go tool airflow-go-pack`, the AFBNDL01 self-contained executable bundle, packing or inspecting a bundle, placing it under `executables_root`, cross-compiling a bundle for workers, `go-sdk` module versioning/tags/pseudo-versions, or getting the bundle onto an Airflow worker (Docker, Kubernetes, or Astro). For the task code see authoring-go-sdk-tasks; for the shared coordinator settings see configuring-airflow-language-sdks.
---

# Deploying Go SDK Bundles

A Go SDK deployment has one artifact: a **bundle**, a single self-contained native executable that also carries its embedded source and a manifest (the AFBNDL01 format, "the executable *is* the bundle"). You build and pack it with `go`, place it where Airflow's `ExecutableCoordinator` scans, and the Python task runner forks it once per task instance. This skill is platform-neutral: it shows the build, the coordinator wiring, then how to get the bundle onto a worker.

> **Experimental.** The Go SDK is under active development and not production-ready. Everything resolves against the single module `github.com/apache/airflow/go-sdk` (Go 1.24+).

> **Order of operations:** write the tasks (**authoring-go-sdk-tasks**) -> build and pack the bundle (this skill) -> place it under `executables_root` and configure the coordinator -> deploy the matching Python stub DAG.

---

## Build and pack the bundle

The coordinator only recognizes a **packed** bundle: it scans for the AFBNDL01 trailer and silently skips any file that lacks it, so a plain `go build` binary is not deployable on its own. Use the packer, shipped as a Go 1.24 `tool` directive in `go.mod` (no global install, version pinned per project):

```bash
go tool airflow-go-pack ./example/bundle                              # build + pack in one step
go tool airflow-go-pack --goos linux --goarch amd64 ./example/bundle -- -trimpath  # cross-compile; flags after -- pass to `go build`
go tool airflow-go-pack --executable ./bin/sample-dag-bundle --source main.go --airflow-metadata <airflow-metadata.yaml> # pack an existing binary
go tool airflow-go-pack inspect ./bin/sample-dag-bundle               # inspect a packed bundle
```

The packer builds the binary, execs it with `--airflow-metadata` to capture the manifest from `RegisterDags`, then appends source + manifest + a 64-byte trailer. The result is one runnable file.

- **Build for the worker's OS/arch.** The bundle is a native executable and is not portable; cross-compile with `--goos`/`--goarch`. A mismatched binary fails on the worker with `exec format error`.
- **Re-pack after any change to the binary.** Re-stripping, re-signing, or swapping in a debug build invalidates the trailer's `binary_sha256`, and the bundle is then rejected.

---

## Wire up the coordinator

Python's `ExecutableCoordinator` scans `executables_root`, matches the incoming `dag_id` against each bundle's embedded manifest, verifies its integrity hash, then forks the bundle. No Go process runs on the host.

1. Place the packed executable under a scanned directory:

   ```bash
   cp ./bundle /opt/airflow/executable-bundles/   # identified by the AFBNDL01 trailer, not by filename
   ```

2. Register `ExecutableCoordinator` and route the queue to it (see **configuring-airflow-language-sdks**):

   ```ini
   [sdk]
   coordinators = {"go": {"classpath": "airflow.sdk.coordinators.executable.ExecutableCoordinator", "kwargs": {"executables_root": ["/opt/airflow/executable-bundles"]}}}
   queue_to_coordinator = {"golang": "go"}
   ```

3. Deploy the matching Python stub DAG; its `queue=` must equal the `queue_to_coordinator` key (`golang` here), and its `dag_id`/`task_id`s must match what the bundle registered.

---

## Deployment paths

The SDK runs on any Airflow with the Task SDK; Astronomer tooling is not required.

### Docker / Kubernetes

Cross-compile the bundle for the image's platform and bake it in. No Go runtime or worker process is needed in the image; the Python task runner forks the bundle.

```dockerfile
FROM apache/airflow:3.3.0        # the language SDKs target Airflow 3.3+
COPY ./executable-bundles/ /opt/airflow/executable-bundles/
# set AIRFLOW__SDK__COORDINATORS and AIRFLOW__SDK__QUEUE_TO_COORDINATOR as env vars
```

On the Helm chart, bake the bundle into a custom image as above or mount it via a shared volume, and set the `[sdk]` config through environment variables on the worker/scheduler. See **deploying-airflow** for the broader Docker Compose and Helm workflow.

> The `apache/airflow:3.3.0` tag above is illustrative: the language SDKs need Airflow 3.3 or newer. Pin whatever current 3.x you actually run rather than copying this tag from memory; read the base image's current tags or docs.

### Astro (one option, not required)

1. Build/pack the bundle, then stage it in the project: `mkdir -p include/executable-bundles && cp ../go-bundle/<packed-bundle> include/executable-bundles/`.
2. In the project `Dockerfile`, copy the bundle to the coordinator's directory: `COPY include/executable-bundles/ /opt/airflow/executable-bundles/`.
3. Put the coordinator config in the project `.env` (loaded automatically): the `AIRFLOW__SDK__*` JSON values (see **configuring-airflow-language-sdks**).
4. `astro dev start` (or `astro dev restart` after changes); deploy with `astro deploy`.

> Don't pin Astro Runtime / Airflow versions from memory; read the generated `Dockerfile` or current docs. While the Go SDK is in preview, a beta/dev image may be required.

---

## Versioning and preview installs

`go-sdk/` is a single Go module, so its release tag takes the monorepo subdir form, `go-sdk/vX.Y.Z` (do not create per-`cmd` tags). Your bundle module depends on `github.com/apache/airflow/go-sdk`; pinning that version also pins `airflow-go-pack`, which is a package in the same module referenced through the `tool` directive. Pin against the release tag:

```bash
go get github.com/apache/airflow/[email protected]
```

To build against an unreleased commit or branch (for example, to try a fix ahead of the next tag), depend on it directly and Go fabricates a pseudo-version:

```bash
go get github.com/apache/airflow/go-sdk@<commit-or-branch>
```

---

## Deploy checklist

- Bundle built **and packed** (`go tool airflow-go-pack`); registered `dag_id`/`task_id` match the Python stubs.
- Built for the worker's OS/arch (e.g. `--goos linux --goarch amd64`).
- Packed AFBNDL01 bundle placed under a directory in `executables_root`.
- `ExecutableCoordinator` + `queue_to_coordinator` configured (**configuring-airflow-language-sdks**).
- Python stub DAG deployed, its `queue=` routed to the Go coordinator.
- Re-packed after any rebuild/strip/sign (preserves `binary_sha256`).

---

## Related Skills

- **authoring-go-sdk-tasks**: Write the Go task code and the matching Python stubs.
- **configuring-airflow-language-sdks**: Register `ExecutableCoordinator` and route the queue.
- **deploying-airflow**: General Airflow deployment (Astro, Docker Compose, Kubernetes).
- **setting-up-astro-project**: Initialize and configure an Astro project.

© astronomer · Apache-2.0 · astronomer/agents

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
github-actions-templates Seth Hobson Скилл github-actions-templates для Claude Code создаёт GitHub Actions для тестирования, сборки и деплоя. Настраивает CI/CD и reusable workflows. CX Codex +1 17 420установок gitlab-ci-patterns Seth Hobson Скилл gitlab-ci-patterns для Claude Code помогает собирать GitLab CI/CD-пайплайны со стадиями, кэшем и деплоем. Описывает пайплайны для тестирования, сборки и доставки приложений. CX Codex +1 13 112установок devops-engineer https://github.com/Jeffallan Скилл devops-engineer для Claude Code создаёт Dockerfile, CI/CD-конфигурации и манифесты Kubernetes. Решает задачи инфраструктуры, деплоя и разбора инцидентов. CX Codex +1 12 400установок gke-app-onboarding официальный google Скилл gke-app-onboarding для Claude Code, Gemini CLI и Codex, который ведёт первичный онбординг приложения в Google Kubernetes Engine. Покрывает контейнеризацию, генерацию манифестов и деплой. CX Codex +1 6 489установок container-escape-techniques yaklang Скилл container-escape-techniques для Claude Code описывает пути выхода из Docker, LXC и Kubernetes-подов на хост через привилегии, capabilities, docker.sock и cgroup. CX Codex +1 3 900установок domain-cloud-native actionbook Скилл domain-cloud-native задаёт правила разработки облачных микросервисов на Rust: от сигналов завершения работы до проверок готовности в Kubernetes. CX Codex +1 3 200установок

Из того же набора34

Весь набор →
delegating-to-otto Скилл delegating-to-otto учит агента вызывать astro otto как субагента для задач Airflow, dbt и дата-инженерии. Полезен, когда нужен разбор миграции на Airflow 3 или аудит репозитория. CX Codex +1 371установок airflow-state-store Скилл airflow-state-store помогает сохранять состояние задач и ассетов между повторами и запусками DAG в Airflow 3.3+, используя хранилища ключ-значение и crash-safe миксин для операторов, которые отправляют задачи во внешние системы. CX Codex +1 239установок authoring-language-sdk-tasks Скилл authoring-language-sdk-tasks помогает писать задачи Apache Airflow на Go или Java, сохраняя описание DAG в Python. Пригодится при настройке заглушек @task.stub и обмена данными через XCom. CX Codex +1 220установок configuring-airflow-language-sdks Скилл configuring-airflow-language-sdks для Claude Code настраивает маршрутизацию задач Airflow к Java- и Go-координаторам через очереди. Настраивает запуск native-задач, которые не стартуют или не подхватываются. CX Codex +1 219установок authoring-go-sdk-tasks Скилл authoring-go-sdk-tasks для Claude Code помогает писать задачи Apache Airflow на Go через Airflow Go SDK. Выносит тяжёлую логику из Python в нативные скомпилированные бандлы. CX Codex +1 217установок migrating-dagster-to-airflow Скилл migrating-dagster-to-airflow для Claude Code ведёт пошаговый перенос проектов Dagster и Dagster+ на Apache Airflow 3 и Astro Runtime через манифест и проверку ассетов. CX Codex +1 207установок deploying-java-sdk-bundles Скилл deploying-java-sdk-bundles собирает и развёртывает скомпилированные Java SDK пакеты Airflow так, чтобы воркеры могли их запускать. CX Codex +1 200установок authoring-java-sdk-tasks Скилл authoring-java-sdk-tasks для Claude Code, Codex, Cursor и других агентов, который учит писать логику задач Airflow на Java, Kotlin и любом JVM-языке через Airflow Java SDK. CX Codex +1 199установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой