Contributions - WaelHamze/xrm-ci-framework GitHub Wiki

Contributions are very welcome. Please see the below steps on how to contribute for the different components.

Build Tools

Steps

  1. You will need a Visual Studio Account. You can sign up for free account.
  2. Install TFX CLI
  3. Review the how to guide on creating VSTS tasks/extensions: Add Build Task
  4. Create a personal access token on your VSTS/TFS account: PAS
  5. Fork the Repository
  6. Location: Build Tools
  7. Open the Solution in Visual Studio: Xrm.CI.Framework.BuildTools.sln
  8. Make changes to existing tasks or add a new task
  9. Deploy the Task to your own instance using TFX CLI. You can use this script: DeployTask.ps1
  10. Test your task
  11. Submit a Pull Request
  12. Changes are tested and reviewed
  13. Tasks/Change are published to the market place in the next release

Design Principals

  1. Tasks should be intuitive and easy to use by the consumer
  2. Try to make the logic in the main task script as light as possible. This allows re-using the same functionality elsewhere if needed
  3. At the moment PowerShell is used to create and build the tasks. This was selected as most MS Dynamics developers are more likely to be familiar with this than other alternatives.