From c46fe4997e2bcb048446e11ba26390e1912744e6 Mon Sep 17 00:00:00 2001 From: Anita-ihuman <62384659+Anita-ihuman@users.noreply.github.com> Date: Sun, 27 Mar 2022 11:03:49 +0100 Subject: [PATCH] docs: added an Introductory section to the "Getting started" (#6554) * Added an introductory secction to Apache APISIX Signed-off-by: Anita-ihuman * Updated the intoductionmwith the feature of APISIX Signed-off-by: Anita-ihuman * updates PR Signed-off-by: Anita-ihuman * Update docs/en/latest/getting-started.md Co-authored-by: Shivam Singh * Update docs/en/latest/getting-started.md Co-authored-by: Shivam Singh * Update docs/en/latest/getting-started.md Co-authored-by: Shivam Singh * Update docs/en/latest/getting-started.md Co-authored-by: Shivam Singh * Update docs/en/latest/getting-started.md Co-authored-by: Shivam Singh * Update docs/en/latest/getting-started.md Co-authored-by: yilinzeng <36651058+yzeng25@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: yilinzeng <36651058+yzeng25@users.noreply.github.com> * Update docs/en/latest/getting-started.md Sure I will effect that now. Co-authored-by: yilinzeng <36651058+yzeng25@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: yilinzeng <36651058+yzeng25@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: yilinzeng <36651058+yzeng25@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: yilinzeng <36651058+yzeng25@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: yilinzeng <36651058+yzeng25@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: Bisakh * Update docs/en/latest/getting-started.md Co-authored-by: Avinal Kumar * Update docs/en/latest/getting-started.md Co-authored-by: leslie <59061168+leslie-tsang@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: leslie <59061168+leslie-tsang@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: leslie <59061168+leslie-tsang@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: leslie <59061168+leslie-tsang@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: leslie <59061168+leslie-tsang@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: leslie <59061168+leslie-tsang@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: leslie <59061168+leslie-tsang@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: leslie <59061168+leslie-tsang@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: leslie <59061168+leslie-tsang@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: leslie <59061168+leslie-tsang@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: leslie <59061168+leslie-tsang@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: leslie <59061168+leslie-tsang@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: leslie <59061168+leslie-tsang@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: leslie <59061168+leslie-tsang@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: leslie <59061168+leslie-tsang@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: leslie <59061168+leslie-tsang@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: leslie <59061168+leslie-tsang@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: leslie <59061168+leslie-tsang@users.noreply.github.com> * Update docs/en/latest/getting-started.md Co-authored-by: Bisakh * updates PR Signed-off-by: Anita-ihuman * updates PR Signed-off-by: Anita-ihuman * Update docs/en/latest/getting-started.md Co-authored-by: Bisakh * Update docs/en/latest/getting-started.md Co-authored-by: leslie <59061168+leslie-tsang@users.noreply.github.com> Co-authored-by: Shivam Singh Co-authored-by: yilinzeng <36651058+yzeng25@users.noreply.github.com> Co-authored-by: Bisakh Co-authored-by: Avinal Kumar Co-authored-by: leslie <59061168+leslie-tsang@users.noreply.github.com> --- docs/en/latest/getting-started.md | 41 +++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) diff --git a/docs/en/latest/getting-started.md b/docs/en/latest/getting-started.md index 19931d4d6562..e59737f23c3c 100644 --- a/docs/en/latest/getting-started.md +++ b/docs/en/latest/getting-started.md @@ -21,6 +21,47 @@ title: Getting Started # --> +## What is an API Gateway? + +An [API gateway](https://microservices.io/patterns/apigateway.html) is an API management tool that acts as a mid layer service between a client and a number backend services. Typically, the API gateway receives the clients requests and processes it by summoning multiple microservices, aggregating the services and returning the appropriate results. + +## What is Apache APISIX? + +An [API gateway](https://microservices.io/patterns/apigateway.html) is an API management tool that acts as a mid-layer service between a client and a number of backend services. Typically, the API gateway receives the client's requests and processes them by summoning multiple microservices, aggregating the services, and returning the appropriate results. + +## What is Apache APISIX + +Apache APISIX is an open-source, dynamic and high-performance cloud-native API gateway that delivers the ultimate performance for all your APIs and microservices. Think of APISIX as a service bus that connects APIs and microservices in your cloud-native architecture. +Apache APISIX facilitates interface traffic handling for Websites, Mobile and IoT applications by providing services such as load balancing, dynamic upstream, grayscale publishing, refined routing, current and speed limiting, and many more. + +### The problem APISIX solves? + + - Help enterprises to solve the difficulties in the transformation of traditional monolithic architecture, so as to achieve rapid iteration of business and products. + - Apache APISIX replaces NGINX and handles traditional north-south traffic. It also replaces Envoy to handle east-west traffic between services. + - Handles Layer 4 and Layer 7 traffic: HTTP, HTTPs, TCP, UDP, MQTT, Dubbo, gRPC, etc. + - It can also be used as a [K8s ingress controller](https://github.com/apache/apisix-ingress-controller). + - Use IdP plugin as Zero-Trust gateway + - Easy to use: APISIX also consists of a built-in low-code dashboard that offers a powerful and flexible interface. You can write your own custom plugins or use custom load balancing algorithms. + +## Features + +Apache APISIX not only covers the traditional functions of NGINX, but also deeply cooperates with different observability platforms, which greatly improves service governance capabilities. Other characteristics of the Apache APISIX gateway includes: + + - Multi-Platform Support: + APISIX is a cloud native, open source API gateway. You can run APISIX from bare-metal to Kubernetes. Since APISIX supports ARM64, it avoids the lock-in challenge of the infrastructure technology. It also provides integration to cloud providers like AWS Lambda, Azure Functions, Lua functions and Apache OpenWhisk. + + - Full Dynamic: + The biggest feature of Apache APISIX is that it is fully dynamic. That includes routing, SSL certificates, plugins, upstream etc. It adopts hot-reloading so, every feature can be dynamically configured by the admin API, without having to restart the service at all. + + - Fine-Grained Routing: + Support all Nginx built-in variables as conditions for routing, so you can use cookie, args, etc. as routing conditions to implement canary release, A/B testing, etc. Apache APISIX provides operators that serve as judgment conditions for routing and a custom routing matching function. By using GraphQL attributes, APISIX allows you to filter routes. + + - OPS Friendly: + Apache APISIX has been adopted amongst organisation’s DevOps team because of it Ops-friendly strategy. it supports numerous tools and platforms like HashiCorp Vault, [Zipkin](https://github.com/Anita-ihuman/apisix/blob/Introduction/docs/en/latest/plugins/zipkin.md), [Apache SkyWalking](https://github.com/Anita-ihuman/apisix/blob/Introduction/docs/en/latest/plugins/skywalking.md), [Consul](https://github.com/Anita-ihuman/apisix/blob/Introduction/docs/en/latest/discovery/consul_kv.md), [Nacos](https://github.com/Anita-ihuman/apisix/blob/Introduction/docs/en/latest/discovery/nacos.md), [Eureka](https://github.com/Anita-ihuman/apisix/blob/Introduction/docs/en/latest/discovery.md), etc. With a user friendly [dashboard](https://github.com/apache/apisix-dashboard), Apache APISIX makes it is easy for users/admins to operate APISIX through a frontend interface. + + - Multi-Language Support: + Apache APISIX is a multi-language gateway for plugin development and supports multiple languages via RPC and Wasm. Developers choose the language according to their needs and write the code according to the language-specific SDKs. The plugin can be integrated with APISIX by compiling it to Wasm (WebAssembly) bytecode. Optionally, developers can leverage the `plugin runners` to implement specific RPC methods (the actual business logic). Currently, APISIX supports plugin runners in Java, Golang, Python and Node.js. + ## Summary This guide walks through how you can get up and running with Apache APISIX.