# Triển khai 

GMPay Edge hỗ trợ hai chế độ chạy sản xuất:

* **Tự lưu trữ Bun/Nitro**: Sử dụng SQLite và thư mục dữ liệu cục bộ bền vững, bằng cách sử dụng Docker hoặc triển khai nguồn với một trình quản lý dịch vụ.
* **Cloudflare Workers**: D1, KV, R2, Hàng đợi, và Trigger Cron.

Cả hai phiên bản đều tiếp cận cùng các API của người bán, quy trình thanh toán, bảng điều khiển quản trị, công việc nền, và quy trình `/install`.

## Docker Compose (được khuyến nghị) 

Cộng đồng công khai [GHCR package](https://github.com/orgs/GMWalletApp/packages/container/package/gmpay-edge) hỗ trợ `linux/amd64` và `linux/arm64`; không cần đăng nhập vào bất kỳ hệ thống đăng ký nào.

Lưu các nội dung sau vào `compose.yml`:

```
services:
  gmpay-edge:
    image: ghcr.io/gmwalletapp/gmpay-edge:latest
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      GMPAY_DATA_DIR: /var/lib/gmpay
    volumes:
      - gmpay-data:/var/lib/gmpay

volumes:
  gmpay-data:
```

Bắt đầu dịch vụ.

```
docker compose pull
docker compose up -d
```

Thẻ `latest` trỏ đến bản ổn định mới nhất. Để triển khai lại đúng phiên bản, hãy chỉ định đầy đủ số phiên bản, chẳng hạn `1.0.0`.

`GMPAY_DATA_DIR` chứa SQLite, các tệp đã tải lên, đối tượng riêng tư, trạng thái hàng đợi và tất cả dữ liệu thực thi khác. Hãy bảo quản và sao lưu thể tích `gmpay-data` khi cập nhật hoặc tạo lại container.

Đọc [Các thao tác với dữ liệu](https://epusdt.com/vi/gmpay-edge/node-data-operations) trước khi sao lưu, phục hồi, hoặc di chuyển một triển khai.

Kiểm tra dịch vụ và xem xét nhật ký bằng cách sử dụng:

```
curl --fail http://127.0.0.1:3000/healthz
docker compose ps
docker compose logs --follow gmpay-edge
```

Để cập nhật mà vẫn giữ nguyên dung lượng dữ liệu:

```
docker compose pull
docker compose up -d
```

### Lệnh Docker 

Nếu Compose không khả dụng, hãy chạy container trực tiếp.

```
docker volume create gmpay-data
docker run --detach --name gmpay-edge --restart unless-stopped \
  --publish 3000:3000 \
  --env GMPAY_DATA_DIR=/var/lib/gmpay \
  --volume gmpay-data:/var/lib/gmpay \
  ghcr.io/gmwalletapp/gmpay-edge:latest
```

## Triển khai Bun từ mã nguồn 

Bạn có thể chạy máy chủ sản xuất trực tiếp từ mã nguồn mà không cần Docker. Hãy cài đặt Git và Bun 1.3 trở lên; Node.js chỉ cần thiết nếu bạn chọn PM2 làm trình quản lý quy trình.

```
git clone https://github.com/GMWalletApp/gmpay-edge.git
cd gmpay-edge
bun install --frozen-lockfile
bun run build:bun
sudo install -d -o "$USER" -g "$USER" /var/lib/gmpay
NODE_ENV=production HOST=0.0.0.0 PORT=3000 \
  GMPAY_DATA_DIR=/var/lib/gmpay \
  bun run start:bun
```

Lệnh cuối cùng sẽ chạy ở chế độ nổi. Hãy giữ nó dưới hệ thống systemd, Supervisor, PM2, hoặc một trình quản lý dịch vụ khác trong môi trường sản xuất. Hãy bảo quản và sao lưu thư mục `GMPAY_DATA_DIR` như cách bạn bảo quản và sao lưu thể tích Docker.

### PM2 

PM2 cần Node.js và npm, nhưng GMPay Edge vẫn hoạt động với Bun. Hãy giữ tùy chọn `--interpreter bun` để PM2 không cố khởi động máy chủ được tạo bằng Node.js.

```
npm install --global pm2
NODE_ENV=production HOST=0.0.0.0 PORT=3000 \
  GMPAY_DATA_DIR=/var/lib/gmpay \
  pm2 start .output/server/index.mjs \
    --name gmpay-edge --interpreter bun
pm2 save
pm2 startup
```

Chạy lệnh được in ra bởi `pm2 startup`, sau đó chạy lại `pm2 save`. Sử dụng `pm2 logs gmpay-edge` và `curl --fail http://127.0.0.1:3000/healthz` để kiểm tra dịch vụ.

Để cập nhật triển khai nguồn.

```
pm2 stop gmpay-edge
git pull --ff-only
bun install --frozen-lockfile
bun run build:bun
pm2 restart gmpay-edge --update-env
```

## Cloudflare Workers 

### Nút áp dụng 

[![Deploy to Cloudflare](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/GMWalletApp/gmpay-edge)

Các quy định về luồng hướng dẫn áp dụng các ràng buộc được khai báo trong `wrangler.jsonc`, thực hiện di chuyển D1 và xây dựng Worker.

* Lệnh xây dựng: `bun run build`
* Lệnh triển khai: `wrangler deploy`

Sau khi triển khai, hãy mở `/install` trên URL của Worker để khởi tạo phiên bản.

### Wrangler CLI 

```
bun install
bunx wrangler login
bun run deploy
```

Nếu D1 cần được chuẩn bị thủ công:

```
bunx wrangler d1 create gmpay-edge
bun run db:migrate:remote
```

Không nên sử dụng ID cơ sở dữ liệu. Thuật toán triển khai tạo hoặc tái sử dụng các tài nguyên có tên D1, KV, R2 và Queue, áp dụng cơ sở dữ liệu cơ bản D1 và xây dựng Worker trước khi xuất bản.

## Phát triển địa phương 

Yêu cầu:

* Bun 1.3 trở lên
* Một môi trường địa phương được hỗ trợ bởi Wrangler for the Workers.

```
bun install
bun run dev
```

`bun run dev` áp dụng các di chuyển (migrations) đang chờ đợi vào cơ sở dữ liệu `gmpay-edge` D1 cục bộ và khởi động ứng dụng tại `http://localhost:3000`.

## Cài đặt lần đầu 

Sau khi Docker hoặc Bun khởi động, hãy mở `http://your-host:3000/install`. Sau khi triển khai Workers, hãy mở `/install` trên URL của Worker. Xác nhận địa chỉ công cộng được phát hiện và các Host được phép trước khi tạo người dùng gốc đầu tiên.

Việc cài đặt tạo ra:

* Người dùng đầu tiên.
* Vai trò `root` được bảo vệ.
* bí mật chạy (hoặc: bí mật thời gian)
* Việc thanh toán không được thực hiện.
* Lệnh Telegram công khai và cài đặt mặc định của Telegram.

Ứng dụng này không tạo một Bot Telegram hoặc liên hệ với Telegram. Cài đặt bảo mật và email được quản lý thông qua giao diện quản trị, thay vì thông qua các biến môi trường của môi trường container.
