Thiết lập proxy ngược cơ bản chỉ cần ba quyết định, và hướng dẫn này hỗ trợ từng phần: tên máy chủ, đường dẫn và máy chủ hậu trường. Tìm kiếm proxy HTTP có thể là proxy chuyển tiếp hoặc proxy ngược, và ở đây bạn lập kế hoạch và kiểm tra một máy chủ do chính bạn vận hành. Agent không bao giờ tự quyết định tên máy chủ hay đường dẫn nào là đúng. Nó ghi lại những gì bạn yêu cầu, hiển thị từng thay đổi dưới dạng diff và báo cáo kết quả thực tế của mọi lệnh, để bạn có thể thấy tác động của từng quyết định trước khi thực hiện bước tiếp theo. Hãy thực hiện bốn bước dưới đây theo thứ tự và coi kế hoạch định tuyến là tài liệu mà cả bạn và agent đều tuân thủ từ lệnh đầu tiên đến yêu cầu cuối cùng.
Khởi động Segment Route và mở thư mục làm việc chứa tệp cấu hình và tệp định tuyến của bạn. Các công cụ tệp hoạt động trong thư mục này, vì vậy một thư mục sạch chỉ chứa các tệp liên quan đến tên miền này sẽ giúp các diff ngắn gọn và kết quả tìm kiếm dễ đọc. Nếu các tệp đang chạy của bạn nằm trên một máy chủ mà bạn sở hữu, hãy sao chép chúng vào thư mục trước, hoặc chọn môi trường SSH cho các lệnh và giữ kế hoạch trong thư mục.
Yêu cầu agent tạo tệp routing-plan.txt với các định tuyến, các lệnh chuyển hướng và mã trạng thái bạn mong đợi cho từng mục. Kế hoạch là văn bản thuần, bạn có thể chỉnh sửa nó, và đó là danh sách để bạn so sánh với kết quả thực tế vào cuối cùng. Đặt ra một kỳ vọng cho mọi định tuyến và mọi lệnh chuyển hướng, để không có quy tắc nào bị bỏ sót việc kiểm tra. Giữ tệp ngắn gọn và dễ đọc.
Phê duyệt diff cho từng quy tắc, sau đó để Shell chạy lệnh kiểm thử cấu hình trước khi tải lại bất kỳ thứ gì. Ở chế độ Ask first, agent sẽ tạm dừng trước mọi thay đổi, và thẻ kiểm thử sẽ hiển thị mã thoát thực tế và toàn bộ đầu ra. Không bao giờ tải lại trước khi kiểm thử thành công, và hãy giữ bản sao lưu của tệp cũ cho đến khi hành vi mới được xác nhận.
Gửi yêu cầu đến từng địa chỉ bằng lệnh request của bạn, đọc mã trạng thái và tiêu đề Location, và so sánh chúng với kế hoạch của bạn. Nếu một giá trị khác biệt, hãy khôi phục bản sao lưu, tải lại và thay đổi một quy tắc khác. Lặp lại cho đến khi mọi kỳ vọng trong kế hoạch khớp với kết quả, sau đó giữ lại kế hoạch cuối cùng làm hồ sơ ghi lại những gì cấu hình dự định làm.
.3 tệproutes.confđã tảirouting-plan.txtđã lưuyour request commandđã ghi lại# routing plan for my own domain
# one line per rule, written before any change
route 1: host app, path /api, goes to service api
route 2: host app, path /, goes to service web
route 3: host admin, path /, goes to service admin
redirect 1: old page to new page, code 301
redirect 2: www host to bare host, code 301
redirect 3: http to https, code 301
# status to expect after the change
expect 1: app path /api answers with a success code
expect 2: old page answers 301 and gives the new address
# keep the old configuration file as a backup
# end of routing planMỗi dòng là một quy tắc hoặc một kỳ vọng. Được viết trước, kế hoạch cung cấp cho bạn thứ gì đó để so sánh các mã trạng thái thực tế sau mọi thay đổi, và một thay đổi làm sai lệch kỳ vọng rất dễ nhận ra. Các tên miền, đường dẫn và dịch vụ chỉ là ví dụ; hãy thay thế chúng bằng dữ liệu của riêng bạn và giữ kế hoạch bên cạnh cấu hình mà nó mô tả. Từ redirect kèm theo một mã là đủ để agent biết cần viết gì.
Hướng dẫn tự lưu trữ này với một máy chủ proxy ngược phía trước các dịch vụ của bạn bắt đầu bằng việc tìm nơi các quy tắc được lưu trữ. list_dir hiển thị thư mục làm việc, glob liệt kê các tệp trông giống như danh sách định tuyến, và grep tìm kiếm chúng bằng các từ route và redirect. Kết quả là một danh sách ngắn gồm tên tệp và số dòng. Chưa có gì thay đổi. Chọn tệp chứa quy tắc cho tên miền của bạn, mở nó bằng read_file và gửi yêu cầu đến từng địa chỉ bằng lệnh request của bạn để ghi lại mã trạng thái hiện tại. Xem lại danh sách ở chế độ Plan only nếu bạn muốn agent đề xuất thứ tự công việc trước, và lưu các ghi chú bên cạnh kế hoạch định tuyến để các mã trạng thái đầu tiên được ghi lại.
Thay đổi một quy tắc tại một thời điểm, vì một diff nhỏ dễ đánh giá. edit_file đọc tệp, đề xuất dòng mới và hiển thị diff với các dòng được thêm và bị loại bỏ. Khi có câu hỏi về quy tắc chuyển hướng tên miền phụ, agent sẽ hiển thị quy tắc bên cạnh mã mà nó nên trả về, và bạn là người quyết định. Ở chế độ Ask first, không có gì được lưu cho đến khi bạn chấp nhận. Auto-run sẽ lưu ngay lập tức, vì vậy chỉ sử dụng nó trên các tệp bạn có thể khôi phục. Giữ tệp cũ làm bản sao lưu, chấp nhận diff và chuyển sang bước tiếp theo. Từ chối diff nếu một dòng làm bạn ngạc nhiên và yêu cầu một thay đổi nhỏ hơn.
Tải lại với một tệp bị lỗi có thể làm sập một trang web đang hoạt động, vì vậy hãy kiểm thử trước. Shell chạy lệnh kiểm thử cấu hình của bạn, và thành công được đánh giá bằng mã thoát thực tế: mã thành công có nghĩa là tệp đã được phân tích cú pháp, bất kỳ mã nào khác có nghĩa là bạn vẫn giữ cấu hình cũ. Thẻ mở rộng để hiển thị toàn bộ đầu ra, bao gồm số dòng của lỗi. Sửa nó bằng một diff nhỏ khác. Sau khi kiểm thử thành công, hãy tải lại, gửi yêu cầu đến địa chỉ một lần nữa và so sánh các mã trạng thái HTTP của lần chạy cũ và mới. Tự xem xét đầu ra, vì một bài kiểm thử thành công chỉ có nghĩa là cú pháp hợp lệ chứ không có nghĩa là định tuyến là đúng.
Các mã trạng thái được nhóm theo chữ số đầu tiên: 2xx thành công, 3xx chuyển hướng, 4xx lỗi máy khách, 5xx lỗi máy chủ. Đối với proxy, 502 có nghĩa là câu trả lời không hợp lệ từ máy chủ hậu trường, 503 có nghĩa là dịch vụ không khả dụng, 504 có nghĩa là máy chủ hậu trường trả lời quá chậm, và 404 có nghĩa là không tìm thấy. http_get lấy một trang của dịch vụ của bạn, và lệnh request của bạn hiển thị địa chỉ mới của một lệnh chuyển hướng. Nếu một mã khác với kế hoạch của bạn, hãy khôi phục tệp sao lưu, tải lại và kiểm thử lại. Sau đó, thay đổi kế hoạch hoặc quy tắc và lặp lại, một quy tắc mỗi vòng. Một kế hoạch định tuyến ngắn gọn và một tệp sao lưu là tất cả những gì bạn cần để hoàn tác.
