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.

Nhập một dự án Compose — một API ghi chú với PostgreSQL và Redis

Một tệp Compose chạy một API, cơ sở dữ liệu PostgreSQL nơi API đó lưu ghi chú và một bộ nhớ đệm Redis, được aggrega import soạn nháp thành các tệp Aggrega — mang theo các kết nối, cài đặt của cơ sở dữ liệu, mật khẩu dưới dạng tham chiếu biến và tag của mỗi image — và được build cho Docker Compose.

Nhập một dự án Compose hướng dẫn từng bước: lệnh, các tệp mà nó ghi và lý do mỗi dòng có mặt ở đó, quá trình build và stack đang chạy. Thư mục này chứa từng giai đoạn của hướng dẫn đó:

thư mục hoặc tệpnội dung
source/dự án Compose, compose.yaml, .aggrega-config.yaml biến thư mục thành một không gian làm việc, và import-answers.yaml, giá trị duy nhất mà một bản build cho Kubernetes cần nhưng không tệp Compose nào chứa
draft/các tệp mà aggrega import compose.yaml --target compose đã ghi, không thay đổi, bao gồm cả release.lock, và những gì nó đã in ra: stdout.txt trên đầu ra chuẩn, import.txt trên đầu ra lỗi chuẩn

Trong một bản checkout của kho tài liệu, check.sh chạy lại quá trình nhập, so sánh những gì nó ghi và in ra với draft/, so sánh các khối mà hướng dẫn trích dẫn với các tệp này, và xác thực rồi build những gì quá trình nhập đã ghi. Nó cần catalog thư viện chuẩn (lấy ở đâu) được checkout bên cạnh kho này, hoặc thư mục của catalog đó được chỉ định trong AGGREGA_CATALOG_DIRS.

Tạo ví dụ

Bạn có thể chạy bước nhập của ví dụ này bằng các lệnh bên dưới, hoặc để trợ lý AI của bạn chạy thay bạn.

Ghi ví dụ vào một thư mục mới đặt theo tên của nó:

Terminal window
aggrega scaffold --example import-compose

Sau đó nó in ra các lệnh cần chạy tiếp theo. Lệnh đầu tiên chuyển vào thư mục mới:

Terminal window
cd import-compose

Build

Quá trình nhập soạn nháp các tệp Aggrega bên cạnh dự án, trong source/. Nó đối chiếu dự án với catalog thư viện chuẩn, được registry mặc định của không gian làm việc phát hành dưới dạng một snapshot đã ký: lần nhập đầu tiên tải nó về, xác minh nó, giữ nó trong bộ nhớ đệm nội dung của không gian làm việc và gọi tên nó bằng digest của nó trong bản ghi mà nó ghi bên cạnh các bản nháp. Một không gian làm việc chỉ định các thư mục catalog của riêng mình — trong AGGREGA_CATALOG_DIRS, hoặc dưới workspace.catalog_dirs — sẽ nhập dựa trên các thư mục đó thay thế. Sau đó quá trình nhập kéo về những gì mà Release được soạn nháp phụ thuộc vào, để bản build có thể tiếp theo ngay:

Terminal window
cd source
aggrega import compose.yaml --target compose
aggrega build --release release.yaml

Bản build ghi dist/compose/docker-compose.yaml; cách chạy nó có trong hướng dẫn được liên kết ở trên.

Với trợ lý AI

Một trợ lý AI được thiết lập với các công cụ của Aggrega cũng có thể làm như vậy: hãy dán prompt này vào trợ lý.

Chỉ sử dụng các công cụ của Aggrega và không tự tạo thư mục nào. Nếu thư mục không gian làm việc chưa chứa thư mục `import-compose`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `import-compose` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `import-compose` mới, trong đó thư mục `source` chứa những gì ví dụ này nhập. Sau đó gọi công cụ `import` với `workspace_root` đặt thành `import-compose/source`, `source` đặt thành `compose.yaml` và `target` đặt thành `compose`: công cụ này đọc các câu trả lời cần thiết từ `import-answers.yaml` bên cạnh `compose.yaml`, ghi các bản nháp vào `import-compose/source` và kéo về những gì chúng cần. Sau đó gọi công cụ `validate` với `workspace_root` đặt thành `import-compose/source` và `release` đặt thành `release.yaml`, rồi gọi công cụ `build` với `workspace_root` đặt thành `import-compose/source`, `release` đặt thành `release.yaml` và `write` đặt thành true. Hãy cho tôi biết lần build đã ghi những tệp nào; chúng nằm trong `import-compose/source/dist/`.

Kiểm thử

Khi stack đang chạy theo cách hướng dẫn từng bước chạy nó, với một image trả lời HTTP trên cổng 8080 được chỉ định cho API, hãy gửi yêu cầu tới API tại cổng mà Release công bố:

Terminal window
curl -sS http://127.0.0.1:8080/notes

Chương trình thay thế trong hướng dẫn trả lời bằng phần mô tả yêu cầu mà nó nhận được:

{
"path": "/notes",
"headers": {
"host": "127.0.0.1:8080",
[… omitted: the user agent and the media types the client sent]
},
"method": "GET",
[… omitted: the rest of the request as the stand-in received it, the client's address and the container's host name]
}

Khi được nhập với --target helm và áp dụng lên Kubernetes, như hướng dẫn từng bước trình bày, API trả lời cùng yêu cầu đó tại cùng địa chỉ sau khi một cổng cục bộ được chuyển tiếp tới Service của nó; ở đó API chưa nhận được mật khẩu cơ sở dữ liệu của nó, vì Secret chỉ đến được cơ sở dữ liệu:

Terminal window
kubectl port-forward -n <namespace> svc/api-default 8080:8080