×
Community Blog Continuous Deployment Automation on Alibaba Cloud: CI/CD Automation on Container Service (2)

Continuous Deployment Automation on Alibaba Cloud: CI/CD Automation on Container Service (2)

This article series describes a practical approach of implementing a Continuous Integration and Deployment (CI/CD) lifecycle using Alibaba Cloud Container Service.

By Evan Wong, Solutions Architect

1. Prerequisites

Before going through the step-by-step guides, the user should have the following prerequisites:

  • A decent computer or laptop.
  • A web browser, recommended Google Chrome.
  • A stable internet connection.
  • An Alibaba Cloud account.
  • Basic knowledge of operations of Linux operating systems.
  • A good understanding and basic knowledge of Docker container and the usage of Dockerfile.
  • A fundamental knowledge of Kubernetes.
  • A GitHub account.

2. Resources

This tutorial uses a number of third party resources including the sample application source codes. Special thanks to Satya Depareddy for the application source codes on GitHub -

https://github.com/depareddy/java-webapp-docker

3. Introduction

This is the second part of the DevOps series. In the previous article, we looked at configuring CI/CD pipelines using Container Service and Container Registry automation features. This part focuses on the deployment of Docker image to Alibaba Cloud Container Service and the steps to automate the flow of continuous deployment on the cloud.

4. Setup Container Service

Before creating a container cluster, there are some services that need to be activated for the first-time users. If the Cloud resources are not activated, it need to be activated before you can proceed to create the Kubernetes cluster.

4.1 Create a Kubernetes Cluster

1

Navigate to the Container Service console, select Kubernetes, and click the Create Kubernetes Cluster button.

There are four different editions of Kubernetes cluster that you can create on Alibaba Cloud.

  • Kubernetes – This edition is the standard Kubernetes cluster that provides full control on the underlying infrastructure. You can manage the master and worker nodes directly.
  • Managed Kubernetes – This is the managed Kubernetes where the master nodes are managed by Alibaba Cloud, you do not need to worry about the health, scalability of the master nodes. All you need to focus is control the worker nodes.
  • Multi-AZ Kubernetes – This is the cluster that span across different availability zones. Choose this option for better fault tolerant on physical data center availability
  • Serverless Kubernetes (beta) – At this point of writing, this edition is currently on beta. This edition provides the highest level of abstraction of underlying infrastructure resources. Developers only need to focus on application deployment and leave the management of the infrastructure to the Cloud Service Provider.

In this lab, we would choose the standard Kubernetes cluster.

2

Go to the Kubernetes Cluster configuration page, specify a name in Cluster Name and then select the Region and Zone of your choice and select "Use Existing" for VPC. Choose vpc-devops for VPC and vswitch-devops for VSwitch.

If the VPC and the VSwitch is not created, you can choose the Auto Create for VPC option.

3

Select configuration, instance type (recommended 2 core, 4G RAM, 40GB ultra disks) for master and worker nodes.

For master nodes, by default it is fixed to 3 master nodes and the number of worker nodes should be set to 2.

4

Set the logon password for the master cluster to "Kubernetes@2019" or a password of your own choice, and select a logon method that allows logging on to the cluster through SSH. CloudMonitor options can be cleared to reduce the time needed to create the cluster. Leave everything default.

5

Click the Create button to create the Kubernetes cluster.

6

7

The screen will show that the cluster is being created. Since a large number of services will be created during the cluster creation process, please wait patiently for 15 - 20 minutes. You can view the creation status in the Container Service console. Shown below are successfully created services.

8

Cluster created successfully if the screen shown as above. Click back to cluster list. Examine the cluster status if it is running.

9

Click on the cluster name to view detailed information.

10

API Server Internet endpoint: The service address and port used by the Kubernetes API server to provide services for Internet. You can use kubectl or other tools on the user terminal through this service to manage the cluster.

API Server Intranet endpoint: The service address and port used by the Kubernetes API server to provide services for Intranet. This IP address is the address of the Server Load Balancer with three backend master nodes providing services.

