# Hướng dẫn vận hành

## 1. Tạo và Xóa

### 1.1 Tạo Kho lưu trữ hình ảnh

Trên trang sản phẩm Hub (kho lưu trữ hình ảnh), nhấp vào **Tạo Kho lưu trữ hình ảnh**, nhập tên kho lưu trữ hình ảnh và ghi chú để hoàn tất việc tạo. Nếu dự án hiện tại đã có kho lưu trữ hình ảnh, hãy chọn **Tạo Kho lưu trữ hình ảnh mới** từ danh sách thả xuống của **tên kho lưu trữ**.

- Tên kho lưu trữ hình ảnh phải là **duy nhất trên toàn cầu** (không được trùng lặp với tên được sử dụng bởi người dùng hoặc dự án khác).
- Mỗi dự án hỗ trợ **tối đa 8 kho lưu trữ hình ảnh**.

### 1.2 Xóa Kho lưu trữ hình ảnh

Nhấp vào nút **Xóa Kho lưu trữ hình ảnh** ở góc trên bên phải của trang bảng điều khiển kho lưu trữ hình ảnh để xóa kho lưu trữ.

- **Chỉ có thể xóa các kho lưu trữ hình ảnh trống.** Nếu kho lưu trữ vẫn chứa hình ảnh, hãy xóa chúng trước.

## 2. Tài khoản và Quyền

Chuẩn bị môi trường: Đăng nhập qua docker login trên máy đã cài đặt Docker (phiên bản 1.10 trở lên).

### 2.1 Tài khoản Console

Tên đăng nhập là email đã đăng ký trên nền tảng VNPT Cloud, và mật khẩu là **mật khẩu đăng nhập console** của bạn.

Đăng nhập vào kho lưu trữ hình ảnh qua lệnh Docker và truy cập dịch vụ qua tên miền:

```
docker login uhub.cloud.vnpt.vn -u {user@email}
```

### 2.2 Mật khẩu độc lập

Bạn có thể thiết lập mật khẩu độc lập trên trang Kho lưu trữ hình ảnh Container. Tài khoản cho mật khẩu độc lập là email đã đăng ký trên nền tảng VNPT Cloud, và mật khẩu là mật khẩu do bạn thiết lập.

- Nếu mật khẩu độc lập khác với mật khẩu đăng nhập console, cả hai đều có thể được sử dụng.
- Mật khẩu độc lập được liên kết với tên đăng nhập, không phải với các kho lưu trữ hình ảnh cụ thể.
- Việc sửa đổi mật khẩu độc lập sẽ ảnh hưởng đến tất cả các kho lưu trữ hình ảnh và hỗ trợ đăng nhập qua cả mạng nội bộ và mạng công cộng của VNPT Cloud.

## 3. Cài đặt truy cập kho lưu trữ

#### Kho lưu trữ hình ảnh chia sẻ ra bên ngoài

Theo mặc định, các kho lưu trữ hình ảnh là riêng tư và chỉ có thể được kéo (pull) bởi tài khoản chính và các tài khoản phụ có quyền thích hợp đối với dự án chứa kho lưu trữ.

Nếu bạn muốn hình ảnh của mình được kéo bởi những người dùng khác trên nền tảng, bạn có thể thiết lập **kho lưu trữ hình ảnh chia sẻ ra bên ngoài** thành công khai.

#### Truy cập Mạng ngoài

Bạn có thể vô hiệu hóa việc đẩy (push) và kéo (pull) hình ảnh qua mạng công cộng bằng cách sử dụng nút chuyển đổi **Truy cập Mạng ngoài**.

Nếu kho lưu trữ của bạn được cấu hình làm **kho lưu trữ hình ảnh chia sẻ công khai**, chỉ có hoạt động đẩy qua mạng công cộng bị cấm, trong khi hoạt động kéo qua mạng công cộng vẫn sẽ được cho phép.

## 4. Đẩy và Kéo Hình ảnh

### 4.1 Đẩy Hình ảnh

**Bước 1**: Gắn thẻ (tag) cho hình ảnh cục bộ:

```
docker tag {local image name} uhub.cloud.vnpt.vn/{created image repository}/{image}:tag
```

**Bước 2**: Đẩy hình ảnh vào kho lưu trữ:

```
docker push uhub.cloud.vnpt.vn/{created image repository}/{image}:tag
```

### 4.2 Kéo Hình ảnh

```
docker pull uhub.cloud.vnpt.vn/{created image repository}/{image}:tag
```

## 5. Trải nghiệm người dùng đa vùng

Kho lưu trữ hình ảnh công cộng VNPT Cloud áp dụng kiến trúc đa vùng. Hình ảnh được đẩy lên một nút ở một vùng có thể được kéo qua mạng nội bộ từ các nút ở các vùng khác.

Ví dụ, tại Bắc Trung Quốc (Bắc Kinh 2) Phân khu khả dụng C, đẩy hình ảnh lên:
![img](https://cdn.udelivrs.com/2025/04/f1d3a097c4c7b9855a795aad881b04f4_1744354467946.png)<br>
Tại Vùng Thượng Hải 2, kéo hình ảnh:
![img](https://cdn.udelivrs.com/2025/04/29bfedd16fc78d38db2974095bb2ecc1_1744354467950.png)<br>

Sau khi quá trình đẩy hình ảnh hoàn tất, tất cả các vùng VNPT Cloud được phủ sóng bởi mạng nội bộ đều có thể kéo các hình ảnh đã đẩy qua mạng nội bộ.

### 6. Giới hạn sử dụng

1. Một hình ảnh đơn lẻ có thể giữ tối đa **800 Tag**. Nếu vượt quá 800 Tag, các Tag không sử dụng và hình ảnh liên quan chưa được kéo trong vòng một tháng sẽ bị xóa, ưu tiên xóa các hình ảnh được tải lên trước đó.
2. Không áp dụng giới hạn kích thước đối với hình ảnh, nhưng **việc đẩy các hình ảnh lớp đơn lẻ (single-layer) vượt quá 5G có thể thất bại**.
3. Tốc độ kéo hình ảnh qua mạng ngoài bị giới hạn ở mức **1MB/s cho mỗi lớp (layer)**.
4. Các vùng **hiện chưa được hỗ trợ** để kéo hình ảnh qua mạng nội bộ: **Nam Trung Quốc (Tuyền Châu)**.