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.

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

Update Getting Started guide #2721

Merged
merged 1 commit into from
Jul 25, 2024

Conversation

scottslowe
Copy link
Contributor

Description

This PR updates the Getting Started guide for consistency throughout all sections.

Here is the full changeset:

execution.md:
Remove language specifier for fenced codeblock.

file-events.md:
Add instructions for single-node and multi-node K8s clusters. Clean up Docker instructions.
Ensure consistent header levels.
Minor fixes in spelling and grammar.

network.md:
Add EKS, AKS instructions for getting service CIDR. Add instructions for single-node and multi-node K8s clusters. Ensure consistent header levels.
Minor fixes in spelling and grammar.

enforcement.md:
Reorganize content to improve flow.
Add EKS, AKS instructions for getting service CIDR. Add instructions for single-node and multi-node K8s clusters. Ensure consistent header levels.
Minor fixes in spelling and grammar.

No release notes/changelog entries necessary.

@scottslowe scottslowe requested review from mtardy and a team as code owners July 23, 2024 21:07
Copy link

netlify bot commented Jul 23, 2024

Deploy Preview for tetragon ready!

Name Link
🔨 Latest commit 08ed75e
🔍 Latest deploy log https://app.netlify.com/sites/tetragon/deploys/66a1122de297d90008533082
😎 Deploy Preview https://deploy-preview-2721--tetragon.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

Copy link
Member

@mtardy mtardy left a comment

Choose a reason for hiding this comment

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

Thanks, that's an amazing change! This time you could have separated the patches by commits but it's completely fine like that.

There's one thing I don't get:

Remove language specifier for fenced codeblock.

In many places you removed the shell specifier, it's only supposed to be removed when you put output of commands, the commands themselves need this to appear correctly. I'm not sure why you removed them in some places, I didn't node all of them.

Once we have some things fixed I'll be happy to merge this :) thanks again!

docs/content/en/docs/getting-started/enforcement.md Outdated Show resolved Hide resolved
docs/content/en/docs/getting-started/enforcement.md Outdated Show resolved Hide resolved
docs/content/en/docs/getting-started/enforcement.md Outdated Show resolved Hide resolved
docs/content/en/docs/getting-started/enforcement.md Outdated Show resolved Hide resolved
--pid=host --cgroupns=host --privileged \
-v ${PWD}/file_monitoring_enforce.yaml:/etc/tetragon/tetragon.tp.d/file_monitoring_enforce.yaml \
-v /sys/kernel/btf/vmlinux:/var/lib/tetragon/btf \
quay.io/cilium/tetragon-ci:latest
quay.io/cilium/tetragon:latest
Copy link
Member

Choose a reason for hiding this comment

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

you could make use of {{< latest-version >}} if you want here that will inject the latest released version of Tetragon

Suggested change
quay.io/cilium/tetragon:latest
quay.io/cilium/tetragon:{{< latest-version >}}

@@ -24,7 +24,7 @@ in your environment.
For a single node Kubernetes cluster, you can target the Tetragon DaemonSet with
a `kubectl exec` command:

```shell
```
Copy link
Member

Choose a reason for hiding this comment

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

again here

-v /sys/kernel/btf/vmlinux:/var/lib/tetragon/btf \
quay.io/cilium/tetragon-ci:latest
-v /sys/kernel/btf/vmlinux:/var/lib/tetragon/btf \
quay.io/cilium/tetragon:latest
Copy link
Member

Choose a reason for hiding this comment

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

same

Suggested change
quay.io/cilium/tetragon:latest
quay.io/cilium/tetragon:{{< latest-version >}}

monitoring network access. In this section, you will see how to monitor network
traffic to "external" destinations (destinations that are outside the
Kubernetes cluster or external to the Docker host where Tetragon is running).
These instructions assume you already have Tetragon running in either Kubernetes or Docker, and that you have deployed the Cilium demo application.
Copy link
Member

Choose a reason for hiding this comment

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

that's a nit but if you can wrap here


```shell
```
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
```
```shell

@mtardy mtardy added area/documentation Improvements or additions to documentation release-note/docs This PR updates the documentation. labels Jul 24, 2024
@scottslowe
Copy link
Contributor Author

scottslowe commented Jul 24, 2024

@mtardy I think I've incorporated all your requested changes. I did not switch to using {{< latest-version >}}; if you feel strongly that we need to make that change, let me know. Otherwise, I believe all changes EXCEPT reworking the Docker/K8s networking section have been addressed (see comment above regarding that work). Oh, and sorry about the language specifier! I thought it was weird that you wanted it removed; I didn't pick up that it only needed to be removed for output. 🤦🏻‍♂️

Copy link
Member

@mtardy mtardy left a comment

Choose a reason for hiding this comment

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

Thanks a lot that's great! Could you squash your commits https://tetragon.io/docs/contribution-guide/submitting-a-pull-request/#commit-changes ? With merge rebase so we squash commits related to feedback.

This commit brings greater consistency to the Getting Started
guide.

execution.md:
Remove language specifier for codeblocks showing output.

file-events.md:
Add instructions for single-node and multi-node K8s clusters.
Clean up Docker instructions.
Ensure consistent header levels.
Minor fixes in spelling and grammar.
Remove language specifier for codeblocks showing output.

network.md:
Add EKS, AKS instructions for getting service CIDR.
Add instructions for single-node and multi-node K8s clusters.
Ensure consistent header levels.
Minor fixes in spelling and grammar.
Remove language specifier for codeblocks showing output.

enforcement.md:
Reorganize content to improve flow.
Add EKS, AKS instructions for getting service CIDR.
Add instructions for single-node and multi-node K8s clusters.
Ensure consistent header levels.
Minor fixes in spelling and grammar.
Remove language specifier for codeblocks showing output.

Signed-off-by: Scott Lowe <[email protected]>
@scottslowe scottslowe force-pushed the pr/scottslowe/docs-gsg-updates branch from 08ed75e to 16f29a6 Compare July 24, 2024 15:00
Copy link
Member

@mtardy mtardy left a comment

Choose a reason for hiding this comment

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

Many thanks!

@mtardy mtardy merged commit 9c0722e into cilium:main Jul 25, 2024
41 checks passed
@scottslowe scottslowe deleted the pr/scottslowe/docs-gsg-updates branch July 29, 2024 11:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/documentation Improvements or additions to documentation release-note/docs This PR updates the documentation.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants