Highlights

New Differ v4 Implementation

We have introduced a new implementation of Differ v4, which replaces the duplicate code with a predefined metadata table. This separates the diff algorithm from the field-handling strategy, helping to improve code readability and maintainability.

This release is only a code refactoring; you should expect no difference in behavior compared to the old Differ v3. If you encounter a negative behavioral difference, we will consider it a bug.

If you want to go back to the Differ v3 implementation, use the following environment variables:

export ENABLE_DIFFER_V4=false # or ENABLE_DIFFER_V4=0

What's Changed

• feat: use differ v4 as default implementation by @bzp2010 in #502
• chore: upgrade toolchain and dependencies by @bzp2010 in #503
• chore(deps): update dependency qs to v6.15.3 by @renovate[bot] in #505
• chore(deps): update dependency listr2 to v10.2.2 by @renovate[bot] in #504
• chore(deps): update bitnamilegacy/etcd docker tag to v3.6 by @renovate[bot] in #473
• fix(deps): update dependency @scalar/openapi-parser to v0.28.8 by @renovate[bot] in #506
• chore(deps): update dependency eslint to v10.6.0 by @renovate[bot] in #507
• chore(deps): update dependency prettier to v3.9.1 by @renovate[bot] in #509
• chore(deps): update typescript-eslint monorepo to v8.62.0 by @renovate[bot] in #510
• feat: bump to 0.28.0 by @bzp2010 in #508

Full Changelog: v0.27.1...v0.28.0

What's Changed

• chore: Configure Renovate by @renovate[bot] in #463
• chore(deps): update dependency eslint-config-prettier to v10.1.8 by @renovate[bot] in #464
• chore(deps): update dependency glob to v13.0.6 by @renovate[bot] in #465
• chore(deps): update dependency parse-duration to v2.1.6 by @renovate[bot] in #467
• chore(deps): update dependency prettier to v3.8.4 by @renovate[bot] in #468
• chore(deps): update dependency slugify to v1.6.9 by @renovate[bot] in #469
• chore(deps): update typescript-eslint monorepo to v8.61.1 by @renovate[bot] in #471
• feat: new differ v4 by @bzp2010 in #479
• chore(deps): update dependency jiti to v2.7.0 by @renovate[bot] in #480
• chore(deps): update dependency semver to v7.8.5 by @renovate[bot] in #482
• chore(deps): update dependency dotenv to v17.4.2 by @renovate[bot] in #477
• chore(deps): update dependency @types/node to v24.13.2 by @renovate[bot] in #474
• chore(deps): update dependency @types/qs to v6.15.1 by @renovate[bot] in #475
• chore(deps): update dependency express to v5.2.1 by @renovate[bot] in #478
• chore(deps): update dependency lru-cache to v11.5.1 by @renovate[bot] in #481
• chore(deps): update dependency zod to v4.4.3 by @renovate[bot] in #485
• chore(deps): update pnpm to v11.8.0 by @renovate[bot] in #486
• chore(deps): update dependency supertest to v7.2.2 by @renovate[bot] in #483
• chore(deps): update dependency winston to v3.19.0 by @renovate[bot] in #484
• fix(apisix-standalone): potential duplication of global rules by @bzp2010 in #497
• feat(differ): add feature gate for v4 by @bzp2010 in #498
• feat: bump to 0.27.1 by @bzp2010 in #499

New Contributors

• @renovate[bot] made their first contribution in #463

Full Changelog: v0.27.0...v0.27.1

What's Changed

• fix(backend-api7): include plugins when dumping stream_route by @AlinsRan in #452
• fix: handle circular OpenAPI schemas during conversion by @jarvis9443 in #454
• docs(converter-openapi): align README extension table with code by @kayx23 in #447
• ci(docker): use reusable image builder workflow by @bzp2010 in #457
• chore: upgrade toolchain and dependencies by @bzp2010 in #458
• fix(codeql): workflow permission and javascript prototype by @bzp2010 in #459
• feat(apisix-standalone): lrucache ttl and active invalidation by @bzp2010 in #460
• docs(backend): update support versions by @bzp2010 in #461
• feat: bump to 0.27.0 by @bzp2010 in #462

New Contributors

• @AlinsRan made their first contribution in #452
• @kayx23 made their first contribution in #447

