Getting started Guide

micho7 edited this page Apr 15, 2015 · 51 revisions

目次

インストール&初期設定

表示系コマンド

サーバの作成手順

サーバ操作系コマンド

サーバの削除手順

スイッチ関連コマンド

アーカイブ関連コマンド

ISOイメージ関連コマンド

SSH公開鍵関連コマンド

TIPS

インストール&初期設定

インストール

こちらをご覧ください。
https://github.com/sakura-internet/node-sacloud/wiki/Installation

設定

次のコマンドでAPIルートを設定します:

! 石狩第1ゾーンにアクセスする場合の例
sacloud config --apiRoot="https://secure.sakura.ad.jp/cloud/zone/is1a/api/cloud/1.1/"

他のゾーンのAPIルートは、こちらをご覧ください。
http://developer.sakura.ad.jp/cloud/api/1.1/

次のコマンドでトークンを設定します:

sacloud config --accessToken=**** --accessTokenSecret=********

設定状況を確認する時は:

sacloud config

表示系コマンド

サーバの一覧を見る

% sacloud show server
GET https://secure.sakura.ad.jp/cloud/api/cloud/1.0/server.json?{} -> 200 OK (1/1) ~0.427sec
+--------------+---------------------+--------+---------------------+
| id           | name                | status | created at          |
+--------------+---------------------+--------+---------------------+
| XXXXXXXXXXXX | storage-probe1      | up     | 2012-03-15 01:58:55 |
+--------------+---------------------+--------+---------------------+
| XXXXXXXXXXXX | storage-probe4      | up     | 2012-07-02 11:28:21 |
+--------------+---------------------+--------+---------------------+

サーバの詳細を見る

% sacloud show server サーバのID
GET https://secure.sakura.ad.jp/cloud/api/cloud/1.0/server/112500180749.json?{} -> 200 OK (1/1) ~0.553sec
+------------+-------------------------------------------------+
| id         | XXXXXXXXXXXX                                    |
+------------+-------------------------------------------------+
| zone       | 31001:is1a                                      |
+------------+-------------------------------------------------+
| name       | test-server                                     |
+------------+-------------------------------------------------+
| tags       |                                                 |
+------------+-------------------------------------------------+
| plan       | 1001:プラン/1Core-1GB                           |
+------------+-------------------------------------------------+
| cpu        | 1                                               |
+------------+-------------------------------------------------+
| memory     | 1024MB                                          |
+------------+-------------------------------------------------+
| status     | down                                            |
+------------+-------------------------------------------------+
| hypervisor |                                                 |
+------------+-------------------------------------------------+
| disk       |                                                 |
+------------+-------------------------------------------------+
| interface  | XXXXXXXXXXXX:XX:XX:XX:XX:XX:XX -> XXX.XXX.XX.XX |
+------------+-------------------------------------------------+
| created at | 2013-04-25 14:27:38                             |
+------------+-------------------------------------------------+

ディスクの一覧を見る

% sacloud show disk
GET https://secure.sakura.ad.jp/cloud/api/cloud/1.0/disk.json?{} -> 200 OK (1/1) ~0.689sec
+--------------+---------------------+---------------------+
| id           | name                | created at          |
+--------------+---------------------+---------------------+
| XXXXXXXXXXXX | test-disk1          | 2012-03-15 01:58:57 |
+--------------+---------------------+---------------------+
| XXXXXXXXXXXX | test-disk2          | 2012-07-02 11:28:25 |
+--------------+---------------------+---------------------+

ディスクの詳細情報を見る

% sacloud show disk ディスクのID
GET https://secure.sakura.ad.jp/cloud/api/cloud/1.0/disk/112500180766.json?{} -> 200 OK (1/1) ~0.633sec
+--------------+---------------------+
| id           | XXXXXXXXXXXX        |
+--------------+---------------------+
| name         | test-disk           |
+--------------+---------------------+
| availability | available           |
+--------------+---------------------+
| size         | 20480MB             |
+--------------+---------------------+
| created at   | 2013-04-25 14:34:14 |
+--------------+---------------------+

サーバの作成手順

サーバを作る

% sacloud create server zone 31001 plan 1001 name test-server

※ 石狩第2ゾーンの場合は 31002 を指定します。sacloud show zone で確認できます。

ネットワークインターフェイスを作る

% sacloud create interface to server サーバのID

