apisix-dotnet-docker VS apisix-docker

For the demo case, we will leverage the sample project built on ASP.NET Core WEB API with a single GET endpoint (retrieves all products list) and Apache APISIX Docker sample project. You can find in README file all instructions on how to run the sample app.

Throughout the post, we get to know the types of possible failure injections with the Fault Injection Plugin 🔌 and simulate failures on our existing Product backend service (developed by using ASP.NET Core WEB API).

🙋🏼 With all the theoretical knowledge in mind, let's jump into the demo of using api-breaker plugin offered by Apache APISIX and see the result in action for our the existing sample project ASP.NET Core WEB API with a single endpoint (retrieves all products list).

Until now, I assume that you have the demo project apisix-dotnet-docker is up and running. You can see the complete source code on Github and the instruction on how to build a multi-container APISIX via Docker CLI.

✅ Clone the demo project apisix-dotnet-docker from GitHub. ✅ Understand the structure of the project and docker-compose.yaml file. ✅ Build a multi-container APISIX via Docker CLI. ✅ Configure APISIX API Gateway routing for the ASP.NET API. ✅ Enable a traffic management plugin.

This project leverages existing the pre-defined Docker Compose configuration file to set up, deploy, and run APISIX, etcd, Prometheus, and other services with a single command. First, clone the apisix-docker repo on GitHub, open it in your favorite editor, navigate to the example folder, and start the project by simply running docker compose up command in a terminal from the project root folder.

We will leverage the existing file-proxy demo project on GitHub. It has a quite similar structure to the existing Apisix docker example repo, only we removed unnecessary files to keep the demo simple. The project has 3 folders, docker-compose.yml, and sample openapi.yaml files.

git clone https://github.com/apache/apisix-docker.git

This first thing you clone the apisix-docker project repo from GitHub:

Apache APISIX Apache APISIX is an open source, dynamic, real-time, high-performance cloud native API gateway. APISIX provides rich traffic management features such as load balancing, dynamic upstream, canary release, circuit breaking, authentication, observability, and more. Official website https://apisix.apache.org/ GitHub projects APISIX (the core): https://github.com/apache/apisix GitHub - apache/apisix: The Cloud-Native API Gateway GitHub - apache/apisix-dashboard: Dashboard for Apache APISIX GitHub - apache/apisix-website: Apache APISIX Website GitHub - apache/apisix-docker: the docker for Apache APISIX GitHub - apache/apisix-go-plugin-runner: Go Plugin Runner for APISIX GitHub - apache/apisix-java-plugin-runner: APISIX Plugin Runner in Java GitHub - apache/apisix-python-plugin-runner: Apache APISIX Python plugin runner GitHub - apache/apisix-helm-chart: Apache APISIX Helm Chart GitHub - apache/apisix-ingress-controller: ingress controller for K8s

We made use of Apache APISIX docker compose repo where we deployed several components in one run and we demonstrated how the API Gateway can be used to manage sample ASP.NET Core application to retrieve product data using Product microservice's API. Also, you learned how to enable limit-count plugin for the API endpoint. There are many other built-in plugins available in Apache APISIX, you can check them on Plugin Hub page. Basically, APISIX can be a lightweight middleware API Gateway regardless of which programming language, frameworks, tools, or platforms you are developing a microservice or application.

In this demo, we are using Apache APISIX Docker repo and it contains an example docker-compose.yaml file and with other config files that makes straightforward to start APISIX using docker compose. We try out this example:

APISIX uses etcd to save and synchronize configuration. Before installing APISIX, you need to install etcd on your machine. It would be installed automatically if you choose the Apache APISIX Docker compose mode, you will learn more about on the next blog post Use Docker Compose to deploy containerized APISIX to AWS ECS.

The apisix-security-java-spring project makes use of the similar example APISIX docker compose template.

✔️ Create an Azure resource group. ✔️ Configure Azure Container Instances. ✔️ Create a Azure context for Docker to offload Apisix and etcd containers execution to ACI. ✔️ Get Apache APISIX example source code for Docker from GitHub. ✔️ Modify Docker compose file there. ✔️ Setup volumes in Azure Storage Account with Azure File Share. ✔️ Add APISIX config files to Azure File Share. ✔️ Bring up APISIX in Azure Container Instances. ✔️ Verify APISIX running. ✔️ Cleanup after you finish.