Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

Các tệp của một bản build

Trang này giải thích một ý tưởng, tệp nào của một bản build nói lên điều gì, và không phải là một không gian làm việc có thể chạy được. Một ứng dụng web với PostgreSQL, được xây dựng từng bước một minh họa điều này trong một không gian làm việc mà bạn build; ghi nó vào một thư mục của riêng bạn bằng lệnh:

Terminal window
aggrega scaffold --example quickstart-web

Sau đó nó in ra các lệnh cần chạy tiếp theo:

Terminal window
cd quickstart-web
cd 1
aggrega build --release release.yaml --auto-pull
export QUICKSTART_DB_PASSWORD=choose-a-password
docker compose -p quickstart-web -f dist/compose/docker-compose.yaml up -d --wait
# then open http://127.0.0.1:8080/ in your browser

Năm loại tệp, mỗi loại có một tác giả

Một bản build đọc năm loại tệp. Mỗi loại nói lên một điều, và trong một nhóm điển hình, mỗi loại có tác giả riêng:

  • một Component cho biết một loại thành phần là gì: các giá trị mà nhà phát triển có thể đặt, các thiết lập hạ tầng mà người vận hành có thể đặt, những gì nó công bố cho các thành phần kết nối với nó, và các socket mà nó kết nối qua đó. Danh mục thư viện chuẩn cung cấp các Components mà hầu hết ứng dụng cần, chẳng hạn core/datastore/postgres và core/compute/server, nên một không gian làm việc thường không viết cái nào;
  • một Aggregate thuộc về nhà phát triển: ứng dụng có những thành phần nào, và mỗi thành phần kết nối tới đâu;
  • một Recipe biến một loại thành phần thành các tệp cho một công cụ — một dịch vụ Compose, một Helm chart, một module Terraform;
  • một Manifest chọn Recipe nào hiện thực hóa từng loại thành phần cho một đích;
  • một Release chỉ định một Aggregate và một Manifest, và cung cấp các thiết lập của một môi trường. Đó là thứ bạn build: aggrega build --release release.yaml.

Cách phân chia này là hướng dẫn: một người có thể viết cả năm loại, và bản build chấp nhận bất kỳ loại nào miễn là mỗi tệp đều hợp lệ.

Aggregate: các thành phần và kết nối của chúng

Bước đầu tiên của ví dụ là một ứng dụng web và cơ sở dữ liệu của nó. Aggregate của nó, lấy từ 1/aggregate.yaml với các chú thích được lược bỏ:

spec:
components:
web:
type: core/compute/server
features:
db_password:
type: core/secret-value
values:
key: PGPASSWORD
origin: "${QUICKSTART_DB_PASSWORD}"
uses:
database:
db:
target: db
inject:
env:
- in: PGHOST
from: host
- in: PGPORT
from: port
- in: PGUSER
from: user
- in: PGDATABASE
from: database
db:
type: core/datastore/postgres
features:
password:
type: core/secret-value
values:
key: POSTGRES_PASSWORD
origin: "${QUICKSTART_DB_PASSWORD}"

Không có gì ở đây chỉ định một cổng, một host, một namespace hay một công cụ. web kết nối tới db qua socket database của nó, và danh sách inject cho biết biến nào của ứng dụng nhận từng mục mà cơ sở dữ liệu công bố: from: chỉ định mục, in: chỉ định biến.

Một kết nối là một chuỗi, được truyền qua đường ống

Recipe của cơ sở dữ liệu công bố host, port, user và database để kết nối đọc. Địa chỉ mà host chứa phụ thuộc vào Recipe mà Manifest đã chọn: tên của một dịch vụ khi cơ sở dữ liệu chạy bên cạnh ứng dụng, một chuỗi con trỏ mà công cụ cấp phát phân giải cho một cơ sở dữ liệu được quản lý, hoặc địa chỉ của một máy chủ đã tồn tại. Bản build sao chép từng chuỗi được công bố vào biến mà Aggregate chỉ định và không diễn giải nó: nó không bao giờ phân giải một địa chỉ hay kiểm tra xem địa chỉ đó có truy cập được hay không.

Manifest và Release

Manifest, lấy từ 1/manifest.yaml, gắn từng loại thành phần, cùng các phần đính kèm mật khẩu, với Recipe hiện thực hóa nó trên Docker Compose:

spec:
mappings:
components:
type:
core/compute/server:1.1.0: compose/server:2.0.0
core/datastore/postgres:1.0.0: compose/postgres:1.0.0
features:
type:
core/secret-value:1.0.0: compose/dotenv-secret:1.0.0

Release, lấy từ 1/release.yaml, chỉ định Aggregate và Manifest, và cung cấp những gì chỉ một môi trường biết, ở đây là image mà ứng dụng chạy, cổng mà nó lắng nghe và cổng mà Docker Compose công bố nó trên địa chỉ loopback của máy bạn (digest của image được rút gọn):

spec:
aggregate: quickstart-web
manifest: quickstart-web-compose
components:
web:
infra:
image: hub.aggrega.ai/tools/quickstart-web:1.1.0@sha256:…
port: 8080
published_port: 8080
db: {}

Các bước sau của ví dụ mở rộng nó: một bộ nhớ đệm Redis bên cạnh cơ sở dữ liệu, rồi chính các thành phần đó trên AWS thông qua Terraform, rồi các bản sao lưu của cơ sở dữ liệu.

Tham số: một Aggregate, nhiều môi trường

Một giá trị khác nhau giữa các môi trường được khai báo trong Aggregate dưới dạng một tham số có kiểu, được tham chiếu ở nơi nó được dùng, và được mỗi Release cung cấp. Trong Một tác vụ chạy theo yêu cầu, Aggregate khai báo lịch chạy báo cáo của nó:

spec:
parameters:
report_schedule:
type: string
default: ""
components:
report:
type: core/compute/task
values:
schedule: "{{ .parameters.report_schedule }}"

và một Release đáp ứng nó:

spec:
parameters:
report_schedule: "30 2 * * 1-5"

Bản build kiểm tra từng giá trị mà Release cung cấp so với kiểu của tham số trước khi điền vào template. Một Release không bao giờ tự viết values của một thành phần: nó đáp ứng các tham số mà Aggregate công khai, nên Aggregate vẫn là nơi duy nhất cho biết giá trị nào thay đổi theo môi trường. Một Release cũng có thể đọc các tham số của nó từ một tệp riêng, parameters: { $import: ./env/prod-values.yaml }.