# 创建普通任务（Job）
[普通任务（Job）](https://kubernetes.io/zh-cn/docs/concepts/workloads/controllers/job/)是Kubernetes中用于管理批处理任务的工作负载，通常用于执行一次性或有限次的短任务。不同于长期运行的业务（如通过Deployment或StatefulSet管理的业务），Job会创建一个或者多个Pod，这些Pod具有明确的开始和结束阶段，如果Job没有达到指定的任务目标，它将继续重试执行Pod，直到达到目标。
您可以根据自身需求为Job设置不同的任务目标：
- 一次性Job：Job只创建一个Pod来执行任务，任务成功完成的标志就是该Pod成功退出（exit 0）。
- 固定结束次数的Job：Job需要确保有多个Pod成功执行任务，任务成功完成的标志是有指定数量的Pod成功完成。
- 带工作队列的Job：Job用于处理工作队列中的任务，每个Pod都会被分配一个索引值，每个分配了索引值的Pod都执行成功，则Job执行成功。
#### 前提条件
- 在创建工作负载前，已存在一个可用集群。若没有可用集群，请参照[购买CCE Autopilot集群](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0028.html)中内容创建。
- 在创建工作负载前，已配置访问镜像中心的VPC终端节点。创建集群时，系统将自动创建对应的VPC终端节点，您可以进入集群的"概览"页，在"网络信息"模块的"镜像访问"中查看是否配置终端节点。如果集群暂未配置终端节点，请参考[配置访问镜像中心的VPC终端节点](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0461.html)进行配置。
 
#### 创建普通任务
您可以通过控制台或kubectl命令行创建普通任务。
- [通过控制台创建]
  1. 登录[CCE控制台](https://console.huaweicloud.com/cce2.0/?#/cce/cluster/list)。
  
  2. 单击集群名称进入集群，在左侧选择"工作负载"，在右上角单击"创建工作负载"。
  
  3. 填写工作负载的**基本信息** 。
     
     表1工作负载的基本信息 
     | 参数  | 说明                                                                                                                                                    |
     |:---|:---|
     | 负载类型  | 选择普通任务Job。关于不同工作负载类型的介绍请参见[工作负载概述](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0907.html)。                                     |
     | 负载名称   | 填写工作负载的名称。请输入1到63个字符的字符串，可以包含小写英文字母、数字和中划线（-），并以小写英文字母开头，小写英文字母或数字结尾。                                                                     |
     | 命名空间  | 选择工作负载的命名空间，默认为default。您可以单击后面的"创建命名空间"，命名空间的详细介绍请参见[创建命名空间](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0278.html)。 |
     | 实例类型 | 选择工作负载的实例类型，默认为通用型。关于实例类型的详细介绍，请参见[设置实例类型](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0908.html)。                  |
     | 实例数量  | 填写实例的数量，即工作负载Pod的数量。                                                                                                                      |
        
     
     
  
  4. 填写工作负载的**容器配置** 。
     
     - 镜像缓存（可选）：如果您已创建相关的镜像缓存，可以选择自动匹配镜像缓存或指定镜像缓存，具体参数说明请参见[镜像缓存参数说明]。使用镜像缓存可以加速镜像下载，提升负载的启动速度，详情请参见[镜像缓存概述](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0157.html)。当集群版本在v1.28.8、v1.31.4及以上时支持使用镜像缓存功能。
       ![](https://support.huaweicloud.com/usermanual-cce-autopilot/public_sys-resources/note_3.0-zh-cn.png)
       目前，只有部分区域支持使用镜像缓存，具体请以控制台为准。
        表2镜像缓存参数说明 
       | 参数选项      | 示例              | 选项说明                                                                                                                                                                                                                                                                                                                         |
       |:---|:---|:---|
       | 不使用      | -                | 不使用镜像缓存，按照"容器信息"中的镜像内容重新下载镜像。                                                                                                                                                                                                                                                                                              |
       | 自动匹配镜像缓存 | -               | 从所有可用的镜像缓存中自动匹配最优镜像，并且匹配顺序如下： - 镜像匹配度：选择镜像信息匹配度最高的镜像缓存。  - 创建时间：选择创建时间最新的镜像缓存。   如果集群未匹配到镜像，则不再使用镜像缓存。 |
       | 指定镜像缓存  | autopilot-test | 指定已有的镜像缓存，该镜像缓存必须为可用状态。如果您需要新建镜像缓存请单击创建镜像缓存，参数说明请参见[创建镜像缓存](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0158.html)。                                                                                                                                                                                       |
          
       
     
     - 容器信息：Pod中可以配置多个容器，您可以单击右侧"添加容器"为Pod配置多个容器。
       - 基本信息：配置容器的基本信息。
         表3容器的基本信息 
         | 参数       | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
         |:---|:---|
         | 容器名称     | 为容器命名。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
         | 更新策略     | 镜像更新/拉取策略。可以勾选"总是拉取镜像"，表示每次都从镜像仓库拉取镜像；如不勾选则优先使用本地已有的镜像，如果没有这个镜像再从镜像仓库拉取。 如果使用镜像缓存，建议不要勾选"总是拉取镜像"，避免重复从原镜像仓库拉取镜像。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
         | 镜像名称     | 单击后方"选择镜像"，选择容器使用的镜像。如果需要使用第三方镜像，请参见[使用第三方镜像](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0009.html)。 如果选择镜像缓存，您需要填入以下信息： - 如果您选择"自动匹配镜像缓存"：您可以在"容器信息 \> 基本信息 \> 镜像名称"中直接输入待使用的镜像名称，集群会按照[镜像缓存参数说明](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0047.html#cce_11_0047__table84021337125719)中的匹配顺序自动匹配。如果在镜像缓存中未匹配到镜像，则不再使用镜像缓存。不使用镜像缓存后，集群将在SWR镜像仓库、镜像中心依次匹配输入的镜像名称，若最终未匹配，则返回镜像拉取失败。  - 如果您选择"指定镜像缓存"：您需要在"容器信息 \> 基本信息 \> 镜像名称"中直接输入该镜像缓存中待使用的镜像的地址。 镜像地址获取方式：鼠标悬浮于指定的镜像缓存上，在出现的悬浮框中对应镜像的"镜像信息"即为镜像地址。    |
         | 镜像版本      | 选择需要部署的镜像版本。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
         | CPU配额     | CPU资源限制值，即允许容器使用的CPU最大值，防止占用过多资源。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
         | 内存配额      | 内存资源限制值，即允许容器使用的内存最大值。如果超过，容器会被终止。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
         | 初始化容器（可选） | 选择容器是否作为初始化（Init）容器。初始化（Init）容器不支持设置健康检查。 Init容器是一种特殊容器，可以在Pod中的其他应用容器启动之前运行。每个Pod中可以包含多个容器，同时Pod中也可以有一个或多个先于应用容器启动的Init容器，当所有的Init 容器运行完成时，Pod中的应用容器才会启动并运行。详细说明请参见[Init容器](https://kubernetes.io/zh/docs/concepts/workloads/pods/init-containers/)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
         | 容器启动项（可选）  | 为容器添加启动项参数，详情请参见[Pod参数](https://kubernetes.io/zh-cn/docs/reference/kubernetes-api/workload-resources/pod-v1/)。CCE Autopilot集群支持以下启动项参数： - stdin：为容器开启标准输入，允许从外部源（如终端或其他输入流）接收输入。  - tty：为容器分配一个虚拟终端，允许您像在本地终端中一样向容器发送命令。 一般需要同时开启stdin，表示将终端（tty）绑定到容器的标准输入（stdin）上，可以支持类似于**kubectl exec -i -t**命令的交互式操作，但区别在于该参数在Pod启动时就已经配置完成。                                                                                                                                                                               |
            
         
       
       - 生命周期（可选）：在容器的生命周期的特定阶段配置需要执行的操作，例如启动命令、启动后处理和停止前处理，详情请参见[设置容器生命周期](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0105.html)。
       
       - 环境变量（可选）：支持通过键值对的形式为容器运行环境设置变量，可用于把外部信息传递给Pod中运行的容器，可以在应用部署后灵活修改，详情请参见[设置环境变量](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0113.html)。
       
       - 数据存储（可选）：在容器内挂载本地存储或云存储，不同类型的存储使用场景及挂载方式不同，详情请参见[存储](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0374.html)。
        
     
     - 镜像访问凭证：用于访问镜像仓库的凭证，默认取值为default-secret，使用default-secret可访问SWR镜像仓库的镜像。default-secret详细说明请参见[default-secret](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0388.html#cce_11_0388__section136587457392)。
     
     
     
     
  
  5. （可选）填写工作负载关联的**高级配置**
     
     表4工作负载的高级配置 
     | 参数     | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
     |:---|:---|
     | 标签与注解 | 以键值对形式为工作负载Pod添加标签或注解，填写完成后需单击"确认添加"。关于标签与注解的作用及配置说明，请参见[设置标签与注解](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0386.html)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
     | 任务设置 | - 并行数：任务负载执行过程中允许同时创建的最大实例数，并行数应不大于实例数。  - 超时时间（秒）：当任务执行超出该时间时，任务将会被标识为执行失败，任务下的所有实例都会被删除。为空时表示不设置超时时间。  - 完成模式： - 非索引：当执行成功的Pod数达到实例数时， Job执行成功。Job中每一个Pod都是同质的，Pod之间是独立无关的。  - 索引：系统会为每个Pod分配索引值，取值为 0 到实例数-1。每个分配了索引的Pod都执行成功，则Job执行成功。索引模式下，Job中的Pod命名遵循$(job-name)-$(index)模式。    - 挂起任务：默认任务创建后被立即执行。选择挂起任务后，任务创建后处于挂起状态；将其关闭后，任务继续执行。   |
     | 网络配置 | - 是否开启指定容器网络配置：开启指定容器网络配置，工作负载使用指定的容器网络配置中的容器子网和安全组来创建，详情请参见[使用容器网络配置为命名空间/工作负载绑定子网及安全组](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0196.html)。  - 指定容器网络配置名：只支持选择关联资源类型为工作负载类型的自定义容器网络配置。                                                                                                                                                                                                                                                                                                                                                                                                                    |
        
     
     
  
  6. 在"规格确认"中，请确认以下信息： 
     1. Pod资源规格计算规则：
        - 默认情况：Pod申请的整体资源规格，基于所有初始化容器与普通容器所需CPU/内存配额计算。
        
        - 自定义配置：若您已配置Pod级别的资源配额，则以Pod级别配置数值作为最终Pod资源规格（优先级高于容器级别配置）。
         
     
     2. 请确保"单Pod临时存储"能够满足容器的需要，具体请参见[增加Pod的临时存储容量](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0867.html)。
     
     3. 计费规格说明：
        - 单Pod的实际计费规格会基于Pod资源规格向上自动规整为Autopilot支持的规格档位，具体规格档位请查看[CCE Autopilot规格说明](https://support.huaweicloud.com/productdesc-cce-autopilot/cce_12_0002.html#section1)。
        
        - 当Pod申请的资源规格低于实际计费规格时，建议使用"一键补齐"功能补足规格差值，避免资源浪费。
         
     
     4. 信息确认无误后，请勾选"我已知晓上述计费规则"。
     
     
     
     
  
  7. 单击右下角"创建工作负载"，等待一段时间后，工作负载状态为"处理中"，每个任务实例会依次处理。等待任务全部处理完成后，工作负载状态将变为"执行完成"。 
     ![](https://support.huaweicloud.com/usermanual-cce-autopilot/zh-cn_image_0000002504593854.png "点击放大")
     
     
   
- [通过kubectl命令行创建]
  
  ![](https://support.huaweicloud.com/usermanual-cce-autopilot/public_sys-resources/notice_3.0-zh-cn.png)
  Autopilot集群暂不支持配置节点亲和与反亲和，所以当您使用kubectl命令行创建工作负载时，为避免Pod创建失败，请不要配置affinity字段。
  Job的关键配置参数如下所示：
  - .spec.completions表示Job结束需要成功运行的Pod个数，默认为1。
  
  - .spec.parallelism表示并行运行的Pod的个数，默认为1。
  
  - .spec.backoffLimit表示失败Pod的最大重试次数，超过这个次数不会继续重试。
  
  - .spec.activeDeadlineSeconds表示Pod运行时间，一旦达到这个时间，Job及其所有的Pod都会停止。且activeDeadlineSeconds优先级高于backoffLimit，即到达activeDeadlineSeconds的Job会忽略backoffLimit的设置。
  
  
  根据.spec.completions和.spec.parallelism的设置，可以将Job划分为以下几种类型。
  表5任务类型 
  | Job类型        | 说明                                                                                                                                                    | .spec.completions | .spec.parallelism |
  |:---|:---|:---|:---|
  | 一次性Job      | 创建一个Pod直至其成功结束。                                                                                                                                     | 1                   | 1               |
  | 固定结束次数的Job | 依次创建一个Pod运行直至成功结束的Pod个数到达到.spec.completions的数值。                                                                                                        | \>1                 | 1                  |
  | 固定结束次数的并行Job | 依次创建多个Pod运行直至成功结束的Pod个数到达到.spec.completions的数值。                                                                                                        | \>1                | \>1              |
  | 带工作队列的并行Job  | 创建一个或多个Pod，从工作队列中取走对应的任务并处理，完成后将任务从队列中删除后退出，详情请参见[使用工作队列进行精细的并行处理](https://kubernetes.io/zh-cn/docs/tasks/job/fine-parallel-processing-work-queue/)。 | 不填写              | \>1或=1           |
     
  以下是一个Job配置示例，保存在myjob.yaml中，其计算π到2000位并打印输出。
  ```
  apiVersion: batch/v1
  kind: Job
  metadata:
    name: myjob
  spec:
    completions: 50        # Job结束需要运行50个Pod，这个示例中就是打印π 50次
    parallelism: 5        # 并行5个Pod
    backoffLimit: 5        # 最多重试5次
    template:
      spec:
        containers:
        - name: pi
          image: perl
          command: ["perl",  "-Mbignum=bpi", "-wle", "print bpi(2000)"]
        restartPolicy: Never
        imagePullSecrets:
          - name: default-secret
  ```
  **说明：**
  - apiVersion: batch/v1 是当前job的Version。
  
  - kind: Job：指定当前资源的类型是Job。
  
  - restartPolicy: Never：是指当前的重启策略。对于Job，只能设置为Never或者OnFailure。对于其他controller（比如Deployment）可以设置为Always。
  
  
  **运行该任务，如下：**
  1. 启动这个job。 
     ```
     [root@k8s-master k8s]# kubectl apply -f myjob.yaml
     job.batch/myjob created
     ```
     
     
  
  2. 查看这个job。 
     **kubectl get job**
     ```
     [root@k8s-master k8s]# kubectl get job
     NAME    COMPLETIONS   DURATION   AGE
     myjob   50/50         23s        3m45s
     ```
     completions为 50/50 表示成功运行了这个job。
     
     
  
  3. 查看pod的状态。 
     **kubectl get pod**
     ```
     [root@k8s-master k8s]# kubectl get pod
     NAME          READY   STATUS      RESTARTS   AGE
     myjob-29qlw   0/1     Completed   0          4m5s
     ...
     ```
     状态为Completed表示这个job已经运行完成。
     
     
  
  4. 查看这个pod的日志。 
     **kubectl logs**
     ```
     # kubectl logs myjob-29qlw
     3.1415926535897932384626433832795028841971693993751058209749445923078164062862089986280348253421170679821480865132823066470938446095505822317253594081284811174502841027019385211055596446229489549303819644288109756659334461284756482337867831652712019091456485669234603486104543266482133936072602491412737245870066063155881748815209209628292540917153643678925903600113305305488204665213841469519415116094330572703657595919530921861173819326117931051185480744623799627495673518857527248912279381830119491298336733624406566430860213949463952247371907021798609437027705392171762931767523846748184676694051320005681271452635608277857713427577896091736371787214684409012249534301465495853710507922796892589235420199561121290219608640344181598136297747713099605187072113499999983729780499510597317328160963185950244594553469083026425223082533446850352619311881710100031378387528865875332083814206171776691473035982534904287554687311595628638823537875937519577818577805321712268066130019278766111959092164201989380952572010654858632788659361533818279682303019520353018529689957736225994138912497217752834791315155748572424541506959508295331168617278558890750983817546374649393192550604009277016711390098488240128583616035637076601047101819429555961989467678374494482553797747268471040475346462080466842590694912933136770289891521047521620569660240580381501935112533824300355876402474964732639141992726042699227967823547816360093417216412199245863150302861829745557067498385054945885869269956909272107975093029553211653449872027559602364806654991198818347977535663698074265425278625518184175746728909777727938000816470600161452491921732172147723501414419735685481613611573525521334757418494684385233239073941433345477624168625189835694855620992192221842725502542568876717904946016534668049886272327917860857843838279679766814541009538837863609506800642251252051173929848960841284886269456042419652850222106611863067442786220391949450471237137869609563643719172874677646575739624138908658326459958133904780275901
     ```
     
     
   
#### 相关操作
普通任务创建完成后，您还可执行[表6]中操作。
 表6其他操作 
| 操作   | 操作说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|
| 查看YAML                                               | 单击任务名称后的"更多 \> 查看YAML"，可查看当前任务对应的YAML文件。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 删除普通任务 | 1. 选择待删除的任务，单击操作列的"更多 \> 删除"。  2. 单击"是"。 任务删除后将无法恢复，请谨慎操作。    |