Power Platform Actions

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: 'me@myenv.onmicrosoft.com'
        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: 'me@myenv.onmicrosoft.com'
        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 }}

Contributing

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 opencode@microsoft.com with any additional questions or comments.

Setting Up Dev Environment

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:
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)
```
- Create a PAT in GitHub to read packages, and enable SSO for the microsoft organization. Then add it to your ~/.npmrc file or use the npm login command as documented here. This will only be needed until the @microsoft/powerplatform-cli-wrapper repo is made public.

Getting Started

Clone, restore modules, build and run:

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

Refreshing actions in dist folder

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

Details

CLI command for pac

References

ADAL/MSAL

CustomerEngagement API

Power Platform Environment Admin (BAP)

Environments Overview

dngoins/powerplatform-actions