Container Image Deployment

This page describes how to deploy container images to new CloudRun Services or new versions of existing CloudRun Services.

Supported Container Image Registries

You can directly use images stored in the following container image registries:

1. Tencent Cloud Container Image Service (Tencent Cloud Container Registry, TCR)

   • Provides stable and efficient image hosting services.
   • Supports private and public image repositories.
   • Access address: Tencent Cloud Container Image Service.

2. Docker Hub

   • The world's largest public container image registry.
   • Provides extensive open-source image resources.
   • Access address: Docker Hub.

You may also use container image services provided by other vendors. However, it is recommended to prioritize Tencent Cloud Container Image Service for better localized support. (Note: Currently, only public cloud images are supported. The login and registration features for image repositories are under active development. Stay tuned for updates.)

Creating an Image Repository

Go to Tencent Cloud Container Image Service. If this is your first time using it, you can create a personal instance which is free of charge at no cost.

Go to the Namespace page and create a namespace, for example, my-project.

Go to the Image Repository page, create a new image repository, fill in the service name, for example, gintest, select the type as Public, choose the namespace as the newly created my-project namespace, and click Create to complete.

Click the name of the newly created image, then click Quick Actions in the Operations column, and complete the image upload as required.

Obtaining the Image Download Address

Obtaining Image Address from Tencent Cloud Container Image Service (TCR)

1. Log in to the Tencent Cloud console
   • Access Tencent Cloud Container Image Service and log in to your account.
2. Go to the target image repository
   • Select the target image repository in the console and click to go to the details page.
3. Locate the image
   • Locate the desired image and its version tag in the image list.
4. Copy the pull command
   • Click the image name, go to the details page, and copy the displayed pull command (e.g., docker pull ccr.ccs.tencentyun.com/namespace/repository:tag).

Obtaining the Image Address from Docker Hub

1. Access Docker Hub
   • Access Docker Hub and search for the desired image.
2. Select the image version
   • On the image details page, switch to the Tags tab and select the desired version tag.
3. Copy the pull command
   • The page will display the pull command (e.g., docker pull repository:tag). Simply copy it.

Example: Obtain the nginx image

Obtaining the nginx image from Tencent Cloud Container Image Service (TCR)

1. Log in to the Tencent Cloud console
   • Access Tencent Cloud Container Image Service and log in to your account.
2. Search for the nginx image
   • Search for nginx in the image repository and select the official or custom nginx image.
3. Copy the pull command
   • Click the image name, go to the details page, and copy the displayed pull command (e.g., docker pull ccr.ccs.tencentyun.com/namespace/nginx:latest).
4. Pull the image
   • Run the copied command in your local terminal to complete the image pull.

Obtaining the nginx image from Docker Hub

1. Access Docker Hub
   • Access Docker Hub and search for nginx.
2. Select the official image
   • Select the official nginx image from the search results.
3. Copy the pull command
   • The page will display the pull command (e.g., docker pull nginx:latest); simply copy it.
4. Pull the image
   • Run the copied command in your local terminal to complete the image pull.

Deploy a New Service

Preparation

• Container image download URL: The segment after docker pull in the image download URL obtained in the previous step is the download address (i.e., ccr.ccs.tencentyun.com/namespace/repository:tag, specifically the repository:tag portion).

• Layer versions cannot be modified once created. If updates are needed, please create a new version.

To deploy the container, perform the following operations:

• 1. Go to CloudBase: Deploy from Container
• 2. Enter the container image download URL that needs to be specified in the Image address field, and fill in the service name and port.
• 3. Click Create and wait for the deployment to complete.
• 4. After the deployment is complete, go to the Overview page to obtain the default access domain for access testing.

Examples of Deploying Open-Source Projects with Common Container Images

Project (GitHub)	Description	One-Click Deployment Link
Nextcloud	An open-source self-hosted cloud storage and collaboration platform that supports file synchronization, sharing, online collaborative office work, and more.	One-Click Deployment
n8n	An open-source automation and integration platform that supports visual drag-and-drop building of workflows and integrates 500+ applications.	One-Click Deployment
code-server	An open-source project that runs VS Code in the browser, enabling a cloud development environment.	One-Click Deployment
Stirling-pdf	A locally deployed PDF tool that supports various PDF operations such as merging, splitting, conversion, OCR, and more.	One-Click Deployment
Excalidraw	An open-source virtual whiteboard that supports collaborative hand-drawn style diagrams, suitable for brainstorming and prototyping.	One-Click Deployment
Crawl4ai	An open-source high-performance asynchronous web crawler specialized for AI data collection and LLM integration.	One-Click Deployment