snctl rack import が読み込み、snctl rack export が書き出すファイル形式について説明します。JSON と YAML のどちらも使用できます。
インポートのワークフロー自体については、ラック管理 をご参照ください。
トップレベルキー
Rack
SambaRack Manager はラックを完全なデバイスレイアウトに展開したうえで、ファイルのエントリをその上に適用します。そのため、レイアウト内のすべてのデバイスを記載してください。
Node
Device
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
id | integer | スロット型デバイスのみ | スロットインデックス。host と bmc では省略します。 |
ip | string | ip または hostname のいずれか | 管理 IP アドレス |
hostname | string | ip または hostname のいずれか | デバイスのホスト名 |
username | string | はい | ログインユーザー |
port | integer | はい | 接続ポート |
password | string | いいえ | デバイス認証情報 をご参照ください。 |
ソースファイル内の実際のパスワード — すなわち、
${<TYPE>_SECRET} プレースホルダになっていないもの — は、暗号化された認証情報ストアにインポートされます。インベントリ自体には、常にプレースホルダのみが保存されます。Group
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | はい | グループ名。エントリのキーと一致させます |
description | string | はい | グループの説明 |
racks | string のリスト | はい | ラック ID。各 ID はインベントリ内、または同じファイル内に存在する必要があります |
例
部品番号1002331 の完全なラックの例:
version: "1.2" # schema version; use "1.2"
racks:
"001": # rack ID; matches id below
id: "001"
part_number: "1002331" # 1001934 | 1002331
serial_terminals: # 0-indexed
- id: 0
ip: 192.168.10.19
hostname: SN40L-16-SCS
username: sysadmin
access_switches: # 0-indexed
- id: 0
ip: 192.168.10.240
hostname: SN40L-16-ACCSW
username: root
port: 3001
data_switches: # 0-indexed
- id: 0
ip: 192.168.10.241
hostname: SN40L-16-DATASW
username: root
port: 3002
pdus: # 1-indexed; 2 for 1002331, 4 for 1001934
- id: 1
ip: 192.168.10.20
hostname: SN40L-16-PDU1
username: admin
port: 3003
- id: 2
ip: 192.168.10.21
hostname: SN40L-16-PDU2
username: admin
port: 3004
nodes:
- rack_node_id: 0 # node slot in the rack, from 0
node_name: prod-node-1 # name used to target this node
host: # no id
ip: 192.168.4.1
hostname: SFT-SN40L-16-H-1
username: root
port: 3024
bmc: # no id
ip: 192.168.5.1
hostname: SN40L-16-H-1-SP
username: admin
xrdus: # 0-indexed, 8 per node
- id: 0
ip: 192.168.6.1
hostname: SN40L-16-H-1-XRDU0
username: root
port: 3026
- id: 1
ip: 192.168.6.2
hostname: SN40L-16-H-1-XRDU1
username: root
port: 3025
- id: 2
ip: 192.168.6.3
hostname: SN40L-16-H-1-XRDU2
username: root
port: 3023
- id: 3
ip: 192.168.6.4
hostname: SN40L-16-H-1-XRDU3
username: root
port: 3022
- id: 4
ip: 192.168.6.5
hostname: SN40L-16-H-1-XRDU4
username: root
port: 3016
- id: 5
ip: 192.168.6.6
hostname: SN40L-16-H-1-XRDU5
username: root
port: 3015
- id: 6
ip: 192.168.6.7
hostname: SN40L-16-H-1-XRDU6
username: root
port: 3013
- id: 7
ip: 192.168.6.8
hostname: SN40L-16-H-1-XRDU7
username: root
port: 3012
groups: # optional
g1:
id: g1
description: Production
racks: ["001"]
次のステップ
インポートが完了したら、デバイス認証情報 を設定してください。snctl のサブコマンドとフラグの一覧は、コマンドリファレンス をご参照ください。