機械翻訳について

WDTプロジェクト・リリース・プロセス

このドキュメントでは、WebLogic Deploy Tooling (WDT)リリースを作成するために従う必要があるプロセスについて説明します。

前提条件

  • WebLogic Server 12.2.1.xのローカル・インストールが使用可能である必要があります。
  • リリース・プロセスがマスター・ブランチに直接プッシュされるため、リリース・プロセスを実行するユーザーは「WebLogic Deploy Tooling GitHubリポジトリ」に対する管理者権限を持っている必要があります。
  • リリース・プロセスを実行するユーザーは、repo:status, repo_deployment, public_repoおよびsecurity_events権限を持つリポジトリに対してGitHub個人アクセス・トークンを作成する必要があります。
  • リリース・プロセスを実行するユーザーには、次に示すように、Maven settings.xmlファイル(GitHub Personal Access Tokenが格納される)にサーバーを追加する必要があります。 このトークンは、プレーン・テキストに格納するか、「Mavenパスワードの暗号化」を使用して暗号化できます。 
  <servers>
    <server>
      <id>github</id>
      <passphrase>store plain text or encrypted token here</passphrase>
    </server>
  </servers>
  • リリース・プロセスの実行元となるマシンがインターネットにアクセスするためにプロキシ・サーバーを必要とする場合、リリース・プロセスを実行するユーザーには、Maven settings.xmlファイルに構成されているアクティブなプロキシが必要です。
  <proxies>
    <proxy>
      <active>true</active>
      <id>my-proxy</id>
      <protocol>http</protocol>
      <host>proxy server DNS name</host>
      <port>proxy server port</port>
      <nonProxyHosts>list of DNS names/patterns separated by |</nonProxyHosts>
    </proxy>
  </proxies>

ソフトウェア・リリース・プロセス

ベスト・プラクティスは、次のステップを開始する前にGitHubに公開されるリリース・ノートを記述することです。

  1. 次の環境変数を設定(およびエクスポート)します:

    • WLST_DIR - $MW_HOME/oracle_common/common/binに設定します。$MW_HOMEは、WLS 12.2.1.xまたはそれ以降のインストール・ディレクトリへのパスです。
    • WDT_SCM_REPO_URL - プロジェクトのブラウズ可能URLに設定(例:https://github.com/oracle/weblogic-deploy-tooling)
    • WDT_SCM_REPO_CONN - プロジェクトのクローン可能URLに設定(例:git@github.com:oracle/weblogic-deploy-tooling.git)

  2. Oracleインフラストラクチャの一部としてリリースする場合は、リリース・プロセスを開始する前に、mainブランチに関連付けられているすべてのJenkinsビルド・アクティビティが完了するまで待機する必要があります。

  3. weblogic-deploy-toolingプロジェクト・ディレクトリで、mvn -B release:prepare release:performコマンドを実行します。

    • 次の開発バージョンでメジャー・バージョンまたはマイナー・バージョンを変更する場合は、コマンドラインでデフォルトのdevelopmentVersionプロパティをオーバーライドします。 たとえば、
      mvn -B -DdevelopmentVersion=3.2.0-SNAPSHOT release:prepare release:perform.
    • SSH秘密キーにパスフレーズがある場合は、パスフレーズを複数回入力するように要求されるため、ビルドを注意します。 適時に入力しないと、失敗する可能性があります。

  4. ビルドが失敗した場合は、mvn -B release:rollbackコマンドを実行して元に戻し、問題を修正した後にステップ2からやり直します。

  5. ソフトウェアのリリース後、GitHubリリース・プロセスに進みます。

GitHubリリース・プロセス

このプロセスは、ローカルMavenリポジトリにあるWDTインストーラに依存します。 そのため、同じユーザーが前のセクションのステップと同じマシンでこれらのステップを実行することが重要です。

  1. GitHubリリースを開始する前に、リリースによってトリガーされたすべてのJenkinsアクティビティが完了するまで待機する必要があります。
  2. リリース・ノートを<wdt-project-directory>/target/ReleaseNotes.mdファイルに保存します。
  3. コマンドmvn -f github-release.xml -DreleaseVersion=<release version number> verifyを実行して、ドラフトGitHubリリースを作成します。
  4. GitHubにログインし、リリース・ページに移動し、ドラフト・リリースをレビュー/編集してから、リリースを公開します。