PRE-RELEASE SOFTWARE. The software is a pre-release version. It may not work the way a final version of the software will. We may change it for the final, commercial version. We also may not release a commercial version.

This repo provides multiple GitHub Actions for the Power Platform. Each action wraps the existing Power Apps CLI. Detailed documentation on GitHub actions for Power Platform is available here.

Sample workflows and detailed instructions are available in our GitHub actions lab repo but if you are already familiar with GitHub actions and Power Platform solutions, simply add below to your existing workflows; also add the secret MYPASSWORD to your repo's 'Settings' | 'Secrets'

jobs:
  build:

    runs-on: windows-latest   # For now, only Windows runners are supported.

    steps:
    - name: Export Solution
      uses: microsoft/powerplatform-actions/export-solution@v0
      with:
        environment-url: 'https://myenv.crm.dynamics.com'
        user-name: '[email protected]'
        password-secret: ${{ secrets.MYPASSWORD }}
        solution-name: aSolution
        solution-output-file: 'aSolution.zip'
        working-directory: 'out'

    - name: Unpack Solution
      uses: microsoft/powerplatform-actions/unpack-solution@v0
      with:
        solution-file: 'out/aSolution1.zip'
        solution-folder: 'out/solutions/solution one'
        solution-type: 'Unmanaged'
        overwrite-files: true

    - name: Publish Solution
      uses: microsoft/powerplatform-actions/publish-solution@v0
      with:
        environment-url: 'https://myenv.crm.dynamics.com'
        user-name: '[email protected]'
        password-secret: ${{ secrets.MYPASSWORD }}

    - name: Prepare solution changes for checkin into source control
      uses: microsoft/powerplatform-actions/branch-solution@v0
      with:
        solution-folder: 'out/solutions/solution one'
        solution-target-folder: 'src/solutions/solution1'
        token: ${{ secrets.GITHUB_TOKEN }}

PRE-RELEASE SOFTWARE. This project will welcome contributions and suggestions in the near future. But in this early preview stage, we're not ready for contributions.

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.

Windows, macOS or Linux:

• Node.js LTS (currently v12)
• gulp CLI: npm install -g gulp-cli
• git
• VS Code or your different favorite editor
• recommended VSCode extensions:
  • EditorConfig for VS Code (editorconfig.editorconfig)
  • ESLint (dbaeumer.vscode-eslint)
  • GitLens (eamodio.gitlens)
  • markdownlint (davidanson.vscode-markdownlint)
  • Mocha sidebar (maty.vscode-mocha-sidebar)
• TEMPORARY: create a PAT for the Azure DevOps org msazure with scope: package(read) and add it as local environment variable:

[Environment]::SetEnvironmentVariable('AZ_DevOps_Read_PAT', '<yourPAT>', [EnvironmentVariableTarget]::User)

Clone, restore modules, build and run:

git clone https://github.com/microsoft/powerplatform-actions.git
cd powerplatform-actions
npm install
gulp

Run npm run dist and commit and push the updates in the ./dist folder.

CLI command for pac

• WebAPI
• WebAPI REST API
• OrgService
• Org url discovery

• Environments Overview