-
Notifications
You must be signed in to change notification settings - Fork 11
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
Improve Repo Sharing Docs #184
base: main
Are you sure you want to change the base?
Conversation
This was missing some key information on who should run what commands and what you need to run to decrypt a cloned repo (we should probably also write a `plural clone` command that compresses that into one command)
✅ Deploy Preview for pluraldocs ready!
To edit notification comments on pull requests, go to your Netlify site settings. |
### Register a public key | ||
|
||
To register a key for your current machine, run: | ||
First, Alice and Bob both need to register age keypairs with plural. To do that register, they should both run this command on their current machine: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
First, Alice and Bob both need to register age keypairs with plural. To do that register, they should both run this command on their current machine: | |
First, Alice and Bob both need to register age keypairs with Plural. To do that registration, they should both run this command on their current machine: |
plural deploy --commit "set up encryption" | ||
``` | ||
|
||
Regardless, whether the console is installed or not, you should be sure the files written locally were pushed upstream, which can also be done with: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Regardless, whether the console is installed or not, you should be sure the files written locally were pushed upstream, which can also be done with: | |
Regardless of whether the console is installed or not, you should ensure the locally-written files were pushed upstream, which can be done with: |
|
||
### Bob Decrypts the Repository | ||
|
||
Now that the keypairs are registered, and repo encryption has moved to using age, Bob should be able to freely decrypt the repo, which is done simply by: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Now that the keypairs are registered, and repo encryption has moved to using age, Bob should be able to freely decrypt the repo, which is done simply by: | |
Now that the keypairs are registered and repo encryption has moved to using age, Bob should be able to freely decrypt the repo, which is done simply by: |
|
||
### Helpful Hints | ||
|
||
- Encryption keys are stored locally or in plural's keybackups, so if new teammate gets a new machine, you'll likely need to do this process again for that teammate. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- Encryption keys are stored locally or in plural's keybackups, so if new teammate gets a new machine, you'll likely need to do this process again for that teammate. | |
- Encryption keys are stored locally or in Plural's keybackups, so if a new teammate gets a new machine, you'll likely need to do this process again for that teammate. |
Summary
This was missing some key information on who should run what commands and what you need to run to decrypt a cloned repo (we should probably also write a
plural clone
command that compresses that into one command)Test Plan
n/a
Checklist