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

Attempt at modernizing the sidecar SPIRE integration doc #15574

Merged

Conversation

bleggett
Copy link
Contributor

@bleggett bleggett commented Aug 20, 2024

Description

  1. SPIRE has Helm charts, we should refer to those and not have our own in-tree SPIRE installation YAML (with WAY out of date SPIRE image refs and config)

  2. In general, refer back to the SPIRE docs and don't make this a SPIRE tutorial - focus on the Istio-specific bits.

  3. Align with current best practices (use upstream Helm charts, recommend controller manager, CSI driver only, etc)

  4. Misc tweaks.

Fixes: #15510

Will open an istio-side PR to delete this once this is in.

Reviewers

  • Ambient
  • Docs
  • Installation
  • Networking
  • Performance and Scalability
  • Extensions and Telemetry
  • Security
  • Test and Release
  • User Experience
  • Developer Infrastructure
  • Localization/Translation

Signed-off-by: Benjamin Leggett <[email protected]>
@bleggett bleggett requested a review from a team as a code owner August 20, 2024 00:06
@istio-testing istio-testing added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Aug 20, 2024
@craigbox
Copy link
Contributor

Committed a couple of fixes to make the site build so I can look at the preview, which is https://deploy-preview-15574--preliminary-istio.netlify.app/latest/docs/ops/integrations/spire/.

content/en/docs/ops/integrations/spire/index.md Outdated Show resolved Hide resolved
content/en/docs/ops/integrations/spire/index.md Outdated Show resolved Hide resolved
content/en/docs/ops/integrations/spire/index.md Outdated Show resolved Hide resolved
content/en/docs/ops/integrations/spire/index.md Outdated Show resolved Hide resolved
content/en/docs/ops/integrations/spire/index.md Outdated Show resolved Hide resolved
content/en/docs/ops/integrations/spire/index.md Outdated Show resolved Hide resolved
content/en/docs/ops/integrations/spire/index.md Outdated Show resolved Hide resolved
content/en/docs/ops/integrations/spire/index.md Outdated Show resolved Hide resolved
@bleggett
Copy link
Contributor Author

Committed a couple of fixes to make the site build so I can look at the preview, which is https://deploy-preview-15574--preliminary-istio.netlify.app/latest/docs/ops/integrations/spire/.

Yep thanks, and sorry - should have marked this as WIP.

Copy link
Member

@dhawton dhawton left a comment

Choose a reason for hiding this comment

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

Few more nits

content/en/docs/ops/integrations/spire/index.md Outdated Show resolved Hide resolved
content/en/docs/ops/integrations/spire/index.md Outdated Show resolved Hide resolved
content/en/docs/ops/integrations/spire/index.md Outdated Show resolved Hide resolved
content/en/docs/ops/integrations/spire/index.md Outdated Show resolved Hide resolved
content/en/docs/ops/integrations/spire/index.md Outdated Show resolved Hide resolved
content/en/docs/ops/integrations/spire/index.md Outdated Show resolved Hide resolved
content/en/docs/ops/integrations/spire/index.md Outdated Show resolved Hide resolved
content/en/docs/ops/integrations/spire/index.md Outdated Show resolved Hide resolved
content/en/docs/ops/integrations/spire/index.md Outdated Show resolved Hide resolved
Signed-off-by: Benjamin Leggett <[email protected]>
Signed-off-by: Benjamin Leggett <[email protected]>
@istio-testing istio-testing added size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. and removed size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Aug 20, 2024
@bleggett bleggett requested review from craigbox and dhawton August 20, 2024 17:55
Signed-off-by: Benjamin Leggett <[email protected]>
Signed-off-by: Benjamin Leggett <[email protected]>
Signed-off-by: Benjamin Leggett <[email protected]>
Signed-off-by: Benjamin Leggett <[email protected]>
Signed-off-by: Benjamin Leggett <[email protected]>
Signed-off-by: Benjamin Leggett <[email protected]>
@bleggett bleggett requested review from a team as code owners August 20, 2024 21:23
Signed-off-by: Benjamin Leggett <[email protected]>
Signed-off-by: Benjamin Leggett <[email protected]>
Signed-off-by: Benjamin Leggett <[email protected]>
@craigbox
Copy link
Contributor

/test doc.test.profile-none

@craigbox
Copy link
Contributor

While we're doing nits, would you mind s/Federation/federation/ in the heading on L371?

Signed-off-by: Benjamin Leggett <[email protected]>
Signed-off-by: Benjamin Leggett <[email protected]>
@bleggett bleggett requested a review from craigbox August 21, 2024 17:51
@bleggett
Copy link
Contributor Author

@craigbox should be good, PTAL.

Copy link
Contributor

@craigbox craigbox left a comment

Choose a reason for hiding this comment

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

YOLO

@craigbox
Copy link
Contributor

/cherry-pick release-1.23

@istio-testing
Copy link
Contributor

@craigbox: once the present PR merges, I will cherry-pick it on top of release-1.23 in a new PR and assign it to you.

In response to this:

/cherry-pick release-1.23

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

@craigbox
Copy link
Contributor

test flake: #15603

/retest

@istio-testing istio-testing merged commit e3638ee into istio:master Aug 23, 2024
13 checks passed
@istio-testing
Copy link
Contributor

@craigbox: new pull request created: #15604

In response to this:

/cherry-pick release-1.23

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

wilsonwu added a commit to wilsonwu/istio.io that referenced this pull request Aug 23, 2024
istio-testing pushed a commit that referenced this pull request Aug 23, 2024
… doc into Chinese (#15605)

* Sync #15574 Attempt at modernizing the sidecar SPIRE integration doc into Chinese

* finish translate

* fix lint
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/environments kind/docs size/XL Denotes a PR that changes 500-999 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

SPIRE docs should stop using hand-constructed YAML templates and just use upstream SPIRE Helm charts
6 participants