status-im
/
consul
mirror of https://github.com/status-im/consul.git
2
0
Fork 0
Code Issues Projects Releases Wiki Activity

add links

This commit is contained in:
Sarah Alsmiller 2022-07-14 11:15:01 -05:00
parent 773e73f325
commit 49ae65b9de
1 changed files with 33 additions and 33 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

66
website/content/docs/api-gateway/configuration/gateway.mdx
View File

@ -13,50 +13,50 @@ This topic provides full details about the `Gateway` resource.
A `Gateway` is an instance of network infrastructure that determines how service traffic should be handled. A `Gateway` contains one or more `listeners` that bind to a set of IP addresses. An `HTTPRoute` or `TCPRoute` can then attach to a gateway listener to direct traffic from the gateway to a service. A `Gateway` is an instance of network infrastructure that determines how service traffic should be handled. A `Gateway` contains one or more `listeners` that bind to a set of IP addresses. An `HTTPRoute` or `TCPRoute` can then attach to a gateway listener to direct traffic from the gateway to a service.
Gateway instances derive their configurations from the `GatewayClass` resource, which acts as a template for individual `Gateway` deployments. Refer to [GatewayClass](/docs/api-gateway/configuration/gatewayclass) for additional information. Gateway instances derive their configurations from the [`GatewayClass`](/docs/api-gateway/configuration/gatewayclass) resource, which acts as a template for individual `Gateway` deployments. Refer to [GatewayClass](/docs/api-gateway/configuration/gatewayclass) for additional information.
Specify the following parameters to declare a Gateway: Specify the following parameters to declare a Gateway:
| Parameter | Description | Required | | Parameter | Description | Required |
|:-----------:|:----------------------------------------------------------------------------------------------------------------------------------------------------------:|:--------:| |:-----------:|:----------------------------------------------------------------------------------------------------------------------------------------------------------:|:--------:|
| kind | Specifies the type of configuration object. The value should always be Gateway | Required | | `kind` | Specifies the type of configuration object. The value should always be Gateway | Required |
| description | Human-readable string for describing the purpose of the Gateway. | Optional | | `description` | Human-readable string for describing the purpose of the Gateway. | Optional |
| version | Specifies the Kubernetes API version. The value should always be gateway.networking.k8s.io/v1alpha2 | Required | | `version ` | Specifies the Kubernetes API version. The value should always be gateway.networking.k8s.io/v1alpha2 | Required |
| scope | Specifies the effective scope of the Gateway. The value should always be namespaced. | Required | | `scope` | Specifies the effective scope of the Gateway. The value should always be namespaced. | Required |
| fields | Specifies the configurations for the Gateway. The fields are listed in the Configuration model. Details for each field are described in the Specification. | Required | | `fields` | Specifies the configurations for the Gateway. The fields are listed in the Configuration model. Details for each field are described in the Specification. | Required |
## Configuration model ## Configuration model
* gatewayClassName: string | required * `gatewayClassName`: string | required
* listeners: array of objects | required * `listeners`: array of objects | required
* allowedRoutes: object | required * `allowedRoutes`: object | required
* namespaces: object | required * `namespaces`: object | required
* from: string | required * `from`: string | required
* selector: object | required if from is configured to selector * `selector`: object | required if from is configured to selector
* matchExpressions: array of objects | required if matchLabels is not configured * `matchExpressions`: array of objects | required if matchLabels is not configured
* key: string | required if matchExpressions is declared * `key`: string | required if matchExpressions is declared
* operator: string | required if matchExpressions is declared * `operator`: string | required if matchExpressions is declared
* values: array of strings | required if matchExpressions is declared * `values`: array of strings | required if matchExpressions is declared
* matchLabels: map of strings | required if matchExpressions is not configured * `matchLabels`: map of strings | required if matchExpressions is not configured
* hostname: string | required * `hostname`: string | required
* name: string | required * `name`: string | required
* port: integer | required * `port`: integer | required
* protocol: string | required * `protocol`: string | required
* tls: object | required if protocol is set to HTTPS * `tls`: object | required if protocol is set to HTTPS
* certificateRefs: array or objects | required if tls is declared * `certificateRefs`: array or objects | required if tls is declared
* name: string | required if certificateRefs is declared * `name`: string | required if certificateRefs is declared
* namespace: string | required if certificateRefs is declared * `namespace`: string | required if certificateRefs is declared
* mode: string | required if certificateRefs is declared * `mode`: string | required if certificateRefs is declared
* options: map of strings | optional * `options`: map of strings | optional
## Specification ## Specification
This topic provides details about the configuration parameters. This topic provides details about the configuration parameters.
### gatewayClassName ### gatewayClassName
Specifies the name of the `GatewayClass` resource used for the `Gateway` instance. Specifies the name of the [`GatewayClass`](/docs/api-gateway/configuration/gatewayclass) resource used for the `Gateway` instance.
* Type: string * Type: string
* Required: required * Required: required
@ -100,11 +100,11 @@ Specifies an array of requirements for matching namespaces. If a match is found,
| Requirement | Description | Type | | Requirement | Description | Type |
|:-----------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:----------------:| |:-----------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:----------------:|
| key | Specifies that label that the key applies to. | string | |`key` | Specifies that label that the key applies to. | string |
| operator | Specifies the key's relation to a set of values. The following values are valid:In: description of what this means NotIn: description of what this means Exists: description of what this means DoesNotExist: description of what this means | string | |`operator` | Specifies the key's relation to a set of values. The following values are valid:In: description of what this means NotIn: description of what this means Exists: description of what this means DoesNotExist: description of what this means | string |
| values | Specifies an array of string values. If the operator is configured to In or NotIn,the values array must be non-empty. If theoperator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch. | array of strings | |`values` | Specifies an array of string values. If the operator is configured to In or NotIn,the values array must be non-empty. If theoperator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch. | array of strings |
| scope | Specifies the effective scope of the Gateway. The value should always be namespaced. | Required | |`scope` | Specifies the effective scope of the Gateway. The value should always be namespaced. | Required |
| fields | Specifies the configurations for the Gateway. The fields are listed in the Configuration model. Details for each field are described in the Specification. | Required | |`fields` | Specifies the configurations for the Gateway. The fields are listed in the Configuration model. Details for each field are described in the Specification. | Required |
```yaml ```yaml
namespaceSelector: namespaceSelector: