From 4816a6af8b79c2671c51782d84f9dc4cc57aaf7b Mon Sep 17 00:00:00 2001
From: Wolmer <81027593+thewolmer@users.noreply.github.com>
Date: Sat, 3 Aug 2024 19:04:53 +0530
Subject: [PATCH] doppler: add page (#13345)

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>
Co-authored-by: spageektti <git@spageektti.cc>
---
 pages/common/doppler-projects.md | 24 ++++++++++++++++++++++++
 pages/common/doppler-run.md      | 24 ++++++++++++++++++++++++
 pages/common/doppler-secrets.md  | 24 ++++++++++++++++++++++++
 pages/common/doppler.md          | 29 +++++++++++++++++++++++++++++
 4 files changed, 101 insertions(+)
 create mode 100644 pages/common/doppler-projects.md
 create mode 100644 pages/common/doppler-run.md
 create mode 100644 pages/common/doppler-secrets.md
 create mode 100644 pages/common/doppler.md

diff --git a/pages/common/doppler-projects.md b/pages/common/doppler-projects.md
new file mode 100644
index 000000000..a11a30280
--- /dev/null
+++ b/pages/common/doppler-projects.md
@@ -0,0 +1,24 @@
+# doppler projects
+
+> Manage Doppler Projects.
+> More information: <https://docs.doppler.com/docs/cli>.
+
+- Get all projects:
+
+`doppler projects`
+
+- Get info for a project:
+
+`doppler projects get {{name|project_id}}`
+
+- Create a project:
+
+`doppler projects create {{name}}`
+
+- Update a project's name and description:
+
+`doppler projects update {{name|project_id}} --name "{{new_name}}" --description "{{new_description}}"`
+
+- Delete a project:
+
+`doppler projects delete {{name|project_id}}`
diff --git a/pages/common/doppler-run.md b/pages/common/doppler-run.md
new file mode 100644
index 000000000..f79cc2a22
--- /dev/null
+++ b/pages/common/doppler-run.md
@@ -0,0 +1,24 @@
+# doppler run
+
+> Run a command with Doppler secrets injected into the environment.
+> More information: <https://docs.doppler.com/docs/cli#run-a-command-with-secrets-populated-in-environment>.
+
+- Run a command:
+
+`doppler run --command {{command}}`
+
+- Run multiple commands:
+
+`doppler run --command {{command1 && command2}}`
+
+- Run a script:
+
+`doppler run {{path/to/command.sh}}`
+
+- Run command with specified project and config:
+
+`doppler run -p {{project_name}} -c {{config_name}} -- {{command}}`
+
+- Automatically restart process when secrets change:
+
+`doppler run --watch {{command}}`
diff --git a/pages/common/doppler-secrets.md b/pages/common/doppler-secrets.md
new file mode 100644
index 000000000..b1c985b01
--- /dev/null
+++ b/pages/common/doppler-secrets.md
@@ -0,0 +1,24 @@
+# doppler secrets
+
+> Manage your Doppler project's secrets.
+> More information: <https://docs.doppler.com/docs/accessing-secrets>.
+
+- Get all secrets:
+
+`doppler secrets`
+
+- Get value(s) of one or more secrets:
+
+`doppler secrets get {{secrets}}`
+
+- Upload a secrets file:
+
+`doppler secrets upload {{path/to/file.env}}`
+
+- Delete value(s) of one or more secrets:
+
+`doppler secrets delete {{secrets}}`
+
+- Download secrets as `.env`:
+
+`doppler secrets download --format=env --no-file > {{path/to/.env}}`
diff --git a/pages/common/doppler.md b/pages/common/doppler.md
new file mode 100644
index 000000000..7672a91c3
--- /dev/null
+++ b/pages/common/doppler.md
@@ -0,0 +1,29 @@
+# doppler
+
+> Manage environment variables across different environments using Doppler.
+> Some subcommands such as `doppler run` and `doppler secrets` have their own usage documentation.
+> More information: <https://docs.doppler.com/docs/cli>.
+
+- Setup Doppler CLI in the current directory:
+
+`doppler setup`
+
+- Setup Doppler project and config in current directory:
+
+`doppler setup`
+
+- Run a command with secrets injected into the environment:
+
+`doppler run --command {{command}}`
+
+- View your project list:
+
+`doppler projects`
+
+- View your secrets for current project:
+
+`doppler secrets`
+
+- Open doppler dashboard in browser:
+
+`doppler open`