Reference
env zero project variables
Sync an environment with one env zero project's environment variables.
Sync an environment with one env zero project's environment variables.
Connection
| What | This provider |
|---|---|
| Vendor | env zero |
| Key | env0-variables |
| Availability | available. You can connect it today. |
| Credential we hold | env0-key |
| Values read back | yes |
| Activation | on-next-deploy |
Directions
| Direction | What it does |
|---|---|
import | We read names and values out of the store into your environment. |
export | We write names and values from your environment into the store. |
Activation
on-next-deploy. A new value waits there and arrives with your next deploy.
Conflict policies
| Direction | Policies you can pick |
|---|---|
import | skip_existing, new_version, fail |
export | create_only, overwrite, overwrite_and_prune |
How syncs work says what each one does.
Connect
Paste a credential from the vendor. We seal it and never show it again.
| Field | Label | Kind | Required | What it is |
|---|---|---|---|---|
keyId | API key ID | text | yes | From Organization Settings, API Keys. An Admin key works; a User key needs a role on this project that includes View Project and Edit Project Settings. |
keySecret | API key secret | secret; we mask it here and seal it | yes | Shown once, when the key is created. |
Connection fields
You set these when you connect. Every mapping on the connection shares them.
| Field | Label | Kind | Required | Advanced | What it is |
|---|---|---|---|---|---|
organizationId | Organization ID | text | yes | no | The ID in the address of your Organization Settings page. |
Mapping fields
You answer these once per environment you map.
| Field | Label | Kind | Required | Advanced | What it is |
|---|---|---|---|---|---|
projectId | Project ID | text | yes | no | The ID in the address of the project's pages. We sync the project's own environment variables and never touch the ones it inherits from the organization or a parent project. Pruning deletes every environment variable of this project that this environment lacks, including ones this sync did not write. |
sensitive | Mark written variables sensitive | yes or no | yes | yes | env zero masks a sensitive value after it is saved, so it cannot be imported back. We never turn it off on a variable that has it. Starts at true. |
Required permissions
We probe for these when we verify the connection.
| Permission | Directions | Blocking | Without it |
|---|---|---|---|
VIEW_PROJECT | every direction | yes | Preview cannot list the project's variables. |
EDIT_PROJECT_SETTINGS | export | yes | Export cannot add, change or remove a variable. |