Building the Deployment Executable

The deployer can easily be built from any platform (and target any other platform) using the .NET SDK and the dotnet command-line interface.

Building on Linux

Prerequisites

• Install the .NET 8 SDK for Linux. Follow the instructions specific to your Linux distribution and version.

---

Building on Windows

Prerequisites

• Download and install the .NET 8 SDK for Windows. Follow the installation wizard.

Recommended

• Install Visual Studio 2022 (VS 2022) for an enhanced development experience.

---

Building on macOS

Prerequisites

• Install the .NET 8 SDK for macOS. Follow the instructions for your macOS version.

---

Build Steps

1. Clone the Repository
   Clone the Cromwell on Azure repository.

2. Build the Solution
   Run the dotnet build command in your terminal (Bash, PowerShell, or Zsh).

   • On Windows, you can also build the solution using Visual Studio 2022.
   • On macOS, you can optionally use Visual Studio for Mac.

3. Run Tests
   Run the dotnet test command in your terminal to ensure everything is working correctly.

4. Publish the Executable
   Publish the deploy-cromwell-on-azure project as a self-contained deployment using the appropriate runtime identifier (RID) for your platform.

   Example commands:

   • Linux: dotnet publish -r linux-x64
   • Windows: dotnet publish -r win-x64
   • macOS: dotnet publish -r osx-x64

   Note:
   If you encounter failures, try deleting the nuget.config file at the root of the directory before publishing.

---

Additional Resources

• Publish command details
• Self-contained deployments (SCD)
• Learn more about dotnet commands