WebSphere ワークロードの移行計画をカスタマイズする

始める前に

このドキュメントでは、すでに移行を準備し、移行計画ファイルが作成されていることを前提としています。

移行計画を編集する

ファイル システムをコピーして分析すると、指定した出力パス（ANALYSIS_OUTPUT_PATH/config.yaml）に新しく作成されたディレクトリに移行計画が作成されます。

この移行計画を必要に応じて編集し、変更を保存します。

移行計画の詳細とコメントを確認して、必要に応じて情報を追加します。

特に、次のセクションに関する編集を検討してください。

移行計画の構造

WebSphere ワークロードの移行計画の構造は次のとおりです。次のセクションで説明するようにカスタマイズできます。

# List of discovered WebSphere application servers and how to migrate their
# hosted applications to containers.
webSphereApplicationServers:
# The application server installation path.
- home: /opt/ibm/wlp
  applicationServerInfo:
    name: WebSphere Application Server
    profile: Liberty
    version: 23.0.0.4
    edition: Base
    # List of Java installations available to the application server.
    javaDevelopmentKits:
    - home: /opt/ibm/java
      vendor: IBM Corporation
      version:
        jdk: java version 1.8.0_361
        jre: Java(TM) SE Runtime Environment
        jvm: IBM J9 VM
  # List of hosted applications and how to migrate them to containers.
  applications:
  - path: /opt/ibm/wlp/usr/servers/defaultServer/apps/app.war
    # Application archives to be migrated into the target container.
    archives:
    - /opt/ibm/wlp/usr/servers/defaultServer/apps/app.war
    # Application configuration files to be migrated into the target container.
    configurations:
      serverXML: /opt/ibm/wlp/usr/servers/defaultServer/server.xml
      serverEnv:
      - /opt/ibm/wlp/usr/servers/defaultServer/server.env
      bootstrapProperties:
      - /opt/ibm/wlp/usr/servers/defaultServer/bootstrap.properties
      variableProperties:
      - /opt/ibm/wlp/usr/servers/defaultServer/variables/variable.properties
      jvmOptions:
      - /opt/ibm/wlp/usr/servers/defaultServer/jvm.options
    # Application resource files to be migrated into the target container.
    resources:
      locations:
      - /opt/ibm/wlp/usr/servers/defaultServer/resources/ports.xml
      libraries:
      - /opt/ibm/wlp/usr/servers/defaultServer/resources/postgresql.jar
      keystores:
      - /opt/ibm/wlp/output/defaultServer/resources/security/key.p12
      sharedResources:
        - /opt/ibm/wlp/usr/shared/resources/jdbc.jar
      additionalResources:
      - /opt/ibm/wlp/output/defaultServer/resources/mongodb.jar
    javaRuntime:
      se: SE8
      ee: EE7
      vendor: IBM Corporation
    targetJavaRuntime:
      se: SE8
      ee: EE7
      vendor: IBM Corporation
    targetApplicationServer:
      profile: Liberty
      version: 23.0.0.4
      edition: Base
    targetContainer:
      # The target container base image name.
      baseImage: ibmcom/websphere-liberty:full-java8-ibmjava-ubi
      # The application server installation path within the target container
      # base image.
      home: /opt/ibm/wlp
      # The application server default server name.
      server: defaultServer
      # The UID or name of the user configured within the target container
      # base image. Defaults to 1001 for Liberty profile.
      user: "1001"
      # The GID or name of the group configured within the target container
      # base image. Defaults to 0 for Liberty profile.
      group: "0"
      # Application ports to be exposed in Kubernetes artifacts.
      ports:
      - name: http-tcp-9080
        port: 9080
        protocol: TCP
      - name: https-tcp-9443
        port: 9443
        protocol: TCP
      # Specify whether discovered keystores are automatically converted to
      # Kubernetes secrets. Defaults to true.
      enableSecrets: true

アプリケーションを除外する

移行の対象外にするアプリケーションを applications リストから削除します。

  applications:
  # Exclude app1.war:
  # - path: app1.war
  #  ...
  - path: app2.war

アプリケーション ファイルを制御する

アプリケーション ファイルを移行の対象外にするかどうかを制御するには、configurations フィールドと resources フィールドを更新します。

  applications:
  - path: app.war
    resources:
      keystores:
      # Exclude key1.p12:
      # - key1.p12
      # Include key2.p12:
      - key2.p12
      additionalResources:
      # Exclude resource1.xml:
      # - resource1.xml
      # Include resource2.xml:
      - resource2.xml

ターゲット Java ランタイムをカスタマイズする

アプリケーションのターゲット Java ランタイムをカスタマイズするには、targetJavaRuntime フィールドを更新します。

  applications:
  - path: app.war
    targetJavaRuntime:
      se: SE
      ee: EE
      vendor: VENDOR

次のように置き換えます。

• SE: Java SE のバージョン。形式: [SE8|SE11|SE17]。
• EE: Java EE または Jakarta EE のバージョン。形式: [EE7|EE8|EE9|EE10]。
• VENDOR: Java ベンダー。形式: [IBM Corporation|Oracle Corporation]。

ターゲット アプリケーション サーバーをカスタマイズする

アプリケーションのターゲット アプリケーション サーバーをカスタマイズするには、targetApplicationServer フィールドを更新します。

  applications:
  - path: app.war
    targetApplicationServer:
      profile: PROFILE
      version: VERSION
      edition: EDITION

次のように置き換えます。

• PROFILE: WebSphere プロファイル。形式: [Liberty|Traditional]。
• TARGET_VERSION: WebSphere のバージョン。
• TARGET_EDITION: WebSphere のエディション。形式: [Base|Core|Open|ND]。

ターゲット コンテナをカスタマイズする

アプリケーションに使用するターゲット コンテナをカスタマイズするには、targetContainer フィールドを更新します。

  applications:
  - path: app.war
    targetContainer:
      baseImage: BASE_IMAGE
      home: HOME
      server: SERVER
      user: USER
      group: GROUP

Kubernetes Secret をカスタマイズする

デフォルトでは、keystores フィールドに指定されているファイルが Kubernetes Secret に移行されます。このファイルをそのまま移行する場合は、この機能を無効にします。

  applications:
  - path: app.war
    resources:
      keystores:
      - key.p12
    targetContainer:
      # Do not migrate keystores to Kubernetes secrets:
      enableSecrets: false

Kubernetes ポートをカスタマイズする

Kubernetes Pod と Service が公開するポートを操作するには、ports フィールドを更新します。

  applications:
  - path: app.war
    targetContainer:
      ports:
      # Exclude http-tcp-9080:
      # - name: http-tcp-9080
      #   port: 9080
      #   protocol: TCP
      # Include https-tcp-9443:
      - name: https-tcp-9443
        port: 9443
        protocol: TCP

次のステップ

• 移行の実行方法を学ぶ。