Skip to content

ci+deploy: publish multi-arch withautonomi/antd image from ant-sdk release - #130

Merged
Nic-dorman merged 1 commit into
mainfrom
nic/v2-352-multi-arch-antd-image
May 27, 2026
Merged

ci+deploy: publish multi-arch withautonomi/antd image from ant-sdk release#130
Nic-dorman merged 1 commit into
mainfrom
nic/v2-352-multi-arch-antd-image

Conversation

@Nic-dorman

Copy link
Copy Markdown
Collaborator

Summary

Moves the antd container image build upstream from indelible. On every tagged ant-sdk release, the linux/amd64 + linux/arm64 binaries from the existing matrix job are wrapped in an Alpine 3.21 base via deploy/Dockerfile and pushed to:

  • withautonomi/antd:vX.Y.Z (Docker Hub) + ghcr.io/withautonomi/antd:vX.Y.Z (GHCR)
  • withautonomi/antd:latest + ghcr.io/withautonomi/antd:lateststable releases only (pre-releases like v1.0.0-rc.1 ship the version tag alone)

⚠️ Prerequisite before merging

This workflow needs two repo secrets to push to Docker Hub:

  • DOCKERHUB_USERNAMEwithautonomi (or whichever account)
  • DOCKERHUB_TOKEN — a Docker Hub access token with write to withautonomi/antd

GHCR uses GITHUB_TOKEN automatically — no setup.

If the secrets are missing on the next release tag, the docker job fails but the release job (GitHub Release + binary artifacts) still publishes — they run in parallel, both gated only on build.

