1. VCP SDK の機能仕様とシステム設計について

# flavor か取得
spec = sdk.get_spec('aws', 'small')

# カスタマイズ
spec.instance_type = 'm5.xlarge'

from common import logsetting
from vcpsdk.vcpsdk import VcpSDK

#
# VCP SDK 初期化
#
vcc_access_token = "ユーザ毎のアクセストークン"

sdk = VcpSDK(vcc_access_token)

#
# UnitGroup 作成
#
ugroup = sdk.create_ugroup('MyUnitGroupName', 'compute')

#
# 作成する Unit の spec 情報を作成
#
spec = sdk.get_spec("aws", "small")

#
# 変更可能な spec
#
# spec.num_nodes = 1
# spec.instance_type = 'm4.large'
# spec.params_v = ['/opt:/opt']
# spec.params_e = ['USER_NAME=test']
# spec.volume_size = 40
# spec.volume_type = "standard"　# standard|io1|gp2|sc1|st1
# spec.disks = ['vol-08cbb04b35c8c9545']

# VC ノードの DNS 設定 (設定ファイル vcp_config.yml で記述した値を変更可能)
# spec.dns = [ '1.1.1.1', '1.0.0.1' ] # e.g. Cloudflare
# spec.dns_opt = [ "timeout:60" ]
# spec.dns_search = "example.com"
# spec.hostname = "mynode"

# VC ノードの /etc/hosts に追加 (設定ファイル vcp_config.yml で記述した値を変更可能)
# spec.add_host = [ "myhost:192.168.1.1", "yourhost:192.168.1.200"]

# AWS EC2 インスタンスのタグ設定
# spec.set_tag('key1', 'value1')
# spec.set_tag('key2', 'value2')

# VC ノード に SSH 接続するための公開鍵を設定
spec.set_ssh_pubkey('tmp/id_rsa.pub')   # tmp/id_rsa はあらかじめ作成しておく

#
# 作成した spec 情報を利用して Unit を作成（VCノード起動）
#
unit = ugroup.create_unit("new_sample_server", spec)

for ugroup in sdk.find_ugroup():
        print(ugroup)
---
[Vc]
+ type[compute] name[03_sample] owner(user1) vcno(55) state[RUNNING] vcid[fxxxb28xxxxxxxe698e8001995b7b4a2]
...

for node in ugroup.find_nodes():
    print(node)
---
[VcNode]
+ no(1) state[RUNNING] id[13xxxxxxxxxxxxxxx2babc606cb4e60f] \
cloud_instance_address[172.30.2.242] cloud_instance_id[i-0e868711a439130d3]
    ...
---
[VcNode]
+ no(1) state[RUNNING] id[13xxxxxxxxxxxxxxx2babc606cb4e60f] \

# VCコントローラー全体(所有UnitGroup内のみ)
sdk.df_nodes()
# VCコントローラー全体(特権モードで全て)
sdk.df_nodes(privileged=True)
# UnitGroup内
ugroup..df_nodes()
# Unit内
unit.df_nodes()

ugroup.delete_units('Unit名', force=True)

unit.add_nodes(5)

unit.delete_nodes(1)

unit.delete_nodes(ip_address="xxx.xxx.xxx.xxx")

ugroup = sdk.get_ugroup('UnitGroup名')
ugroup.cleanup()

spec = sdk.get_spec('aws', 'small')
spec.volume_size = 80

for ugroup in sdk.find_ugroups():
    print(ugroup)
    ---
    + type[compute] name[03_sample] owner(user1) vcno(55) state[RUNNING] vcid[fxxxb...]

print(sdk.get_vpn_catalog("aws"))
---
{'default': {'aws_availability_zone': 'ap-northeast-1a', 'aws_vpc_subnet_id': 'subnet-0a743...', 'private_network_ipmask': '172.30.2.0/24', 'aws_vpc_security_group_id': 'sg-0a56...', 'aws_region': 'ap-northeast-1'}}

# 全部
catalogs = sdk.get_vpn_catalog()

for provider in catalogs.keys():
    if provider in ["onpremises"]:
        continue
    print("== provider {}".format(provider))
    print(catalogs[provider])
---
== provider oracle
{'default': {'oracle_subnet_id': 'ocid1.subnet.oc1.ap-tokyo-1.aaxx...', 'oracle_availability_domain': 'mkro:AP-TOKYO-1-AD-1', 'private_network_ipmask': '172.24.2.0/24', 'oracle_tenancy_ocid': 'ocid1.tenancy.oc1..aa...', 'oracle_compartment_id': 'ocid1.compartment.oc1..a...', 'oracle_region': 'ap-tokyo-1'}}
== provider sakura
{'default': {'sakura_private_subnet_gateway_ip': '172.20.1.4', 'sakura_local_switch_id': '1...', 'private_network_ipmask': '172.20.1.0/24', 'sakura_zone': 'tk1a'}}
== provider aws
{'default': {'aws_availability_zone': 'ap-northeast-1a', 'aws_vpc_subnet_id': 'subnet-0a743...', 'private_network_ipmask': '172.30.2.0/24', 'aws_vpc_security_group_id': 'sg-0a56...', 'aws_region': 'ap-northeast-1'}}
== provider azure
{'default': {'private_network_ipmask': '172.21.1.0/24', 'azure_location': 'Japan East', 'azure_resource_group_name': 'niivcp', 'azure_vnet_name': 'vcc3013', 'azure_subnet_name': 'vcc3013subnet', 'azure_security_group_name': 'vcc3013-main-nsg'}}
== provider aws_spot
{'default': {'aws_availability_zone': 'ap-northeast-1a', 'aws_vpc_subnet_id': 'subnet-0a7...', 'private_network_ipmask': '172.30.2.0/24', 'aws_vpc_security_group_id': 'sg-0a5...', 'aws_region': 'ap-northeast-1'}}    ...

