-
Notifications
You must be signed in to change notification settings - Fork 69
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
Add how to encrypt/decrypt image and volume #636
Conversation
|
8e30ec5
to
f42d372
Compare
16e1316
to
68fcd05
Compare
73a754f
to
fa847ac
Compare
795c836
to
9bec7d0
Compare
8aac267
to
04883ca
Compare
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.
LGTM
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.
The flow LGTM, thanks.
docs/image/image-security.md
Outdated
|
||
## Encrypt Image | ||
|
||
After getting a source image, please select `Ecnrypt` to encrypt virtual machine image. |
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.
After getting a source image, please select `Ecnrypt` to encrypt virtual machine image. | |
After getting a source image, please select `Encrypt` to encrypt the virtual machine image. |
docs/image/image-security.md
Outdated
|
||
## Use Image | ||
|
||
Select the image when creating virtual machine image. |
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.
Select the image when creating virtual machine image. | |
Select the image when creating a virtual machine. |
docs/volume/volume-security.md
Outdated
|
||
There are two ways to create an encrypted volume. In either case, be sure to select an encrypted storage class. | ||
|
||
### In Volumes Tabs |
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.
Maybe "Volumes page"?
docs/volume/volume-security.md
Outdated
|
||
![create-empty-volume](/img/v1.2/volume/create-empty-volume.png) | ||
|
||
### In Images Tab |
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.
And "Volumes tab when creating a virtual machine".
docs/volume/volume-security.md
Outdated
|
||
### In Volumes Tabs | ||
|
||
![create-empty-volume](/img/v1.2/volume/create-empty-volume.png) |
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.
would be nice to update the two screenshots with the encrypted storage class created in the previous steps.
ba552b9
to
4828080
Compare
Updated the all links from |
8b2f8d2
to
6c5ced0
Compare
6c5ced0
to
8a647fc
Compare
Gentle ping to @jillian-maroket , the GUI PR harvester/dashboard#1151 is ready, I think this document won't be changed anymore. Please help review this when you have time, thanks! |
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.
I restructured some parts because of unnecessary headings and text. Please be mindful of the indentation.
docs/image/image-security.md
Outdated
```yaml | ||
apiVersion: v1 | ||
kind: Secret | ||
metadata: | ||
name: encryption | ||
namespace: default | ||
data: | ||
CRYPTO_KEY_CIPHER: aes-xts-plain64 | ||
CRYPTO_KEY_HASH: sha256 | ||
CRYPTO_KEY_PROVIDER: secret | ||
CRYPTO_KEY_SIZE: 256 | ||
CRYPTO_KEY_VALUE: "Your encryption passphrase" | ||
CRYPTO_PBKDF: argon2i | ||
``` |
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.
Please indent this code block.
docs/image/image-security.md
Outdated
```yaml | ||
allowVolumeExpansion: true | ||
apiVersion: storage.k8s.io/v1 | ||
kind: StorageClass | ||
metadata: | ||
name: encryption | ||
parameters: | ||
csi.storage.k8s.io/node-publish-secret-name: encryption | ||
csi.storage.k8s.io/node-publish-secret-namespace: default | ||
csi.storage.k8s.io/node-stage-secret-name: encryption | ||
csi.storage.k8s.io/node-stage-secret-namespace: default | ||
csi.storage.k8s.io/provisioner-secret-name: encryption | ||
csi.storage.k8s.io/provisioner-secret-namespace: default | ||
encrypted: "true" | ||
migratable: "true" | ||
numberOfReplicas: "3" | ||
staleReplicaTimeout: "2880" | ||
provisioner: driver.longhorn.io | ||
reclaimPolicy: Delete | ||
volumeBindingMode: Immediate | ||
``` |
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.
Please indent this code block.
docs/volume/volume-security.md
Outdated
```yaml | ||
allowVolumeExpansion: true | ||
apiVersion: storage.k8s.io/v1 | ||
kind: StorageClass | ||
metadata: | ||
name: encryption | ||
parameters: | ||
csi.storage.k8s.io/node-publish-secret-name: encryption | ||
csi.storage.k8s.io/node-publish-secret-namespace: default | ||
csi.storage.k8s.io/node-stage-secret-name: encryption | ||
csi.storage.k8s.io/node-stage-secret-namespace: default | ||
csi.storage.k8s.io/provisioner-secret-name: encryption | ||
csi.storage.k8s.io/provisioner-secret-namespace: default | ||
encrypted: "true" | ||
migratable: "true" | ||
numberOfReplicas: "3" | ||
staleReplicaTimeout: "2880" | ||
provisioner: driver.longhorn.io | ||
reclaimPolicy: Delete | ||
volumeBindingMode: Immediate | ||
``` |
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.
Please indent this code block.
Hi @jillian-maroket, I'm curious if we have any guidelines for writing documentation. For example, do we have a standard way to arrange sections or specific terms we can use in certain sections? For instance, avoiding like "Don't" in limitation sections, etc. |
fa0d396
to
fc6a6bd
Compare
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.
LGTM, suggest squashing and fix the "encrypr" typo in the first commit message.
Signed-off-by: Jack Yu <jack.yu@suse.com>
Signed-off-by: Jack Yu <jack.yu@suse.com>
Co-authored-by: Jillian <67180770+jillian-maroket@users.noreply.github.com> Signed-off-by: Jack Yu <jack.yu@suse.com>
Description
Since the v1.4.0 harvester will support image/volume encryption, I'd like to refine the current image documentation structure.
It will be two markdowns in the sidebar:
Please check following path to review the content
Related Issue
harvester/harvester#3129