Skip to content
This repository has been archived by the owner on Jul 4, 2024. It is now read-only.

This repository provides an easy way to get started on publishing an offer to the Microsoft Commercial Marketplace.

License

Notifications You must be signed in to change notification settings

microsoft/commercial-marketplace-offer-solution

Repository files navigation

Commercial Marketplace Offer Templates

This repository provides an easy way to get started on publishing an offer to the Microsoft Commercial Marketplace.

Included in this repository are:

  • Azure Application and Azure Virtual Machine offer type templates
  • GitHub actions and starter workflows to help you get started with automation
  • Scripts to help you run common tasks, such as creating a VM image

These templates are designed to be a starting point for your offer and are not intended to be a complete solution. You are free to modify the templates to meet your needs.

Getting Started

Step 1: Create a repository

The easiest way to get started is to use the GitHub Template Repository feature to create a new repository from this template. You can also fork or clone this repository and modify the files to meet your needs.

Step 2: Install Tools

The templates and scripts in this repository use the following tools:

Please refer to the setup scripts for your operating system for easy installation:

Step 3: Associate an Azure AD application with your Partner Center account

The scripts in this repository use the Partner Center API to create and manage offers. To use the scripts, you must first associate an Azure AD application with your Partner Center account. Follow the instructions in the Commercial Marketplace documentation to create an Azure AD application and associate it with your Partner Center account.

Step 4: Modify Offer Template Files

Use the following offer templates to build your own Commercial Marketplace offerings. Each offer template includes a README file that contains instructions on how to build the offer and modify it for your use case.

This offer template demonstrates how to build a solution template Azure Application offer. This offer deploys a Windows Server 2019 VM and runs a custom script extension that writes content to a file. The custom script extension runs a PowerShell script after the VM has been provisioned.

This offer template demonstrates how to create a Windows Server 2019 virtual machine image with Chocolatey and Microsoft Edge installed. The image can then be used to create an Azure Virtual Machine offer.

This offer template demonstrates how to build a solution template Azure Application offer that uses a VM image from a Virtual Machine offer.

Step 5: Create GitHub Workflows

GitHub actions and starter workflows are provided to automate the build, test and publish process for Commercial Marketplace offers.

Before using a workflow or action, create a new actions repository secret (AZURE_CREDENTIALS) with the following:

{
  "clientId": "<Azure AD application client ID>",
  "clientSecret": "<Azure AD application client secret>",
  "subscriptionId": "<Azure subscription ID>",
  "tenantId": "<Azure AD application tenant ID>",
  "resourceManagerEndpointUrl": "https://management.azure.com/"
}

For more information on creating a GitHub actions repository secret, see Creating encrypted secrets for a repository.

To use an action, refer to it as follows in your workflow:

microsoft/commercial-marketplace-offer-solution/.github/actions/[ACTION DIRECTORY]

For example:

steps:
  - name: Build and create/update offer
    uses: microsoft/commercial-marketplace-offer-solution/.github/actions/commercial-marketplace

Refer to the GitHub documentation for more information on using starter workflows.

Contribute

Contributions to this repository are welcome. Here's how you can contribute:

  • Submit bugs and help us verify fixes.
  • Submit feature requests and help us implement them.
  • Submit pull requests for bug fixes and features.

Please refer to Contribution Guidelines for more details.

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.

About

This repository provides an easy way to get started on publishing an offer to the Microsoft Commercial Marketplace.

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published