Doppler CLI について
Doppler CLI は Doppler シークレット管理サービスからシークレットを取得し、コマンド実行、アプリケーション起動、および CI/CD ワークフローに注入するコマンドラインツールです。プロジェクトと設定の選択をサポートし、開発からデプロイまでの環境変数管理を簡潔にします。
主な機能
- 01Doppler からシークレットを取得し、コマンド実行環境に注入する
- 02ローカル開発用に異なるプロジェクトと設定を選択する
- 03CI/CD パイプラインに認証とシークレット管理を提供する
活用シーン
- 01ローカル開発時に API キーとデータベース認証情報に安全にアクセスする
- 02継続デプロイワークフローで環境固有のシークレットを自動的に注入する
- 03複数の開発環境にわたって異なる設定セットを管理・切り替える
インストール
OS またはパッケージマネージャーを選び、コマンドをターミナルで実行します。
インストール後にdoppler --versionを実行して確認します。
コマンド例
よく使うコマンドを使う順に並べています。
詳細
Doppler CLI
Doppler CLI は、Doppler のシークレットや設定を操作するための公式ツールです。
次のことができます:
- シークレット、プロジェクト、環境を管理する
- シークレットを環境に注入してアプリケーションを実行する
- アクティビティログと監査ログを表示する
インストール
Doppler CLI は、人気のある複数のパッケージマネージャーで利用できます。シェルスクリプト、GitHub Action を使ってインストールすることも、スタンドアロンバイナリをダウンロードすることもできます。
バイナリ署名の検証方法など、詳しくは インストール ページをご覧ください。
macOS
brew を使うことをおすすめします。
$ brew install dopplerhq/cli/doppler
$ doppler --version
更新するには:
$ brew upgrade doppler
brew を使わずにインストールする方法については、インストール ページをご覧ください。
Windows
winget を使うことをおすすめします。
$ winget install doppler
$ doppler --version
更新するには:
$ winget upgrade doppler
その他の方法については、インストール ページをご覧ください。
シェルスクリプト
この方法は、パッケージマネージャーの更新を利用しない CI ジョブやその他の環境におすすめです。
$ (curl -Ls --tlsv1.2 --proto "=https" --retry 3 https://cli.doppler.com/install.sh || wget -t 3 -qO- https://cli.doppler.com/install.sh) | sh
詳しくは、インストール ページをご覧ください。
Linux
手順については、インストール ページをご覧ください。
Docker
手順については、インストール ページをご覧ください。
GitHub Action
GitHub Action を使って CLI の最新バージョンをインストールできます。詳しくは cli-action の リポジトリをご覧ください。
使用方法
セットアップは文字どおり 1 分ほどで完了します。CLI による Doppler ワークプレースへのアクセスを承認し、プロジェクトと設定を選択します。
$ doppler login # generate auth credentials
$ doppler setup # select your project and config
# optional
$ doppler configure --all # view local configuration
デフォルトでは、doppler login は認証トークンのスコープをルートディレクトリ(--scope=/)に設定します。つまり、Doppler CLI を使用するプロジェクトは、どのサブディレクトリからでもこのトークンにアクセスできます。スコープを限定するには、ログイン時に scope フラグを指定します:doppler login --scope=./ または doppler login --scope ~/projects/backend。
セットアップ(つまり doppler setup)では、選択したプロジェクトと設定のスコープが現在のディレクトリ(--scope=./)に設定されます。scope フラグを使ってこのスコープを変更することもできます。詳しくは doppler help を実行してください。
Go のバージョン
このプロジェクトでは、複数の場所で Go のバージョンを定義しています。Go のバージョンを更新する場合は、GO_VERSION_DEF を検索し、すべての箇所が更新されていることを確認してください。