III. Thiết lập các phụ thuộc của chuỗi đối tác

Sau khi thiết lập xong Cardano SPO, bạn cần cấu hình các phụ thuộc của chuỗi đối tác như Ogmios, Kupo, DB-sync, Postgres, và Cardano-node. Để đơn giản hóa quy trình này, một tệp Docker Compose đã được cung cấp, giúp dễ dàng khởi động các dịch vụ này trên máy chủ. Ngoài ra, bạn cũng có thể chọn xây dựng các phụ thuộc này từ mã nguồn. ( nếu bạn chưa cài Docker compose có thể tham khảo tại đây)

1. Khởi động các phụ thuộc của chuỗi đối tác bằng Docker Compose

Để thiết lập các phụ thuộc của chuỗi đối tác, làm theo các bước sau:

a. Tải partner-chain từ github.

git clone https://github.com/midnight-ntwrk/partner-chain-deps-docker.git
cd partner-chain-deps-docker

b. Chỉnh sửa file compose.yml

nano compose.yml

Điều hướng bằng các phím mũi tên để xác định vị trí các biến môi trường POSTGRESS.

- POSTGRES_HOST=postgres

- POSTGRES_PORT=5432

- POSTGRES_DB=cexplorer

- POSTGRES_USER=postgres

- POSTGRES_PASSWORD=password123

⚠️ Thay đổi giá trị mặc định POSTGRES_PASSWORD và  POSTGRES_USER thành giá trị an toàn hơn.

c. Chạy Partner-chain và các thành phần phụ thuộc

docker-compose up -d

Ví dụ đầu ra:

Lưu ý: Bạn cần phải chờ cho các phụ thuộc của partner-chain đồng bộ hóa 100% với mạng lưới Cardano. Xem bước tiếp theo để giám sát các dịch vụ này.

2. Khởi động các phụ thuộc của chuỗi đối tác bằng Docker Compose

a. Xác minh trạng thái của các dịch vụ và cổng:

Liệt kê các container Docker đang hoạt động cùng với trạng thái, các cổng, và ID của container:

docker container list

ví dụ đầu ra:

b. Xem nhật ký của các container cụ thể:

docker logs db-sync
docker logs ogmios
docker logs kupo
docker logs postgres
docker logs cardano-node

Thay thế db-sync, ogmios, v.v., bằng tên hoặc ID thực tế của các container mà bạn muốn kiểm tra.

c. Xem bảng điều khiển của Ogmios và Kupo:

Nếu IP của máy chủ là x.x.x.x và họ muốn truy cập dịch vụ đang chạy trên cổng 1337, chẳng hạn như Ogmios, họ sẽ nhập vào thanh địa chỉ của trình duyệt như sau:
http://x.x.x.x:1337

d. Truy vấn tiến trình đồng bộ hóa của Cardano-db-sync:

cài đặt psql

sudo apt-get install postgresql-client

Truy vấn tiến trình đồng bộ hóa của Postgres-db-sync:

psql -d cexplorer -U postgres -c "SELECT 100 * (EXTRACT(EPOCH FROM (MAX(time) AT TIME ZONE 'UTC')) - EXTRACT(EPOCH FROM (MIN(time) AT TIME ZONE 'UTC'))) / (EXTRACT(EPOCH FROM (NOW() AT TIME ZONE 'UTC')) - EXTRACT(EPOCH FROM (MIN(time) AT TIME ZONE 'UTC'))) AS sync_percent FROM block;"

Tùy chọn truy vấn từ xa bằng ssh, nhưng hãy thay thế user@x.x.x.x bằng thông tin đăng nhập thực tế:

ssh user@x.x.x.x -C "psql -d cexplorer -h localhost -p 5432 -U postgres -c \"SELECT 100 * (EXTRACT(EPOCH FROM (MAX(time) AT TIME ZONE 'UTC')) - EXTRACT(EPOCH FROM (MIN(time) AT TIME ZONE 'UTC'))) / (EXTRACT(EPOCH FROM (NOW() AT TIME ZONE 'UTC')) - EXTRACT(EPOCH FROM (MIN(time) AT TIME ZONE 'UTC'))) AS sync_percent FROM block;\""

e. Các lệnh docker-compose hữu ích:

Để tìm hiểu thêm về Docker Compose, hãy truy cập tài liệu chính thức của Docker Compose. Tuy nhiên, dưới đây là một số lệnh thông dụng:

docker-compose stop # stop containers
docker-compose start # start containers
docker-compose restart # restart containers
docker-compose down # stop and remove containers
docker-compose stats # display resource usage statistics

Nguồn tham khảo: https://docs.midnight.network/