Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Docs/intentions refactor docs day 2022 #16758

Merged
merged 26 commits into from
Mar 24, 2023
Merged

Docs/intentions refactor docs day 2022 #16758

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
945c132
converted intentions conf entry to ref CT format
trujillo-adam Mar 23, 2023
4034c6f
set up intentions nav
trujillo-adam Mar 23, 2023
8c06a18
add page for intentions usage
trujillo-adam Mar 23, 2023
35757aa
final intentions usage page
trujillo-adam Mar 23, 2023
1204b41
final intentions overview page
trujillo-adam Mar 23, 2023
eb19246
Merge branch 'main' into docs/intentions-refactor-docs-day-2022
trujillo-adam Mar 23, 2023
7339de8
fixed old relative links
trujillo-adam Mar 23, 2023
8c5bd0c
Merge branch 'docs/intentions-refactor-docs-day-2022' of github.com:h…
trujillo-adam Mar 23, 2023
9b6b69f
updated diagram for overview
trujillo-adam Mar 23, 2023
7e612a5
updated links to intentions content
trujillo-adam Mar 23, 2023
22a9066
fixed typo in updated links
trujillo-adam Mar 24, 2023
ad6e940
rename intentions overview page file to index
trujillo-adam Mar 24, 2023
b345201
rollback link updates to intentions overview
trujillo-adam Mar 24, 2023
8cd42d6
fixed nav
trujillo-adam Mar 24, 2023
0a45d1e
Updated custom HTML in API and CLI pages to MD
trujillo-adam Mar 24, 2023
9c1a513
applied suggestions from review to index page
trujillo-adam Mar 24, 2023
0b9bfea
moved conf examples from usage to conf ref
trujillo-adam Mar 24, 2023
aaef49e
missed custom HTML section
trujillo-adam Mar 24, 2023
c8e8894
applied additional feedback
trujillo-adam Mar 24, 2023
4c40599
Apply suggestions from code review
trujillo-adam Mar 24, 2023
a5ff062
updated headings in usage page
trujillo-adam Mar 24, 2023
0be6ddf
renamed files and udpated nav
trujillo-adam Mar 24, 2023
8b64fea
updated links to new file names
trujillo-adam Mar 24, 2023
7acd715
added redirects and final tweaks
trujillo-adam Mar 24, 2023
2bb6e9b
typo
trujillo-adam Mar 24, 2023
64f21a8
Merge branch 'main' into docs/intentions-refactor-docs-day-2022
trujillo-adam Mar 24, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Updated custom HTML in API and CLI pages to MD
  • Loading branch information
@trujillo-adam
trujillo-adam committed Mar 24, 2023
commit 0a45d1e2c930d7ae1a3f2696b5625bd3342e4112
110 changes: 10 additions & 100 deletions website/content/api-docs/connect/intentions.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -43,16 +43,7 @@ The table below shows this endpoint's support for

| Blocking Queries | Consistency Modes | Agent Caching | ACL Required |
| ---------------- | ----------------- | ------------- | ------------------------------ |
| `NO` | `none` | `none` | `intentions:write`<sup>1</sup> |

