Workspaces

Workspace browser

Workspace page accessible to site admins, allows to manage workspaces.

What is a workspace?

  • Workspace is an data structure that contains files (terraform scripts, json files, etc.).

  • Workspace can have plan associated with it. With this, plan data is automatically transferred into workspace and saved as a JSON file.

  • Workspaces can also be connected with remote Git repositories.

  • Terraform and Git operations processed externally are performed against entire workspaces. They are treated as virtual "folders" containing files.

  • Workspaces can be selected. Terraform console and Execution logs pages operates on selected workspaces.

  1. In this box you can enter a name of new workspace and create it with "New workspace" button. After that, the list will refresh and you will see new workspaces appended. Workspaces are empty when created. Name of the workspace is presented in the list.

  2. Workspace list contains all workspaces existing in given instance.

  3. Select workspace operation marks it as a currently selected workspace. This is important for Terraform console and Execution logs page, as they operate on selected workspace data. When workspace is selected, green icon appears before workspace name.

  4. You can rename workspace, by typing new name in dialog form and saving it.

  5. You can view files stored in given workspace. Files are stored in Atlassian Forge app storage.

  6. You can delete workspace and all it's files. Confirm the operation in dialog.

Deleting a workspace will remove all files stored inside it!

If you delete a workspace that contains associated plan, it will not remove the plan! You will see in plan browser, that workspace association was removed.

  1. Label "Remote / Not connected" present information is given workspace is associated with remote Git repository. New workspaces are not connected by default.

  2. This workspace description shows:

    1. Generic workspace ID that helps to debug and identify given workspace. Workspace ID can be present on plan browser if it's associated with plan

    2. Associated plan ID is present if workspace was created from plan browser. Otherwise, it will be set to None.

Last updated