Microservices Engine:Kubernetes クラスターへの SchedulerX のデプロイ

方法 1（推奨）：Deployment を使用した SchedulerX のデプロイ

前提条件

• Container Service for Kubernetes（ACK）クラスターまたは自己管理型 Kubernetes クラスターが作成されています。詳細については、「ACK マネージドクラスターの作成」をご参照ください。

• SchedulerX がアクティブ化されています。

• SchedulerX コンソールで Kubernetes アプリケーションが作成されています。詳細については、「アプリケーションの作成」をご参照ください。

手順 1：サービスアカウントの設定

サービスアカウントは、SchedulerX を使用して Kubernetes ジョブがスケジュールされるときに、検証と承認のための ID を提供します。デフォルトでは、Kubernetes ジョブが属する名前空間のサービスアカウントが使用されます。

Kubernetes クラスターの必要な名前空間で schedulerx-serviceaccount.yaml を 1 回だけ実行する必要があります。現在の名前空間に属するポッドまたはジョブのみをスケジュールする場合は、次の YAML コードを実行します。

apiVersion: v1
kind: ServiceAccount
metadata:
  name: schedulerx
---
apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
  name: schedulerx-role
rules:
  - apiGroups: [""]
    resources: ["pods"]
    verbs: ["create","delete","get","list","patch","update","watch"]
  - apiGroups: [""]
    resources: ["pods/log"]
    verbs: ["get","list","watch"]
  - apiGroups: [""]
    resources: ["configmaps"]
    verbs: ["create","delete","get","list","patch","update"]
  - apiGroups: [""]
    resources: ["events"]
    verbs: ["watch"]
  - apiGroups: ["batch"]
    resources: ["jobs","cronjobs"]
    verbs: ["create","delete","get","list","patch","update","watch"]
---
kind: RoleBinding
apiVersion: rbac.authorization.k8s.io/v1
metadata:
  name: schedulerx-binding
subjects:
  - kind: ServiceAccount
    name: schedulerx
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: Role
  name: schedulerx-role

名前空間をまたがってジョブをスケジュールする場合は、ClusterRole および ClusterRoleBinding API 操作を呼び出す必要があります。

apiVersion: v1
kind: ServiceAccount
metadata:
  name: schedulerx
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: schedulerx-cluster-role
rules:
  - apiGroups: [""]
    resources: ["pods"]
    verbs: ["create","delete","get","list","patch","update","watch"]
  - apiGroups: [""]
    resources: ["pods/log"]
    verbs: ["get","list","watch"]
  - apiGroups: [""]
    resources: ["configmaps"]
    verbs: ["create","delete","get","list","patch","update"]
  - apiGroups: [""]
    resources: ["events"]
    verbs: ["watch"]
  - apiGroups: ["batch"]
    resources: ["jobs","cronjobs"]
    verbs: ["create","delete","get","list","patch","update","watch"]
---
kind: ClusterRoleBinding
apiVersion: rbac.authorization.k8s.io/v1
metadata:
  name: schedulerx-cluster-binding
subjects:
  - kind: ServiceAccount
    name: schedulerx
    namespace: <NAMESPACE1>
  - kind: ServiceAccount
    name: schedulerx
    namespace: <NAMESPACE2>
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: schedulerx-cluster-role

手順 2：SchedulerX エージェントのインストール

次のサンプルコードは、schedulerx-agent.yaml の設定を示しています。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: schedulerx-agent
  labels:
    app: schedulerx-agent
spec:
  replicas: 1
  selector:
    matchLabels:
      app: schedulerx-agent
  template:
    metadata:
      labels:
        app: schedulerx-agent
    spec:
      serviceAccountName: schedulerx
      containers:
      - name: schedulerx-agent
        image: registry.cn-hangzhou.aliyuncs.com/schedulerx/agent:latest-amd64
        imagePullPolicy: Always
        resources:
          limits:
            cpu: 500m
          requests:
            cpu: 500m
        env:
          - name: "SCHEDULERX_ENDPOINT"
            value: "${SCHEDULERX_ENDPOINT}"
          - name: "SCHEDULERX_NAMESPACE"
            value: "${SCHEDULERX_NAMESPACE}"
          - name: "SCHEDULERX_GROUPID"
            value: "${SCHEDULERX_GROUPID}"
          - name: "SCHEDULERX_APPKEY"
            value: "${SCHEDULERX_APPKEY}"
          - name: "SCHEDULERX_STARTER_MODE"
            value: "pod"
        livenessProbe:
          exec:
            command: ["/bin/bash","/root/health.sh"]
          timeoutSeconds: 30
          initialDelaySeconds: 30

方法 2：Helm パッケージを使用した SchedulerX のデプロイ

前提条件

• ACK クラスターまたは自己管理型 Kubernetes クラスターが作成されています。詳細については、「ACK マネージドクラスターの作成」をご参照ください。

• SchedulerX がアクティブ化されています。

• SchedulerX コンソール で Kubernetes アプリケーションが作成されています。詳細については、「アプリケーションの作成」をご参照ください。

• Helm パッケージ管理ツール がインストールされています。

手順 1：SchedulerX Helm パッケージのダウンロード

