Command Palette
Search for a command to run...
HyperAIの新機能リリース｜コンピューティングコンテナの環境変数とシークレット変数の設定
日々のモデルの微調整、推論のデプロイ、または自動化タスクでは、サードパーティサービスのトークンを渡したり、モデルリポジトリのアドレスを指定したり、実行時パラメータを渡したりするなど、さまざまなサードパーティサービスやリモートリポジトリとやり取りする必要が生じることがよくあります。
全ての人の科学研究と工学の実践をより安全かつ効率的にするために、HyperAI（hyper.ai）は、コンピューティングコンテナの「環境変数とシークレット変数」を設定する機能を正式にリリースしました。本日より、コンピューティングコンテナ（タスクやJupyterワークスペースを含む）を作成または構成する際に、変数名／変数値の形式で環境変数セットを直接注入することで、コンテナの動作をより洗練された柔軟な方法で制御できるようになります。
* 公式文書:
https://hyper.ai/docs/gear/env-vars
環境変数を設定する
各環境変数にはタイプがあり、それはプレーンテキストかシークレットのいずれかで、変数の右側にある「シークレット」にチェックが入っているかどうかによって決まります。
コンテナの作成／設定ページで「環境変数」を探してください。
- 「環境変数を追加」をクリックし、「変数名」と「変数値」を入力します。
- 変数タイプを選択してください。デフォルトはプレーンテキストです。キーやトークンなどの機密情報の場合は、右側の「Secret」をチェックしてSecretタイプに設定してください。
- 複数の変数を追加することができ、それらは送信後にコンテナと共に保存されます。
秘密変数の脱感作と読み取り
秘密変数が保存されると、プラットフォームはその値を平文で返さなくなります。編集権限を持つメンバーは、ページ全体で匿名化されたプレースホルダーコンテンツのみを見ることができます。
- 脱感作後、最初と最後の 2 文字のみが保持され、真ん中の文字は「••••」に置き換えられます (例: hf••••23)。
- 元の値が8ビット未満の場合、実際の長さが明らかにならないように「••••••」と表示されます。
編集権限を持たないメンバーは値を一切読み取ることができず、インターフェースは直接nullを返します。
匿名化された値は表示目的のみに使用されるものであり、変数の実際の値ではありません。コンテナは常に実行時に保存された元の値を挿入します。
再起動およびクローン作成時の秘密情報処理
元のシークレットの実際の値を使用するかどうかは、この操作が同じ実行を再開するのか、新しい実行を作成するのかによって異なります。
ワークスペースを再起動します:
閉じたワークスペースを再起動する場合（「開始」または「更新して開始」を使用する場合）、以前に保存されたシークレット値を使用して同じ実行が継続されます。そのため、シークレット値を再入力する必要はありません。
- クイックスタート：以前の設定をすべてそのまま再利用し、Secret の実際の値はサーバー側のプラットフォームによって自動的に入力されます。
- 設定を変更して有効化してください。シークレットは匿名化された読み取り専用形式で表示され、デフォルトでは保持されます。変更するには、変数の「置換」をクリックし、新しい値を入力してから、「置換のキャンセル」をクリックして元の値に戻してください。
クローン/実行の作成:
以下の操作は完全に新しい実行を生成するため、元のシークレットの実際の値は反映されません。
- 公開されているチュートリアルや公開されているリソースからの複製。
- 他人の設定を複製して起動する。自動モデリングから複製する。
- 「実行を継続／この時点から複製」を使用して、以前の実行から新しい実行を作成します。
このような場合、クローナーは元のシークレットを平文で読み取ることができず、プラットフォームもそれを新しい実行に引き継ぎません。ページには変数名が保持され、「元のシークレットの値は保持できません。新しい値を入力してください。」というメッセージが表示されます。シークレットの各変数に独自の値を入力するか、開始前に不要な変数を削除する必要があります。平文の変数は通常どおり新しい実行に引き継がれます。
変数型を変更する:
変数の型は、平文と秘密の間で切り替えることができます。
- 平文を秘密情報に変更するには、「秘密情報」のチェックボックスをオンにするだけです。既に入力した値が、この秘密情報の値として保存されます。
- Secret をプレーンテキストに変更するには、「Secret」のチェックを外してください。Secret の元の値は読み取れないため、変更後に破棄されます。そのため、変数の値を再度入力する必要があります（最初に確認ウィンドウが表示されます）。
より詳細な情報については、公式ドキュメントを参照してください。
