Máy chủ, cơ sở dữ liệu và bộ nhớ đệm

Đây là tài liệu hướng dẫn dùng MixEngine qua dòng lệnh mix. Nếu bạn muốn thao tác bằng giao diện đồ họa cho dễ hơn, hãy tải ứng dụng MixDB tại https://lab.mixnz.com/#mixdb. MixDB làm việc trên cùng một MixEngine, nên mọi khái niệm trong cẩm nang này vẫn áp dụng.

Có hai từ cần phân biệt, đúng như cách MixEngine phân biệt chúng.

Package là một chương trình MixEngine biết cách chạy, ví dụ Caddy, MariaDB, Redis. Cài package chỉ là chép một bản của nó vào thư mục riêng của MixEngine, không làm gì khác.

Service là một instance đang chạy của package: có cổng, thư mục dữ liệu, cấu hình sinh tự động, log và trạng thái riêng. mariadb@main và mariadb@legacy là hai service của cùng một package, với cổng khác nhau, dữ liệu khác nhau, và có thể cả phiên bản khác nhau.

Có những gì

Không có gì tự xuất hiện. MixEngine mới cài chưa có web server nào cho tới khi bạn cài. Chữ "mặc định" ở bảng trên nghĩa là thứ dự án này khuyên dùng khi có nhiều lựa chọn, chứ không phải thứ đã có sẵn.

Cài và tạo

mix package available
mix package install mariadb 12.3.2
mix service create mariadb@main 12.3.2

Phần trước dấu @ trong id service là tên package mà service đó là instance của. Vì thế mix service create không cần thêm tham số riêng cho package. Phần sau dấu @ là do bạn đặt, dùng để phân biệt hai service với nhau; MixEngine không gán ý nghĩa gì cho chữ đó. Caddy chỉ chạy một lần cho cả home MixEngine, nên service của nó chỉ đơn giản là caddy, không có @.

Id không đổi được sau khi tạo, vì nó cũng là tên thư mục cấu hình sinh ra, thư mục log, socket, và địa chỉ lưu mật khẩu. Muốn đổi tên thì tạo service mới rồi xóa cái cũ; dữ liệu vẫn được giữ lại.

Các cờ hữu ích của mix service create:

Ai được cổng 3306

MariaDB và MySQL cùng muốn một cổng, và hai instance của cùng một loại cũng vậy. Quy tắc chỉ có một: ai tạo trước thì được trước. Service đầu tiên xin 3306 sẽ được nó; service tiếp theo nhận cổng trống đầu tiên phía trên. MixEngine báo lại cổng nó đã chọn, vì cổng bạn không tự chọn thì bạn cần được cho biết.

Nếu bạn ghi rõ cổng, MixEngine dùng đúng cổng đó, không cấp phát gì thêm.

Mỗi thư mục dữ liệu chỉ một service

mix service create từ chối --data-dir mà một service khác đang giữ, và nêu tên service đó. Hai server cùng ghi lên một bộ file sẽ làm hỏng chúng, và cái giá đó rơi vào dữ liệu của bạn chứ không phải vào một lần khởi động thất bại.

Chạy service

mix service list
mix service status mariadb@main
mix service start mariadb@main
mix service stop mariadb@main
mix service logs mariadb@main --follow

mix service status bắt buộc có id, trong khi start và các lệnh còn lại thì id là tùy chọn. Hỏi status mà không nói của cái gì thì thực ra là gõ nhầm list, và nếu trả lời bằng một danh sách thì sẽ che mất lỗi đó.

Xóa service sẽ xóa bản ghi và cấu hình sinh ra từ nó, nhưng không bao giờ xóa dữ liệu, vì đó là cơ sở dữ liệu của ai đó. Kết quả trả về nêu rõ thư mục còn để lại, để không ai phải đi tìm:

mix service delete mariadb@legacy

Cơ sở dữ liệu và tài khoản

Tạo cơ sở dữ liệu chỉ cần một lệnh, và lệnh này tự khởi động server nếu nó chưa chạy:

mix database create mariadb@main --name blog
mix database create mariadb@main --name shop --user shop_app

