Build a Java application image with a Dockerfile

Step 1: Bind a source code repository

In the Alibaba Cloud Container Registry console, bind your hosted code repository. This example uses a GitHub repository.

1. Log on to the Container Registry console.

2. In the top navigation bar, select a region.

3. On the Instances page, click the Personal Edition instance that you want to manage.

4. In the left-side navigation pane, choose Repository > Code Source.

5. In the row for GitHub, click Bind Account in the Actions column. In the dialog box that appears, click Go to the source code repository to bind account to open GitHub.

6. On the authorization page, click Authorize AliyunDeveloper. After you return to the Code Source page, the status for GitHub is displayed as Bound, indicating a successful binding.

Step 2: Create a repository

1. Log on to the Container Registry console.

2. In the top navigation bar, select a region.

3. On the Instances page, click the Personal Edition instance that you want to manage.

4. In the left-side navigation pane, choose Repository > Repositories and then click Create Repository.

5. Configure the repository information.

   Parameter	Description	Example
   Region	The region where the repository is located.	China (Hangzhou)
   Namespace	The namespace for the repository.	test23432
   Repository Name	Enter a name for the repository.	test
   Repository Type	The repository type can be Public or Private. You must be logged in to push images regardless of repository type. To protect your data, use a private repository. Public: Anyone can pull images without authentication. Private: Authentication is required to pull images.	Private
   Summary	A brief description.	-
   Description	A detailed description. Markdown is supported.	Use the created Dockerfile and the ACR image building service to build, package, and run the image.

6. Click Next and set the code source.

   Parameter	Description
   Code Source	Set Code Source to GitHub and select the bound source code repository.
   Build Settings	For this example, select Automatically Build Images When Code Changes and Build with Servers Deployed Outside Chinese Mainland. Automatically Build Images When Code Changes: Automatically triggers a build when code is committed to a branch. Build with Servers Deployed Outside Chinese Mainland: Runs the build in a data center outside the Chinese mainland and pushes the resulting image to the specified region. Build Without Cache: Forces a re-pull of the base dependency image for every build, which may increase build time.

7. Click Create Repository.

   After the repository is created, the repository details page displays its basic information.

8. In the left-side navigation pane, click the icon to the left of the repository name. On the Repositories page, you can see your new repository. A Status of Normal indicates that the repository was created successfully.

Step 3: Perform a build

1. In the left-side navigation pane, choose Repository > Repositories. Click the name of your repository, or click Manage in the Actions column of the repository.

2. In the left-side navigation pane, click Build. In the Build Rules section, click Add Build Rule.

3. Configure the build rule.

   Parameter	Description	Example
   Type	The event that triggers the build rule when code is pushed to the repository. Valid values are Branch and Tag.	Branch
   Branch/Tag	The code branch to build from.	master
   Build Context Directory	The directory where the Dockerfile is located. This is a relative path from the root of the code branch. In this tutorial, the full path is /Dockerfile, so enter / here.	/
   Dockerfile Filename	The name of the Dockerfile. The default is Dockerfile. For example, if the full path is /Dockerfile, enter Dockerfile.	Dockerfile
   Image Version	The tag for the image version.	V1.0.0

4. Click OK to return to the Build page.

5. In the Build Rules section, find the rule that you created and click Build in the corresponding Actions column.

   In the Build Log section, a build status of Success indicates that the build is complete.

Step 4: Configure an image accelerator

1. Log on to the Alibaba Cloud Container Registry console. In the top navigation bar, select the region where your container instance was created.

2. In the left-side navigation pane, choose Image Tool > Image Accelerator. In the Booster section, copy the accelerator address.

3. Run the following commands to configure the image accelerator in Docker. Replace https://g******w9.mirror.aliyuncs.com with the accelerator address that you copied. The following commands are for Ubuntu and CentOS. For other operating systems, see Configure an image accelerator.

   mkdir -p /etc/docker # Create a directory for the configuration file.
   tee /etc/docker/daemon.json <<-'EOF' # Write the accelerator configuration.
   {
     "registry-mirrors": ["https://g******w9.mirror.aliyuncs.com"]
   }
   EOF
   systemctl daemon-reload  # Reload the configuration file.
   systemctl restart docker # Restart the Docker service.

Verify the results

View the built image

Run the image

Starting from September 9, 2024, the format of registry endpoints for new Personal Edition instances will change. For more information, see Usage notes for new Personal Edition instances. Choose a method to push and pull images based on your instance version.