Master node SSH IP address: You can directly log on to the master node through SSH to facilitate daily maintenance on the cluster.

Service Access Domain: The domain name used for testing services in the cluster.

5. Setup Container Registry

5.1 Create GitHub Account (Optional)

If you do not have a GitHub account, go to www.github.com and sign up for a new account. Fill in the username, email and password. Then, after verification, choose the Free account.

11

After registration is completed, it shall bring you the main landing page.

12

5.2 Fork the Application Source Codes

In this lab, we are using GitHub as the source code repository. First, you would need to fork the source codes from existing Git repository: https://github.com/echoesian/java-webapp-docker. To do this, login into your own GitHub and navigate to this repository https://github.com/echoesian/java-webapp-docker. Click on the Fork on the top right hand corner on the screen.

13

After forking successful, you should have the source codes in your own repository.

5.3 Bind GitHub account to Container Registry

Go to the Alibaba Cloud console, click Home in the upper left corner of the page, and select Container Registry.

14

The prompt shown in the following figure appears upon your first logon. Select Malaysia (Kuala Lumpur) or any other region of your choice in the upper left corner and click OK.

Go to Code Source and click Bind Account

15

On the pop-up dialog, click on the right arrow. It will open a new link to sign in to the GitHub account.

16

On the GitHub sign-in page, input the login details and click Sign In.

17

On the Authrization page, click on "Authroize Aliyun Developer"

18

Once it is authorized, you should receive a notification email. Go back to the Container Registry page. Click on the Account Bound button.

19

By now, it should show "Bound" on the GitHub code source section.

20

5.4 Namespace

Go back to the Namespace page. On the defaut prompt, click OK.

21

If it is the first time, click on the Reset Docker Login Password.

22

Set the Docker logon password to [Aliyun-test] or [your choice of password].

23

A namespace is a collection of repositories. We recommend that you group the repositories of a company or organization in one namespace.

  • Use company name as the namespace: aliyun, alibaba
  • Use team or organization as the namespace: misaka-team

The following figure shows the list of namespaces. In this lab, we would be using the existing namespace devops-workshop.

24

5.5 Create New Repository

Create a repository according to the following figure. Set the region to Malaysia (Kuala Lumpur) or any other region of your choice.

25

Set parameters according to the following figure and click Next. Select the namespace you created earlier.

26

Select GitHub, input your account user name and project. Click Create Repository.

27

The following figure shows that the repository has been created.

28

Click Manage to open the repository.

Detailed commands for pushing images to this repository are displayed.

29

Copy the first command shown in the following figure to the ECS terminal and enter the repository logon password.

30

5.6 Push the Docker Image to the Container Registry

On the terminal, on the root level, navigate to the application source code directory.

$ cd java-webapp-docker

List the available docker images:

$ docker images

31

Copy the second command shown in the following figure to the ECS terminal (replace [ImageId] with the actual one and set [tag] to v1).

32

33

Copy the third command shown in the following figure to the ECS terminal (set [tag] to v1).

34

The following figure shows that the image is being uploaded.

35

The following figure shows that the image has been uploaded.

36

Go to the Alibaba Cloud console and select Tags. The uploaded image is displayed.

37

5.7 Configure Automatic Image Build

Go to the build section, enable the Automatically build image option.

38

For details about how to download the image in other environments, see the repository guide.

39

6. Deploy Application to Container Service

6.1 Initial Application Deployment to Kubernetes Cluster

Go to the Container Registry page, click on the manage link on the repository that was created earlier.

40

Click on the "Deploy Application".

41

On the prompt up page, click on the Deploy button.

42

On the container service page, leave all defaults and click Next.

43

Select latest image version (1.0), enable Always pull image and click Next.

44

Click Create.

45

The next page should show Create Success. Verify if the deployment is successful.

46

6.2 Create Service

Go to the Discovery->Load Balancing page->Service. Click create to create a new Server Load Balancer to expose the port of the application.

47

48

Input the name of the service, choose Service Load balancer and public for type and choose the related container application. On port mapping input 8080 for service port and container port respectively. Leave protocol to TCP as default.

