Cloud native API management refers to the use of API management tools and practices that are designed to be natively integrated with cloud computing environments, such as Kubernetes. These tools and practices help organizations to manage and govern their APIs in a more effective and efficient way, leveraging the benefits of cloud computing such as scalability, reliability, and cost-effectiveness. Cloud native API management is also a way of designing, building, and deploying APIs in a cloud environment. There are several characteristics that are commonly associated with cloud native API management:
WSO2 APK, designed to help you build, deploy, and manage APIs in a cloud environment. Our platform is built on top of a microservices architecture and uses containerization technologies to ensure scalability and flexibility. With features like automatic failover and load balancing, our APK platform is designed to be highly available and able to handle large numbers of API requests without performance degradation. We've also added support for continuous delivery and deployment, so you can quickly and easily push updates to your API services.
Some characteristics of APK
- Scalability: Designed to scale up and down based on demand, allowing them to handle large numbers of API requests without performance degradation.
- High availability: Designed to be highly available, with features like automatic failover and load balancing to ensure that API services are always available to clients.
- Elasticity: Designed to be elastic, meaning that they can quickly and easily adapt to changes in demand and workload.
- Microservices architecture: Built using a microservices architecture, which allows for more flexible and scalable deployment of API services.
- Containerization: Use containerization technologies to package and deploy product API services/ implementations in a cloud environment.
- Continuous delivery and deployment: Support continuous delivery and deployment, allowing developers to quickly and easily push updates to product.
For more information about APK release planning and project management information, visit APK Project Dashboard
For in-depth information about WSO2 API Management Platform, visit WSO2 API Management
To ask questions and get assistance from our community, visit WSO2 Discord
To learn how to participate in our overall community, visit our community page
In this README:
You'll find many other useful documents on our Documentation.
APK is an open-source platform for providing complete API Management capabilities on top of the Kubernetes cluster management platform.
APK is composed of these components:
-
Control Plane - The APK control plane. It provides API Management capabilities, marketplace capabilities along with domain services and web applications. It consists of the following sub-components:
-
Back Office - Responsible for configuring the portal aspects of API including descriptions, documents, images, etc. Also, manage API visibility and lifecycle. The backend component was developed using Ballerina
-
Dev Portal - Responsible for API consumer interaction. API consumers can discover APIs, read documents, try them out and eventually subscribe to and consume APIs. The backend component was developed using Ballerina
-
Admin Portal - Responsible for configuring rate limit policies, key management services, and other administrative tasks. Backend components developed using Ballerina
-
Management Server - Responsible for communication with data planes and pushing updates. Backend components developed using Go lang
-
-
Data Plane - The APK data plane. It provides API runtime capabilities such as gateway, rate-limiting services, and runtime management. It consists of the following sub-components:
-
Runtime Manager - Responsible for configuring the runtime aspects of API including API endpoints, discovering Kubernetes services, and converting them into APIs, etc. The backend component was developed using Ballerina
-
Management Client - Responsible for communication with the management server(control plane) to push/pull updates and maintain connectivity between the data plane and the control plane. The backend component was developed using Go
-
API Gateway - Router - Router will intercept incoming API traffic and apply quality of services such as authentication, authorization, and rate limiting. The router uses the Envoy Proxy as the core component that does the traffic routing. Required additional extensions were developed using C++
-
API Gateway - Enforcer - The Enforcer is the component that enforces the API management capabilities such as security, Rate Limiting, analytics, validation and etc. When the Router receives a request, it forwards that request to the Enforcer in order to perform the additional QoS. Plugins were developed using Java
-
Identity Platform - Responsible for authentication and authorization happens in the data plane.
-
WSO2 APK comes with Postman collections to test product APIs and developers can use collection of API requests and configure them to test different scenarios. For example, they can reuse available requests to verify that the API returns the correct responses for different requests. These tests will allow users to identify potential issues or bugs that may need to be addressed before using it. Please refer Postman Tests section of the repo for more information about tests and test artifacts.
WSO2 API Kubernetes Platform has released following docker images in the WSO2 public docker hub.
- Adapter: wso2/adapter:0.0.1-m4
- Gateway Enforcer: wso2/enforcer:0.0.1-m4
- Gatewary Router: wso2/router:0.0.1-m4
- Management Server: wso2/management-server:0.0.1-m4
- Runtime DS: wso2/runtime-domain-service:0.0.1-m4
- Admin DS: wso2/admin-domain-service:0.0.1-m4
- BackOffice DS: wso2/backoffice-domain-service:0.0.1-m4
- Devportal DS: wso2/devportal-domain-service:0.0.1-m4
- IDP DS: wso2/idp-domain-service:0.0.1-m4
- IDP UI: wso2/idp-ui:0.0.1-m4
-
Install Helm and Kubernetes client
-
An already setup Kubernetes cluster. If you want to run it on the local you can use Minikube or Kind or a similar software.
-
Setup deployment namespace
kubectl create namespace <Namespace>
HELM-HOME
= apk/helm-charts
- Execute
helm repo add bitnami https://charts.bitnami.com/bitnami
andhelm repo add jetstack https://charts.jetstack.io
- Clone the repo and cd into the
HELM-HOME
folder. - Execute
helm dependency build
command to download the dependent charts. - Now execute
helm install apk-test . -n apk
to install the APK components.
- To deploy control plane components only use
--set wso2.apk.dp.enabled=false
- To deploy data plane components only use
--set wso2.apk.cp.enabled=false
and need to disable Adapter connection to Management Server by setting following value tofalse
in /apk/helm-charts/templates/data-plane/gateway-components/log-conf.yaml file.
[managementServer]
enabled = false
- Verify the deployment by executing
kubectl get pods -n apk
kubectl get svc -n apk | grep router-service
kubectl port-forward svc/apk-test-wso2-apk-router-service -n apk 9095:9095
Follow the instruction below to deploy an API using the kubectl.
-
Create API CR and create production and/or sandbox HTTPRoute CRs, and service for the API backend . You can find a sample CR set in
developer/tryout/samples/
folder in this repository. -
Apply CRs to kubernetes API server using the kubectl.
kubectl apply -f developer/tryout/samples/
Note: Services should be created in a different namespace than APK or Kubernetes System namespaces. Note: APIs should be created in the APK deployment namespace.
- Get a token to invoke the System API. Provide the router service external ip to below command.
TOKEN=$(curl --location --request POST '{router_service}:9095/oauth2/token' \
--header 'Host: idp.am.wso2.com' \
--header 'Authorization: Basic NDVmMWM1YzgtYTkyZS0xMWVkLWFmYTEtMDI0MmFjMTIwMDAyOjRmYmQ2MmVjLWE5MmUtMTFlZC1hZmExLTAyNDJhYzEyMDAwMg==' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials')
- List the created API and retrieve API_ID.
curl --location --request GET '{router_service}:9095/api/am/runtime/apis' \
--header 'Host: api.am.wso2.com' \
--header 'Authorization: Bearer $TOKEN'
- Get a token to invoke the created API. Provide the router service external ip to below command.
INTERNAL_KEY=$(curl --location --request POST '{router_service}:9095/api/am/runtime/apis/<$API_ID>/generate-key' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Host: api.am.wso2.com' \
--header 'Authorization: Bearer $TOKEN')
- Invoke the API.
curl --location --request GET '{router_service}:9095/http-bin-api/1.0.8/get' \
--header 'HOST: gw.wso2.com' \
--header 'Internal-Key: $INTERNAL_KEY'
- Install Java JDK 11.
- Install Gradle(7.5.1).
- Install Ballerina Ballerina version: 2201.3.1 (Swan Lake Update 3).
- Install Go.
- Install Lua.
- Docker Runtime Up and Running.
Run /apk-build.sh file.
sh apk-build.sh
For example: building Runtime Domain Service
cd runtime/runtime-domain-service
gradle build
We use GitHub to track all of our bugs and feature requests. Each issue we track has a variety of metadata:
- Epic. An epic represents a feature area for APK as a whole. Epics are fairly broad in scope and are basically product-level things.Each issue is ultimately part of an epic.
- Milestone. Each issue is assigned a milestone. This is 0.1, 0.2, ..., or 'Nebulous Future'. The milestone indicates when we think the issue should get addressed.
- Priority. Each issue has a priority which is represented by the column in the Prioritization project. Priority can be one of P1, P2, or >P2. The priority indicates how important it is to address the issue within the milestone. P1 says that themilestone cannot be considered achieved if the issue isn't resolved.