Skip to main content
本ガイドでは、SambaRack Manager ソフトウェアの初期セットアップと動作確認について説明します。この作業では、設定ディレクトリの初期化、暗号鍵 (encryption key) の生成、および必要なファイルの作成を行います。 セットアップの全体の流れは次のとおりです。
  1. SambaRack Manager ソフトウェアのインストール
  2. 初期セットアップと動作確認 (このページ)
  3. SambaRack Manager インベントリへの SambaRack の追加
  4. SambaRack Manager でのデバイス認証情報の設定

初期セットアップ

以下の手順に従って、SambaRack Manager の設定を初期化し、動作を確認します。

ステップ 1: 設定の初期化

初期化コマンドを実行して snctl をセットアップします。
この対話型ウィザードでは、以下の項目の入力を求められます。
  • フォルダの場所 (デフォルト: ~/.snctl): 設定ファイルの保存先。このディレクトリが存在しない場合は作成されます。
  • サービスアカウント (任意): GCS アクセス用のサービスアカウント。
  • ログの場所 (任意): ログの保存先。
指定したフォルダの場所にすでに設定ファイルが存在する場合、初期化は中止されます。
完了すると、設定ディレクトリには以下のファイルが作成されます。

ステップ 2: 環境変数の設定 (カスタムの場所を使用する場合)

snctl config init の実行時に (~/.snctl とは異なる) カスタムのフォルダの場所を選択した場合、最後に以下のような案内が表示されます。
以下のいずれかのオプションを選択します。 オプション 1 - 環境変数を設定する (推奨):
オプション 2 - コマンドごとに —snctl-dir フラグを使用する:
いずれのオプションでも、指定したパスが .snctl で終わっていない場合、CLI は自動的にパスの末尾に .snctl を付加します。たとえば、SNCTL_DIR=/home/user/myconfig と指定すると /home/user/myconfig/.snctl が使用されます。

ステップ 3: セットアップの確認

初期化後、すべてが正しく設定されていることを確認します。 snctl が動作することを確認する:
期待される出力:
現在の設定を表示する:
このコマンドは、.snctl/config.yaml の主要な情報を表示します。 期待される出力:
SambaRack Manager がすでにインストールされている状態で snctl config show を実行すると、config.yaml に記録されたバージョンが現在実行中のバージョンと異なる場合、config.yaml が現在のバージョンに更新されます。
作成されたファイルを確認する:
期待される出力:

ステップ 4: 必要な依存関係の確認

必要な依存関係がすべてインストールされていることを確認します。
詳細は snctl doctor をご参照ください。

ステップ 5: 暗号鍵の安全な保管

暗号鍵は安全に保管してください。暗号鍵は以下の操作に必要です。
  • シークレットの復号
  • インフラストラクチャに対するコマンドの実行
暗号鍵にアクセスできる人は誰でも、保存されているすべてのシークレットを復号できます。このファイルは相応に厳重に保護してください。

セキュリティに関する考慮事項

SambaRack Manager には、現時点で以下のセキュリティ上の制限があります。あらかじめご了承ください。

アクセス制御

snctl にアクセスできる人は誰でも、すべてのインフラストラクチャを管理する完全な権限を持ちます。
現在、snctl はロールベースアクセス制御 (RBAC) をサポートしていません。これは以下を意味します。
  • snctl にアクセスできるすべてのユーザーが、すべての操作を実行できます
  • 読み取り専用権限と書き込み権限の分離はありません
  • 監視操作と電源操作の区別はありません
  • ネットワーク管理者とシステム管理者を分離できません

監査とロギング

現在、snctl は、誰がどの操作を実行したかを記録する監査ログを保持していません。

次のステップ

初期セットアップが完了したら、ラックを SambaRack Manager インベントリに追加します。ラック管理 をご参照ください。