0.19.0

Highlight

Multi-upstream support in services

ADC now supports the inclusion of multiple upstreams in a single service in such a structure:

services:
- name: demo
  upstream:
    <default upstream>
  upstreams:
    - name: non-default-upstream-1
      <upstream config 1>
    - name: non-default-upstream-2
      <upstream config 2>
  routes: []

That is, it lets users create multiple new upstreams with service.upstreams. Where service.upstream is the default upstream, it will be used as the default upstream for all requests, or users can use the traffic-split plugin if users want to route some traffic to other upstreams proportionally or conditionally.

The service.upstreams supports setting a name or ID for the upstream, which is inferred and generated using sha1(service_name.upstream_name) if users don't specify the ID manually, and which can be used in the weighted_upstreams.upstream_id in the traffic-split plugin, allowing users to get rid of the requirement to inline upstream resources in the traffic-split plugin and enjoy the full functionality of the upstream health check.
Please note that when using custom IDs, users must ensure the uniqueness of the IDs, as conflicts can result in unintended coverage of resources.

In API7, upstream is natively associated with the service, which is a built-in capability, so support is native.
Whereas in APISIX upstreams are unable to proactively record associations with services, so we record the services that the upstream belongs to in labels, even though this is simulated, it works out of the box, please be careful not to manage and manually modify the records in labels by means other than ADC.

What's Changed

• feat(api7): support multiple upstream of service by @bzp2010 in #252
• fix(apisix): log scope typo by @bzp2010 in #253
• feat(apisix): support multiple upstream of service by @bzp2010 in #254
• fix(apisix): tolerate instance without stream proxy enabled by @bzp2010 in #255
• feat: bump to 0.19.0 by @bzp2010 in #256

Full Changelog: v0.18.0...v0.19.0

0.18.0

Notice

Since this version, the API7 backend no longer uses the force publish mode (i.e. publish-free API) and it no longer uses service templates.

As it does not use the publish mechanism, atomicity in effect is now no longer supported and all changes take effect immediately. If an error occurs, the ADC will report the error and exit with the exit code.

Highlight

ADC efficiency improvements

It greatly improves the time taken by the ADC to perform export and synchronization, and it may achieve a 100% speedup when enjoying the full optimization.

It encompasses multiple aspects:

• TCP connection reuse on the backend
• Mechanisms for parallel sync tasks
• Extensive refactoring

You can enjoy these optimizations as soon as you update, check the compatibility list for your use case.

OpenAPI converter support multi-file input

In 0.17.0 we supported multi-file input support for diff and sync, and now it has been introduced to the OAS converter as well.

Refactoring

In addition to the above, we have done a lot of refactoring, for example:

• Backend API definations
• API7 and APISIX backend implementations
• ADC logging infrastructure
• Differ v3 logging output

What's Changed

• fix(core): sync command example typo by @bzp2010 in #227
• chore: upgrade nx toolchain by @bzp2010 in #226
• feat(core): add remote state file as experimental feature by @bzp2010 in #229
• feat(core): support multiple file input for OAS converter by @bzp2010 in #228
• feat(api7): add parallel backend request as experimental feature by @bzp2010 in #230
• feat(api7): move to publish-free api by @bzp2010 in #234
• feat(backend): enable keepalive for backend api call by @bzp2010 in #235
• chore(core): move tasks to separate folder by @bzp2010 in #236
• chore(core): decouple logger by @bzp2010 in #237
• feat(api7): allow dev version and admin key mode by @bzp2010 in #238
• fix(api7): unexpectedly pass the empty string gateway group id by @bzp2010 in #239
• refactor: api7 backend by @bzp2010 in #240
• feat(core): add ingress entrypoint by @bzp2010 in #241
• feat(core): all in one ingress mode by @bzp2010 in #244
• fix(core): incorrect empty remote in ingress mode by @bzp2010 in #246
• feat(apisix): rewrite apisix backend by @bzp2010 in #245
• feat: imporve backend error handling by @bzp2010 in #247
• feat: bump to 0.18.0 by @bzp2010 in #248
• fix(core): lint does not allow string input on numeric fields by @bzp2010 in #249
• docs(api7): update compatibility matrix by @bzp2010 in #250

Full Changelog: v0.17.0...v0.18.0

0.17.0

Highlight

Support for multi-file input using glob

This has been implemented on the diff and sync commands. It is not implemented on OpenAPI Converter because it doesn't support multi-file input yet, which will be improved later.

It now supports such syntax:

• adc sync -f 'spec/*.yaml'
• adc sync -f 'spec/**/*.yaml'

Note that the glob expressions need to be quote-wrapped because we don't want the glob implementation in the shell to intervene for a uniform user experience.

More guides: https://github.com/isaacs/node-glob?tab=readme-ov-file#glob-primer

APISIX support down to 3.2.x

APISIX support has been extended to 3.2, which was an LTS but is now considered retired, which helps users to migrate.

For Known Issues/Limitations, please refer to: https://github.com/api7/adc/blob/main/libs/backend-apisix/README.md

What's Changed

• feat(core): support glob file path by @bzp2010 in #212
• feat(apisix): support apisix lower than 3.8 by @bzp2010 in #213
• feat(core): dump sorted yaml by @bzp2010 in #217
• feat(api7): support route vars expr by @bzp2010 in #219
• fix(apisix): service missing hosts by @bzp2010 in #220
• feat: bump to 0.17.0 by @bzp2010 in #221
• fix(apisix): upstream nodes should be allowed to be null by @bzp2010 in #222
• docs(api7): add 3.3.x support by @bzp2010 in #223

Full Changelog: v0.16.2...v0.17.0

0.16.2

What's Changed

• feat: release docker image by @bzp2010 in #209
• feat: bump to 0.16.2 by @bzp2010 in #210
• fix: docker release tag typo by @bzp2010 in #211

Full Changelog: v0.16.1...v0.16.2

0.16.1

What's Changed

• feat(core): loose custom resource id length by @bzp2010 in #206
• feat: bump to 0.16.1 by @bzp2010 in #207

Full Changelog: v0.16.0...v0.16.1

0.16.0

Highlight

Support for custom resource ID

The resource ID can now be customized by the user instead of letting ADC generate it automatically.
Just write the id field in the resource to make it work, but there are a few resources that are not supported yet, such as upstream (which is inlined by the service and doesn't support references) and consumer (whose username is the ID and doesn't want to be specified additionally).

It has been implemented on API7 and APISIX. #203 #204

What's Changed

• fix(api7): mismatched fields in upstream mtls by @bzp2010 in #202
• feat: support custom resource id by @bzp2010 in #203
• feat(core): update custom id schema by @bzp2010 in #204
• feat: bump to 0.16.0 by @bzp2010 in #205

Full Changelog: v0.15.0...v0.16.0

v0.15.0

Highlight

Support for Consumer Credentials on Apache APISIX✨

This release supports consumer credentials on APISIX, which will be enabled after APISIX is upgraded to 3.11.0. If not, you can only use the legacy consumer plugins format.

What's Changed

• feat: output more logs when errors happened by @bzp2010 in #187
• feat(api7): allow mutliple uris in route by @bzp2010 in #191
• feat(api7): support route-level timeout by @bzp2010 in #197
• chore: upgrade nx toolchain by @bzp2010 in #198
• test(api7): fix consumer credentials by @bzp2010 in #199
• feat(apisix): support consumer credentials by @bzp2010 in #200
• feat: bump to 0.15.0 by @bzp2010 in #201

Full Changelog: v0.14.0...v0.15.0

v0.14.0

Highlight

Support for Consumer Credentials✨

This release supports consumer credentials on API7, which will be enabled after API7 is upgraded to 3.2.15. If not, you can only use the legacy consumer credentials format.

What's Changed

• fix(core): re-order ssl operation events by @bzp2010 in #183
• feat(core): improve oas converter error output by @bzp2010 in #184
• feat(api7): support consumer credentials by @bzp2010 in #182
• feat: bump to 0.14.0 by @bzp2010 in #186

Full Changelog: v0.13.0...v0.14.0

v0.13.0

NOTICE

From this release, ADC will drop API7 3.2.13.0 support in favor of new features that became available on API7 3.2.14.x.

---

What's Changed

• feat(core): looser name length by @bzp2010 in #179
• feat(api7): add priority support by @bzp2010 in #170
• feat: bump to 0.13.0 by @bzp2010 in #180

Full Changelog: v0.12.2...v0.13.0

v0.12.2

What's Changed

• ci: test api7 on 3.2.14.3 by @bzp2010 in #167
• fix(core): route vars expr schema by @bzp2010 in #168
• fix(core): upstream health checker optional field schema by @bzp2010 in #169
• fix: improve inline documentation by @pottekkat in #172
• feat: add inline examples by @pottekkat in #174
• feat(core): linter looser description length by @bzp2010 in #175
• feat: bump to 0.12.2 by @bzp2010 in #176

Full Changelog: v0.12.1...v0.12.2