Prerequisites
To deploy an Azure TRE instance, the following assets and tools are required:
- Azure subscription
- Azure Active Directory (AAD) tenant in which you can create application registrations
- Git client such as Git or GitHub Desktop
- Docker Desktop
Development container
The Azure TRE solution contains a development container with all the required tooling to develop and deploy the Azure TRE. To deploy an Azure TRE instance using the provided development container you will also need:
The files for the dev container are located in /.devcontainer/ folder.
Tip
An alternative of running the development container locally is to use GitHub Codespaces.
Clone the Azure TRE Git repository
Tip
If using Windows please clone the repository to a Linux file system, i.e. to /xxx rather than c:\, for example within Windows Subsytem for Linux. If you clone the repository to a Windows file system you will likely hit issues with file permissions as described in this issue: https://github.com/microsoft/AzureTRE/issues/1395
git clone https://github.com/microsoft/AzureTRE.git
The Git repository will host some basic configuration for the TRE instances that are deployed from a given repository. Create a new branch for the instance that you are about to deploy.
cd AzureTRE
git checkout -b quickstartenv
-
Open the cloned repository in Visual Studio Code and connect to the development container.
code .
Tip
Visual Studio Code should recognize the available development container and ask you to open the folder using it. For additional details on connecting to remote containers, please see the Open an existing folder in a container quickstart.
When you start the development container for the first time, the container will be built. This usually takes a few minutes.