6.3 Create Trigger

Go to Container service -> Deployment

49

To create a new trigger, navigate to the trigger section and click on the "Create Trigger" button

50

On the pop-up dialog, choose "Redeploy" as the Action. Click confirm.

51

Once the trigger is created, you should see a URL link appear as below. Copy this link to the clipboard so that it can be used in the later section.

52

Go back to the container registry page and navigate to the trigger section. Click on the "Create" button on the top right.

53

On the pop-up dialog, key in the following details and paste the URL link from the Container Service trigger page that was copied previously.

54

7. Continuous Integration and Deployment on Container Service

In this lab, we are using GitHub as the source code repository. In this section, you would be committing a code change on the existing tag and push the changes to the remote git.

Generally, the workflow of the code commit is listed below.

1) Create a branch with the tag

    git branch {tagname}-branch {tagname}
    git checkout {tagname}-branch

2) Include the fix manually if it's just a change ....

    git add .
    git ci -m "Fix included"

3) Delete and recreate the tag locally

    git tag -d {tagname}
    git tag {tagname}

4) Delete and recreate the tag remotely

    git push origin :{tagname} // deletes original remote tag
    git push origin {tagname} // creates new remote tag

7.1 Install Git

$yum install -y git

55

7.2 Clone the Source Codes to Local Computer

Next, you would need to clone the codes to the local computer. To do that open a terminal or command prompt. Type

$git clone https://github.com/echoesian/java-webapp-docker

56

After the codes are successfully cloned.

7.3 Create a New Tag

To create a new tag, type

$git tag release-v1.0

57

7.4 Create a New Branch

To create a new branch from the tag,

$git branch release-v1.0-branch release-v1.0

58

7.5 Checkout the Codes from the Branch

Checkout the source codes from the new branch

$git checkout release-v1.0-branch

59

7.6 Change the Existing Source Code

Go to the home directory of the project source code – java-webapp-docker. Change the directory to src/main/webapp. Open the index.jsp with an editor such as vi or vim. Change the header

to "Welcome to Alibaba Cloud DevOps v1.0".

<html>
<body>
<h1>Welcome to Alibaba Cloud DevOps v1.0</h1>
</body>
</html>

7.7 Commit Changes and Create New Tag

Add the file to the Git for commit by typing:

$git add .

60

Then, to commit the code to the repository:

$git commit -m "changed header text"

61

Delete and recreate the tag remotely

$git push origin :release-v1.0

62

To create the new tag

$git push origin release-v1.0

63

To enable credential caching for the remote GitHub functions:

$ git config credential.helper store
$ git remote -v

Username for 'https://github.com': <USERNAME>
Password for 'https://USERNAME@github.com': <PASSWORD>

7.8 Automatic Build

Once the changes being push to the GitHub remote repository, Alibaba Cloud Container Registry should have been triggered and build the new image automatically. Go to the container registry page -> build and check out the status of the build. The status should show "Successful".

64

You can view the log of the build task.

65

Click refresh on the top right corner of the pop-up page to view the latest log.

66

Go back to the Container Service and navigate to the Deployment section. Click on the simplewebapp-default and navigate to the Events section. You would notice that the deployment job has scaled down the previous pod, pull the latest image and deploy the new image to the pod.

67

Go to the History version section, the latest version is placed on top of the list. If there is a need to roll back to the previous versions, you can click on the Rollback link on the version.

68

Open the browser and key in the service address with the context path /simplewebapp. The new site should show "Welcome to Alibaba Cloud DevOps v1.0".

69

The URL address can be found on the Container Service -> Service page. There would be an external IP address appear on the ExternalEndpoint label.

70

In the next part of the series, this tutorial extends to execute the Kubernetes deployment strategies namely rolling update, blue-green release and canary release. Stay tuned.

0 0 0
Share on

Alibaba Clouder

1,402 posts | 218 followers

You may also like

Comments

Alibaba Clouder

1,402 posts | 218 followers

Related Products