<p>
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
<code>service</code> rule. See{' '}
<a href="/consul/docs/connect/intentions/intentions-usage#acl-requirements">
ACL requirements for intentions
</a>{' '}
for more details.
</p>
| `NO` | `none` | `none` | `intentions:write` <p> Define intention rules in the `service` policy. Refer to [ACL requirements for intentions](/consul/docs/connect/intentions/intentions-usage#acl-requirements) for additional information.</p> |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is there a reason why we need to add <p> here?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It adds a little padding and looks nicer than a br tag, IMO.


The corresponding CLI command is [`consul intention create -replace`](/consul/commands/intention/create#replace).

Expand Down Expand Up @@ -149,16 +140,7 @@ The table below shows this endpoint's support for

| Blocking Queries | Consistency Modes | Agent Caching | ACL Required |
| ---------------- | ----------------- | ------------- | ------------------------------ |
| `NO` | `none` | `none` | `intentions:write`<sup>1</sup> |

<p>
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
<code>service</code> rule. See{' '}
<a href="/consul/docs/connect/intentions/intentions-usage#acl-requirements">
ACL requirements for intentions
</a>{' '}
for more details.
</p>
| `NO` | `none` | `none` | `intentions:write` <p> Define intention rules in the `service` policy. Refer to [ACL requirements for intentions](/consul/docs/connect/intentions/intentions-usage#acl-requirements) for additional information.</p> |

The corresponding CLI command is [`consul intention create`](/consul/commands/intention/create).

Expand Down Expand Up @@ -246,16 +228,7 @@ The table below shows this endpoint's support for

| Blocking Queries | Consistency Modes | Agent Caching | ACL Required |
| ---------------- | ----------------- | ------------- | ------------------------------ |
| `NO` | `none` | `none` | `intentions:write`<sup>1</sup> |

<p>
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
<code>service</code> rule. See{' '}
<a href="/consul/docs/connect/intentions/intentions-usage#acl-requirements">
ACL requirements for intentions
</a>{' '}
for more details.
</p>
| `NO` | `none` | `none` | `intentions:write`<p> Define intention rules in the `service` policy. Refer to [ACL requirements for intentions](/consul/docs/connect/intentions/intentions-usage#acl-requirements) for additional information.</p> |

This endpoint supports the same parameters as the [create an intention](#create-intention-with-id) endpoint.
Additional parameters unique to this endpoint include:
Expand Down Expand Up @@ -300,16 +273,7 @@ The table below shows this endpoint's support for

| Blocking Queries | Consistency Modes | Agent Caching | ACL Required |
| ---------------- | ----------------- | ------------- | ----------------------------- |
| `YES` | `all` | `none` | `intentions:read`<sup>1</sup> |

<p>
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
<code>service</code> rule. See{' '}
<a href="/consul/docs/connect/intentions/intentions-usage#acl-requirements">
ACL requirements for intentions
</a>{' '}
for more details.
</p>
| `YES` | `all` | `none` | `intentions:read`<p> Define intention rules in the `service` policy. Refer to [ACL requirements for intentions](/consul/docs/connect/intentions/intentions-usage#acl-requirements) for additional information.</p> |

The corresponding CLI command is [`consul intention get`](/consul/commands/intention/get).

Expand Down Expand Up @@ -372,16 +336,7 @@ The table below shows this endpoint's support for

| Blocking Queries | Consistency Modes | Agent Caching | ACL Required |
| ---------------- | ----------------- | ------------- | ----------------------------- |
| `YES` | `all` | `none` | `intentions:read`<sup>1</sup> |

<p>
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
<code>service</code> rule. See{' '}
<a href="/consul/docs/connect/intentions/intentions-usage#acl-requirements">
ACL requirements for intentions
</a>{' '}
for more details.
</p>
| `YES` | `all` | `none` | `intentions:read`<p> Define intention rules in the `service` policy. Refer to [ACL requirements for intentions](/consul/docs/connect/intentions/intentions-usage#acl-requirements) for additional information.</p> |

The corresponding CLI command is [`consul intention get`](/consul/commands/intention/get).

Expand Down Expand Up @@ -435,16 +390,7 @@ The table below shows this endpoint's support for

| Blocking Queries | Consistency Modes | Agent Caching | ACL Required |
| ---------------- | ----------------- | ------------- | ----------------------------- |
| `YES` | `all` | `none` | `intentions:read`<sup>1</sup> |

<p>
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
<code>service</code> rule. See{' '}
<a href="/consul/docs/connect/intentions/intentions-usage#acl-requirements">
ACL requirements for intentions
</a>{' '}
for more details.
</p>
| `YES` | `all` | `none` | `intentions:read`<p> Define intention rules in the `service` policy. Refer to [ACL requirements for intentions](/consul/docs/connect/intentions/intentions-usage#acl-requirements) for additional information.</p> |

The corresponding CLI command is [`consul intention list`](/consul/commands/intention/list).

Expand Down Expand Up @@ -522,16 +468,7 @@ The table below shows this endpoint's support for

| Blocking Queries | Consistency Modes | Agent Caching | ACL Required |
| ---------------- | ----------------- | ------------- | ------------------------------ |
| `NO` | `none` | `none` | `intentions:write`<sup>1</sup> |

<p>
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
<code>service</code> rule. See{' '}
<a href="/consul/docs/connect/intentions/intentions-usage#acl-requirements">
ACL requirements for intentions
</a>{' '}
for more details.
</p>
| `NO` | `none` | `none` | `intentions:write`<p> Define intention rules in the `service` policy. Refer to [ACL requirements for intentions](/consul/docs/connect/intentions/intentions-usage#acl-requirements) for additional information.</p> |

The corresponding CLI command is [`consul intention delete`](/consul/commands/intention/delete).

Expand Down Expand Up @@ -577,16 +514,7 @@ The table below shows this endpoint's support for

| Blocking Queries | Consistency Modes | Agent Caching | ACL Required |
| ---------------- | ----------------- | ------------- | ------------------------------ |
| `NO` | `none` | `none` | `intentions:write`<sup>1</sup> |

<p>
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
<code>service</code> rule. See{' '}
<a href="/consul/docs/connect/intentions/intentions-usage#acl-requirements">
ACL requirements for intentions
</a>{' '}
for more details.
</p>
| `NO` | `none` | `none` | `intentions:write`<p> Define intention rules in the `service` policy. Refer to [ACL requirements for intentions](/consul/docs/connect/intentions/intentions-usage#acl-requirements) for additional information.</p> |

The corresponding CLI command is [`consul intention delete`](/consul/commands/intention/delete).

Expand Down Expand Up @@ -633,16 +561,7 @@ The table below shows this endpoint's support for

| Blocking Queries | Consistency Modes | Agent Caching | ACL Required |
| ---------------- | ----------------- | ------------- | ----------------------------- |
| `NO` | `none` | `none` | `intentions:read`<sup>1</sup> |

<p>
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
<code>service</code> rule. See{' '}
<a href="/consul/docs/connect/intentions/intentions-usage#acl-requirements">
ACL requirements for intentions
</a>{' '}
for more details.
</p>
| `NO` | `none` | `none` | `intentions:read`<p> Define intention rules in the `service` policy. Refer to [ACL requirements for intentions](/consul/docs/connect/intentions/intentions-usage#acl-requirements) for additional information.</p> |

The corresponding CLI command is [`consul intention check`](/consul/commands/intention/check).

Expand Down Expand Up @@ -693,16 +612,7 @@ The table below shows this endpoint's support for

| Blocking Queries | Consistency Modes | Agent Caching | ACL Required |
| ---------------- | ----------------- | -------------------- | ----------------------------- |
| `YES` | `all` | `background refresh` | `intentions:read`<sup>1</sup> |

<p>
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
<code>service</code> rule. See{' '}
<a href="/consul/docs/connect/intentions/intentions-usage#acl-requirements">
ACL requirements for intentions
</a>{' '}
for more details.
</p>
| `YES` | `all` | `background refresh` | `intentions:read`<p> Define intention rules in the `service` policy. Refer to [ACL requirements for intentions](/consul/docs/connect/intentions/intentions-usage#acl-requirements) for additional information.</p> |

The corresponding CLI command is [`consul intention match`](/consul/commands/intention/match).

Expand Down
11 changes: 1 addition & 10 deletions website/content/commands/intention/check.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,16 +31,7 @@ are not supported from commands, but may be from the corresponding HTTP endpoint

| ACL Required |
| ----------------------------- |
| `intentions:read`<sup>1</sup> |

<p>
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
<code>service</code> rule. See{' '}
<a href="/consul/docs/connect/intentions/intentions-usage#acl-requirements">
ACL requirements for intentions
</a>{' '}
for more details.
</p>
| `intentions:read`<p> Define intention rules in the `service` policy. Refer to [ACL requirements for intentions](/consul/docs/connect/intentions/intentions-usage#acl-requirements) for additional information.</p> |

## Usage

Expand Down
11 changes: 1 addition & 10 deletions website/content/commands/intention/create.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,16 +25,7 @@ are not supported from commands, but may be from the corresponding HTTP endpoint

| ACL Required |
| ------------------------------ |
| `intentions:write`<sup>1</sup> |

<p>
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
<code>service</code> rule. See{' '}
<a href="/consul/docs/connect/intentions/intentions-usage#acl-requirements">
ACL requirements for intentions
</a>{' '}
for more details.
</p>
| `intentions:write`<p> Define intention rules in the `service` policy. Refer to [ACL requirements for intentions](/consul/docs/connect/intentions/intentions-usage#acl-requirements) for additional information.</p> |

## Usage

Expand Down
11 changes: 1 addition & 10 deletions website/content/commands/intention/delete.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,16 +19,7 @@ are not supported from commands, but may be from the corresponding HTTP endpoint

| ACL Required |
| ------------------------------ |
| `intentions:write`<sup>1</sup> |

<p>
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
<code>service</code> rule. See{' '}
<a href="/consul/docs/connect/intentions/intentions-usage#acl-requirements">
ACL requirements for intentions
</a>{' '}
for more details.
</p>
| `intentions:write`<p> Define intention rules in the `service` policy. Refer to [ACL requirements for intentions](/consul/docs/connect/intentions/intentions-usage#acl-requirements) for additional information.</p> |

-> **Deprecated** - The one argument form of this command is deprecated in
Consul 1.9.0. Intentions no longer need IDs when represented as
Expand Down
11 changes: 1 addition & 10 deletions website/content/commands/intention/get.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,16 +24,7 @@ are not supported from commands, but may be from the corresponding HTTP endpoint

| ACL Required |
| ----------------------------- |
| `intentions:read`<sup>1</sup> |

<p>
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
<code>service</code> rule. See{' '}
<a href="/consul/docs/connect/intentions/intentions-usage#acl-requirements">
ACL requirements for intentions
</a>{' '}
for more details.
</p>
| `intentions:read`<p> Define intention rules in the `service` policy. Refer to [ACL requirements for intentions](/consul/docs/connect/intentions/intentions-usage#acl-requirements) for additional information.</p> |

## Usage

Expand Down
11 changes: 1 addition & 10 deletions website/content/commands/intention/list.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,16 +19,7 @@ are not supported from commands, but may be from the corresponding HTTP endpoint

| ACL Required |
| ----------------------------- |
| `intentions:read`<sup>1</sup> |

<p>
<sup>1</sup> Intention ACL rules are specified as part of a{' '}
<code>service</code> rule. See{' '}
<a href="/consul/docs/connect/intentions/intentions-usage#acl-requirements">
ACL requirements for intentions
</a>{' '}
for more details.
</p>
| `intentions:read` <p> Define intention rules in the `service` policy. Refer to [ACL requirements for intentions](/consul/docs/connect/intentions/intentions-usage#acl-requirements) for additional information.</p> |

## Usage

Expand Down