マニフェストを適用する

mNi マニフェストは、mNi Cloud のリソースを YAML で記述する形式です。このページでは、VPC、サブネット、VM を一つのファイルから作成します。

開始する前に

CLIでサインインするの手順を完了します。
mni whoamiで、操作するテナントを確認します。
mni get clusterimagesで、cirros-0.6.3が利用できることを確認します。

利用できるリソースを確認する

接続先が提供しているリソースを表示します。

mni api-resources

マニフェストに指定できる項目は explain で確認できます。

mni explain vpcs --recursive
mni explain subnets --recursive
mni explain virtualmachines --recursive

マニフェストを作成する

次の内容をapplication-stack.yamlとして保存します。

apiVersion: vpc/v1alpha2
kind: Vpc
metadata:
  name: development-vpc
  displayName: Development VPC
  description: Network created from a manifest
spec:
  enforceSecurityGroups: false
---
apiVersion: vpc/v1alpha2
kind: Subnet
metadata:
  name: application-subnet
  displayName: Application subnet
spec:
  vpc: development-vpc
  cidr: 10.42.1.0/24
---
apiVersion: vm/v1alpha1
kind: VirtualMachine
metadata:
  name: application-server
  displayName: Application server
spec:
  cores: 2
  memory: 4Gi
  subnet: application-subnet
  rootVolume:
    size: 20Gi
    source:
      kind: ClusterImage
      name: cirros-0.6.3

---で区切ると、複数のリソースを一つのファイルに記述できます。CIDRは、同じVPCにある既存のサブネットと重ならない範囲を指定してください。

注意

同じ apiVersion、kind、metadata.name を持つリソースが存在する場合、新規作成ではなく既存リソースが更新されます。既存リソースを変更しない場合は、適用前に mni get で名前を確認し、マニフェストの metadata.name を変更してください。

mni apply -f application-stack.yaml

初回は、次のように作成結果が表示されます。

vpcs/development-vpc created
subnets/application-subnet created
virtualmachines/application-server created

作成結果を確認する

mni get vpcs
mni get subnets
mni get virtualmachines

詳細な状態と依存関係を確認するには、describeを使用します。

mni describe vpcs development-vpc
mni describe subnets application-subnet
mni describe virtualmachines application-server

VPCとサブネットの状態がReady、VMの状態がRunningになるまで待ちます。mni describe virtualmachines application-serverでは、VMに割り当てられたIPアドレスも確認できます。

作成したリソースを削除する

VM、サブネット、VPCの順に、一つずつ削除します。

注意

このページの例で作成した3つのリソースを今後使用しない場合だけ実行してください。削除したリソースは元に戻せません。VM内に必要なデータがある場合は先に保存し、確認メッセージに表示される削除対象と連動して削除されるリソースを確認してください。

mni delete virtualmachines application-server
mni delete subnets application-subnet
mni delete vpcs development-vpc

確認メッセージに表示された対象を確認し、削除を続ける場合はyを入力します。