Rate this page:
When you call , we automatically create three environments for you:
Environments are where you deploy your app. Once an app is running in an environment, you can install it from that environment on to an Atlassian site with . This process is documented in our app tutorials.
We recommend using the development environment for testing your changes, staging for a stable version of your app, and production as the version of your app that’s ready for use.
By default, the CLI will run commands for the development environment unless you specify another with the flag.
While your app is deployed to development, your app title will have the suffix . Similarly, while your app is deployed to staging, it will have the suffix . Once you deploy your app to production, your app title will no longer have any suffix.
When using the staging environment, you can't use the command. You'll need to redeploy your app using each time you make a code change.
When using the staging and development environments, you won't be able to view the scopes defined for the APIs included in your Forge app. You'll need to deploy your app to the production environment for scopes to display. See View Forge app permissions for more details.
When using the production environment, you can't use the or commands. To debug issues, you’ll need to redeploy your affected code to the staging or development environments where you have access to debugging tools. For apps installed on sites you don’t have access to, you’ll need to ask the app user to download the logs for your app and send them to you.
Environment variables are key-value pairs you can manage via the Forge CLI variables commands. Each of your variables has separate values corresponding to the different environments your app is deployed to (development, staging, production). As with other Forge CLI commands, the Forge CLI variables commands act on the development environment unless another environment is specified explicitly.
List your environment variables by running:
forge variables list
Set a variable with key MY_KEY and value my-value by running:
forge variables set MY_KEY my-value
Set an encrypted variable by providing the option by running:
forge variables set --encrypt MY_KEY my-value
Encrypted values are protected from output. However, they are passed to your app's environment as clear text.
Unset a variable with key MY_KEY by running:
forge variables unset MY_KEY
Read a variable with key MY_KEY in your code as below:
The same variable can be set in the production environment through the option.
forge variables set --environment production --encrypt MY_KEY my-value
When you're using the command, you must prefix environment variables with .
Set the value of by prefixing to the variable name, then running the following command in your terminal:
You do not need to change variable assignment when using environment variables with , the variable is still accessed with .
const myVar = process.env.MY_KEY // MY_KEY will be "test"
When you deploy a Forge app, a new version is created in the Forge environment you specified, or by default; the environment. As you iterate on the app and deploy changes, you'll create more versions.
Forge app version numbers are handled automatically by the platform and cannot be specified in the file. The Forge CLI does not show explicit version numbers, instead it shows latest or out-of-date when viewing app installations. Site administrators have access to the Forge version number when managing app installations in an Atlassian product.
After deploying a new version of your app, you'll see one of two different behaviors based on whether your changes are considered “minor” or “major”. There are various factors that we use to determine this, outlined below.
Major version upgrades are not applied to an app installation immediately. This is because major versions involve significant changes that may require users and admins to re-consent or review the changes before continuing.
The following changes are considered major version upgrades, and are all applied to the file:
You can use the Forge CLI to complete a major upgrade with . Site admins can select upgrade from the manage apps screen to complete the app upgrade.
Minor upgrades are not versioned. Instead, your app code is replaced with a new latest version. The Forge CLI shows latest as the changes are applied as part of the process.
Minor upgrades are automatic and don't require any action by users or site admins.
Rate this page: