Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Azure AKS Functionality in Tools, Tasks and Pipeline

The Opsera integration with Azure is broken into two components: creation, management and execution of tasks (Opsera Tasks) for managing the clusters and then direct pipeline steps (Opsera Pipelines) to publish containers. The two aspects are necessary to work together in order to complete the functionality. Listed below are details on how to perform all of the tasks in Opsera.

Prerequisites: There must be a registered Azure tool with proper Connection credentials verified to create an Azure cluster template in Tasks. The user must then run the task in order for it to be accessed in the Azure pipeline step.

Tools

To Create an Azure Tool:

  1. Navigate to Tool Registry and select + New Tool button

2. Complete Create New Tool form. For Tool Identifier field, select Azure.

3. Select Create and tool will save.

Configure Applications

  1. Navigate to the Tool Detail.

  2. Navigate to the Applications tab and select +New Azure Application Credential

3. Provide the following values:

Name - Provide a name for the application. Note: After saving, the Application Name cannot be edited.

Resource - Value found in the Azure portal.

Client ID - Value found in the Azure portal.

Client Secret - Value found in the Azure portal.

4. Select Save to save application.

The application is now stored in the tool’s Applications tab:

The tool can now be configured in a Create Azure AKS Cluster

Tasks

There are 2 steps to Azure Cluster creation. Template creation is a prerequisite to creating the cluster. Once the template has been created, you must select Run Task for the first cluster to be created.

  1. To create an Azure AKS Cluster template, navigate to Tasks.

  2. Select “Create Azure AKS Cluster” from the Type drop down. Once this has been selected, other drop down fields will become available to select to continue creation process.

Azure Credential - This field is fetched from Applications tab of the selected Azure tool.

Azure Region - The region selected is the location of the data center where the resources will operate. In selecting a region, consider that the region is close in proximity to customer (if necessary) and that it will meet all necessary legal or compliance needs.

Machine Type - Select the name of the desired virtual machine size.

Azure Kubernetes Version - Select the Kubernetes version. The default version will display for the region selected.

Cluster Name - Choose a unique name for the Azure cluster. Reference this name in the Azure pipeline step.

Disk Size - Select the disk size for template. Disk size is in GB and ranges from 32-1000

Minimum Nodes - Choose a minimum number of nodes.

Maximum Nodes - Choose a maximum number of nodes.

VPC CIDR Block - Select an existing VPC CIDR Block from the Azure portal.

Subnet CIDR Block - Select an existing Subnet CIDR Block from the Azure portal.

Once the user has filled in all the required information the user will be redirected to the task’s screen where the user can view the summary of the information entered and there is an option to run the task.

Tasks run in a similar fashion to the pipelines where they auto update based on the status of the orchestration once the run has been triggered. The logs can be viewed segregated by run count in the Activity Logs screen. Click on any row to view more log info, including detailed messages about failure or success.

Pipeline Setup

Azure Service Deployment Flow:

Build step → Azure ACR Push → Azure AKS Deploy

Once the user has successfully created the cluster template in tasks then successfully ran it to create the cluster in Azure, they can then use the Azure AKS Deploy pipeline step to deploy docker images to the Azure Cluster. In order to run this step successfully, there needs to be a build step and an Azure ACR Push step to be successfully configured in the pipeline.

Azure Tool - Choose the tool that was used to create the Azure cluster.

Azure Credential - Drop down values will include the selected tool’s configured applications.

Cluster Name - Drop down includes successfully run clusters created in Tasks.

Generate Dynamic Service Name - When switch is enabled, a unique service name for each pipeline run using the Dynamic Name Prefix given and the run count will be generated (for example: PrefixName -1, PrefixName-2).

Service Name - Azure Service names must also be unique hence we have the ability to generate unique service names for every run based on the run count which can be enabled via the specified toggle in the pipeline step.

Host URL - Host URL is unique to user.

Service Port - This is the location where service will be deployed.

Artifact Step - Select the corresponding Azure ACR push step.

After all the details have been configured the step will run as a general pipeline step and the logs can be viewed from the Summary/Activity Logs table

  • No labels