Băng hà
Tiếng Việt

Nhà phát triển

Bắt đầu nhanh: từ đăng ký đến máy chủ đầu tiên

Máy chủ được quản lý bằng API CloudStack tiêu chuẩn, nên dùng ngay được công cụ dòng lệnh cmk và Claude Code.

  1. Tạo tài khoản

    Đăng ký, xác minh email và hoàn tất xác minh danh tính. Sau khi được duyệt, tài khoản bảng điều khiển đám mây sẽ được mở và bạn có thể nạp tiền.

    Tạo tài khoản

  2. Tạo khóa API

    Mở bảng điều khiển đám mây từ trang tài khoản, vào hồ sơ ở menu góc trên bên phải và chọn “Generate keys”. Bạn sẽ nhận được API key và secret key.

  3. Cài đặt và cấu hình cmk

    cmk (CloudMonkey) là công cụ dòng lệnh chính thức của CloudStack. Tải bản cho hệ điều hành của bạn rồi trỏ tới SOFT Cloud. Khóa được lưu trong ~/.cmk/config trên máy của bạn.

    # https://github.com/apache/cloudstack-cloudmonkey/releases
    cmk set url https://console.soft.cc/client/api
    cmk set apikey    <API Key>
    cmk set secretkey <Secret Key>
    cmk sync
  4. Khởi tạo máy chủ đầu tiên

    Liệt kê vùng, cấu hình và image rồi tạo máy. Phí được trừ theo giờ từ số dư. Để SSH từ bên ngoài, hãy gán IP công cộng và quy tắc chuyển tiếp cổng trong bảng điều khiển. Image chỉ nhận khóa SSH; người dùng đăng nhập là ubuntu, debian hoặc rocky tùy image.

    cmk register sshkeypair name=me publickey="$(cat ~/.ssh/id_ed25519.pub)"
    cmk list zones filter=id,name
    cmk list serviceofferings filter=id,name,cpunumber,memory
    cmk list templates templatefilter=executable filter=id,name
    cmk deploy virtualmachine name=dev-01 keypair=me \
        zoneid=<zone> serviceofferingid=<offering> templateid=<template>
    # Ubuntu: ubuntu · Debian: debian · Rocky Linux: rocky
    ssh -p <port> ubuntu@<public IP>
  5. Để Claude Code làm

    Khi cmk đã chạy trong terminal của bạn, Claude Code cũng dùng được. Thêm vài dòng vào CLAUDE.md của dự án rồi cứ yêu cầu bằng ngôn ngữ thường ngày.

    # CLAUDE.md
    ## SOFT Cloud
    - Manage servers with `cmk` (CloudStack CLI, already configured).
    - Ask me before creating, resizing or deleting anything: it is billed hourly.
    - The database URL is in the DATABASE_URL environment variable.

    > Tạo một máy chủ Ubuntu 2 lõi, 4 GB tên dev-01 và cài Docker lên đó.

    Đừng dán secret key vào cuộc trò chuyện. Hãy để nó trong cấu hình cmk hoặc biến môi trường.

  6. Kết nối PostgreSQL

    Đặt cơ sở dữ liệu ở trang Cơ sở dữ liệu. Khi đang chạy, trang chi tiết sẽ hiện chuỗi kết nối. Chỉ chấp nhận kết nối TLS.

    export DATABASE_URL='postgresql://app:<password>@<host>:<port>/app?sslmode=require'
    psql "$DATABASE_URL"

Windows Server 2022 (tự mang giấy phép)

Image này là bản đánh giá của Microsoft (Standard, có giao diện desktop), không kèm giấy phép và chưa kích hoạt. Theo điều khoản của Microsoft, bạn phải chuyển sang bản chính thức bằng giấy phép Windows Server của mình (có Software Assurance hoặc thuê bao, dùng được trên đám mây bên thứ ba) trước khi dùng cho môi trường thật. Bản đánh giá hết hạn sau 180 ngày kể từ lần khởi động đầu tiên, sau đó sẽ tự tắt mỗi giờ. Đăng nhập bằng Administrator: mật khẩu được tạo khi khởi động lần đầu, bạn có thể xem hoặc đặt lại trong bảng điều khiển. Remote Desktop dùng cổng 3389; bạn tự thêm quy tắc chuyển tiếp cổng hoặc tường lửa. Khuyến nghị tối thiểu 2 vCPU, 4 GB và ổ hệ thống 50 GB. Trong PowerShell quyền quản trị:

DISM /online /Get-CurrentEdition            # ServerStandardEval
# Datacenter: /Set-Edition:ServerDatacenter
DISM /online /Set-Edition:ServerStandard /ProductKey:XXXXX-XXXXX-XXXXX-XXXXX-XXXXX /AcceptEula
# restart (it restarts once more by itself), then:
slmgr /skms <your KMS>                     # only if you use your own KMS
slmgr /ato
slmgr /dlv                                  # License Status: Licensed

Chúng tôi không cung cấp giấy phép Windows hay máy chủ KMS, và không cho phép Windows 10 / 11. Nếu máy chủ sẽ làm domain controller, hãy chuyển sang bản chính thức trước: domain controller không chuyển được.