mirror of https://github.com/status-im/consul.git
maintenance complete, pending markdown-page component addition
This commit is contained in:
parent
30167c9b4c
commit
582dce9d8f
|
@ -1,8 +0,0 @@
|
||||||
{
|
|
||||||
"ignore": {
|
|
||||||
"marked": {
|
|
||||||
"versions": "0.8.2",
|
|
||||||
"reason": "IE breaks"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
|
@ -1,11 +1,4 @@
|
||||||
module.exports = {
|
module.exports = {
|
||||||
...require('@hashicorp/nextjs-scripts/.stylelintrc.js'),
|
...require('@hashicorp/nextjs-scripts/.stylelintrc.js'),
|
||||||
rules: {
|
/* Specify overrides here */
|
||||||
'selector-pseudo-class-no-unknown': [
|
|
||||||
true,
|
|
||||||
{
|
|
||||||
ignorePseudoClasses: ['first', 'last'],
|
|
||||||
},
|
|
||||||
],
|
|
||||||
},
|
|
||||||
}
|
}
|
||||||
|
|
|
@ -1,4 +0,0 @@
|
||||||
module.exports = {
|
|
||||||
presets: ['next/babel'],
|
|
||||||
plugins: ['import-glob-array'],
|
|
||||||
}
|
|
|
@ -1,28 +0,0 @@
|
||||||
import Search from '@hashicorp/react-search'
|
|
||||||
|
|
||||||
export default function SearchBar() {
|
|
||||||
return (
|
|
||||||
<Search
|
|
||||||
renderHitContent={({ hit, Highlight }) => (
|
|
||||||
<>
|
|
||||||
<span className="name">
|
|
||||||
<Highlight attribute="page_title" hit={hit} tagName="span" />
|
|
||||||
</span>
|
|
||||||
<span className="description">
|
|
||||||
<Highlight attribute="description" hit={hit} tagName="span" />
|
|
||||||
</span>
|
|
||||||
</>
|
|
||||||
)}
|
|
||||||
resolveHitLink={(hit) => ({
|
|
||||||
href: {
|
|
||||||
pathname: `/${transformIdtoUrl(hit.objectID)}`,
|
|
||||||
},
|
|
||||||
})}
|
|
||||||
placeholder="Search Consul documentation"
|
|
||||||
/>
|
|
||||||
)
|
|
||||||
}
|
|
||||||
|
|
||||||
function transformIdtoUrl(id) {
|
|
||||||
return id.replace(/\/index$/, '')
|
|
||||||
}
|
|
|
@ -1,4 +0,0 @@
|
||||||
.g-search {
|
|
||||||
width: calc(100% - 2rem);
|
|
||||||
max-width: 600px;
|
|
||||||
}
|
|
|
@ -1,6 +1,6 @@
|
||||||
import BasicHero from '../../components/basic-hero'
|
import BasicHero from 'components/basic-hero'
|
||||||
import PrefooterCTA from '../../components/prefooter-cta'
|
import PrefooterCTA from 'components/prefooter-cta'
|
||||||
import ConsulEnterpriseComparison from '../../components/enterprise-comparison/consul'
|
import ConsulEnterpriseComparison from 'components/enterprise-comparison/consul'
|
||||||
import Head from 'next/head'
|
import Head from 'next/head'
|
||||||
import HashiHead from '@hashicorp/react-head'
|
import HashiHead from '@hashicorp/react-head'
|
||||||
|
|
|
@ -19,8 +19,8 @@ to optimize performance of Connect without having to make requests to the server
|
||||||
## Authorize
|
## Authorize
|
||||||
|
|
||||||
-> **Note:** This endpoint will always treat intentions with `Permissions`
|
-> **Note:** This endpoint will always treat intentions with `Permissions`
|
||||||
defined as *deny* intentions during evaluation, as this endpoint is only suited
|
defined as _deny_ intentions during evaluation, as this endpoint is only suited
|
||||||
for networking layer 4 (e.g. TCP) integration.
|
for networking layer 4 (e.g. TCP) integration.
|
||||||
For performance and reliability reasons it is desirable to implement intention
|
For performance and reliability reasons it is desirable to implement intention
|
||||||
enforcement by listing [intentions that match the
|
enforcement by listing [intentions that match the
|
||||||
destination](/api/connect/intentions#list-matching-intentions) and representing
|
destination](/api/connect/intentions#list-matching-intentions) and representing
|
|
@ -146,7 +146,11 @@ The table below shows this endpoint's support for
|
||||||
| ----------------- | ----------------- | ------------- | -------------- |
|
| ----------------- | ----------------- | ------------- | -------------- |
|
||||||
| `YES`<sup>1</sup> | `none` | `none` | `service:read` |
|
| `YES`<sup>1</sup> | `none` | `none` | `service:read` |
|
||||||
|
|
||||||
<sup>1</sup> Supports <a href="/api/features/blocking#hash-based-blocking-queries">hash-based blocking</a> only.
|
<sup>
|
||||||
|
1
|
||||||
|
</sup> Supports <a href="/api/features/blocking#hash-based-blocking-queries">
|
||||||
|
hash-based blocking
|
||||||
|
</a> only.
|
||||||
|
|
||||||
### Parameters
|
### Parameters
|
||||||
|
|
|
@ -248,7 +248,7 @@ The table below shows this endpoint's support for
|
||||||
<sup>1</sup> The ACL required depends on the config entry kind being deleted:
|
<sup>1</sup> The ACL required depends on the config entry kind being deleted:
|
||||||
|
|
||||||
| Config Entry Kind | Required ACL |
|
| Config Entry Kind | Required ACL |
|
||||||
| ------------------- | ---------------- |
|
| ------------------- | ------------------ |
|
||||||
| ingress-gateway | `operator:write` |
|
| ingress-gateway | `operator:write` |
|
||||||
| proxy-defaults | `operator:write` |
|
| proxy-defaults | `operator:write` |
|
||||||
| service-defaults | `service:write` |
|
| service-defaults | `service:write` |
|
||||||
|
@ -256,7 +256,7 @@ The table below shows this endpoint's support for
|
||||||
| service-resolver | `service:write` |
|
| service-resolver | `service:write` |
|
||||||
| service-router | `service:write` |
|
| service-router | `service:write` |
|
||||||
| service-splitter | `service:write` |
|
| service-splitter | `service:write` |
|
||||||
| terminating-gateway | `operator:write ` |
|
| terminating-gateway | `operator:write ` |
|
||||||
|
|
||||||
### Parameters
|
### Parameters
|
||||||
|
|
|
@ -119,11 +119,12 @@ The table below shows this endpoint's support for
|
||||||
[agent caching](/api/features/caching), and
|
[agent caching](/api/features/caching), and
|
||||||
[required ACLs](/api#authentication).
|
[required ACLs](/api#authentication).
|
||||||
|
|
||||||
| Blocking Queries | Consistency Modes | Agent Caching | ACL Required |
|
| Blocking Queries | Consistency Modes | Agent Caching | ACL Required |
|
||||||
| ---------------- | ----------------- | ------------- | --------------- |
|
| ---------------- | ----------------- | ------------- | ----------------------------- |
|
||||||
| `YES` | `all` | `none` | `operator:write` <sup>1</sup> |
|
| `YES` | `all` | `none` | `operator:write` <sup>1</sup> |
|
||||||
|
|
||||||
<sup>1</sup> ACL required was <code>operator:read</code> prior to versions 1.8.6, 1.7.10, and 1.6.10.
|
<sup>1</sup> ACL required was <code>operator:read</code> prior to versions 1.8.6,
|
||||||
|
1.7.10, and 1.6.10.
|
||||||
|
|
||||||
### Sample Request
|
### Sample Request
|
||||||
|
|
|
@ -47,8 +47,8 @@ The table below shows this endpoint's support for
|
||||||
| `NO` | `none` | `none` | `intentions:write`<sup>1</sup> |
|
| `NO` | `none` | `none` | `intentions:write`<sup>1</sup> |
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
<sup>1</sup> Intention ACL rules are specified as part of a <code>service</code> rule.
|
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
|
||||||
See{' '}
|
<code>service</code> rule. See{' '}
|
||||||
<a href="/docs/connect/intentions#intention-management-permissions">
|
<a href="/docs/connect/intentions#intention-management-permissions">
|
||||||
Intention Management Permissions
|
Intention Management Permissions
|
||||||
</a>{' '}
|
</a>{' '}
|
||||||
|
@ -156,8 +156,8 @@ The table below shows this endpoint's support for
|
||||||
| `NO` | `none` | `none` | `intentions:write`<sup>1</sup> |
|
| `NO` | `none` | `none` | `intentions:write`<sup>1</sup> |
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
<sup>1</sup> Intention ACL rules are specified as part of a <code>service</code> rule.
|
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
|
||||||
See{' '}
|
<code>service</code> rule. See{' '}
|
||||||
<a href="/docs/connect/intentions#intention-management-permissions">
|
<a href="/docs/connect/intentions#intention-management-permissions">
|
||||||
Intention Management Permissions
|
Intention Management Permissions
|
||||||
</a>{' '}
|
</a>{' '}
|
||||||
|
@ -254,8 +254,8 @@ The table below shows this endpoint's support for
|
||||||
| `NO` | `none` | `none` | `intentions:write`<sup>1</sup> |
|
| `NO` | `none` | `none` | `intentions:write`<sup>1</sup> |
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
<sup>1</sup> Intention ACL rules are specified as part of a <code>service</code> rule.
|
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
|
||||||
See{' '}
|
<code>service</code> rule. See{' '}
|
||||||
<a href="/docs/connect/intentions#intention-management-permissions">
|
<a href="/docs/connect/intentions#intention-management-permissions">
|
||||||
Intention Management Permissions
|
Intention Management Permissions
|
||||||
</a>{' '}
|
</a>{' '}
|
||||||
|
@ -308,8 +308,8 @@ The table below shows this endpoint's support for
|
||||||
| `YES` | `all` | `none` | `intentions:read`<sup>1</sup> |
|
| `YES` | `all` | `none` | `intentions:read`<sup>1</sup> |
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
<sup>1</sup> Intention ACL rules are specified as part of a <code>service</code> rule.
|
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
|
||||||
See{' '}
|
<code>service</code> rule. See{' '}
|
||||||
<a href="/docs/connect/intentions#intention-management-permissions">
|
<a href="/docs/connect/intentions#intention-management-permissions">
|
||||||
Intention Management Permissions
|
Intention Management Permissions
|
||||||
</a>{' '}
|
</a>{' '}
|
||||||
|
@ -361,8 +361,8 @@ $ curl \
|
||||||
|
|
||||||
## Read Specific Intention by ID
|
## Read Specific Intention by ID
|
||||||
|
|
||||||
-> **Deprecated** - This endpoint is deprecated in Consul 1.9.0 in favor of
|
-> **Deprecated** - This endpoint is deprecated in Consul 1.9.0 in favor of
|
||||||
[reading by name](#read-specific-intention-by-name) or by viewing the
|
[reading by name](#read-specific-intention-by-name) or by viewing the
|
||||||
[`service-intentions`](/docs/agent/config-entries/service-intentions)
|
[`service-intentions`](/docs/agent/config-entries/service-intentions)
|
||||||
config entry for the destination.
|
config entry for the destination.
|
||||||
|
|
||||||
|
@ -383,8 +383,8 @@ The table below shows this endpoint's support for
|
||||||
| `YES` | `all` | `none` | `intentions:read`<sup>1</sup> |
|
| `YES` | `all` | `none` | `intentions:read`<sup>1</sup> |
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
<sup>1</sup> Intention ACL rules are specified as part of a <code>service</code> rule.
|
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
|
||||||
See{' '}
|
<code>service</code> rule. See{' '}
|
||||||
<a href="/docs/connect/intentions#intention-management-permissions">
|
<a href="/docs/connect/intentions#intention-management-permissions">
|
||||||
Intention Management Permissions
|
Intention Management Permissions
|
||||||
</a>{' '}
|
</a>{' '}
|
||||||
|
@ -443,8 +443,8 @@ The table below shows this endpoint's support for
|
||||||
| `YES` | `all` | `none` | `intentions:read`<sup>1</sup> |
|
| `YES` | `all` | `none` | `intentions:read`<sup>1</sup> |
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
<sup>1</sup> Intention ACL rules are specified as part of a <code>service</code> rule.
|
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
|
||||||
See{' '}
|
<code>service</code> rule. See{' '}
|
||||||
<a href="/docs/connect/intentions#intention-management-permissions">
|
<a href="/docs/connect/intentions#intention-management-permissions">
|
||||||
Intention Management Permissions
|
Intention Management Permissions
|
||||||
</a>{' '}
|
</a>{' '}
|
||||||
|
@ -527,13 +527,13 @@ The table below shows this endpoint's support for
|
||||||
[agent caching](/api/features/caching), and
|
[agent caching](/api/features/caching), and
|
||||||
[required ACLs](/api#authentication).
|
[required ACLs](/api#authentication).
|
||||||
|
|
||||||
| Blocking Queries | Consistency Modes | Agent Caching | ACL Required |
|
| Blocking Queries | Consistency Modes | Agent Caching | ACL Required |
|
||||||
| ---------------- | ----------------- | ------------- | ----------------------------- |
|
| ---------------- | ----------------- | ------------- | ------------------------------ |
|
||||||
| `NO` | `none` | `none` | `intentions:write`<sup>1</sup> |
|
| `NO` | `none` | `none` | `intentions:write`<sup>1</sup> |
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
<sup>1</sup> Intention ACL rules are specified as part of a <code>service</code> rule.
|
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
|
||||||
See{' '}
|
<code>service</code> rule. See{' '}
|
||||||
<a href="/docs/connect/intentions#intention-management-permissions">
|
<a href="/docs/connect/intentions#intention-management-permissions">
|
||||||
Intention Management Permissions
|
Intention Management Permissions
|
||||||
</a>{' '}
|
</a>{' '}
|
||||||
|
@ -590,8 +590,8 @@ The table below shows this endpoint's support for
|
||||||
| `NO` | `none` | `none` | `intentions:write`<sup>1</sup> |
|
| `NO` | `none` | `none` | `intentions:write`<sup>1</sup> |
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
<sup>1</sup> Intention ACL rules are specified as part of a <code>service</code> rule.
|
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
|
||||||
See{' '}
|
<code>service</code> rule. See{' '}
|
||||||
<a href="/docs/connect/intentions#intention-management-permissions">
|
<a href="/docs/connect/intentions#intention-management-permissions">
|
||||||
Intention Management Permissions
|
Intention Management Permissions
|
||||||
</a>{' '}
|
</a>{' '}
|
||||||
|
@ -618,7 +618,7 @@ and returns whether the connection would be authorized or not given the current
|
||||||
Consul configuration and set of intentions.
|
Consul configuration and set of intentions.
|
||||||
|
|
||||||
-> **Note:** This endpoint will always evaulate intentions with `Permissions`
|
-> **Note:** This endpoint will always evaulate intentions with `Permissions`
|
||||||
defined as *deny* intentions during. This endpoint is only suited for
|
defined as _deny_ intentions during. This endpoint is only suited for
|
||||||
networking layer 4 (e.g. TCP) integration.
|
networking layer 4 (e.g. TCP) integration.
|
||||||
|
|
||||||
For performance and reliability reasons it is desirable to implement intention
|
For performance and reliability reasons it is desirable to implement intention
|
||||||
|
@ -645,8 +645,8 @@ The table below shows this endpoint's support for
|
||||||
| `NO` | `none` | `none` | `intentions:read`<sup>1</sup> |
|
| `NO` | `none` | `none` | `intentions:read`<sup>1</sup> |
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
<sup>1</sup> Intention ACL rules are specified as part of a <code>service</code> rule.
|
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
|
||||||
See{' '}
|
<code>service</code> rule. See{' '}
|
||||||
<a href="/docs/connect/intentions#intention-management-permissions">
|
<a href="/docs/connect/intentions#intention-management-permissions">
|
||||||
Intention Management Permissions
|
Intention Management Permissions
|
||||||
</a>{' '}
|
</a>{' '}
|
||||||
|
@ -708,8 +708,8 @@ The table below shows this endpoint's support for
|
||||||
| `YES` | `all` | `background refresh` | `intentions:read`<sup>1</sup> |
|
| `YES` | `all` | `background refresh` | `intentions:read`<sup>1</sup> |
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
<sup>1</sup> Intention ACL rules are specified as part of a <code>service</code> rule.
|
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
|
||||||
See{' '}
|
<code>service</code> rule. See{' '}
|
||||||
<a href="/docs/connect/intentions#intention-management-permissions">
|
<a href="/docs/connect/intentions#intention-management-permissions">
|
||||||
Intention Management Permissions
|
Intention Management Permissions
|
||||||
</a>{' '}
|
</a>{' '}
|
|
@ -197,7 +197,7 @@ The table below shows this endpoint's support for
|
||||||
that does not include the acquire parameter will proceed normally even if another
|
that does not include the acquire parameter will proceed normally even if another
|
||||||
session has locked the key.**
|
session has locked the key.**
|
||||||
|
|
||||||
For an example of how to use the lock feature, check the
|
For an example of how to use the lock feature, check the
|
||||||
[Leader Election tutorial](https://learn.hashicorp.com/tutorials/consul/application-leader-elections).
|
[Leader Election tutorial](https://learn.hashicorp.com/tutorials/consul/application-leader-elections).
|
||||||
|
|
||||||
- `release` `(string: "")` - Supply a session ID to use in a release operation. This is
|
- `release` `(string: "")` - Supply a session ID to use in a release operation. This is
|
|
@ -252,14 +252,13 @@ $ curl \
|
||||||
The HTTP status code will indicate the health of the cluster. If `Healthy` is true, then a
|
The HTTP status code will indicate the health of the cluster. If `Healthy` is true, then a
|
||||||
status of 200 will be returned. If `Healthy` is false, then a status of 429 will be returned.
|
status of 200 will be returned. If `Healthy` is false, then a status of 429 will be returned.
|
||||||
|
|
||||||
|
|
||||||
## Read the Autopilot State
|
## Read the Autopilot State
|
||||||
|
|
||||||
This endpoint queries the health of the autopilot status.
|
This endpoint queries the health of the autopilot status.
|
||||||
|
|
||||||
| Method | Path | Produces |
|
| Method | Path | Produces |
|
||||||
| ------ | ---------------------------- | ------------------ |
|
| ------ | --------------------------- | ------------------ |
|
||||||
| `GET` | `/operator/autopilot/state` | `application/json` |
|
| `GET` | `/operator/autopilot/state` | `application/json` |
|
||||||
|
|
||||||
The table below shows this endpoint's support for
|
The table below shows this endpoint's support for
|
||||||
[blocking queries](/api/features/blocking),
|
[blocking queries](/api/features/blocking),
|
||||||
|
@ -288,32 +287,32 @@ $ curl \
|
||||||
|
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
"Healthy": true,
|
"Healthy": true,
|
||||||
"FailureTolerance": 1,
|
"FailureTolerance": 1,
|
||||||
"OptimisticFailureTolerance": 4,
|
"OptimisticFailureTolerance": 4,
|
||||||
"Servers": {
|
"Servers": {
|
||||||
"5e26a3af-f4fc-4104-a8bb-4da9f19cb278": {},
|
"5e26a3af-f4fc-4104-a8bb-4da9f19cb278": {},
|
||||||
"10b71f14-4b08-4ae5-840c-f86d39e7d330": {},
|
"10b71f14-4b08-4ae5-840c-f86d39e7d330": {},
|
||||||
"1fd52e5e-2f72-47d3-8cfc-2af760a0c8c2": {},
|
"1fd52e5e-2f72-47d3-8cfc-2af760a0c8c2": {},
|
||||||
"63783741-abd7-48a9-895a-33d01bf7cb30": {},
|
"63783741-abd7-48a9-895a-33d01bf7cb30": {},
|
||||||
"6cf04fd0-7582-474f-b408-a830b5471285": {}
|
"6cf04fd0-7582-474f-b408-a830b5471285": {}
|
||||||
},
|
},
|
||||||
"Leader": "5e26a3af-f4fc-4104-a8bb-4da9f19cb278",
|
"Leader": "5e26a3af-f4fc-4104-a8bb-4da9f19cb278",
|
||||||
"Voters": [
|
"Voters": [
|
||||||
"5e26a3af-f4fc-4104-a8bb-4da9f19cb278",
|
"5e26a3af-f4fc-4104-a8bb-4da9f19cb278",
|
||||||
"10b71f14-4b08-4ae5-840c-f86d39e7d330",
|
"10b71f14-4b08-4ae5-840c-f86d39e7d330",
|
||||||
"1fd52e5e-2f72-47d3-8cfc-2af760a0c8c2"
|
"1fd52e5e-2f72-47d3-8cfc-2af760a0c8c2"
|
||||||
],
|
],
|
||||||
"RedundancyZones": {
|
"RedundancyZones": {
|
||||||
"az1": {},
|
"az1": {},
|
||||||
"az2": {},
|
"az2": {},
|
||||||
"az3": {}
|
"az3": {}
|
||||||
},
|
},
|
||||||
"ReadReplicas": [
|
"ReadReplicas": [
|
||||||
"63783741-abd7-48a9-895a-33d01bf7cb30",
|
"63783741-abd7-48a9-895a-33d01bf7cb30",
|
||||||
"6cf04fd0-7582-474f-b408-a830b5471285"
|
"6cf04fd0-7582-474f-b408-a830b5471285"
|
||||||
],
|
],
|
||||||
"Upgrade": {}
|
"Upgrade": {}
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -322,13 +321,12 @@ $ curl \
|
||||||
- `FailureTolerance` is the number of redundant healthy servers that could be
|
- `FailureTolerance` is the number of redundant healthy servers that could be
|
||||||
fail without causing an outage (this would be 2 in a healthy cluster of 5
|
fail without causing an outage (this would be 2 in a healthy cluster of 5
|
||||||
servers).
|
servers).
|
||||||
|
|
||||||
- `OptimisticFailuretolerance` <EnterpriseAlert inline /> is the maximum number
|
- `OptimisticFailuretolerance` <EnterpriseAlert inline /> is the maximum number
|
||||||
of servers that could fail in the right order over the right period of time
|
of servers that could fail in the right order over the right period of time
|
||||||
without causing an outage. This value is only useful when using the [Redundancy
|
without causing an outage. This value is only useful when using the [Redundancy
|
||||||
Zones feature](/docs/enterprise/redundancy) with autopilot.
|
Zones feature](/docs/enterprise/redundancy) with autopilot.
|
||||||
|
|
||||||
- `Servers` is a mapping of server ID to an object holding detailed information about that server.
|
- `Servers` is a mapping of server ID to an object holding detailed information about that server.
|
||||||
The format of the detailed info is documented in its own section.
|
The format of the detailed info is documented in its own section.
|
||||||
|
|
||||||
- `Leader` is the server ID of current leader. This value can be used as an index into the `Servers` object.
|
- `Leader` is the server ID of current leader. This value can be used as an index into the `Servers` object.
|
||||||
|
@ -340,7 +338,6 @@ $ curl \
|
||||||
|
|
||||||
- `ReadReplicas` <EnterpriseAlert inline /> is a list of server IDs that autopilot has identified as read replicas.
|
- `ReadReplicas` <EnterpriseAlert inline /> is a list of server IDs that autopilot has identified as read replicas.
|
||||||
These will never be promoted. These values can be used as indexes into the `Servers` map.
|
These will never be promoted. These values can be used as indexes into the `Servers` map.
|
||||||
|
|
||||||
- `Upgrade` <EnterpriseAlert inline /> is an object holding all the information about any ongoing automated upgrade.
|
- `Upgrade` <EnterpriseAlert inline /> is an object holding all the information about any ongoing automated upgrade.
|
||||||
The format of this object is detailed in its own section.
|
The format of this object is detailed in its own section.
|
||||||
|
|
||||||
|
@ -348,25 +345,25 @@ $ curl \
|
||||||
|
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
"ID": "1c3e3278-3f88-4a97-9f6a-1058584e8058",
|
"ID": "1c3e3278-3f88-4a97-9f6a-1058584e8058",
|
||||||
"Name": "node1",
|
"Name": "node1",
|
||||||
"Address": "198.18.0.1:8300",
|
"Address": "198.18.0.1:8300",
|
||||||
"NodeStatus": "alive",
|
"NodeStatus": "alive",
|
||||||
"Version": "1.9.0+ent",
|
"Version": "1.9.0+ent",
|
||||||
"LastContact": "1.321ms",
|
"LastContact": "1.321ms",
|
||||||
"LastTerm": 4,
|
"LastTerm": 4,
|
||||||
"LastIndex": 42,
|
"LastIndex": 42,
|
||||||
"Healthy": true,
|
"Healthy": true,
|
||||||
"StableSince": "2020-08-12T12:13:14Z",
|
"StableSince": "2020-08-12T12:13:14Z",
|
||||||
"RedundancyZone": "az1",
|
"RedundancyZone": "az1",
|
||||||
"UpgradeVersion": "1.2.3",
|
"UpgradeVersion": "1.2.3",
|
||||||
"ReadReplica": false,
|
"ReadReplica": false,
|
||||||
"Status": "voter",
|
"Status": "voter",
|
||||||
"Meta": {
|
"Meta": {
|
||||||
"build": "1.2.3",
|
"build": "1.2.3",
|
||||||
"zone": "az1"
|
"zone": "az1"
|
||||||
},
|
},
|
||||||
"NodeType": "redundancy-zone-voter"
|
"NodeType": "redundancy-zone-voter"
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -389,19 +386,13 @@ $ curl \
|
||||||
- `Healthy` is whether the server is healthy according to the current Autopilot configuration.
|
- `Healthy` is whether the server is healthy according to the current Autopilot configuration.
|
||||||
|
|
||||||
- `StableSince` is the time this server has been in its current `Healthy` state.
|
- `StableSince` is the time this server has been in its current `Healthy` state.
|
||||||
|
|
||||||
- `RedundancyZone` <EnterpriseAlert inline /> is the name of the redundancy zone this server is within.
|
- `RedundancyZone` <EnterpriseAlert inline /> is the name of the redundancy zone this server is within.
|
||||||
|
|
||||||
- `UpgradeVersion` <EnterpriseAlert inline /> is the version that will be used for automated upgrade calculations.
|
- `UpgradeVersion` <EnterpriseAlert inline /> is the version that will be used for automated upgrade calculations.
|
||||||
|
|
||||||
- `ReadReplica` <EnterpriseAlert inline /> indicates whether this server is a read replica or not.
|
- `ReadReplica` <EnterpriseAlert inline /> indicates whether this server is a read replica or not.
|
||||||
|
- `Status` indicates the current Raft status of this server. Possible values are:
|
||||||
- `Status` indicates the current Raft status of this server. Possible values are:
|
`leader`, `voter`, `non-voter`, or `staging`.
|
||||||
`leader`, `voter`, `non-voter`, or `staging`.
|
|
||||||
|
|
||||||
- `Meta` is the node metadata of this server. Values within this map are used for determining a server's
|
- `Meta` is the node metadata of this server. Values within this map are used for determining a server's
|
||||||
redundancy zone and upgrade version.
|
redundancy zone and upgrade version.
|
||||||
|
|
||||||
- `NodeType` is the desired type autopilot thinks this server should have. In Consul OSS the only possible
|
- `NodeType` is the desired type autopilot thinks this server should have. In Consul OSS the only possible
|
||||||
value is `voter` as all present servers should having voting rights. In Consul Enterprise the possible values also
|
value is `voter` as all present servers should having voting rights. In Consul Enterprise the possible values also
|
||||||
include `read-replica`, `zone-voter`, `zone-standby` and `zone-extra-voter`. `zone-voter` indicates that autopilot
|
include `read-replica`, `zone-voter`, `zone-standby` and `zone-extra-voter`. `zone-voter` indicates that autopilot
|
||||||
|
@ -416,13 +407,11 @@ $ curl \
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
"Servers": [
|
"Servers": [
|
||||||
"10b71f14-4b08-4ae5-840c-f86d39e7d330",
|
"10b71f14-4b08-4ae5-840c-f86d39e7d330",
|
||||||
"b007061c-6d15-4c90-b3d6-2fef276a0650"
|
"b007061c-6d15-4c90-b3d6-2fef276a0650"
|
||||||
],
|
],
|
||||||
"Voters": [
|
"Voters": ["b007061c-6d15-4c90-b3d6-2fef276a0650"],
|
||||||
"b007061c-6d15-4c90-b3d6-2fef276a0650"
|
"FailureTolerance": 1
|
||||||
],
|
|
||||||
"FailureTolerance": 1,
|
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -430,43 +419,36 @@ Each zone in the responses `RedundancyZones` mapping will have this structure.
|
||||||
|
|
||||||
- `Servers` is a list of server IDs of all the servers in this zone. These values can be used as indexes
|
- `Servers` is a list of server IDs of all the servers in this zone. These values can be used as indexes
|
||||||
into the top level response's `Servers` mapping.
|
into the top level response's `Servers` mapping.
|
||||||
|
|
||||||
- `Voters` is a list of server IDs of all servers in this zone that have voting rights. Typically this will
|
- `Voters` is a list of server IDs of all servers in this zone that have voting rights. Typically this will
|
||||||
be a list with 1 value but in some failure scenarios or upgrade scenarios the size could increase. These
|
be a list with 1 value but in some failure scenarios or upgrade scenarios the size could increase. These
|
||||||
values can be used as indexes into the top level response's `Servers` mapping.
|
values can be used as indexes into the top level response's `Servers` mapping.
|
||||||
|
|
||||||
- `FailureTolerance` is the number of servers in this zone that could fail without causing a total zone failure
|
- `FailureTolerance` is the number of servers in this zone that could fail without causing a total zone failure
|
||||||
and subsequent promotion of a server from another zone as a fallback.
|
and subsequent promotion of a server from another zone as a fallback.
|
||||||
|
|
||||||
### Upgrade Information Response Format <Enterprise Alert inline />
|
### Upgrade Information Response Format <Enterprise Alert inline />
|
||||||
|
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
"Status": "awaiting-new-servers",
|
"Status": "awaiting-new-servers",
|
||||||
"TargetVersion": "1.9.1+ent",
|
"TargetVersion": "1.9.1+ent",
|
||||||
"TargetVersionVoters": [
|
"TargetVersionVoters": ["f0344689-3e1f-4125-b55d-e888d3abf514"],
|
||||||
"f0344689-3e1f-4125-b55d-e888d3abf514"
|
"TargetVersionNonVoters": [
|
||||||
],
|
"619a4ba6-1a0b-476e-8a1a-28aeee7735a2",
|
||||||
"TargetVersionNonVoters": [
|
"fd683fe6-541f-4ebf-bc5a-6eae51571ddb"
|
||||||
"619a4ba6-1a0b-476e-8a1a-28aeee7735a2",
|
],
|
||||||
"fd683fe6-541f-4ebf-bc5a-6eae51571ddb"
|
"TargetVersionReadReplicas": ["9f1e27ae-1129-45ef-97dd-6d8c3ec47e6a"],
|
||||||
],
|
"OtherVersionVoters": [
|
||||||
"TargetVersionReadReplicas": [
|
"0cbdd493-235f-48f2-98d9-1bf2443b9d72",
|
||||||
"9f1e27ae-1129-45ef-97dd-6d8c3ec47e6a"
|
"21812bd7-2f21-4565-9892-2fdd3d4e1a99",
|
||||||
],
|
"c654ba5c-cc76-4056-a5ca-6e78d95f27ad"
|
||||||
"OtherVersionVoters": [
|
],
|
||||||
"0cbdd493-235f-48f2-98d9-1bf2443b9d72",
|
"OtherVersionNonVoters": [
|
||||||
"21812bd7-2f21-4565-9892-2fdd3d4e1a99",
|
"6d973f11-6bdb-4f7d-8a90-c1300066da4c",
|
||||||
"c654ba5c-cc76-4056-a5ca-6e78d95f27ad"
|
"6241ab45-371e-4b2a-a0f1-d847c3b7b1b0"
|
||||||
],
|
],
|
||||||
"OtherVersionNonVoters": [
|
"OtherVersionReadReplicas": ["42d10fc3-581b-4403-832d-945b3a0d8841"]
|
||||||
"6d973f11-6bdb-4f7d-8a90-c1300066da4c",
|
}
|
||||||
"6241ab45-371e-4b2a-a0f1-d847c3b7b1b0"
|
|
||||||
],
|
|
||||||
"OtherVersionReadReplicas": [
|
|
||||||
"42d10fc3-581b-4403-832d-945b3a0d8841"
|
|
||||||
],
|
|
||||||
}
|
|
||||||
```
|
```
|
||||||
|
|
||||||
- `Status` is the automated upgrade status. Possible values are:
|
- `Status` is the automated upgrade status. Possible values are:
|
||||||
|
@ -477,23 +459,18 @@ Each zone in the responses `RedundancyZones` mapping will have this structure.
|
||||||
|
|
||||||
- `await-new-voters` indicates that a newer versioned server has been added but that autopilot is waiting for more servers
|
- `await-new-voters` indicates that a newer versioned server has been added but that autopilot is waiting for more servers
|
||||||
of that version to be added before proceeding with the upgrade.
|
of that version to be added before proceeding with the upgrade.
|
||||||
|
|
||||||
- `promoting` indicates that enough servers of the target version have been added and autopilot will now promote them
|
- `promoting` indicates that enough servers of the target version have been added and autopilot will now promote them
|
||||||
to voters.
|
to voters.
|
||||||
|
|
||||||
- `demoting` indicates that autopilot is currently demoting the servers not running the target version.
|
- `demoting` indicates that autopilot is currently demoting the servers not running the target version.
|
||||||
|
|
||||||
- `leader-transfer` indicates that autopilot is in the process of transferring leadership to a server running
|
- `leader-transfer` indicates that autopilot is in the process of transferring leadership to a server running
|
||||||
the target version.
|
the target version.
|
||||||
|
|
||||||
- `await-new-servers` indicates that the majority of the upgrade is complete but that more servers running the target
|
- `await-new-servers` indicates that the majority of the upgrade is complete but that more servers running the target
|
||||||
version need to be added to completely replace all of the previous servers.
|
version need to be added to completely replace all of the previous servers.
|
||||||
|
|
||||||
- `await-server-removal` indicates that the upgrade is complete and it is now safe to remove the previous servers.
|
- `await-server-removal` indicates that the upgrade is complete and it is now safe to remove the previous servers.
|
||||||
|
|
||||||
- `TargetVersion` is the version that Autopilot is upgrading to. This will be the maximum version of all servers
|
- `TargetVersion` is the version that Autopilot is upgrading to. This will be the maximum version of all servers
|
||||||
`UpgradeVersion` field in the top level `Servers` mapping.
|
`UpgradeVersion` field in the top level `Servers` mapping.
|
||||||
|
|
||||||
- `TargetVersionVoters` is a list of IDs of servers running the target version and that currently have voting rights.
|
- `TargetVersionVoters` is a list of IDs of servers running the target version and that currently have voting rights.
|
||||||
|
|
||||||
- `TargetVersionNonVoters` is a list of IDs of servers running the target version and that currently do not have voting rights.
|
- `TargetVersionNonVoters` is a list of IDs of servers running the target version and that currently do not have voting rights.
|
||||||
|
@ -504,4 +481,4 @@ Each zone in the responses `RedundancyZones` mapping will have this structure.
|
||||||
|
|
||||||
- `OtherVersionNonVoters` is a list of IDs of servers not running the target version and that currently do not have voting rights.
|
- `OtherVersionNonVoters` is a list of IDs of servers not running the target version and that currently do not have voting rights.
|
||||||
|
|
||||||
- `OtherVersionReadReplicas` is a list of IDs of servers not running the target version and are read replicas.
|
- `OtherVersionReadReplicas` is a list of IDs of servers not running the target version and are read replicas.
|
|
@ -67,7 +67,7 @@ $ curl \
|
||||||
"WbL6oaTPom+7RG7Q/INbJWKy09OLar/Hf2SuOAdoQE4=": 1
|
"WbL6oaTPom+7RG7Q/INbJWKy09OLar/Hf2SuOAdoQE4=": 1
|
||||||
},
|
},
|
||||||
"PrimaryKeys": {
|
"PrimaryKeys": {
|
||||||
"pUqJrVyVRj5jsiYEkM/tFQYfWyJIv4s3XkvDwy7Cu5s=": 1,
|
"pUqJrVyVRj5jsiYEkM/tFQYfWyJIv4s3XkvDwy7Cu5s=": 1
|
||||||
},
|
},
|
||||||
"NumNodes": 3
|
"NumNodes": 3
|
||||||
},
|
},
|
||||||
|
@ -81,7 +81,7 @@ $ curl \
|
||||||
"WbL6oaTPom+7RG7Q/INbJWKy09OLar/Hf2SuOAdoQE4=": 1
|
"WbL6oaTPom+7RG7Q/INbJWKy09OLar/Hf2SuOAdoQE4=": 1
|
||||||
},
|
},
|
||||||
"PrimaryKeys": {
|
"PrimaryKeys": {
|
||||||
"pUqJrVyVRj5jsiYEkM/tFQYfWyJIv4s3XkvDwy7Cu5s=": 1,
|
"pUqJrVyVRj5jsiYEkM/tFQYfWyJIv4s3XkvDwy7Cu5s=": 1
|
||||||
},
|
},
|
||||||
"NumNodes": 3
|
"NumNodes": 3
|
||||||
}
|
}
|
|
@ -2,8 +2,7 @@
|
||||||
layout: commands
|
layout: commands
|
||||||
page_title: 'Commands: Connect Proxy'
|
page_title: 'Commands: Connect Proxy'
|
||||||
sidebar_title: envoy
|
sidebar_title: envoy
|
||||||
description:
|
description: The connect proxy subcommand is used to run the Envoy proxy for Connect.
|
||||||
The connect proxy subcommand is used to run the Envoy proxy for Connect.
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Consul Connect Envoy
|
# Consul Connect Envoy
|
||||||
|
@ -78,10 +77,10 @@ proxy configuration needed.
|
||||||
`1.16.0`. This is required so that the correct configuration can be generated.
|
`1.16.0`. This is required so that the correct configuration can be generated.
|
||||||
|
|
||||||
- `-no-central-config` - By default the proxy's bootstrap configuration can be
|
- `-no-central-config` - By default the proxy's bootstrap configuration can be
|
||||||
customized centrally. This requires that the command run on the same agent
|
customized centrally. This requires that the command run on the same agent
|
||||||
as the proxy will and that the agent is reachable when the command is run.
|
as the proxy will and that the agent is reachable when the command is run.
|
||||||
In cases where either assumption is violated this flag will prevent the
|
In cases where either assumption is violated this flag will prevent the
|
||||||
command attempting to resolve config from the local agent.
|
command attempting to resolve config from the local agent.
|
||||||
|
|
||||||
- `-- [pass-through options]` - Any options given after a double dash are passed
|
- `-- [pass-through options]` - Any options given after a double dash are passed
|
||||||
directly through to the `envoy` invocation. See [Envoy's
|
directly through to the `envoy` invocation. See [Envoy's
|
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue