文档

应用分发快速入门

更新时间:

您可以通过ACK One舰队的应用分发功能将舰队实例中的应用分发至多个关联集群中,无需依赖Git仓库,简化应用部署流程。本文介绍如何在舰队实例中创建应用并根据分发策略分发至多集群中。

前提条件

步骤一(可选):在舰队实例中创建命名空间

如果待分发的应用所在的命名空间在舰队中不存在,您需要先在舰队实例中创建命名空间,如已存在则跳过此步骤。

使用舰队实例的KubeConfig连接舰队实例,执行以下命令,创建示例命名空间demo。

kubectl create namespace demo

步骤二:在舰队实例中创建应用

此处应用支持ConfigMap、Deployment、Service等资源,本文以分发单独一个Nginx Deployment为例介绍。

  1. 使用以下内容,创建weighted-deployment.yaml文件。

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      namespace: demo  # 分发的应用所在的命名空间。
      name: weighted-deployment
    spec:
      replicas: 3
      selector:
        matchLabels:
          app: weighted-deployment
      template:
        metadata:
          labels:
            app: weighted-deployment
        spec:
          containers:
          - name: nginx
            image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
            ports:
            - containerPort: 80
  2. 执行以下命令部署应用。

    kubectl apply -f weighted-deployment.yaml

步骤三:在舰队实例中创建分发策略为多集群分发应用

您可以通过定义分发策略(PropagationPolicy)选择需要分发的应用以及对应的集群。创建分发策略后会将匹配到的应用分发到对应集群中。

本文示例:以复制(Duplicated)方式将Deployment weighted-deployment分发到cluster1和cluster2中,两集群副本数一致,均为3个。

  1. 使用以下内容,创建propagationpolicy.yaml文件。

    apiVersion: one.alibabacloud.com/v1alpha1
    kind: PropagationPolicy
    metadata:
      name: weighted-pp
      namespace: demo
    spec:
      resourceSelectors:
      - apiVersion: apps/v1
        kind: Deployment
        name: weighted-deployment
      placement:
        clusterAffinity:
          clusterIds:
          - ${cluster1-id} # 您的集群ID。
          - ${cluster2-id} # 您的集群ID。
        replicaScheduling:
          replicaSchedulingType: Duplicated

    主要参数说明如下,详细参数说明请参见分发策略

    参数

    说明

    参数值

    resourceSelectors

    选择一个或多个待分发的K8s资源。

    • apiVersion:指定待分发资源的apiVersion,必选。

    • kind:指定待分发资源的类型,必选。

    • name:指定待分发资源的名称。

    • namespace:指定待分发资源的命名空间。

      说明

      PropagationPolicy只可以选择其本身所在命名空间的资源。

    • labelSelector:通过标签选择资源。

    placement

    clusterAffinity:指定资源要分发的集群。

    通过clusterIds数组直接指明集群ID。更多其他选择方式请参见分发策略

    说明

    此处需填写集群ID,不是集群名称。

    replicaScheduling:指定有副本数资源的调度策略。例如Deployment、StatefulSet、Job。

    replicaSchedulingType值为Duplicated,表示会将每个资源都复制到集群中,即每个集群都会有spec.Replicas个副本数。更多说明请参见分发策略

  2. 执行以下命令,创建分发策略。

    kubectl apply -f propagationpolicy.yaml

步骤四(可选):在舰队实例中创建差异化策略

您可以通过定义差异化策略(OverridePolicy)选择需要差异化部署的集群以及资源。创建差异化策略后会将相应的资源进行定制化修改后再部署到选中的集群中。

本文示例:将部署到cluster2的应用进行一些差异化修改,将replicas数修改为1,且将镜像的registry修改为阿里云的registry

  1. 使用以下内容,创建overridepolicy.yaml文件。

    apiVersion: one.alibabacloud.com/v1alpha1
    kind: OverridePolicy
    metadata:
      name: example
      namespace: demo
    spec:
      resourceSelectors:
        - apiVersion: apps/v1
          kind: Deployment
          name: weighted-pp
      overrideRules:
        - targetCluster:
            clusterNames:
              - ${cluster2-id}   # 需要差异化部署的集群ID。
          overriders:
            plaintext:
              - operator: replace
                path: /spec/replicas
                value: 1
            imageOverrider:
              - component: Registry
                operator: replace
                value: registry.cn-hangzhou.aliyuncs.com

    主要参数说明如下,详细参数说明请参见差异化策略

    参数

    说明

    参数值

    resourceSelector

    选择需要差异化修改的资源。

    • apiVersion:指定需要差异化修改资源的apiVersion,必选。

    • kind:指定需要差异化修改的资源类型,必选。

    • name:指定需要差异化修改的资源名称。

    • namespace:指定需要差异化修改的命名空间。

      说明

      PropagationPolicy只可以选择其本身所在命名空间的资源。

    • labelSelector:通过标签来选择资源。

    overrideRules

    通过一组覆盖规则修改应用模板。

    • plaintext:使用JSON Patch的方式修改模板。

    • imageOverrider:可以修改镜像的registryrepositoryversion

  2. 执行以下命令,创建差异化策略。

    kubectl apply -f overridepolicy.yaml

步骤五:查看多集群中应用的状态

您可以通过以下AMC命令查看应用的多集群分发状态,也可以直接去关联集群中查看应用的运行状态,以确认舰队应用分发成功。

执行以下命令,查看应用状态。

kubectl amc get deploy -n demo

预期输出:

NAME                  CLUSTER          READY   UP-TO-DATE   AVAILABLE   AGE    ADOPTION
weighted-deployment   cxxxxxxxxxxxxx   3/3     3            3           3d4h   Y
weighted-deployment   cxxxxxxxxxxxxx   3/3     3            3           3d4h   Y

预期输出表明,应用已经分发至指定的集群中。

相关文档