|
| 1 | +--- |
| 2 | +title: Install and Use HAMi on AWS |
| 3 | +translated: true |
| 4 | +--- |
| 5 | + |
| 6 | +HAMi is now available on the AWS Marketplace, and you can quickly install it via Helm or AWS add-on. |
| 7 | + |
| 8 | +## Prerequisites |
| 9 | + |
| 10 | +Before installation, please ensure you have: |
| 11 | + |
| 12 | +- Subscribed to HAMi on the AWS Marketplace |
| 13 | +- Created a Kubernetes cluster |
| 14 | + |
| 15 | +## Install with Helm |
| 16 | + |
| 17 | +You can use the following commands to pull HAMi’s Helm chart and install it: |
| 18 | + |
| 19 | +```shell |
| 20 | +export HELM_EXPERIMENTAL_OCI=1 |
| 21 | +# The `username` and `password-stdin` correspond to your AWS login credentials. |
| 22 | +aws ecr get-login-password --region us-east-1 | helm registry login --username AWS --password-stdin 709825985650.dkr.ecr.us-east-1.amazonaws.com |
| 23 | +mkdir awsmp-chart && cd awsmp-chart |
| 24 | +helm pull oci://709825985650.dkr.ecr.us-east-1.amazonaws.com/dynamia-ai/hami --version 2.6.1-community |
| 25 | +tar xf $(pwd)/* && find $(pwd) -maxdepth 1 -type f -delete |
| 26 | +helm install --generate-name --namespace <ENTER_NAMESPACE_HERE> ./* |
| 27 | +``` |
| 28 | + |
| 29 | +You can customize the installation by adjusting the [configuration](../userguide/configure.md). |
| 30 | + |
| 31 | +## Install with AWS Add-on |
| 32 | + |
| 33 | +Before installing HAMi using the AWS add-on, you need to install **cert-manager**. |
| 34 | +You can find it in the AWS Marketplace add-ons section and install it through the AWS Console. |
| 35 | +You may also refer to the [AWS User Guide](https://docs.aws.amazon.com/eks/latest/userguide/lbc-manifest.html#lbc-cert) for installation instructions. |
| 36 | + |
| 37 | +Once cert-manager is installed, you can install the HAMi add-on from the AWS Marketplace. |
| 38 | + |
| 39 | +## Verify Your Installation |
| 40 | + |
| 41 | +You can verify your installation with the following command: |
| 42 | + |
| 43 | + |
| 44 | +``` |
| 45 | +kubectl get pods -n kube-system |
| 46 | +``` |
| 47 | + |
| 48 | + |
| 49 | +If both the **hami-device-plugin** and **hami-scheduler** pods are in the `Running` state, your installation was successful. |
| 50 | + |
| 51 | +## Usage Examples |
| 52 | + |
| 53 | +### NVIDIA Devices |
| 54 | +[Use Exclusive GPU](https://project-hami.io/docs/userguide/NVIDIA-device/examples/use-exclusive-card) |
| 55 | +[Allocate Specific Device Memory to a Container](https://project-hami.io/docs/userguide/NVIDIA-device/examples/allocate-device-memory) |
| 56 | +[Allocate Device Core Resources to a Container](https://project-hami.io/docs/userguide/NVIDIA-device/examples/allocate-device-core) |
| 57 | +[Assign Tasks to MIG Instances](https://project-hami.io/docs/userguide/NVIDIA-device/examples/dynamic-mig-example) |
0 commit comments