Skip to content

Commit 7baaf10

Browse files
Merge pull request #99 from FouoF/add-aws
add aws installation document
2 parents 18d3250 + 72489d7 commit 7baaf10

File tree

3 files changed

+113
-1
lines changed

3 files changed

+113
-1
lines changed
Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
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)
Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
---
2+
title: 在 AWS 上安装和使用 HAMi
3+
translated: true
4+
---
5+
6+
HAMi 已经在 AWS 市场上发布,你可以通过 helm 或 AWS add-on 快速安装。
7+
8+
## 准备工作
9+
10+
在安装前,请确保你已经:
11+
12+
- 在市场上订阅了 HAMi
13+
- 创建了一个 Kubernetes 集群
14+
15+
## 使用 Helm 安装
16+
17+
你可以使用以下命令获取 HAMi 的 Helm chart 并安装:
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+
您可以通过调整[配置](../userguide/configure.md)来自定义安装。
30+
31+
## 使用 AWS add-on 安装
32+
33+
在使用 AWS add-on 安装 HAMi 前,你需要安装cert-manager,你可以在 AWS 插件市场中找到该插件并通过控制台安装。
34+
你也可以参考[AWS 用户指南](https://docs.aws.amazon.com/eks/latest/userguide/lbc-manifest.html#lbc-cert)进行安装。
35+
36+
然后你就可以使用 AWS 插件市场中的 HAMi 插件进行安装。
37+
38+
## 验证您的安装
39+
40+
您可以使用以下命令验证您的安装:
41+
42+
```
43+
kubectl get pods -n kube-system
44+
```
45+
46+
如果 hami-device-plugin 和 hami-scheduler pods 都处于 Running 状态,则说明您的安装成功。
47+
48+
## 使用示例
49+
50+
### NVIDIA 设备
51+
[使用独占 GPU](https://project-hami.io/zh/docs/userguide/NVIDIA-device/examples/use-exclusive-card)
52+
[为容器分配特定设备内存](https://project-hami.io/zh/docs/userguide/NVIDIA-device/examples/allocate-device-memory)
53+
[为容器分配设备核心资源](https://project-hami.io/zh/docs/userguide/NVIDIA-device/examples/allocate-device-core)
54+
[将任务分配给 mig 实例](https://project-hami.io/zh/docs/userguide/NVIDIA-device/examples/dynamic-mig-example)

sidebars.js

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,8 @@ module.exports = {
3434
"installation/upgrade",
3535
"installation/uninstall",
3636
"installation/webui-installation",
37-
"installation/how-to-use-volcano-vgpu"
37+
"installation/how-to-use-volcano-vgpu",
38+
"installation/aws-installation"
3839
]
3940
},
4041
{

0 commit comments

Comments
 (0)