租户端 计算 容器服务（TKE） 用户指南 使用 TCR 企业版实例内容器镜像创建工作负载

使用 TCR 企业版实例内容器镜像创建工作负载

最近更新时间: 2024-10-17 17:10:00

操作场景

容器镜像服务企业版面向具有严格数据安全及合规性要求、业务分布在多个地域、集群规模庞大的企业级容器客户，提供企业级的独享镜像安全托管服务。相较于个人版服务，企业版支持容器镜像安全扫描、跨地域自动同步、Helm Chart 托管、网络访问控制等特性，详情请参见 容器镜像服务。

本文介绍如何在容器服务 TKE 中，使用容器镜像服务 TCR 内托管的私有镜像进行应用部署。

前提条件

在使用 TCR 内托管的私有镜像进行应用部署前，您需要完成以下准备工作：

操作步骤

准备容器镜像

创建命名空间

新建的 TCR 企业版实例内无默认命名空间，且无法通过推送镜像自动创建。请参考 创建命名空间 按需完成创建。 建议命名空间名使用项目或团队名，本文以 docker 为例。

创建镜像仓库（可选）

容器镜像托管在具体的镜像仓库内，请参考 创建镜像仓库 按需完成创建。镜像仓库名称请设置为期望部署的容器镜像名称，本文以 getting-started 为例。

说明

通过 docker cli 或其他镜像工具，例如 jenkins 推送镜像至企业版实例内时，若镜像仓库不存在，将会自动创建，无需提前手动创建。

推送容器镜像

您可通过 docker cli 或其他镜像构建工具，例如 jenkins 推送镜像至指定镜像仓库内，本文以 docker cli 为例。此步骤需要您使用一台安装有 Docker 的云服务器或物理机，并确保访问的客户端已在 配置网络访问策略 定义的公网或内网允许访问范围内。

  1. 参考 获取实例访问凭证 获取登录指令，并进行 Docker Login。

  2. 登录成功后，您可在本地构建新的容器镜像或从 DockerHub 上获取一个公开镜像用于测试。 本文以 DockerHub 官方的 Nginx 最新镜像为例，在命令行工具中依次执行以下指令，即可推送该镜像。请将 demo-tcr、docker 及 getting-started 依次替换为您实际创建的实例名称、命名空间名称及镜像仓库名。

    docker tag getting-started:latest demo-tcr.cloudcr.com/docker/getting-started:latest
    docker push demo-tcr.cloudcr.com/docker/getting-started:latest

    推送成功后，即可前往控制台的 镜像仓库 页面，选择仓库名进入详情页面查看。

配置 TKE 集群访问 TCR 实例

TCR 企业版实例支持网络访问控制，默认拒绝全部来源的外部访问。您可根据 TKE 集群的网络配置，选择通过公网或内网访问指定实例，拉取容器镜像。若 TKE 集群与 TCR 实例部署在同一地域，建议通过内网访问方式拉取容器镜像，可提升拉取速度，并节约公网流量成本。

使用 TCR 扩展组件进行快速配置（推荐）

  1. 登录容器服务控制台，选择左侧导航栏中的集群。

  2. 在集群管理页面，选择集群 ID，进入集群详情页。

  3. 选择左侧菜单栏中的组件管理，在组件管理页面单击新建。

  4. 在新建组件管理页面中勾选 TCR 组件。

    说明

    当前 TCR 组件暂只支持 K8S 版本 ≥ 1.12 的集群，如集群版本暂不支持，请采用手动配置方式，或升级集群版本。

    • 单击查看详情了解组件功能及配置说明。

    • 单击参数配置开始配置组件。

    在 TCR 组件参数设置页面，参考查看详情中介绍的组件配置方式，配置相关参数。

    • 关联实例：选择与集群同地域的 TCR 实例。

    • 免密拉取配置：可采用默认配置。

    • 内网访问配置：可选功能，在 TCR 实例接入集群所在 VPC 并开启自动解析后，集群内节点可内网访问 TCR 实例，无需使用本功能。由于 TCR 侧自动解析功能依赖于 PrivateDNS，若当前集群所在地暂未支持 PrivateDNS 产品，可使用本配置实现内网访问。如内网访问链路中未展示为“链路正常”，请参考 内网访问控制，配置 TCR 实例与 TKE 集群所在私有网络 VPC 的内网链路。

  5. 单击确定返回组件选择界面。

  6. 在组件选择界面单击完成，开始为集群安装 TCR 扩展组件。

    组件安装完成后，集群将具备内网免密拉取该关联实例内镜像的能力，无需额外配置。

手动配置内网访问及访问凭证

1. 配置内网访问

  1. 参考 内网访问控制，配置 TCR 实例与 TKE 集群所在私有网络 VPC 的内网链路，并开启自动解析。

  2. 如当前 TCR 实例所在地域暂不支持开启自动解析，可在 TKE 集群中直接配置 TCR 实例的域名解析。请根据您的实际情况，选择以下方案：

    • 创建集群时配置节点 Host 在创建 TKE 集群的“云服务器配置”步骤中，选择高级设置并在“节点启动配置”中输入如下内容：

       echo '172.21.17.69 demo.cloudcr.com' >> /etc/hosts

    • 为已有集群配置节点 Host 登录集群各个节点，并执行以下命令：

       echo '172.21.17.69 demo.cloudcr.com' >> /etc/hosts

      172.21.17.69 及 demo.cloudcr.com 请替换为您实际使用的内网解析 IP 及 TCR 实例域名。

2. 配置访问凭证

  1. 参考TCR - 服务级账号管理，获取服务级账号的用户名及密码。

  2. 在集群详情页，选择左侧的 配置管理 > Secret，进入 Secret 页面。

    在 Secret 页面单击新建进入新建 Secret 页面，参考以下信息下发访问凭证。

    主要参数信息如下：

    • Secret 类型：选择 Dockercfg (镜像仓库访问凭证)。

    • 生效范围：勾选需下发凭证的命名空间。

    • 镜像仓库域名：填写 TCR 实例的访问域名。

    • 用户名、密码：填写 步骤1 已获取的用户名及密码。

  3. 单击创建 Secret即可完成下发。

使用 TCR 实例内容器镜像创建工作负载

  1. 在集群详情页面，选择左侧工作负载> Deployment。

  2. 在 Deployment 页面单击新建。

  3. 在新建**Deployment** 页面，参考以下信息创建工作负载。 主要参数信息如下，其他参数请按需设置：

    • 命名空间：选择已下发访问凭证的命名空间。

    • 实例内容器：

      • 镜像：单击选择镜像，并在选择镜像页面，选择容器镜像服务企业版，再根据需要选择地域、实例和镜像仓库。

      • 镜像版本：选择好镜像后，单击选择镜像版本，在选择镜像版本页面，根据需要选择该镜像仓库的某个版本。若不选择则默认为 latest。

    • 镜像访问凭证：

      • 集群已安装 TCR 扩展组件：无需配置。

        集群未安装 TCR 扩展组件：选择添加镜像访问凭证，并选择 配置访问凭证 步骤中已下发的访问凭证。

  4. 完成其他参数设置后，单击创建 Deployment后查看该工作负载的部署进度。 部署成功后，可在 Deployment 页面查看该工作负载的“运行/期望Pod数量”为“1/1”。