Cách giữ kế hoạch địa chỉ IPv6 cho VPN còn dễ đọc sau một năm
Một kế hoạch dễ đọc nói rõ tiền tố nào thuộc về trang nào và câu trả lời quay về thế nào. Ghi vai trò, ký hiệu, ủy quyền và tuyến quay về bên cạnh từng mục.
Hai câu hỏi quyết định một kế hoạch địa chỉ có xứng chỗ hay không: tiền tố nào thuộc về trang nào, và một câu trả lời thoát khỏi trang đó bằng cách nào. Trả lời cả hai trong một lượt và người bảo trì có thể đổi một peer mà không phải hỏi ai. Mọi thứ khác trong tài liệu tồn tại để chống đỡ hai câu trả lời ấy. Thứ không chống đỡ được câu nào là trang trí.
Người đọc phải trả lời gì trước khi chạm vào một peer
Nén làm địa chỉ trông gọn gàng, và gọn gàng không phải cấu trúc. Cấu trúc là biết dải nào nhà cung cấp đã ủy quyền, dải nào bạn chọn, dải nào là bể máy khách và dải nào nằm sau một trang.
Hãy viết cho đồng nghiệp sẽ gia nhập quý tới và phải thêm một trang thứ hai. Không gì trên trang cho họ biết tiền tố đến từ đâu trừ khi mục đó nói ra. Bỏ qua điều đó và thay đổi đầu tiên trở thành khảo cổ học.
Mỗi dòng của kế hoạch phải mang gì
Bốn trường làm một mục có thể kiểm tra được: độ dài tiền tố, chủ sở hữu, lưu lượng đi đâu tiếp theo và thành phần nào phân phát giá trị. Đối chiếu chúng với cấu hình đang chạy và mọi bất đồng tự lộ ra. Một bước nhảy trỏ tới đường hầm đã bị xóa tháng trước trông sai ngay thay vì lẫn vào xung quanh.
Giữ các vai trò trên dòng riêng ngay cả khi hai vai trò đang chia sẻ một tiền tố hôm nay. Gộp chúng lại khiến một lần tách về sau đọc như một phân bổ mới chứ không phải bản sửa.
| Entry | Fields to record | Why a reviewer needs it |
|---|---|---|
| Endpoint addresses | Prefix, owning side, session initiator | Firewall rules and peer config both read it |
| Tunnel interfaces | Prefix and length, next hop, interface name | Shows the path a packet actually takes |
| Client allocations | Pool range, size, distributing component | Shows room left before a redesign |
| Downstream networks | Prefix, site label, return route | Explains a reply that never arrives |
Nơi văn bản chuẩn và cú pháp cấu hình tách khỏi nhau
RFC 5952 ấn định một dạng văn bản duy nhất cho một địa chỉ: chữ thường, không có số không ở đầu và chuỗi nhóm không dài nhất được nén đúng một lần. Dùng nó trong ghi chú, phiếu và nhật ký thay đổi để hai tài liệu so sánh được mà không cần chuyển đổi. Người đọc gặp hai cách viết của cùng một địa chỉ bắt đầu tìm một khác biệt không tồn tại. Tính nhất quán ở đây rẻ và nó loại bỏ cả một lớp báo động sai.
Tệp cấu hình tuân theo quy tắc riêng của chúng, và đó không phải quy tắc dễ đọc. Một địa chỉ ghép với cổng cần ngoặc vuông ngay cả khi địa chỉ trần không cần, và bản sao từ ghi chú sang tệp cấu hình làm mất khác biệt đó mà không cảnh báo. Hãy đặt tên cho dạng mà mỗi trường dùng, nếu không kế hoạch gây ra đúng lỗi chép mà nó phải ngăn.
Hai ký hiệu đều ổn miễn mỗi cái được dán nhãn. Chính sự trộn lẫn không nhãn mời gọi sai sót.
Nơi các dải chồng lấn và tuyến quay về thiếu xuất hiện
Chồng lấn sống lâu hơn các lỗi khác vì không gì trông sai cho đến khi hai trang cùng trả lời một dải. Dán nhãn trang và tạo tiền tố duy nhất cục bộ theo quy trình đã ghi lại thay vì sao chép một ví dụ.
Danh sách máy khách không bao giờ giải thích câu trả lời đi theo hướng nào. Ghi tuyến quay về của cổng LAN bên cạnh dải peer mà đường hầm mang, và bản ghi giải thích một mạng con từ xa nhận yêu cầu rồi im lặng. Chạy các kiểm tra bên dưới trên máy và so với mục ghi. Một kế hoạch mâu thuẫn với ip -6 route là kế hoạch mà người ta thôi đọc.
ip -6 route show default
ip -6 route get 2001:db8:2::10
ip -6 addr show dev wg0
Khả năng tiếp cận không phải quyền, và một tiền tố không bao giờ ngụ ý chính sách. Viết quyền truy cập dự định bên cạnh tuyến mà nó áp dụng. Nếu không, người đọc tiếp theo coi một địa chỉ trong kế hoạch là quyền chạm tới mọi dịch vụ phía sau nó.
Kế hoạch sống sót qua trang thứ ba thế nào
Đánh dấu mỗi tiền tố là đã ủy quyền, phân bổ cục bộ hoặc định tuyến theo cách khác. Với mọi thứ có thể di chuyển, hãy nêu tiến trình di chuyển nó. Sau đó liệt kê các bản ghi DNS và quy tắc tường lửa phải đổi trong cùng khung giờ, vì một cập nhật tiền tố dừng ở bộ định tuyến là mới xong một nửa.
Sau một thay đổi, hãy chạm tới một tài nguyên sau mọi ranh giới mà thay đổi đã đụng tới trước khi sửa tài liệu. Một kế hoạch mô tả mạng của tháng trước còn tệ hơn không có, vì người ta tin vào nó. Giữ các phân bổ đã thu hồi trong danh sách kèm ngày chúng biến mất để không ai phát hành lại nhầm. Bí mật nằm ngoài tệp; kế hoạch giải thích mạng, không mở nó ra.
Lưu kế hoạch ở nơi các thay đổi được xem xét, bên cạnh cấu hình mà nó mô tả. Một tài liệu không ai đọc lại thối nhanh hơn mạng mà nó lập bản đồ.