ネットワークインターフェイスを接続する

  • 共有セグメントに接続する場合
% sacloud connect interface ネットワークインターフェイスのID to switch shared
  • スイッチやルータ+スイッチに接続する場合
% sacloud connect interface ネットワークインターフェイスのID to switch スイッチのID

ディスクを作る

  • 空ディスクを作成する
% sacloud create disk zone 31001 plan 4 size 100 type virtio name ディスク名

※ 石狩第2ゾーンの場合は 31002 を指定します。sacloud show zone で確認できます。
※ planは標準プランが2、SSDプランが4です。
※ sizeはGiB単位で指定します。1TB=1024、2TB=2048、4TB=4096となります。SSDの場合は20,100,250,500のみ指定可能です。
※ typeにideを指定すると、IDE接続も可能です。
  • アーカイブからディスクにコピーする
% sacloud copy archive アーカイブのID to disk ディスクのID

※ アーカイブのIDは、 sacloud show archive で確認できます。

% sacloud show disk ディスクのID
GET https://secure.sakura.ad.jp/cloud/api/cloud/1.0/disk/112500180784.json?{} -> 200 OK (1/1) ~0.404sec
+--------------+-----------------------------------------+
| id           | XXXXXXXXXXXX                            |
+--------------+-----------------------------------------+
| name         | CentOS 6.4 64bit (基本セット)           |
+--------------+-----------------------------------------+
| description  | Copy of `CentOS 6.4 64bit (基本セット)` |
+--------------+-----------------------------------------+
| availability | available                               |
+--------------+-----------------------------------------+
| progress     | 100%                                    |
+--------------+-----------------------------------------+
| size         | 20480MB                                 |
+--------------+-----------------------------------------+
| created at   | 2013-04-25 14:46:50                     |
+--------------+-----------------------------------------+

※ progressが100%になるまで待ちます。

ディスク名とコネクションを変更する

% sacloud update disk ディスクのID name ディスク名 connection virtio description 説明文

※ connectionにideを指定すると、IDE接続も可能です。

ディスクをサーバに接続する

% sacloud attach disk ディスクのID to server サーバのID

ディスクにホスト名とパスワードとIPアドレスを書き込む

  • 共有セグメントに接続している場合
% sacloud modify disk ディスクのID password パスワード hostname ホスト名 publickey "`cat ~/.ssh/id_dsa.pub`"

※ IPアドレスは自動的に設定されます
※ SSHキーのID指定には現在対応していません
  • スイッチ(もしくはルータ+スイッチ)に接続している場合
% sacloud modify disk ディスクのID password パスワード hostname ホスト名 publickey "`cat ~/.ssh/id_dsa.pub`" ipaddress 192.168.100.100 prefix 24 gateway 192.168.100.254

※ IPアドレスの指定が必要です
※ SSHキーのID指定には現在対応していません

ディスクのデータを別のディスクにコピーする

% sacloud copy disk コピー元ディスクのID to disk コピー先ディスクのID

※ コピー先のディスクはあらかじめ作成しておく必要があります

サーバ操作系コマンド

サーバを起動する

% sacloud start server サーバのID

サーバを停止する

% sacloud stop server サーバのID

ISOイメージを挿入する

% sacloud insert cdrom ISOイメージのID to server サーバID

ISOイメージを排出する

% sacloud eject cdrom from server サーバID

タグを設定する

% sacloud update server サーバID tags タグ名

サーバの削除手順

ネットワークインターフェイスを切断する

% sacloud disconnect interface インターフェイスのID from switch

ネットワークインターフェイスを削除する

% sacloud delete interface インターフェイスのID

ディスクをサーバから切断する

% sacloud detach disk ディスクのID from server

ディスクを削除する

% sacloud delete disk ディスクのID

サーバを削除する

% sacloud delete server サーバのID

スイッチ関連コマンド

スイッチの一覧を見る

% sacloud show switch
+--------------+------------------+---------------------+
| id           | name             | created at          |
+--------------+------------------+---------------------+
| XXXXXXXXXXXX | switch1          | 2012-10-22 10:13:42 |
+--------------+------------------+---------------------+
| XXXXXXXXXXXX | switch2          | 2012-11-05 07:36:42 |
+--------------+------------------+---------------------+
| XXXXXXXXXXXX | switch3          | 2013-03-29 17:17:55 |
+--------------+------------------+---------------------+
| XXXXXXXXXXXX | switch4          | 2013-03-29 17:18:23 |
+--------------+------------------+---------------------+