次のコマンドを実行して、SchedulerX Helm パッケージをダウンロードします。

wget https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/helm/schedulerxchart-2.0.0.tgz

手順 2：SchedulerX Helm パッケージのインストール

1. SchedulerX コンソールでアプリケーションのアクセス・パラメーターを取得します。

   1. SchedulerX コンソール にログインします。

   2. Enterprise Distributed Application Service (EDAS) コンソール にログインします。

   3. 上部のナビゲーションバーで、リージョンを選択します。

   4. 左側のナビゲーションペインで、[アプリケーション管理] をクリックします。

   5. 左側のナビゲーションペインで、[タスクスケジューリング (schedulerx)] をクリックします。表示されるナビゲーショツリーで、[アプリケーション] をクリックします。

   6. [アプリケーション管理] ページで、アクセス構成[操作] 列の アクセス構成k8s をクリックします。 パネルの左上隅にあるドロップダウンリストから を選択します。

2. 次のインストールコマンドを実行します。

   説明

   • コマンドのアクセス・パラメーターを、スケジュールするアプリケーションのアクセス・パラメーターに置き換えます。

   • デフォルトでは、アクセス設定のイメージアドレスは、インターネット上の AMD アーキテクチャのイメージのアドレスです。マシンのあるリージョンとマシンのアーキテクチャに基づいてイメージアドレスを指定します。

   helm install  schedulerxchart schedulerxchart-2.0.0.tgz \
   --set SCHEDULERX_ENDPOINT=acm.aliyun.com\
   ,SCHEDULERX_NAMESPACE=f856c3f8-a15c-4a7e-9b4e-f812a9f8****\
   ,SCHEDULERX_GROUPID=k8s-test3\
   ,SCHEDULERX_APPKEY=****\
   ,SCHEDULERX_AGENT_IMAGE=registry.cn-hangzhou.aliyuncs.com/schedulerx/agent:latest-amd64

   次の図は、インストールプロセスを示しています。

   

   次の表は、image の有効な値を示しています。

   チップアーキテクチャ	ロケーション	説明
   x86_64	中国のリージョンとゾーン	registry.cn-hangzhou.aliyuncs.com/schedulerx/agent:latest-amd64
   	中国以外のリージョンとゾーン	schedulerx-registry.ap-southeast-1.cr.aliyuncs.com/schedulerx/agent:latest-amd64
   arm64	中国のリージョンとゾーン	registry.cn-hangzhou.aliyuncs.com/schedulerx/agent:latest-arm64
   	中国以外のリージョンとゾーン	schedulerx-registry.ap-southeast-1.cr.aliyuncs.com/schedulerx/agent:latest-arm64

   次の表は、env に含まれる変数を示しています。

   パラメーター	説明
   ${SCHEDULERX_ENDPOINT}	ENDPOINT は、アプリケーションがデプロイされているリージョンと一致するエンドポイントを指定します。例： addr-sh-internal.edas.aliyun.com。詳細については、「エンドポイント」をご参照ください。
   ${SCHEDULERX_NAMESPACE}	NAMESPACE は、アプリケーションが属する名前空間の ID を指定します。名前空間 ID は、SchedulerX コンソールの [名前空間] ページで確認できます。
   ${SCHEDULERX_GROUPID}	GROUPID は、アプリケーション ID を指定します。アプリケーション ID は、SchedulerX コンソールの [アプリケーション管理] ページで確認できます。
   ${SCHEDULERX_APPKEY}	APPKEY は、アプリケーションキーを指定します。アプリケーションキーは、SchedulerX コンソールの [アプリケーション管理] ページで確認できます。
   SCHEDULERX_AGENT_IMAGE	イメージ URL。

   パッケージをインストールした後、SchedulerX コンソールでインスタンスを表示できます。

方法 3：Java 用 SchedulerX SDK を使用した SchedulerX のデプロイ

前提条件

• ACK クラスターまたは自己管理型 Kubernetes クラスターが作成されています。詳細については、「ACK マネージドクラスターの作成」をご参照ください。

• SchedulerX がアクティブ化されています。

• SchedulerX コンソールで Kubernetes アプリケーションが作成されています。詳細については、「アプリケーションの作成」をご参照ください。

アプリケーションを SchedulerX に接続する

Java 用 SchedulerX SDK を使用して、アプリケーションを SchedulerX に接続します。詳細については、「Spring Boot アプリケーションを SchedulerX に接続する」をご参照ください。

<dependency>
  <groupId>com.aliyun.schedulerx</groupId>
  <artifactId>schedulerx2-spring-boot-starter</artifactId>
  <version>${schedulerx2.version}</version>
</dependency>	
<dependency>
  <groupId>com.aliyun.schedulerx</groupId>
  <artifactId>schedulerx2-plugin-kubernetes</artifactId>
  <version>${schedulerx2-plugin-kubernetes.version}</version>
</dependency>

Kubernetes ジョブの作成

次のスクリプトのいずれかを実行する前に、[タスク管理] ページの [タスクの作成] パネルで Kubernetes ジョブを作成します。詳細については、「ジョブ管理」をご参照ください。