Truy cập MinIO Console và Tạo Bucket đầu tiên
MinIO cung cấp giao diện quản trị trực quan (Console) chạy trên cổng 9001 theo mặc định khi triển khai qua Docker Compose. Để truy cập, bạn cần biết địa chỉ IP công cộng hoặc địa chỉ localhost nếu đang làm việc trên cùng một máy chủ.
Mở trình duyệt web (Chrome, Firefox, hoặc Edge) trên máy client hoặc trực tiếp trên server Ubuntu 24.04.
Đánh địa chỉ URL sau vào thanh địa chỉ, thay thế YOUR_SERVER_IP bằng IP thực tế của server Ubuntu:
http://YOUR_SERVER_IP:9001
Kết quả mong đợi: Trình duyệt hiển thị màn hình đăng nhập MinIO Console với logo MinIO và hai ô nhập liệu Username và Password.
Nhập thông tin đăng nhập tương ứng với biến môi trường bạn đã cấu hình trong docker-compose.yml ở Phần 3 (mặc định thường là minioadmin).
Username: minioadmin
Password: minioadmin
Nhấn nút Sign In. Kết quả mong đợi: Bạn được chuyển đến trang Dashboard chính của MinIO Console, hiển thị các chỉ số tổng quan như Usage, Buckets, và Policies.
Tạo Bucket và Cấu hình Quyền truy cập
Trong MinIO, Bucket là container chứa các object (file). Bạn cần tạo bucket trước khi upload dữ liệu. Giao diện Console cho phép tạo bucket và thiết lập quyền ngay lập tức.
Trên trang Dashboard Console, nhấn vào nút Create Bucket (thường nằm ở góc trên bên phải hoặc danh sách trống).
Trong hộp thoại hiện ra, điền thông tin sau:
- Bucket name:
my-first-bucket
- Region:
us-east-1 (hoặc để mặc định)
- Bucket policy: Chọn
Private (Mặc định, chỉ người có quyền mới truy cập) hoặc Public (Cho phép bất kỳ ai có link đều tải file).
Để minh họa, hãy chọn Private để đảm bảo bảo mật cơ bản. Nhấn nút Create.
Kết quả mong đợi: Bucket my-first-bucket xuất hiện trong danh sách Buckets trên Dashboard với trạng thái Private.
Để kiểm tra quyền truy cập, hãy thử upload một file test nhỏ từ máy client vào bucket này. Nhấn vào tên bucket my-first-bucket, sau đó kéo thả file hoặc nhấn Upload để chọn file từ máy tính.
Thao tác này chỉ thành công nếu bạn đang đăng nhập bằng user có quyền (minioadmin). Nếu bạn cấu hình bucket là Public và chia sẻ link, người lạ cũng có thể tải về nhưng không thể upload nếu không có quyền.
Verify kết quả: Sau khi upload thành công, file sẽ hiện trong danh sách Objects của bucket với trạng thái Uploaded. Bạn có thể click vào file để xem nội dung (nếu là text) hoặc tải xuống (Download).
Cài đặt MinIO Client (mc) trên Ubuntu Host
MinIO Client (mc) là công cụ dòng lệnh mạnh mẽ để quản lý object storage, tương tự như AWS CLI. Việc cài đặt mc trên Ubuntu host giúp bạn tự động hóa quy trình upload/download qua script hoặc thao tác nhanh trên terminal.
MinIO cung cấp script cài đặt tự động. Bạn cần tải script này về và chạy nó với quyền root hoặc sudo để cài đặt vào thư mục hệ thống /usr/local/bin.
Thực thi lệnh sau trên terminal của Ubuntu 24.04:
curl https://dl.min.io/client/mc/release/linux-amd64/mc >/usr/local/bin/mc
sudo chmod +x /usr/local/bin/mc
Lệnh đầu tiên tải binary file của mc từ server phân phối chính thức của MinIO. Lệnh thứ hai cấp quyền thực thi (executable) cho file này.
Kết quả mong đợi: Terminal không báo lỗi và bạn có thể chạy lệnh mc version để kiểm tra.
Thực thi lệnh kiểm tra sau để xác nhận cài đặt thành công:
mc version
Kết quả mong đợi: Hiển thị phiên bản của mc, ví dụ: mc version RELEASE.2024-xx-xx. Nếu thấy lỗi command not found, hãy thử chạy lại sudo mc version hoặc kiểm tra biến PATH.
Cấu hình Alias và Test Upload/Download
Để mc giao tiếp với MinIO server, bạn cần tạo một "Alias" (biệt danh) chứa thông tin kết nối: endpoint, access key, và secret key. Điều này giúp bạn không phải gõ lại thông tin dài dòng trong mỗi lệnh.
Sử dụng lệnh mc alias set để cấu hình. Thay thế YOUR_SERVER_IP bằng IP server MinIO của bạn. Nếu đang chạy trên localhost, dùng localhost.
mc alias set myminio http://YOUR_SERVER_IP:9000 minioadmin minioadmin
Cấu trúc lệnh: mc alias set [tên_alias] [endpoint] [access_key] [secret_key].
Kết quả mong đợi: mc hiển thị thông báo Done! hoặc không có lỗi. Alias myminio đã được lưu vào file cấu hình ~/.mc/config.json.
Để kiểm tra alias có hoạt động không, hãy liệt kê các bucket trên server thông qua alias này:
mc ls myminio
Kết quả mong đợi: Danh sách các bucket hiện có (bao gồm my-first-bucket bạn vừa tạo) được hiển thị với ngày giờ tạo.
Thực hiện Upload và Download file
Bây giờ bạn đã có thể sử dụng mc để quản lý file. Trước tiên, hãy tạo một file test nhỏ trên Ubuntu host để làm nguồn upload.
echo "Hello MinIO from Ubuntu 24.04 CLI" > test-file.txt
Lệnh này tạo file test-file.txt với nội dung chuỗi ký tự đơn giản trong thư mục hiện tại.
Thực hiện lệnh upload file này vào bucket my-first-bucket của MinIO:
mc cp test-file.txt myminio/my-first-bucket/
Cú pháp: mc cp [nguồn] [đích]. Đích là [alias]/[bucket-name]/.
Kết quả mong đợi: mc hiển thị thông báo thành công, ví dụ: 35 B / 35 B [--------------------------] 100.00% 0s và thông báo test-file.txt được copy thành công.
Để xác minh file đã nằm trên server, bạn có thể dùng lệnh liệt kê chi tiết:
mc ls myminio/my-first-bucket/
Kết quả mong đợi: File test-file.txt xuất hiện trong danh sách.
Bây giờ, hãy thử tải file đó về một thư mục khác (ví dụ /tmp) để kiểm tra tính năng download:
mc cp myminio/my-first-bucket/test-file.txt /tmp/test-file-downloaded.txt
Lệnh này copy file từ MinIO về hệ thống file local.
Kết quả mong đợi: mc hiển thị quá trình copy thành công. Bạn có thể kiểm tra nội dung file tải về bằng lệnh:
cat /tmp/test-file-downloaded.txt
Kết quả mong đợi: Nội dung hiển thị đúng là Hello MinIO from Ubuntu 24.04 CLI.
Verify kết quả cuối cùng: Bạn đã thành công truy cập Console, tạo bucket, cài đặt mc, cấu hình alias, và thực hiện được đầy đủ quy trình upload/download file giữa host Ubuntu và MinIO server.
Điều hướng series:
Mục lục: Series: Triển khai Database Object Storage với MinIO và Ubuntu 24.04
« Phần 3: Triển khai MinIO Single Node với Docker Compose
Phần 5: Tối ưu hóa hiệu năng và bảo mật cho MinIO »