Full Changelog: v0.26.0...v0.27.0

What's Changed

• fix: rename schema field https_verify_cert to https_verify_certificate by @jarvis9443 in #438
• feat(server): validate api by @bzp2010 in #440
• feat(backend): improve log for http error response by @LiteSun in #443
• chore: upgrade dependencies by @bzp2010 in #448
• feat: bump to 0.26.0 by @bzp2010 in #449

Full Changelog: v0.25.0...v0.26.0

Highlights

Server-side configuration validation

You can now run a server-side configuration validation using the adc validate. Essentially, this is equivalent to performing a dry-run synchronization.

All configurations are built as API requests and validated via the Admin API, allowing you to perform a more rigorous configuration validation than adc lint before actually running adc sync.

In terms of strictness:

adc sync > adc validate > adc lint

Now, the validate command is available on all backends.

In the future, we will also add a validate API to the adc server to improve the AIC user experience.

Enhanced error reporting

New binary ADC build, whose error call stack now reflects the original line and column numbers in the codebase. Previously, it could only display line numbers from the bundled JS file.

What's Changed

• fix(api7): make upstream optional by @jarvis9443 in #425
• test(api7): deploy test components by docker compose by @jarvis9443 in #429
• feat(cli): improve UX when throw error by @bzp2010 in #431
• feat(api7): add server-side configuration validator by @jarvis9443 in #432
• feat(cli): refine validate command by @bzp2010 in #433
• feat(apisix): add server-side configuration validator by @jarvis9443 in #434
• chore: upgrade dependencies by @bzp2010 in #435
• feat: bump to 0.25.0 by @bzp2010 in #436

New Contributors

• @jarvis9443 made their first contribution in #425

Full Changelog: v0.24.3...v0.25.0

What's Changed

• chore: upgrade toolchain and dependencies by @bzp2010 in #421
• feat: migrate from webpack to esbuild by @bzp2010 in #423
• feat: bump to 0.24.3 by @bzp2010 in #424

Full Changelog: v0.24.2...v0.24.3

What's Changed

• fix(server): free socket timeout invalid operator by @bzp2010 in #409
• feat: bump to 0.24.2 by @bzp2010 in #410

Full Changelog: v0.24.1...v0.24.2

What's Changed

• fix(server): free socket timeout caused socket hang up by @bzp2010 in #407
• feat: bump to 0.24.1 by @bzp2010 in #408

Full Changelog: v0.24.0...v0.24.1

Note

Container images

ADC container images are now available on Docker Hub, whereas previously they were only accessible via the GitHub registry.

Additionally, in accordance with API7.ai policy, container images starting from this release will be signed to comply with software supply chain security requirements. Containers on Docker Hub and GitHub registry are signed.

Use the following command to verify the signature:

Install cosign first.

COSIGN_REPOSITORY=api7/notary cosign verify api7/adc:0.24.0 \
  --certificate-identity="https://github.com/api7/adc/.github/workflows/docker.yaml@refs/tags/v0.24.0" \
  --certificate-oidc-issuer="https://token.actions.githubusercontent.com"

# verify image from GitHub registry
COSIGN_REPOSITORY=api7/notary cosign verify ghcr.io/api7/adc:0.24.0 \
  --certificate-identity="https://github.com/api7/adc/.github/workflows/docker.yaml@refs/tags/v0.24.0" \
  --certificate-oidc-issuer="https://token.actions.githubusercontent.com"

What's Changed

• feat(server): report apisix-standalone endpoint status by @bzp2010 in #396
• chore(deps): upgrade toolchain and deps by @bzp2010 in #398
• ci(release): push image to docker hub by @bzp2010 in #400
• ci(release): add image provenance by @bzp2010 in #401 (Replaced by cosign signature)
• ci(release): add image signature by @bzp2010 in #402
• ci(release): fix packages permission by @bzp2010 in #403
• feat: bump to 0.24.0 by @bzp2010 in #404

Full Changelog: v0.23.1...v0.24.0

What's Changed

• fix(apisix-standalone): system time rollback caused sync failure by @bzp2010 in #393
• fix(apisix): transform client TLS certificate pairs when dump upstream by @bzp2010 in #395
• feat: bump to 0.23.1 by @bzp2010 in #394

Full Changelog: v0.23.0...v0.23.1