Skip to content

Commit 064d3e3

Browse files
authored
routes: add description and logo url (#1766)
* routes: add description and logo url * remove databroker settings * add route to route logo url * update id
1 parent 7eee751 commit 064d3e3

File tree

4 files changed

+121
-8
lines changed

4 files changed

+121
-8
lines changed
Loading

content/docs/reference/reference.json

+31-8
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121
"id": "address",
2222
"title": "Address",
2323
"path": "/address",
24-
"description": "Specifies the Host and Port to serve HTTP requests from.",
24+
"description": "Specifies the IP Address and Port to serve HTTP requests from.",
2525
"short_description": "",
2626
"type": "string",
2727
"services": ["proxy"]
@@ -439,7 +439,7 @@
439439
"id": "http-redirect-address",
440440
"title": "HTTP Redirect Address",
441441
"path": "/http-redirect-address",
442-
"description": "If set, HTTP Redirect Address specifies the Host and Port to redirect HTTP to HTTPS traffic on.",
442+
"description": "If set, HTTP Redirect Address specifies the IP Address and Port to redirect HTTP to HTTPS traffic on.",
443443
"services": [],
444444
"type": "string"
445445
},
@@ -546,17 +546,24 @@
546546
"path": "/tracing",
547547
"services": []
548548
},
549-
"tracing-provider": {
550-
"id": "tracing-provider",
549+
"tracing-otlp-endpoint": {
550+
"id": "tracing-otlp-endpoint",
551551
"title": "Tracing Provider",
552-
"description": "The name of the tracing provider. For example, Jaeger or Zipkin. Required.",
552+
"description": "Endpoint URL for OTLP trace data. Required.",
553+
"path": "/tracing",
554+
"services": []
555+
},
556+
"tracing-otlp-protocol": {
557+
"id": "tracing-otlp-endpoint",
558+
"title": "Tracing Provider",
559+
"description": "Transport protocol to be used for OTLP trace data.",
553560
"path": "/tracing",
554561
"services": []
555562
},
556563
"tracing-sample-rate": {
557564
"id": "tracing-sample-rate",
558565
"title": "Tracing Sample Rate",
559-
"description": "The percentage of requests to sample in decimal notation. Default is 0.0001, or .01%. Optional.",
566+
"description": "The percentage of requests to sample. Default is 100%.",
560567
"path": "/tracing",
561568
"services": []
562569
},
@@ -797,6 +804,14 @@
797804
"description": "Allows unauthenticated HTTP OPTIONS requests.",
798805
"type": "bool"
799806
},
807+
"description": {
808+
"id": "description",
809+
"title": "Description",
810+
"path": "/routes/description",
811+
"services": ["proxy"],
812+
"description": "Description of the route.",
813+
"type": "string"
814+
},
800815
"enable-google-cloud-serverless-authentication": {
801816
"id": "enable-google-cloud-serverless-authentication",
802817
"title": "Enable Google Cloud Serverless Authentication",
@@ -1057,9 +1072,9 @@
10571072
},
10581073
"logo-url": {
10591074
"id": "logo-url",
1060-
"title": "Logo Url",
1075+
"title": "Logo URL",
10611076
"path": "/branding#logo-url",
1062-
"description": "A Url pointing to your logo. Defaults to Pomerium's Logo.",
1077+
"description": "A URL pointing to your logo. Defaults to Pomerium's Logo.",
10631078
"services": [],
10641079
"type": "URL"
10651080
},
@@ -1318,6 +1333,14 @@
13181333
"description": "Modifies response headers before they are returned to the client. 'Header' matches the HTTP header name; 'prefix' will be replaced with 'value'.",
13191334
"type": "object"
13201335
},
1336+
"route-logo-url": {
1337+
"id": "route-logo-url",
1338+
"title": "Route Logo URL",
1339+
"path": "/routes/logo-url",
1340+
"services": ["proxy"],
1341+
"description": "The route logo URL.",
1342+
"type": "URL"
1343+
},
13211344
"route-timeout": {
13221345
"id": "route-timeout",
13231346
"title": "Route Timeout",
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
---
2+
id: description
3+
title: Route Description
4+
keywords:
5+
- reference
6+
- Route Description
7+
pagination_prev: null
8+
pagination_next: null
9+
toc_max_heading_level: 2
10+
---
11+
12+
import Tabs from '@theme/Tabs';
13+
import TabItem from '@theme/TabItem';
14+
15+
# Route Description
16+
17+
## Summary
18+
19+
Route description shown in the routes portal.
20+
21+
## How to configure
22+
23+
<Tabs>
24+
<TabItem value="Core" label="Core">
25+
26+
| **Config file key** | **Type** | **Usage** |
27+
| :------------------ | :------- | :----------- |
28+
| `description` | `string` | **optional** |
29+
30+
</TabItem>
31+
<TabItem value="Enterprise" label="Enterprise">
32+
33+
Set the route **description** under **General** route settings in the Console:
34+
35+
![Set the route **description** under **General** route settings in the Console](../img/routes/route-description.png)
36+
37+
</TabItem>
38+
<TabItem value="Kubernetes" label="Kubernetes">
39+
40+
| **[Annotation name](/docs/deploy/k8s/ingress#set-ingress-annotations)** | **Type** | **Usage** |
41+
| :-- | :-- | :-- |
42+
| `description` | `string` | **optional** |
43+
44+
</TabItem>
45+
</Tabs>
+45
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
---
2+
id: logo-url
3+
title: Route Logo URL
4+
keywords:
5+
- reference
6+
- Route Logo URL
7+
pagination_prev: null
8+
pagination_next: null
9+
toc_max_heading_level: 2
10+
---
11+
12+
import Tabs from '@theme/Tabs';
13+
import TabItem from '@theme/TabItem';
14+
15+
# Route Logo URL
16+
17+
## Summary
18+
19+
Route logo URL shown in the routes portal.
20+
21+
## How to configure
22+
23+
<Tabs>
24+
<TabItem value="Core" label="Core">
25+
26+
| **Config file key** | **Type** | **Usage** |
27+
| :------------------ | :------- | :----------- |
28+
| `logo_url` | `string` | **optional** |
29+
30+
</TabItem>
31+
<TabItem value="Enterprise" label="Enterprise">
32+
33+
Set the route **logo URL** under **General** route settings in the Console:
34+
35+
![Set the route **logo URL** under **General** route settings in the Console](../img/routes/route-description.png)
36+
37+
</TabItem>
38+
<TabItem value="Kubernetes" label="Kubernetes">
39+
40+
| **[Annotation name](/docs/deploy/k8s/ingress#set-ingress-annotations)** | **Type** | **Usage** |
41+
| :-- | :-- | :-- |
42+
| `logo_url` | `string` | **optional** |
43+
44+
</TabItem>
45+
</Tabs>

0 commit comments

Comments
 (0)