feat: support devcontainer

[bzp2010]

Description

Add devcontainer support to the project, which is expected to cover Linux, Windows (WSL2), macOS OSs, and the amd64, arm64 CPU ISAs, i.e. the environments used by most developers.

Basically, the container provides an isolated environment from the host, the runtime and toolset required for APISIX development are built in the container build, they will be available out of the box and developers no longer need to build and install them on the host. Just start dev container, wait a few moments, and it's ready to go.

Significantly simplify the parts that may be unfamiliar to developers and just focus on writing Lua code and test cases.

In addition to this, etcd is ready, maintained by docker-compose, and accessible on the local loopback.

Checklist

• I have explained the need for this PR and the problem it solves
• I have explained the changes or the new features added to this PR
• I have added tests corresponding to this change
• I have updated the documentation to reflect this change
• I have verified that this change is backward compatible (If not, please discuss on the APISIX mailing list first)

[bzp2010]

I have tested this on Windows WSL2 + Docker Desktop and macOS + OrbStack, where macOS is an arm64 based m4 chip.
Developers don't need to make any individual adjustments to any of the above environments, they will automatically do the right thing. (e.g. Installs the arm64-based binaries)

However, I don't have a desktop system running Linux, which would require someone else to help test, but that should not be a problem.

[bzp2010]

The error in the CI is not related to this PR, it also fails on other PRs, will investigate it later.

UPDATE

I have fixed the issue in #11769.

[SkyeYoung]

🆒 I will help with testing using Manjaro KDE Plasma(amd64) + Docker Engine.

[SkyeYoung]

Tested in Manjaro KDE Plasma (amd64) + Docker Engine:

But I encountered some problems during the test:

Error Log

error.log

[github-actions]

This pull request has been marked as stale due to 60 days of inactivity. It will be closed in 4 weeks if no further activity occurs. If you think that's incorrect or this pull request should instead be reviewed, please simply write any comment. Even if closed, you can still revive the PR at any time or discuss it on the [email protected] list. Thank you for your contributions.

[bzp2010]

This PR has been renovated, where the tests can run correctly, except for a problem that needs to be solved by #12070.

[SkyeYoung]

This PR has been renovated, where the tests can run correctly, except for a problem that needs to be solved by #12070.

Looks like #12070 has been merged.

[bzp2010]

Merging the master branch to fix #12070 doesn't seem to be successful, I'll rebase and force push.

[SkyeYoung]

Still got some error logs: It seems that there will be many problems caused by personal environmental factors

🤔

[Baoyuantop]

Works well on my arm macOS.

[Baoyuantop]

Need to install the Dev Containers extension?

[bzp2010]

@Baoyuantop Yes

[bzp2010]

Usually, it is pre-included. I mentioned that "which has built-in integration"

[bzp2010]

I confirmed that the test failure is not related to this PR, so maybe we can merge this PR first and continue to improve usability in subsequent PRs. This PR has been open for too long.

[juzhiyuan]

I have tried locally and works well

[SkyeYoung]

I tried it again locally, and it is still the previous environment.

make run and FLUSH_ETCD=1 prove -Itest-nginx/lib -I. -r t/admin/api.t works.

But make test still have some problems.

[bzp2010]

@juzhiyuan @SkyeYoung

These warnings will be fixed in a later PR. I will merge this PR first.