Azure Container Service Plugin

Jenkins Plugin to create an Azure Container Service cluster with a DC/OS orchestrator and deploys a marathon config file to the cluster.

Pre-requirements

Register and authorize your client application.

Retrieve and use Client ID and Client Secret to be sent to Azure AD during authentication.

Refer to

• Adding, Updating, and Removing an Application
• Register a client app

How to install the Azure Container Service Plugin

1. Download the azure-acs-plugin.hpi file from here
2. Within the Jenkins dashboard, click Manage Jenkins.
3. In the Manage Jenkins page, click Manage Plugins.
4. Click the Advanced tab.
5. Click on the Choose file button in the Upload Plugin section and choose the azure-acs-plugin.hpi file.
6. Click the Upload button in the Upload Plugin section.
7. Click either “Install without restart” or “Download now and install after restart”.
8. Restart Jenkins if necessary.

Configure the plugin

1. Within the Jenkins dashboard, Select a Job then select Configure
2. Scroll to the "Add post-build action" drop down.
3. Select "Azure Container Service Configuration"
4. Enter the subscription ID, Client ID, Client Secret and the OAuth 2.0 Token Endpoint in the Azure Profile Configuration section.
5. Enter the Region, DNS Name Prefix, Agent Count, Agent VM Size, Admin Username, Master Count, and SSH RSA Public Key in the Azure Container Service Profile Configuration section.
6. Enter the Marathon config file path, SSH RSA private file path, and SSH RSA private file password in the Marathon Profile Configuration section.
7. Save Job and click on Build now.
8. Jenkins will create an Azure Container Service cluster and deploy the marathon file to the cluster upon cluster creation if cluster doesn't exist. Otherwise, the marathon file will be deployed to the existing Azure Container Service cluster.
9. Logs are available in the builds console logs.