Bash trên Linux: Đọc đúng mã thoát pipeline với pipefail

Một tác vụ tự động có thể báo thành công dù lệnh đầu tiên trong chuỗi đã thất bại. Khi nối lệnh bằng dấu |, cần biết Bash tính mã thoát của cả pipeline như thế nào. Nhìn dòng cuối của log chưa đủ để kết luận dữ liệu đã được xử lý đúng.

1. Pipeline không mặc định phản ánh mọi lỗi

Theo tài liệu Bash về pipeline, mặc định trạng thái pipeline là trạng thái của lệnh cuối. Khi bật pipefail, Bash lấy mã khác 0 của lệnh thất bại ở vị trí bên phải nhất, hoặc 0 nếu mọi lệnh thành công.

Mã 0 thường biểu thị thành công; mã khác 0 cần được diễn giải theo chương trình cụ thể. Đừng mặc định mọi giá trị khác 0 đều là cùng một loại sự cố.

2. Thử bằng lệnh không ghi dữ liệu

Chạy mỗi ví dụ trong một tiến trình Bash con như bên dưới để không thay tùy chọn của phiên làm việc chính. Ví dụ chỉ in kết quả, không đọc dữ liệu production.

bash -c 'set +e; set +o pipefail; false | true; printf "status=%s\n" "$?"'
bash -c 'set +e; set -o pipefail; false | true; printf "status=%s\n" "$?"'

Kết quả mong đợi lần lượt là status=0 và status=1. Lệnh true cuối pipeline thành công trong cả hai trường hợp; pipefail thay cách tổng hợp trạng thái, không làm false trở thành thành công.

3. Lưu mã thoát ngay sau lệnh cần kiểm tra

$? phản ánh lệnh vừa chạy. Nếu in một thông báo trước khi lưu nó, bạn có thể đang đọc mã của lệnh in thay vì pipeline. Trong script Bash, có thể lưu ngay:

set -o pipefail
if false | true; then
  printf 'Pipeline succeeded\n'
else
  pipeline_status=$?
  printf 'Pipeline failed: %s\n' "$pipeline_status" >&2
fi

Đây là minh họa xử lý trạng thái bằng if. Với chương trình thật, nhánh lỗi còn phải quyết định dừng, thử lại hay báo người vận hành. Chỉ in thông báo không tự làm toàn bộ script trả mã thất bại; cần chủ động trả trạng thái phù hợp ở điểm kết thúc tác vụ.

4. pipefail không thay cho chính sách lỗi

Một bộ lọc có thể dùng mã khác 0 để báo không tìm thấy kết quả; một bên đọc dừng sớm cũng có thể làm bên ghi nhận tín hiệu khi pipe đóng. Hãy đọc quy ước của từng công cụ trước khi biến mọi mã khác 0 thành cảnh báo khẩn cấp.

Đừng đồng nhất pipefail với set -e. Tùy chọn -e có những ngoại lệ theo ngữ cảnh, được mô tả trong tài liệu set của Bash. Một dòng thiết lập ở đầu file không thay thế việc thử từng nhánh lỗi và kiểm tra kết quả đầu ra.

5. Checklist cho tác vụ Linux tự động

• Script chạy bằng Bash đúng như thiết kế, không vô tình dùng sh.
• Có thử trường hợp lệnh đầu thất bại nhưng lệnh cuối thành công.
• Mã thoát được giữ trước khi chạy lệnh log khác.
• “Không có dữ liệu” được phân biệt với “không đọc được dữ liệu”.
• Tác vụ chỉ báo thành công sau khi kiểm tra đầu ra cần thiết, không chỉ vì file log đã được tạo.
• Nhánh thất bại trả trạng thái để bộ lập lịch có thể nhận biết.

pipefail giúp nhìn thấy lỗi bị lệnh cuối che khuất, nhưng kết luận thành công vẫn cần dựa trên cả mã thoát và điều kiện hoàn thành thực tế của công việc.