Bash Script Generator

Tính năng nổi bật

• Sinh khung script đầy đủ: shebang, set -euo pipefail, IFS thu hẹp và ba hằng số nhận dạng script
• Chọn kiểu đọc tham số: vòng lặp case có cờ dài như --dry-run, hoặc getopts gọn hơn nhưng chỉ cờ ngắn
• Hàm log chia bốn mức debug, info, warn, error, tự tắt màu khi ghi ra tệp hoặc chạy qua cron
• Bẫy trap dọn thư mục tạm và in ra dòng lỗi khi script dừng bất thường hoặc bị bấm Ctrl+C
• Kiểm tra lệnh phụ thuộc bằng command -v, báo hết các lệnh còn thiếu trong một lượt rồi thoát mã 127
• Khóa flock trên bộ mô tả tệp số 9 để tiến trình thứ hai thoát ngay thay vì chạy chồng lên nhau
• Bốn khối việc dựng sẵn: sao lưu thư mục, đồng bộ rsync, dọn tệp cũ theo số ngày, canh dịch vụ systemd
• Chế độ chạy thử xuyên suốt mọi khối việc, kèm nút chép và nút tải tệp .sh về máy

Vì sao nên bắt đầu từ khung có sẵn thay vì gõ từ đầu

Phần thân của một script vận hành thường chỉ dài mươi dòng, nhưng phần khiến nó chạy an toàn trên máy chủ thì dài gấp năm lần: đọc tham số, in trợ giúp, ghi log kèm dấu thời gian, dọn tệp tạm khi lỗi, kiểm tra máy có đủ lệnh cần dùng chưa, chặn hai bản cùng chạy. Ai cũng biết những phần đó quan trọng, nhưng khi đang vội thì chúng bị bỏ qua đầu tiên, và cái giá phải trả đến muộn: script chạy nửa chừng rồi lỗi, để lại thư mục tạm cả chục gigabyte; cron gọi hai lần trong lúc lần trước chưa xong, hai tiến trình rsync ghi đè lẫn nhau; lệnh chạy trên máy thiếu công cụ nên thất bại im lặng và ba tuần sau mới phát hiện không có bản sao lưu nào. Khung dựng sẵn ở đây gom đúng những phần hay bị bỏ quên đó thành các nút bật tắt. Bạn chọn cái cần, tải tệp về, rồi chỉ viết thêm phần việc riêng của mình. Quan trọng hơn, mã sinh ra có chú thích tiếng Việt ngay tại chỗ, nên khi ba tháng sau bạn hoặc đồng nghiệp mở lại thì vẫn đọc hiểu từng khối làm gì.

Lợi ích khi sử dụng

• •Không phải nhớ cú pháp trap, flock hay getopts mỗi lần viết script mới
• •Chế độ chạy thử có sẵn trong mọi khối việc, thử trước khi để script xóa hay ghi đè thật
• •Mã sinh ra có chú thích tiếng Việt tại chỗ nên người sau đọc lại vẫn hiểu
• •Toàn bộ chạy trong trình duyệt, đường dẫn máy chủ bạn gõ vào không gửi đi đâu cả
• •Tải thẳng tệp .sh, không phải chép qua chép lại rồi lỗi thụt lề

Cách dùng công cụ sinh script Bash

1. 1Đặt tên tệp, mô tả ngắn và tên tác giả ở khối trên cùng, hoặc bấm một trong bốn mẫu dựng sẵn để nạp nhanh cấu hình thường gặp.
2. 2Bật tắt các khối nền tảng: chế độ nghiêm ngặt, kiểu đọc tham số, hàm trợ giúp, hàm log, bẫy dọn dẹp, kiểm tra lệnh phụ thuộc, kiểm tra quyền root và khóa flock.
3. 3Bật các khối việc bạn cần rồi điền đường dẫn thật: thư mục sao lưu, cặp nguồn đích cho rsync, thư mục và số ngày cần dọn, tên dịch vụ systemd cần canh.
4. 4Đọc lại phần xem trước bên phải, nó cập nhật ngay theo từng thay đổi, rồi bấm nút tải để lấy tệp .sh về máy.
5. 5Trên máy chủ, chạy chmod +x để cấp quyền, chạy bash -n để kiểm tra cú pháp, rồi chạy với cờ chạy thử một lần trước khi giao cho cron.

set -euo pipefail: ba lớp bảo vệ và những chỗ chúng gây bất ngờ

Cờ -e bảo bash thoát ngay khi một lệnh trả về mã khác không, thay vì chạy tiếp như không có gì xảy ra. Cờ -u biến việc dùng biến chưa gán thành lỗi, đây chính là lớp chặn cho tình huống kinh điển rm -rf $DIR khi DIR rỗng và đường dẫn rút gọn thành thư mục gốc. Còn pipefail đổi cách tính mã trả về của ống dẫn: mặc định bash chỉ lấy mã của lệnh cuối, nên tar czf x.tar.gz thư-mục chạy hỏng mà đưa qua một lệnh khác thành công thì cả ống dẫn vẫn báo thành công. Ba cờ này nên bật mặc định, nhưng cần biết chúng gây bất ngờ ở đâu. Thứ nhất, -e không có hiệu lực với lệnh nằm trong điều kiện if, trong vế trái của && hay ||, nên đừng dựa vào nó để bắt lỗi ở những chỗ đó. Thứ hai, một lệnh trả mã khác không một cách hợp lệ, ví dụ grep không tìm thấy dòng nào, sẽ làm script dừng oan; cách xử lý là viết grep ... || true khi bạn thật sự chấp nhận kết quả rỗng. Thứ ba, với -u thì việc đọc một mảng rỗng theo cú pháp cũ cũng bị coi là lỗi trên bash cũ, nên khung sinh ra dùng dạng có giá trị mặc định để tránh. Dòng IFS đi kèm thu hẹp ký tự tách từ về xuống dòng và tab, giúp vòng lặp không tự cắt đôi đường dẫn có dấu cách.

getopts hay vòng lặp case: chọn theo việc bạn cần cờ dài hay không

getopts là lệnh dựng sẵn của bash, viết ngắn và tự lo phần gom cờ dính nhau, nên gõ -vn hay -v -n đều hiểu như nhau. Nhược điểm lớn nhất là nó chỉ hiểu cờ một ký tự. Muốn có --dry-run hay --config thì phải viết tay vòng lặp while kèm case, và đó là lý do lựa chọn thứ hai tồn tại. Trong khung sinh ra, chuỗi cờ của getopts bắt đầu bằng dấu hai chấm để tắt thông báo lỗi mặc định của bash, nhờ vậy script tự in thông báo bằng tiếng Việt qua nhánh dấu hỏi và nhánh dấu hai chấm. Sau vòng lặp phải có dòng dịch chuyển theo OPTIND thì các đối số còn lại mới về đúng vị trí. Bản dùng vòng lặp case xử lý được cả bốn dạng viết mà người dùng hay gõ: cờ ngắn -c giá-trị, cờ dài --config giá-trị, cờ dài dính dấu bằng --config=giá-trị, và dấu gạch đôi đứng một mình để báo rằng mọi thứ phía sau là đối số chứ không phải cờ. Nó cũng kiểm tra trường hợp người dùng gõ --config mà quên giá trị, thay vì lẳng lặng nuốt luôn đối số kế tiếp. Nếu script chỉ có bạn dùng, getopts là đủ; nếu script giao cho người khác hoặc ghi vào tài liệu vận hành, hãy chọn vòng lặp case vì cờ dài tự nó đã là lời giải thích.

trap và flock: hai thứ chỉ thấy cần khi đã gặp sự cố

Lệnh trap gắn một hàm vào các sự kiện kết thúc. Khung sinh ra bắt ba tín hiệu: EXIT tức mọi đường thoát, INT tức người dùng bấm Ctrl+C, và TERM tức có ai đó gửi lệnh dừng. Hàm dọn dẹp lấy mã thoát ngay dòng đầu vì chỉ ở đó giá trị còn nguyên, sau đó gỡ chính cái bẫy để tránh gọi lại vòng vo, xóa thư mục tạm rồi thoát lại đúng mã cũ. Có thêm một bẫy nữa gắn vào ERR chỉ để ghi lại số dòng gặp lỗi, nhờ vậy thông báo cuối cùng chỉ đúng chỗ hỏng thay vì để bạn dò cả tệp. Còn flock giải quyết một bài toán khác: cron không quan tâm lần chạy trước xong chưa. Một tác vụ sao lưu hẹn mỗi mười lăm phút nhưng có hôm chạy hai mươi phút sẽ tạo ra hai tiến trình cùng ghi vào một thư mục đích. Cách chống là mở một tệp khóa trên bộ mô tả tệp số 9 rồi xin khóa không chờ; xin không được thì thoát ngay. Chọn bộ mô tả 9 vì các số 0, 1, 2 đã dành cho đầu vào, đầu ra và lỗi chuẩn. Khóa tự nhả khi tiến trình kết thúc, kể cả khi bị buộc dừng, nên không có chuyện khóa mắc kẹt vĩnh viễn.

Bốn khối việc dựng sẵn và những chỗ hay sai khi vận hành thật

Khối sao lưu gói một thư mục thành tệp .tar.gz có gắn dấu thời gian theo định dạng năm tháng ngày giờ phút giây, nhờ đó tên tệp sắp xếp theo bảng chữ cái cũng chính là sắp xếp theo thời gian. Nó chuyển vào thư mục cha rồi mới gói để tệp lưu trữ không chứa cả đường dẫn tuyệt đối bên trong, đây là lỗi khiến nhiều bản sao lưu bung ra sai chỗ. Khối rsync dùng bộ tùy chọn giữ nguyên quyền và thời gian, có nén trên đường truyền, kèm cờ xóa ở đích những gì không còn ở nguồn; cờ xóa này mạnh nên chế độ chạy thử tự thêm cờ chạy thử của chính rsync để bạn xem trước danh sách. Khối dọn tệp cũ đếm số tệp khớp trước rồi mới xóa, và giới hạn độ sâu ở một mức để không lỡ tay quét xuống các thư mục con; lưu ý mốc ngày của find tính theo bội số hai mươi tư giờ trọn vẹn, nên +14 nghĩa là cũ hơn mười bốn ngày tròn chứ không phải trước ngày thứ mười bốn. Khối canh dịch vụ hỏi trạng thái bằng lệnh kiểm tra im lặng, chỉ khởi động lại khi dịch vụ thật sự chết, chờ hai giây rồi hỏi lại lần nữa, và nếu vẫn hỏng thì in hai mươi dòng trạng thái gần nhất để bạn có manh mối.

Đưa script lên máy chủ: quyền, đường dẫn và môi trường của cron

Tệp tải về chưa có quyền chạy, phải cấp bằng chmod +x, thường là 755 cho script dùng chung và 700 nếu bên trong có thông tin nhạy cảm. Nơi đặt hợp lý cho script quản trị là /usr/local/bin hoặc một thư mục riêng của dự án, tránh để trong thư mục người dùng vì cron của root sẽ không đọc được. Trước khi chạy lần đầu, hãy dùng bash -n để kiểm tra cú pháp mà không thực thi lệnh nào, rồi chạy với cờ chạy thử. Cạm bẫy lớn nhất khi chuyển sang cron là môi trường: cron không đọc tệp khởi tạo shell của bạn, biến PATH thường chỉ còn vài thư mục cơ bản, nên lệnh nào cài ở /usr/local/bin có thể không tìm thấy dù gõ trực tiếp trên terminal vẫn chạy. Cách chống là ghi đường dẫn tuyệt đối, hoặc đặt lại PATH ngay đầu script. Kế đến là đầu ra: cron gửi mọi thứ script in ra qua thư nội bộ, thứ mà hầu như không ai đọc, nên hãy chuyển hướng cả đầu ra chuẩn lẫn lỗi chuẩn vào một tệp log bằng hai dấu lớn hơn kèm 2>&1. Cuối cùng là thư mục làm việc: cron bắt đầu ở thư mục nhà, nên mọi đường dẫn tương đối trong script sẽ trỏ sai; khung sinh ra có sẵn hằng số giữ thư mục chứa script để bạn dựa vào đó thay vì dùng đường dẫn tương đối.

Câu hỏi thường gặp (FAQ)

Từ khóa liên quan

• tạo script bash online
• bash script generator
• mẫu script bash chuẩn
• set -euo pipefail nghĩa là gì
• getopts trong bash
• đọc tham số dòng lệnh bash
• hàm log có màu trong bash
• trap bash dọn dẹp khi thoát
• flock chống chạy trùng cron
• script sao lưu thư mục tự động
• script rsync đồng bộ máy chủ
• xóa file cũ hơn 30 ngày bằng find
• script kiểm tra dịch vụ systemd
• viết script chạy cron trên vps
• kiểm tra lệnh tồn tại trong bash
• shebang usr bin env bash
• dry run trong shell script
• chmod +x cấp quyền chạy script
• bash -n kiểm tra cú pháp script
• template shell script vận hành