diff --git a/app/_includes/landing_pages/card.md b/app/_includes/landing_pages/card.md new file mode 100644 index 00000000..641360a4 --- /dev/null +++ b/app/_includes/landing_pages/card.md @@ -0,0 +1,9 @@ +
+
+

{{ include.config.title}}

+

{{ include.config.description}}

+
+{% if include.config.cta %} +{% include landing_pages/cta.md config=include.config.cta %} +{% endif %} +
\ No newline at end of file diff --git a/app/_includes/landing_pages/image.md b/app/_includes/landing_pages/image.md new file mode 100644 index 00000000..da0f95ee --- /dev/null +++ b/app/_includes/landing_pages/image.md @@ -0,0 +1 @@ +{{include.config.alt_text}} \ No newline at end of file diff --git a/app/_landing_pages/gateway-entities.yaml b/app/_landing_pages/gateway-entities.yaml new file mode 100644 index 00000000..d637f45b --- /dev/null +++ b/app/_landing_pages/gateway-entities.yaml @@ -0,0 +1,133 @@ +content: + - row: + - column: + - type: header + config: + type: h1 + text: "Kong Gateway Entities" + align: center + + - row: + - column: + - type: structured_text + config: + blocks: + - type: text + text: | + Kong entities refer to the various components and objects that make up the Kong API Gateway and its ecosystem. + - type: image + config: + url: "https://raw.githubusercontent.com/Kong/docs.konghq.com/main/app/assets/images/products/konnect/getting-started/konnect-gateway-entities.png" + alt_text: "this is alt text" + + - row: + - column: + - type: header + config: + type: h2 + text: "Entity References" + - row: + - column: + - type: card + config: + title: "Service" + description: "Represent your upstream APIs or microservices. Each Service corresponds to a set of APIs that you want to expose through Kong." + cta: + text: ABC + url: "#" + align: end + - column: + - type: card + config: + title: "Routes" + description: "Define how requests are mapped to Services. Routes specify criteria such as paths, hosts, methods, and headers that determine which Service a request should be proxied to" + cta: + text: XYZ + url: "x" + align: end + - column: + - type: card + config: + title: "Consumers" + description: "Represent the clients or users consuming your APIs. Consumers can be individual users, applications, or other services." + cta: + text: ABC + url: "#" + align: end + - column: + - type: card + config: + title: "Certificates" + description: "Used for securing communication between clients and Kong or between Kong and upstream services using SSL/TLS." + cta: + text: ABC + url: "#" + align: end + - row: + - column: + - type: card + config: + title: "Upstreams" + description: "Represent a load-balanced group of backend services. An Upstream can have multiple Targets (backend services), and Kong will distribute requests among these Targets." + cta: + text: ABC + url: "#" + align: end + - column: + - type: card + config: + title: "Targets" + description: "he actual backend servers or instances that Kong forwards requests to. They are part of an Upstream." + cta: + text: XYZ + url: "x" + align: end + - column: + - type: card + config: + title: "SNIs" + description: "Server Name Indications used to support multiple SSL certificates for different domain names using a single IP address" + cta: + text: ABC + url: "#" + align: end + - column: + - type: card + config: + title: "ACLs" + description: "Used to control access to Services and Routes by grouping Consumers and allowing or denying access based on these groups" + cta: + text: ABC + url: "#" + align: end + - row: + - column: + - type: card + config: + title: "Plugins" + description: "Extend Kong’s functionality by adding features such as authentication, rate limiting, logging, and transformations. Plugins can be applied globally or on specific Services" + cta: + text: ABC + url: "#" + align: end + - column: + - type: card + config: + title: "Workspace" + description: "Extend Kong’s functionality by adding features such as authentication, rate limiting, logging, and transformations. Plugins can be applied globally or on specific Services" + cta: + text: XYZ + url: "x" + align: end + - column: + - type: structured_text + config: + blocks: + type: text + text: " " + - column: + - type: structured_text + config: + blocks: + type: text + text: " " \ No newline at end of file diff --git a/app/_layouts/concept.html b/app/_layouts/concept.html new file mode 100644 index 00000000..bed83888 --- /dev/null +++ b/app/_layouts/concept.html @@ -0,0 +1,8 @@ +--- +layout: default +--- + +
+

{{ page.title }}

+ {{ content }} +
\ No newline at end of file diff --git a/app/gateway/entities/index.md b/app/gateway/entities/index.md new file mode 100644 index 00000000..c358760e --- /dev/null +++ b/app/gateway/entities/index.md @@ -0,0 +1,37 @@ +--- +title: Kong Gateway Entities +layout: landing_page +entities: + - service + - route + - upstream + - plugin +related_resources: + - text: How to create rate limiting tiers + url: /plugins/rate-limiting/ +--- + + +## Entities + +Kong entities refer to the various components and objects that make up the Kong API Gateway and its ecosystem. + +Entities include: + +* [Services]: Represent your upstream APIs or microservices. Each Service corresponds to a set of APIs that you want to expose through Kong. +* Routes: Define how requests are mapped to Services. Routes specify criteria such as paths, hosts, methods, and headers that determine which Service a request should be proxied to. +* Consumers: Represent the clients or users consuming your APIs. Consumers can be individual users, applications, or other services. +* Plugins: Extend Kong’s functionality by adding features such as authentication, rate limiting, logging, and transformations. Plugins can be applied globally or on specific Services, Routes, or Consumers. +* Certificates: Used for securing communication between clients and Kong or between Kong and upstream services using SSL/TLS. +* Upstreams: Represent a load-balanced group of backend services. An Upstream can have multiple Targets (backend services), and Kong will distribute requests among these Targets. +* Targets: The actual backend servers or instances that Kong forwards requests to. They are part of an Upstream. +* SNIs: Server Name Indications used to support multiple SSL certificates for different domain names using a single IP address. +* ACLs (Access Control Lists): Used to control access to Services and Routes by grouping Consumers and allowing or denying access based on these groups. +* Certificates: Used to handle SSL/TLS certificates for secure communication. + + +{place holder text about how kong entities are kong gateway entities that map across all of our products.} + + +![image](https://raw.githubusercontent.com/Kong/docs.konghq.com/main/app/assets/images/products/konnect/getting-started/konnect-gateway-entities.png) #this thing renders to the right +