# VCP SDK バージョン確認
sdk.version()
---
    vcplib:
      filename: /home/jovyan/vcpsdk/vcplib/occtr.py
      version: 20.08.0+20200831

    vcpsdk:
      filename: /home/jovyan/vcpsdk/vcpsdk/vcpsdk.py
      version: 20.10.0+20201001

      plugin:
        aws: 1.2+20191001
        aws_disk: 1.0+20190408
        aws_spot: 1.1+20191001
        azure: 1.2+20191001
        vmware: 1.1+20191001
        azure_disk: 1.0+20190408
        sakura: 1.1+20191001
        sakura_disk: 1.0+20190930
        oracle: 1.0+20200331
        oracle_disk: 1.0+20200331
        aic: 1.2+20191001
        abc: 1.3+20190408
        hokudai: 1.1+20191001
        chameleon: 1.0+20200831
        chameleon_ext: 20200731
        gcp: 1.0+20190408
        onpremises: 1.0+20190408

    vc_controller:
      host: 10.0.0.1
      name: vcc3060
      wait_timeout_sec: 1000(default 15min)
      vc_controller: 20.10.0+20201001
      vc_controller_git_tag: nightly-20200511-15-g8dd969e

      plugin:
        sakura: 1.1+20200401
        aws: 1.2+20200401
        abc: 1.3+20200401
        gcp: 1.0+20200401
        vmware: 1.1+20200401
        aws_spot: 1.1+20200401
        azure: 1.2+20200401
        aic: 1.2+20200401
        chameleon: 1.0+20200401
        hokudai: 1.1+20200401
        oracle: 1.0+20200401

from common import logsetting
from vcpsdk.vcpsdk import VcpSDK

#
# VCP SDK 初期化
#
vcc_access_token = "ユーザ毎のアクセストークン"

sdk = VcpSDK(vcc_access_token)

# VC コントローラ環境に登録済みのクラウドネットワークセグメント情報 (VPNカタログ) を取得
vpn_catalog_name = "default"
vpn_catalog = vcpsdk.get_vpn_catalog("chameleon", catalog_name=vpn_catalog_name)

#
# ネットワーク確認
#
# Chameleon Network の予約用 Extension を生成
network_ext = sdk.get_extension("chameleon_network")
network_ext.setup(vpn_catalog)

# ネットワークの存在チェック
assert network_ext.network_exists(), "not exist sharedwan1"

#
# ホスト (物理サーバ) の予約
#
host_ext = vcpsdk.get_extension("chameleon")

# ホスト予約に必要な属性
node_type = "compute_skylake"
min_instances = 1
max_instances = 3

# 日付はUTCで指定する
start_dt = datetime.datetime.utcnow()
start_date=start_dt.strftime("%Y-%m-%d %H:%M")
end_date=(start_dt + datetime.timedelta(days=7)).strftime("%Y-%m-%d %H:%M") # 7日

host_ext.setup(
    node_type,
    start_date=start_date,
    end_date=end_date,
    min_instances=min_instances,
    max_instances=max_instances,
    lease_name_prefix = "S003",        # lease_name の prefix
    vpn_catalog=vpn_catalog,
)

# ホスト予約をリクエスト
lease_info = host_ext.reserve_host()
lease_info.wait()

# 予約IDを取得 (create_unitで必要)
reservation_id = lease_info.reservation_id

#---------------------------------------------------

#
# UnitGroupの作成
#
ugroup = sdk.create_ugroup('UnitGroup名', 'compute')

#
# 作成する Unit の spec 情報を作成
#
spec = sdk.get_spec("chameleon", "default")
spec.reservation = reservation_id       # 予約済み reservation_id

#
# 変更可能な spec
#
# クラウドのマシンイメージ設定
# spec.cloud_image = 'niivcp-20170616'

# VC ノード に SSH 接続するための公開鍵を設定
spec.set_ssh_pubkey('tmp/id_rsa.pub')

# VC ノードのタグ設定は Chameleon Cloud ではサポートしない

#
# 作成した spec 情報を利用して Unit を作成（VCノード起動）
# (注意) ホスト予約の開始時刻の到来後に create_unit を呼ぶこと
#
unit_name = 'chameleon_server'
unit = ugroup.create_unit(unit_name, spec, wait_for=True, verbose=0)

spec.dns = "1.1.1.1"
spec.hostname = "server01"

docker run --hostname server01 --dns=1.1.1.1 ...

# 起動する VC ノードの個数
spec.num_nodes = 1

# Base コンテナ起動時の VOLUME (-v, --volume) パラメータ
spec.params_v = ['/opt:/opt']
# Base コンテナ起動時の環境変数 ENV (-e) パラメータ
spec.params_e = ['USER_NAME=test']

# 仮想マシンイメージ名（`onpremises`(=既存サーバモード)の場合は指定不可）
spec.cloud_image = 'vmtemplate01'

# VC ノードに SSH 接続するための公開鍵ファイル
spec.set_ssh_pubkey('tmp/id_rsa.pub')