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

Adding install doc and updating example #25

Merged
merged 3 commits into from
Oct 31, 2023
Merged

Adding install doc and updating example #25

merged 3 commits into from
Oct 31, 2023

Conversation

dlakhaws
Copy link
Contributor

Description of changes:

  • Adding install doc
  • Updating static provisioning example

@dlakhaws dlakhaws temporarily deployed to PR Unit Tests October 30, 2023 18:12 — with GitHub Actions Inactive
@dlakhaws dlakhaws temporarily deployed to PR Integration Tests October 30, 2023 18:12 — with GitHub Actions Inactive
#### Helm
- Add the `aws-mountpoint-s3-csi-driver` Helm repository.
```sh
helm repo add aws-mountpoint-s3-csi-driver ???
Copy link
Contributor Author

Choose a reason for hiding this comment

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

note: this will stay ??? until we finalize where we install the helm repo from

docs/install.md Outdated Show resolved Hide resolved
docs/install.md Show resolved Hide resolved
docs/install.md Outdated Show resolved Hide resolved
examples/kubernetes/static_provisioning/README.md Outdated Show resolved Hide resolved
vladem
vladem previously approved these changes Oct 31, 2023
docs/install.md Show resolved Hide resolved
docs/install.md Outdated
kubectl delete -k "github.com/awslabs/aws-mountpoint-s3-csi-driver/deploy/kubernetes/overlays/stable/?ref=release-<YOUR-CSI-DRIVER-VERION-NUMBER>"
```

> Warning: Warning: executing this command will delete a service account s3-csi-driver-sa from your cluster , which may cause problems when installing the driver again on a EKS cluster (re-created account won't include eks.amazonaws.com/role-arn annotation). Please refer to [eksctl documentation](https://eksctl.io/usage/iamserviceaccounts/) for details of how to re-create SA in this case.
Copy link
Contributor

Choose a reason for hiding this comment

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

warning 2 times

Copy link
Contributor Author

Choose a reason for hiding this comment

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

ah, fixed

### Set up driver permissions
The driver requires IAM permissions to talk to Amazon S3 to manage the volume on user's behalf. AWS maintains a managed policy, available at ARN `arn:aws:iam::aws:policy/AmazonS3FullAccess`.

For more information, review ["Creating the Amazon Mountpoint for S3 CSI driver IAM role for service accounts" from the EKS User Guide.](TODO: add AWS docs link)
Copy link
Contributor

Choose a reason for hiding this comment

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

We'll have to update this to cover self managed clusters. Fine with that being a followup though.


## Prerequisites

* Kubernetes Version >= 1.20
Copy link
Contributor

Choose a reason for hiding this comment

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

Where does this version come from? Just curious

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I believe this is due to the CSI Driver Spec requirement but will double check, will have another doc PR up soon and will make an edi tin there if it's not the case

@dlakhaws dlakhaws merged commit a40bb31 into main Oct 31, 2023
2 checks passed
@dlakhaws dlakhaws deleted the update-docs branch October 31, 2023 21:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants