Chuẩn bị workspace thực hành

Vì sao cần học

Mọi bài thực hành trong khóa đều chạy trên môi trường của bạn và được kiểm tra bằng agent kdc. Trước khi học Linux, cần một chỗ làm bài tách biệt và một agent đã liên kết để kiểm tra kết quả.

Mục tiêu

• Liên kết agent với tài khoản, bật kiểm tra từ xa và hiểu agent gửi gì về nền tảng.
• Tạo workspace riêng cho bài thực hành.
• Đọc và đặt quyền file bằng chmod, giải thích ý nghĩa quyền 600.

Điều kiện tiên quyết

• Python 3.10 trở lên. Chạy python3 --version: python3 gọi Python, còn --version yêu cầu in phiên bản rồi thoát. Kết quả cần là Python 3.10 hoặc mới hơn.
• Đã đăng nhập trên web.

Mental model

Agent chạy outbound. Agent trên máy bạn tự hỏi nền tảng xem có yêu cầu kiểm tra không, chạy các check cố định rồi gửi lại kết quả đạt/chưa đạt. Nền tảng không SSH vào máy bạn và không gửi lệnh shell tùy ý. Agent không gửi nội dung file hay log.

Lab root. Agent chỉ đọc file bài tập trong một thư mục gốc, mặc định ~/kdc-labs. Đường dẫn trong bài như workspace/README.md được tính từ lab root.

Quyền file. Mỗi file có ba nhóm quyền cho chủ sở hữu (user), nhóm (group) và người khác (other), mỗi nhóm gồm đọc r=4, ghi w=2, thực thi x=1. Quyền 600 nghĩa là chủ file đọc/ghi được, mọi tài khoản khác không làm gì được. File chứa cấu hình nhạy cảm nên có quyền này.

Thực hành (Guided Lab)

Bấm biểu tượng ⓘ ở góc trên bên phải khối lệnh để xem giải thích lệnh và tham số. Bấm lần nữa để thu gọn.

1. Tải agent về máy thực hành

Bạn chỉ cần một file Python độc lập để kiểm tra bài tập. Mở Servers của tôi, bấm Tải agent kdc.py, hoặc sao chép nhóm lệnh tải/liên kết trên trang đó; địa chỉ trong nhóm lệnh được điền theo web bạn đang mở.

Nếu dùng terminal, ví dụ dưới đây dành cho nền tảng đang chạy local. Nếu học trên web trực tuyến, thay giá trị KDC_WEB_URL bằng địa chỉ web khóa học trên thanh địa chỉ, chỉ lấy phần https://<tên-miền> (kèm cổng nếu có), không thêm /lessons/... hay /api.

KDC_WEB_URL='http://127.0.0.1:3000'
curl -fL "$KDC_WEB_URL/downloads/kdc.py" -o ~/kdc.py
python3 ~/kdc.py --help

~ là home của tài khoản hiện tại. File agent nằm ở ~/kdc.py, thư mục bài tập là ~/kdc-labs; hai vị trí có vai trò khác nhau. Vì dùng đường dẫn bắt đầu bằng ~, bạn có thể chạy agent từ bất kỳ thư mục nào. Không cần cài package Python bằng pip.

Nếu tải bằng trình duyệt, file thường nằm trong Downloads. Trên Linux/macOS, khi file có đúng tên kdc.py ở đó, chuyển về home bằng:

mv ~/Downloads/kdc.py ~/kdc.py
python3 ~/kdc.py --help

Chỉnh đường dẫn nguồn nếu trình duyệt lưu ở chỗ khác. Đích đã có sẽ bị thay thế. Với WSL2, tải bằng curl ngay trong terminal WSL để có file trong home Linux.

2. Liên kết agent

Trong cùng terminal đã đặt KDC_WEB_URL, chạy:

mkdir -p ~/kdc-labs
python3 ~/kdc.py connect \
  --api "$KDC_WEB_URL/api" \
  --name "Laptop của tôi" \
  --lab-root ~/kdc-labs

CLI in ra mã liên kết và mã xác nhận. Mở trang Servers, nhập hai mã, đợi CLI báo đã liên kết. Trong khung Server đã liên kết, tích ô Kiểm tra từ xa dưới tên máy đó. Nếu chưa thấy máy, bấm Làm mới.

Giữ agent chạy trong terminal này:

python3 ~/kdc.py run

run dùng cấu hình đã lưu khi connect, liên tục chờ yêu cầu kiểm tra và gửi kết quả. Khi thấy Agent sẵn sàng. Lab root: ..., giữ terminal mở. Ctrl+C dừng agent. Mở terminal thứ hai để làm các bước tiếp theo; không đổi thư mục trong terminal đang chạy agent.

3. Tạo workspace

mkdir -p ~/kdc-labs/workspace
cd ~/kdc-labs/workspace

4. Tạo README và file cấu hình

Nếu chưa có các file này, tạo bằng các lệnh sau. Nếu đã có, dùng trình soạn thảo để sửa nội dung vì dấu > sẽ ghi đè file hiện có.

printf 'Workspace thực hành của tôi\nKDC-LAB\n' > README.md
printf 'APP_ENV=practice\n' > config.env
cat README.md
cat config.env

README phải có dòng KDC-LAB; cấu hình chỉ dùng giá trị mẫu APP_ENV=practice, không ghi secret thật.

5. Xem quyền hiện tại

ls -l config.env

Ví dụ, nếu file hiện có quyền 644, bạn thấy:

-rw-r--r--  1  <user>  <group>  <size>  <date>  config.env

Các phần <...> trong ví dụ là chỗ minh họa, không phải lệnh cần gõ. Ký tự đầu - nghĩa là file thường; chín ký tự tiếp theo chia thành rw- (chủ sở hữu), r-- (group), r-- (người khác). Quyền ban đầu có thể khác tùy thiết lập máy.

Bạn có thể bấm Kiểm tra kết quả ở thời điểm này để xem tiêu chí quyền file trước khi sửa.

6. Đặt quyền 600 rồi kiểm tra lại

chmod 600 config.env
ls -l config.env

Kết quả ls -l sau khi đổi quyền cần bắt đầu bằng:

-rw-------

Chỉ chủ sở hữu đọc và sửa được file. Không cần sudo vì bạn tạo file bằng tài khoản của mình. Chỉ áp dụng 600 cho file này: thư mục cần quyền x để đi vào.

Tự kiểm tra (Verification)

ls -l ~/kdc-labs/workspace
cat ~/kdc-labs/workspace/README.md

Dòng của config.env phải bắt đầu bằng -rw-------, README phải có KDC-LAB.

Chọn server và bấm Kiểm tra kết quả. Nếu server chưa có trong danh sách sau khi bật Kiểm tra từ xa, tải lại trang bài học.

Tự tra cứu lệnh và tham số

man chmod
man ls
man mkdir

man mở trang hướng dẫn của lệnh đứng sau nó. Dùng phím mũi tên để cuộn, gõ / rồi tên tùy chọn để tìm, nhấn q để thoát. Một tùy chọn chỉ có nghĩa trong lệnh đang dùng: -p của mkdir tạo thư mục cha, nhưng -p ở một lệnh khác có thể làm việc hoàn toàn khác.

Lỗi thường gặp

• Agent báo không tìm thấy file bài tập: lab root khác với thư mục bạn tạo. Chạy python3 ~/kdc.py status để xem lab root; status chỉ in cấu hình liên kết, không chạy kiểm tra.
• can't open file .../kdc.py: chưa tải agent hoặc lưu khác vị trí. Chạy ls -l ~/kdc.py để kiểm tra; nếu chưa có, tải lại theo bước 1. Dùng python3 ~/kdc.py run thay cho đường dẫn nằm trong mã nguồn dự án.
• curl báo lỗi hoặc Python báo cú pháp HTML: kiểm tra đúng URL web và đường dẫn /downloads/kdc.py, tải lại bằng curl -fL. Với agent trên VM mà web chạy trên laptop, xem cách dùng SSH tunnel ở bài VM Linux.
• ls hoặc chmod báo No such file or directory: file chưa có hoặc terminal đang ở sai thư mục. Chạy pwd, rồi ls -l ~/kdc-labs/workspace/config.env để xác định vị trí file.
• Bấm kiểm tra mà job chờ mãi: agent chưa chạy, hoặc chưa bật Kiểm tra từ xa trên trang Servers.
• chmod 600 trên thư mục làm mất quyền vào thư mục, vì thư mục cần quyền x để truy cập. Chỉ đặt 600 cho file.

Bảo mật

Token của agent nằm ở ~/.config/kdc/device.json với quyền 600, hết hạn sau 30 ngày. Thu hồi server trên trang Servers khi không dùng nữa.

Tài liệu chính thức

• GNU Coreutils — mkdir · ls · chmod
• Bash — chuyển hướng đầu ra
• curl — hướng dẫn tùy chọn tải file
• chmod(1) — Linux manual page
• Red Hat Enterprise Linux 10 documentation