スイッチを作る

% sacloud create switch zone 31001 name スイッチ名

※ 石狩第2ゾーンの場合は 31002 を指定します。sacloud show zone で確認できます。

スイッチを削除する

sacloud delete switch スイッチのID

ルータ+スイッチの一覧を見る

% sacloud show internet
+--------------+-----------------+-----------+---------------------+
| id           | name            | subnet id | created at          |
+--------------+-----------------+-----------+---------------------+
| XXXXXXXXXXXX | test-global     | 9999      | 2013-03-07 05:43:09 |
+--------------+-----------------+-----------+---------------------+

ルータ+スイッチを作る

% sacloud create internet zone 31001 prefix 27 bandwidth 500 name 名称

※ 石狩第2ゾーンの場合は 31002 を指定します。sacloud show zone で確認できます。

ルータ+スイッチを削除する

% sacloud delete internet ルータ+スイッチのID

アーカイブ関連コマンド

アーカイブの一覧を見る

% sacloud show archive
+--------------+----------------------------------------------+---------------------+
| id           | name                                         | created at          |
+--------------+----------------------------------------------+---------------------+
| XXXXXXXXXXXX | CentOS 5.9 64bit (基本セット)                | 2013-03-13 08:38:06 |
+--------------+----------------------------------------------+---------------------+
| XXXXXXXXXXXX | CentOS 6.4 64bit (基本セット)                | 2013-03-14 06:03:19 |
+--------------+----------------------------------------------+---------------------+

アーカイブの情報を見る

% sacloud show archive アーカイブのID
+--------------+---------------------+
| id           | XXXXXXXXXXXX        |
+--------------+---------------------+
| name         | archive-test        |
+--------------+---------------------+
| availability | uploading           |
+--------------+---------------------+
| size         | 20480MB             |
+--------------+---------------------+
| created at   | 2013-05-24 15:12:00 |
+--------------+---------------------+

アーカイブのFTPアップロード領域を作る

サイズは20(GB)か100(GB)を選択可能です。
※ 石狩第2ゾーンの場合は 31002 を指定します。sacloud show zone で確認できます。

% sacloud create archive zone 31001 size 20 name archive-test
+---------------+---------------------------+
| id            | XXXXXXXXXXXX              |
+---------------+---------------------------+
| name          | archive-test              |
+---------------+---------------------------+
| availability  | uploading                 |
+---------------+---------------------------+
| size          | 20480MB                   |
+---------------+---------------------------+
| created at    | 2013-05-24 15:12:00       |
+---------------+---------------------------+
| ftp:hostName  | sac-is1a-ssl.sakura.ad.jp |
+---------------+---------------------------+
| ftp:ipAddress | 133.242.31.244            |
+---------------+---------------------------+
| ftp:user      | XXXXXXXXXXXXXXXXXXX       |
+---------------+---------------------------+
| ftp:password  | XXXXXXXXXXXXXXXX          |
+---------------+---------------------------+

ここで表示されるユーザ名、パスワードにてFTPログインし、アーカイブをアップロードしてください。

FTPを完了し利用可能な状態にする

% sacloud ftp-close archive アーカイブのID

FTP転送を再オープンする

% sacloud ftp-open archive アーカイブのID
+---------------+---------------------------+
| ipaddress     | 133.242.31.244            |
+---------------+---------------------------+
| ftp:hostName  | sac-is1a-ssl.sakura.ad.jp |
+---------------+---------------------------+
| ftp:ipAddress | 133.242.31.244            |
+---------------+---------------------------+
| ftp:user      | XXXXXXXXXXXXXXXXXXX       |
+---------------+---------------------------+
| ftp:password  | XXXXXXXXXXXXXXXX          |
+---------------+---------------------------+

アーカイブを削除する

% sacloud delete archive アーカイブのID

ISOイメージ関連コマンド

ISOイメージの一覧を見る

% sacloud show cdrom
+--------------+------------------------------------------------------+---------------------+
| id           | name                                                 | created at          |
+--------------+------------------------------------------------------+---------------------+
| XXXXXXXXXXXX | CentOS 5.9 32bit                                     | 2012-12-27 08:09:03 |
+--------------+------------------------------------------------------+---------------------+
| XXXXXXXXXXXX | CentOS 5.9 64bit                                     | 2013-01-17 09:19:54 |
+--------------+------------------------------------------------------+---------------------+