Mặc định không in mật khẩu ra. Mật khẩu được sinh ngẫu nhiên rồi lưu vào credential store của hệ điều hành: Credential Manager trên Windows, Keychain trên macOS, Secret Service trên Linux. Thứ được in ra là địa chỉ nơi nó được lưu, theo đúng tên và key của store. Nhờ vậy một client có thể nói với bạn "đã lưu trong credential store dưới tên …" mà không ai phải hardcode quy tắc đặt tên của MixEngine.

Khi project cần chính mật khẩu đó, thường là để điền vào file .env, mix database credentials sẽ in nó ra. Cờ --password trên lệnh create cho bạn tự chọn mật khẩu thay vì để MixEngine sinh:

mix database credentials mariadb@main --user blog
mix database create mariadb@main --name shop --user shop-app --password

Không kèm giá trị thì --password sẽ hỏi và đọc một dòng từ standard input, nên dùng qua pipe cũng được: echo secret | mix database create … --password. Chọn mật khẩu cho tài khoản đã tạo trước đó sẽ thay đổi giá trị đang lưu, và server được đồng bộ lại theo đúng cách nó vẫn làm khi mật khẩu bị lệch. Tuy nhiên, một tài khoản có sẵn trên server mà MixEngine không giữ credential nào thì vẫn bị từ chối, kể cả khi bạn đưa đúng mật khẩu. Biết mật khẩu không có nghĩa tài khoản đó là của bạn.

Để mở cơ sở dữ liệu bằng ứng dụng trên máy:

mix database client mariadb@main   # what is installed, and where this system looked
mix database open mariadb@main     # open it

client chỉ đọc: không khởi động gì, không mở gì. "Chưa cài client nào" là một câu trả lời chứ không phải lỗi; nó cho biết MixEngine đã tìm ở đâu và có thể tải client ở đâu.

open khởi động instance nếu nó đang dừng, đọc mật khẩu từ credential store ngay lúc đó, rồi đưa cho client qua biến môi trường của chính tiến trình client. Mật khẩu không bao giờ được in ra, không nằm trong tham số, nên cũng không bao giờ lọt vào lịch sử shell.

Service được dùng bao nhiêu tài nguyên, và khi nào thì dừng

mix service limits mariadb@main
mix service limits mariadb@main set --memory 512 --cpu 50
mix service idle mariadb@main --after 30m

limits không kèm lệnh con thì đọc; set thay thế; clear xóa. set thay thế tất cả các trường, không chỉ trường bạn nêu. Ví dụ set --cpu 50 sẽ xóa luôn giới hạn bộ nhớ đang có. Vì thế lệnh in ra cả ba trường của kết quả, để giới hạn bị xóa hiện ngay trên màn hình chứ không thành bất ngờ về sau. Hệ điều hành thực sự áp đặt được gì thì mỗi hệ mỗi khác, và câu trả lời sẽ nói bạn đang có loại nào trong hai loại: giới hạn cứng là một bức tường, chạm tới là service bị kill hoặc lần cấp phát tiếp theo thất bại; giới hạn cảnh báo là một vạch được theo dõi, service có thể vượt qua, khi đó MixEngine cảnh báo và, nếu recipe cho phép, khởi động lại. Nếu vẽ một giới hạn cảnh báo như thể nó là một bảo đảm thì đó là nói dối về dữ liệu của bạn.

idle cho biết khi nào service bị dừng vì không ai dùng, và hiện tại cái gì đang giữ nó mở. Mặc định không có gì tự dừng: service đã dừng thì cứ dừng cho tới khi bạn khởi động lại, nên bật tính năng này là lựa chọn bạn đưa ra cho từng service.

Cấu hình sinh tự động

MixEngine tự viết cấu hình cho mọi service nó chạy, từ những gì nó biết. Các file đó dùng xong bỏ: chúng được sinh lại, không bao giờ được đọc ngược lại. Nên không có gì trong đó để bạn sửa, và không có gì phải giữ cho đồng bộ. Nếu một thiết lập bạn cần chưa có cờ tương ứng, đó là thiếu sót của MixEngine, không phải lời mời bạn sửa file.

Trang này ở dạng Markdown: https://mixnz.github.io/mixengine/vi/services.md