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

Use --app-namespace rather than -n for dedicated option in state-namespace docs #734

Merged
merged 2 commits into from
Mar 17, 2024

Conversation

jfmontanaro
Copy link
Contributor

When using a dedicated namespace for state storage, the docs currently suggest specifying this namespace via the -n flag. However this can lead to undesirable behaviors, since the app is typically being deployed to a different namespace. In my case, I had a resource where I had neglected to specify the namespace, and it would have ended up getting deployed to the state-storage namespace rather than the same namespace as the rest of the app.

This was discussed in carvel-dev/kapp#815 and fixed in carvel-dev/kapp#814 with the introduction of the --app-namespace flag, which controls which is used for state storage independently of the app namespace. However the docs did not reflect this change.

This commit adjusts the documentation to recommend using --app-namespace when storing configs in a separate namespace.

Copy link

netlify bot commented Mar 7, 2024

Deploy Preview for carvel ready!

Name Link
🔨 Latest commit a6f89fa
🔍 Latest deploy log https://app.netlify.com/sites/carvel/deploys/65f0c7ecb26c5200080d0e8d
😎 Deploy Preview https://deploy-preview-734--carvel.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.

@judahrand
Copy link

judahrand commented Mar 11, 2024

Yes! Please, can this be merged - the current docs are pretty misleading.

More generally it'd be great in the --app-namespace could be added to the docs in all the relevant places. Currently it doesn't seem to appear anywhere.

Copy link
Member

@praveenrewar praveenrewar left a comment

Choose a reason for hiding this comment

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

Thank you for the updates @jfmontanaro!
Your changes look good to me. Could you also make the same changes in the v0.59.0 and v0.60.0 (v0.59.0 was the release where this flag was introduced).
Also, please sign your commits to make the DCO bot happy :)

@jfmontanaro
Copy link
Contributor Author

Hi @praveenrewar, happy to do that - I just made the first commit directly on github, so it was signed with github's signature. Is that sufficient or should I sign it with something specific to me?

@praveenrewar
Copy link
Member

@jfmontanaro You need to sign the commit with an email that is associated with your GitHub account. You can squash your existing commit with a new commit and sign it.
Details

…space.md

When using a dedicated namespace for state storage, the docs currently suggest specifying this namespace via the  flag. However this can lead to undesirable behaviors, since the app is typically being deployed to a different namespace. In my case, I had a resource where I had neglected to specify the namespace, and it would have ended up getting deployed to the state-storage namespace rather than the same namespace as the rest of the app.

This was discussed in carvel-dev/kapp#815 and fixed in carvel-dev/kapp#814 with the introduction of the  flag, which controls which is used for state storage independently of the app namespace. However the docs did not reflect this change.

This commit adjusts the documentation to recommend using  when storing configs in a separate namespace.

Signed-off-by: Joseph Montanaro <[email protected]>
@jfmontanaro jfmontanaro force-pushed the app-namespace-state-storage branch from 7306953 to 8fe5af9 Compare March 12, 2024 21:18
@jfmontanaro
Copy link
Contributor Author

Got it, sorry. I thought you were talking about some kind of cryptographic signature, since I know that is a thing that Git can do.

I've made those changes, so from my perspective everything here is good to go.

Copy link
Contributor

@100mik 100mik left a comment

Choose a reason for hiding this comment

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

Thank you for this! Changes look good

@100mik 100mik merged commit 86d8ed1 into carvel-dev:develop Mar 17, 2024
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Archived in project
Development

Successfully merging this pull request may close these issues.

4 participants