ISOイメージの情報を見る

% sacloud show cdrom ISOイメージのID
+--------------+---------------------+
| id           | XXXXXXXXXXXX        |
+--------------+---------------------+
| name         | cdrom-test          |
+--------------+---------------------+
| availability | available           |
+--------------+---------------------+
| size         | 5120MB              |
+--------------+---------------------+
| created at   | 2013-05-24 15:19:03 |
+--------------+---------------------+

ISOイメージのFTPアップロード領域を作る

サイズは5(GB)か10(GB)を選択可能です。
※ 石狩第2ゾーンの場合は 31002 を指定します。sacloud show zone で確認できます。

% sacloud create cdrom zone 31001 size 5 name cdrom-test
+---------------+---------------------------+
| id            | XXXXXXXXXXXX              |
+---------------+---------------------------+
| name          | cdrom-test                |
+---------------+---------------------------+
| availability  | uploading                 |
+---------------+---------------------------+
| size          | 5120MB                    |
+---------------+---------------------------+
| created at    | 2013-05-24 15:19:03       |
+---------------+---------------------------+
| ftp:hostName  | sac-is1a-ssl.sakura.ad.jp |
+---------------+---------------------------+
| ftp:ipAddress | 133.242.31.244            |
+---------------+---------------------------+
| ftp:user      | XXXXXXXXXXXXXXXXX         |
+---------------+---------------------------+
| ftp:password  | XXXXXXXXXXXXXXXX          |
+---------------+---------------------------+

ここで表示されるユーザ名、パスワードにてFTPログインし、ISOイメージをアップロードしてください。

FTPを完了し利用可能な状態にする

% sacloud ftp-close cdrom ISOイメージのID

FTP転送を再オープンする

% sacloud ftp-open cdrom ISOイメージのID
+---------------+---------------------------+
| ipaddress     | 133.242.31.244            |
+---------------+---------------------------+
| ftp:hostName  | sac-is1a-ssl.sakura.ad.jp |
+---------------+---------------------------+
| ftp:ipAddress | 133.242.31.244            |
+---------------+---------------------------+
| ftp:user      | XXXXXXXXXXXXXXXXX         |
+---------------+---------------------------+
| ftp:password  | XXXXXXXXXXXXXXXX          |
+---------------+---------------------------+

ISOイメージを削除する

% sacloud delete cdrom 112500219061

SSH公開鍵関連コマンド

SSH公開鍵を登録する

% sacloud create sshkey publickey "`cat .ssh/id_dsa.pub`" name user@hostname

SSH公開鍵を削除する

% sacloud delete sshkey SSH公開鍵のID

TIPS

コマンドの途中でタブキーを押すと補完できます

% sacloud create server zone 31001 plan ←タブ
1001:プラン/1Core-1GB       32010:プラン/10Core-32GB
12003:プラン/3Core-12GB     4001:プラン/1Core-4GB
12004:プラン/4Core-12GB     4002:プラン/2Core-4GB
・・省略・・

% sacloud create disk zone 31001 plan ←タブ
2:標準プラン  4:SSDプラン

--csvオプションをつけるとCSV形式で出力します

% sacloud show disk --csv
id,name,created at
XXXXXXXXXXXX,test-disk1,2012-03-15 01:58:57
XXXXXXXXXXXX,test-disk2,2012-07-02 11:28:25

--tsvオプションをつけるとTSV形式で出力します

% sacloud show disk --tsv
id      name    created at
XXXXXXXXXXXX    test-disk1  2012-03-15 01:58:57
XXXXXXXXXXXX    test-disk2  2012-07-02 11:28:25

--jsonオプションをつけるとJSON形式で出力します

% sacloud show disk --json
[{
  "requestInfo": {
    "time": 1366868691437,
    "method": "get",
    "url": "https://secure.sakura.ad.jp/cloud/api/cloud/1.0/disk.json?{}",
    "path": "disk"
  },
  "request": {},
  "responseInfo": {
    "time": 1366868692019,
    "latency": 582,
    "length": 45268,
    "serial": "e986df5b199bc35a007ad783d873a494",
    "status": 200,
    "statusText": "OK",
    "type": "resources",
    "key": "disks"
  },
・・省略・・
Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.