Manage applications for multiple environments
Azure Service Fabric clusters enable you to create clusters using anywhere from one to many thousands machines. In most cases, you find yourself having to deploy your application across multiple cluster configurations: your local development cluster, a shared development cluster and your production cluster. All of these clusters are considered different environments your code has to run in. Application binaries can run without modification across this wide spectrum, but you often want to configure the application differently.
Consider two simple examples:
- your service listens on a defined port, but you need that port to be different across the environments
- you need to provide different binding credentials for a database across the environments
The configuration you provide can be divided in two categories:
- Configuration that applies to how your services are run
- For example, the port number for an endpoint or the number of instances of a service
- This configuration is specified in the application or service manifest file
- Configuration that applies to your application code
- For example, binding information for a database
- This configuration can be provided either through configuration files or environment variables
Not all attributes in the application and service manifest file support parameters. In those cases, you have to rely on substituting strings as part of your deployment workflow. In Visual Studio Team Services you can use an extension like Replace Tokens: https://marketplace.visualstudio.com/items?itemName=qetza.replacetokens or in Jenkins you could run a script task to replace the values.
Specifying parameters during application creation
When creating a named application instances in Service Fabric, you have the option to pass in parameters. The way you do it depends on how you create the application instance.
- In PowerShell, the
New-ServiceFabricApplicationcmdlet takes the application parameters as a hashtable.
- Using sfctl, The
sfctl application createcommand takes parameters as a JSON string. The install.sh script uses sfctl.
- Visual Studio provides you with a set of parameter files in the Parameters folder in the application project. These parameter files are used when publishing from Visual Studio, using Visual Studio Team Service or Team Foundation Server. In Visual Studio, the parameter files are being passed on to the Deploy-FabricApplication.ps1 script.
The following articles show you how to use some of the concepts described here: