接続設定を保存する
頻繁に使用する接続設定をプロファイルとして保存できます。 プロファイルには、プロジェクト ID、組織 ID、オプションで、今後の Atlas CLI セッションで使用する APIキーが保存されます。 時間を節約するには、各コマンドで --projectIdと--orgIdフラグを使用する代わりにプロファイルを指定します。 Atlas CLI は、 config.tomlと呼ばれる構成ファイルにプロファイルを保存します。
注意
環境変数に保存されている設定は、プロファイルに保存されている設定よりも優先されます。 --projectIdと--orgIdフラグで指定されたプロジェクトまたは組織は、プロファイルと環境変数の両方よりも優先されます。
構成ファイルを見つけます
Atlas CLI は、オペレーティング システムに応じて次の場所に構成ファイルを保存します。
%AppData/atlascli
/Users/{username}/Library/Application Support/atlascli
$XDG_CONFIG_HOME/atlascli
デフォルトでは、Atlas CLI は構成ファイルを$XDG_CONFIG_HOME環境変数で定義されたパスに保存します。 $XDG_CONFIG_HOME変数で定義されているパスを希望の場所に変更できます。 変数の変更の詳細については、「$XDG_CONFIG_HOME XDG ベース ディレクトリの仕様 」を参照してください。
$XDG_CONFIG_HOMEが設定されていない場合、Atlas CLI は次を使用します。
$HOME/.config/atlascli
Atlas CLI は、 コマンドを実行したユーザーに、 ファイルへの読み取りアクセス権および書込みアクセス権を付与します。
プロファイルの作成
atlas auth loginまたはatlas config initコマンドを初めて実行すると、Atlas CLI はconfig.tomlファイルとデフォルトのプロファイルを自動的に作成します。 プロファイル、環境変数、または--projectId --orgIdフラグと フラグを指定せずに コマンドを実行すると、Atlas CLI はコマンドにデフォルトのプロファイルを使用します。
ユースケースを選択します
ユースケースに基づいて接続方法を選択します。
コマンド | 認証方法 | ユースケース |
|---|---|---|
atlas auth login | Atlas のログイン認証情報と認証トークン | 非プログラムの使用に最適 |
atlas config init | APIキー | プログラムによる使用に最適 |
詳細については、「接続方法の選択 」を参照してください。
前提条件を完了する
ホストの IP アドレスをIP アクセス リストに追加します。
接続方法として
atlas config initを選択した場合は、 API キーを構成する必要があります。Atlas CLI インストールがファイアウォールの背後にあり、 プロキシURLを使用する場合は、
HTTP_PROXYまたはHTTPS_PROXY環境変数を設定します。重要
Atlas CLI は、
http、https、socks5スキームをサポートしています。 プロキシ サービスのアクセス リストで、メイン ターゲット URL としてcloud.mongodb.com/を指定する必要があります。 プロキシ構成で認証が有効になっている場合は、ユーザー名とパスワードも指定する必要があります。詳細については、「 プロキシ サーバー 」を参照してください。
実行手順
ユースケースを選択し、手順に従ってプロファイルを作成します。
デフォルトのプロファイルまたは名前付きプロファイルを選択します。
デフォルトのプロファイルを作成します。
プロファイル、環境変数、または
--projectId--orgIdフラグと フラグを指定せずに、 コマンドを実行します。--profile defaultフラグを使用します。
--profile <profileName>フラグを使用するには、 という名前のプロファイルを作成します。
デフォルトのプロファイルを作成するには、次の手順に従います。 デフォルト プロファイルがすでに存在する場合、これらのコマンドはデフォルト プロファイルの値をアップデートします。
プロファイル設定を確認します。
プロファイルを確認するには、構成ファイルを表示するか、 atlas config describeコマンドを実行します。 デフォルト プロファイルの場合、 <profileName>はdefaultです。
atlas config describe <profileName>
このコマンドは、次の設定を返します。 Atlas CLI は、セキュリティのためにアクセス トークンとリフレッシュ トークンの値を編集します。
SETTING VALUE "access_token": "redacted", "mongosh_path": "/usr/local/bin/mongosh", "org_id": "60c9877baf349d6fc4fd9744", "output": "json", "project_id": "60c94857241ae99848af45ad", "refresh_token": "redacted", "service": "cloud"
カスタム名のプロファイルを作成するには、次の手順に従います。
プロファイル設定を確認します。
プロファイルを確認するには、構成ファイルを表示するか、 atlas config describeコマンドを実行します。 デフォルト プロファイルの場合、 <profileName>はdefaultです。
atlas config describe <profileName>
このコマンドは、次の設定を返します。 Atlas CLI は、セキュリティのためにアクセス トークンとリフレッシュ トークンの値を編集します。
SETTING VALUE "access_token": "redacted", "mongosh_path": "/usr/local/bin/mongosh", "org_id": "60c9877baf349d6fc4fd9744", "output": "json", "project_id": "60c94857241ae99848af45ad", "refresh_token": "redacted", "service": "cloud"
デフォルトのプロファイルまたは名前付きプロファイルを選択します。
デフォルトのプロファイルを作成します。
プロファイル、環境変数、または
--projectId--orgIdフラグと フラグを指定せずに、 コマンドを実行します。--profile defaultフラグを使用します。
--profile <profileName>フラグを使用するには、 という名前のプロファイルを作成します。
デフォルトのプロファイルを作成するには、次の手順に従います。 デフォルト プロファイルがすでに存在する場合、これらのコマンドはデフォルト プロファイルの値をアップデートします。
プロファイル設定を確認します。
プロファイルを確認するには、構成ファイルを表示するか、 atlas config describeコマンドを実行します。 デフォルト プロファイルの場合、 <profileName>はdefaultです。
atlas config describe <profileName>
このコマンドは、次の設定を返します。 Atlas CLI は、セキュリティのためにAPIキーの値を編集します。
SETTING VALUE "mongosh_path": "/usr/local/bin/mongosh", "org_id": "60c9877baf349d6fc4fd9744", "output": "json", "private_api_key": "redacted", "project_id": "60c94857241ae99848af45ad", "public_api_key": "redacted", "service": "cloud"
カスタム名のプロファイルを作成するには、次の手順に従います。
プロファイル設定を確認します。
プロファイルを確認するには、構成ファイルを表示するか、 atlas config describeコマンドを実行します。 デフォルト プロファイルの場合、 <profileName>はdefaultです。
atlas config describe <profileName>
このコマンドは、次の設定を返します。 Atlas CLI は、セキュリティのためにAPIキーの値を編集します。
SETTING VALUE "mongosh_path": "/usr/local/bin/mongosh", "org_id": "60c9877baf349d6fc4fd9744", "output": "json", "private_api_key": "redacted", "project_id": "60c94857241ae99848af45ad", "public_api_key": "redacted", "service": "cloud"
プロファイルの更新
構成ファイルに保存されている設定は、次の方法でアップデートできます。
テキスト エディターを使用して
config.tomlファイルを編集します。設定には
atlas config setコマンドを実行します。 これにより、config.tomlファイル内の個々の値が編集されます。
プロファイル付きでコマンドを実行
プロファイルを使用して Atlas CLI コマンドを実行するには、次のようにします。
コマンドに
--profile <profileName>フラグを追加するか、--profile <profileName>フラグを省略してデフォルトのプロファイルを使用します。
例
このコマンドは、 myProfileという名前のプロファイルを使用します。
atlas <command> --profile myProfile
このコマンドは、デフォルトの プロファイルを使用します。
atlas <command>