Image details

  • Base: alpine:3.21
  • User: non-root, UID 65532 (`antd:antd`)
  • Volume: /var/lib/antd
  • Exposed ports: 8082 (REST), 50051 (gRPC)
  • Healthcheck: `wget http://localhost:8082/health\` (30s interval)
  • Defaults (overrideable via env or CLI):
    • `ANTD_REST_ADDR=0.0.0.0:8082`
    • `ANTD_GRPC_ADDR=0.0.0.0:50051`

Container needs external reachability to be useful; antd's own default flipped to loopback-only in v0.8.0 (#107). Operator is presumed to front the image with their own gateway / firewall.

Test plan

  • YAML validates locally on dev2.
  • After secrets are added: tag a pre-release (e.g. `v0.8.1-rc.1`) to validate the full pipeline without moving `:latest`. Expected: 2-arch manifest list on both registries, digests match across.
  • `docker manifest inspect ghcr.io/withautonomi/antd:vX.Y.Z` shows both `linux/amd64` and `linux/arm64`.
  • Unauthenticated `docker pull withautonomi/antd:vX.Y.Z` works.

Sibling cleanup (after this lands)

Drop `deploy/antd/Dockerfile` + the second build-push step in indelible's `.github/workflows/release.yml` (tracked separately as V2-353 in the indelible-side ticket queue).

…lease

Indelible has been building and publishing the antd container image as
a transitional companion via its own release workflow (deploy/antd in
that repo). That works but inverts ownership: ant-sdk releases drive
when the image needs to update, but a different repo's release
workflow has to be re-tagged to ship it.

Moves the antd image build upstream. On every tagged ant-sdk release,
linux/amd64 + linux/arm64 binaries built by the existing matrix job
are wrapped in an Alpine 3.21 base via deploy/Dockerfile and pushed to
both Docker Hub (withautonomi/antd) and GHCR (ghcr.io/withautonomi/antd).

Tagging:
- :vX.Y.Z always
- :latest only on stable releases (pre-releases like v1.0.0-rc.1 ship
  :v1.0.0-rc.1 alone, no :latest move)

Image defaults (overrideable):
- ENV ANTD_REST_ADDR=0.0.0.0:8082
- ENV ANTD_GRPC_ADDR=0.0.0.0:50051

The container needs network reachability to be useful; antd's own
default flipped to loopback-only in v0.8.0. Operator is presumed to
front the image with their own gateway / firewall.

Runs as non-root UID 65532 with VOLUME /var/lib/antd and a wget-based
/health HEALTHCHECK.

Prerequisite to land on main: add DOCKERHUB_USERNAME + DOCKERHUB_TOKEN
secrets to the repo. GHCR push uses GITHUB_TOKEN automatically. Without
the Docker Hub secrets, the docker job fails on the next release tag
but the GitHub Release + binary artifacts still publish (release job
runs in parallel, not gated on docker).

Sibling cleanup ticket: drop deploy/antd from the indelible repo and
the second build-push step from indelible's release.yml once this
lands and the first ant-sdk-driven image is verified.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@Nic-dorman
Nic-dorman merged commit 6071f39 into main May 27, 2026
Nic-dorman added a commit that referenced this pull request May 28, 2026
Closes the gRPC parity gap with REST: external-signer (UploadService +
chunks PrepareChunk/FinalizeChunk) and WalletService are now reachable
over gRPC, plus stream-download stubs return honest UNIMPLEMENTED/501
instead of pretending. All 11 gRPC-capable SDKs follow with matching
fan-out.

## Additive (antd daemon)

- gRPC UploadService + chunks prepare/finalize — external-signer two-phase
  upload + single-chunk publish over gRPC, mirroring REST 1:1 (#140)
- gRPC WalletService — GetAddress / GetBalance / Approve, parity with
  REST /v1/wallet/* (#154)
- /v1/data/prepare now honors visibility for public DataMap chunk
  bundling via data_prepare_upload_with_visibility (#138)

## Fixes (antd daemon)

- Stream-download stubs (DataServiceStub.StreamDownload, REST
  /v1/data/stream/*) now return UNIMPLEMENTED / 501 honestly rather
  than empty success (#155)

## SDK fan-out — external-signer (gRPC prepare/finalize)

All 11 gRPC-capable SDKs replace their stub raises with real gRPC calls
to the new UploadService + ChunkService PrepareChunk/FinalizeChunk RPCs:

- antd-rust (#169), antd-go (#170), antd-py (#171), antd-java (#172),
  antd-kotlin (#173), antd-csharp (#174), antd-ruby (#175),
  antd-dart (#176), antd-swift (#177), antd-cpp (#178),
  antd-elixir (#179)

## SDK fan-out — WalletService

Same 11 SDKs gain walletAddress / walletBalance / walletApprove over gRPC:

- antd-rust (#180), antd-go (#181), antd-py (#182), antd-java (#183),
  antd-kotlin (#184), antd-csharp (#185), antd-ruby (#186),
  antd-dart (#187), antd-swift (#188), antd-cpp (#189),
  antd-elixir (#190)

## SDK examples + build fixes

- antd-ruby: payForQuotes tuple args as Hash for eth-0.5.13
  compatibility (#131)
- antd-go + ant-dev: add 03-chunks + 06-private-data examples;
  renumber 03-files to 04-files (#132)
- antd-java + antd-cpp: close async client surface gaps (#133)
- ant-dev: pull antd[rest,grpc] extras so 08_grpc example runs out
  of the box (#134)
- antd-js + antd-py + antd-go READMEs: surface external-signer
  methods + 07 example (#135)
- antd-elixir: 07_external_signer example via cast shell-out (#136)
- antd-swift: 07_external_signer example + fix FinalizeUploadDTO
  optional address (#137)
- antd-php: empty tx_hashes serializes as JSON object on finalize
  (#139)

## FFI

- ant-ffi refresh against current ant-core API + Swift xcframework
  build pipeline (#150)
- Android AAR build pipeline (#156)

## Infra

- CI: auto-tag Go submodules on umbrella release tag push (#129)
- Deploy: publish multi-arch withautonomi/antd image from ant-sdk
  release (#130)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant