GitHub Action for substituting variables in parameterized files

With the Variable Substitution Action for GitHub, you can apply variable substitution to XML, JSON and YAML based configuration and parameter files.

• Tokens defined in the target configuration files are updated and then replaced with variable values.
• Variable substitution is applied for only the JSON keys predefined in the object hierarchy. It does not create new keys.
• Only variables defined explicitly as Environment variables as part of the workflow or system variables that are already available for workflow context can be used in substitution.

If you are looking for more Github Actions to deploy code or a customized image into an Azure Webapp or a Kubernetes service, consider using Azure Actions.

The definition of this Github Action is in action.yml.

End-to-End Sample Workflow

Sample workflow to apply Variable substitution on XML, JSON, YML files

# .github/workflows/var-substitution.yml
on: [push]
name: variable substitution in json, xml, and yml files

jobs:
  build:
    runs-on: windows-latest
    steps:
    - uses: joshlrogers/[email protected] 
      with:
        files: 'Application/*.json, Application/*.yaml, ./Application/SampleWebApplication/We*.config'
      env:
        Var1: "value1"
        Var2.key1: "value2"
        SECRET: ${{ secrets.SOME_SECRET }}

Define splitChar to change the character used to split the environment variable names for variable identification and substitution

# .github/workflows/var-substitution.yml
on: [push]
name: variable substitution in json, xml, and yml files

jobs:
 build:
   runs-on: windows-latest
   steps:
   - uses: joshlrogers/[email protected]
     with:
       files: 'Application/*.json, Application/*.yaml, ./Application/SampleWebApplication/We*.config'
       splitChar: '__'
     env:
       Var1: "value1"
       Var2__key1: "value2"
       Var3__key1__key2: "value3"
       SECRET: ${{ secrets.SOME_SECRET }}

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.