개발자

빠른 시작: 가입부터 첫 서버까지

서버는 표준 CloudStack API로 관리하므로 cmk 명령줄 도구와 Claude Code를 바로 쓸 수 있습니다.

1. 계정 만들기

   가입하고 이메일을 인증한 뒤 본인 확인을 마칩니다. 승인되면 클라우드 콘솔 계정이 열리고 충전할 수 있습니다.

   계정 만들기

2. API 키 생성

   계정 페이지에서 클라우드 콘솔을 열고 오른쪽 위 메뉴에서 프로필로 들어가 “Generate keys”를 누릅니다. API 키와 시크릿 키가 발급됩니다.

3. cmk 설치 및 설정

   cmk(CloudMonkey)는 CloudStack 공식 명령줄 도구입니다. 사용하는 시스템용으로 내려받은 뒤 SOFT Cloud를 가리키도록 설정하세요. 키는 내 컴퓨터의 ~/.cmk/config에 저장됩니다.

   # 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. 첫 서버 만들기

   영역, 사양, 이미지를 조회한 뒤 생성합니다. 요금은 매시간 잔액에서 차감됩니다. 외부에서 SSH로 접속하려면 콘솔에서 공인 IP와 포트 포워딩 규칙을 설정하세요. 이미지는 SSH 키만 지원하며, 로그인 사용자는 이미지에 따라 ubuntu, debian, rocky입니다.

   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에 맡기기

   터미널에서 cmk가 동작하면 Claude Code도 쓸 수 있습니다. 프로젝트의 CLAUDE.md에 몇 줄을 추가하고, 평소 말투로 요청하면 됩니다.

   # 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.

   > 2코어 4GB Ubuntu 서버를 dev-01이라는 이름으로 만들고 Docker를 설치해 줘.

   시크릿 키를 대화창에 붙여 넣지 마세요. cmk 설정이나 환경 변수에 두세요.

6. PostgreSQL 연결

   데이터베이스 페이지에서 주문합니다. 실행되면 상세 페이지에 연결 문자열이 표시됩니다. TLS 연결만 허용됩니다.

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

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