20.5. リモート Git リポジトリーの統合

手順

1. 端末ウィンドウで、GitHub リポジトリーをシステムにクローンします。

   $ git clone https://github.com/kiegroup/bc-git-integration-push.git

   Copy to Clipboard Toggle word wrap

2. クローンしたリポジトリーに移動します。

   $ cd bc-git-integration-push

   Copy to Clipboard Toggle word wrap

3. Maven の新規インストールを実行します。

   $ mvn clean install

   Copy to Clipboard Toggle word wrap

4. EAP_HOME ディレクトリーに /hooks ディレクトリーを作成します。

   $ mkdir -p _EAP_HOME_/hooks/

   Copy to Clipboard Toggle word wrap

5. git-push-2.1-SNAPSHOT.jar を EAP_HOME/hooks/ ディレクトリーにコピーします。

   $ cp bc-git-integration-push/target/git-push-2.1-SNAPSHOT.jar _EAP_HOME_/hooks/

   Copy to Clipboard Toggle word wrap

6. 必要に応じて、テンプレートの .gitremote 設定ファイルを作成するには git-push-2.1-SNAPSHOT.jar を実行します。

   $ java -jar git-push-2.1-SNAPSHOT.jar

   Copy to Clipboard Toggle word wrap

   テンプレート .gitremote 設定ファイルの例

   #This is an auto generated template empty property file
   provider=GIT_HUB
   login=
   password=
   token=
   remoteGitUrl=https://api.github.com/
   useSSH=false
   ignore=.*demo.*, test.*
   githubOrg=OrgName
   gitlabGroup=Group/subgroup

   Copy to Clipboard Toggle word wrap

7. .gitremote 設定ファイルパラメーターを変更します。

   Expand

   表20.1 .gitremote パラメーターの例

   パラメーター	説明
   provider	Git プロバイダー。許容値は GIT_HUB と GIT_LAB の 2 つのみ。必須。
   login	Git プロバイダーのユーザー名。必須。
   password	プレーンテキストのパスワードです。token が指定されている場合は必要ありません。
   token	username および password ベースの、安全対策がされていない接続の代わりとなる生成トークン。注記: これが設定されていない場合は、セキュアでない接続を使用している旨の警告が表示されます。password が指定されている場合は必須ではありません。注記: GitLab はトークン認証のみをサポートします。
   remoteGitUrl	パブリックのプロバイダー URL またはプロバイダー用にローカルでホストされたエンタープライズ URL。必須。注記: 公開 GitHub URL は API URL である必要があります。たとえば、api.github.com です。
   useSSH	SSH プロトコルがリモートリポジトリーに変更をプッシュできるようにするブール型。任意。デフォルト値 = false。注記: このパラメーターはローカルの ~/.ssh/ ディレクトリーを使用して SSH 設定を取得します。
   ignore	これらの式のいずれかに一致するプロジェクト名を無視するために、コンマ区切りの正規表現。任意。
   githubOrg	プロバイダーとして GitHub を使用する場合にリポジトリー組織を定義します。任意。
   gitlabGroup	プロバイダーとして GitLab を使用する場合にリポジトリーグループおよびサブグループを定義します。任意。

   Show more

8. EAP_HOME/hooks に、post-commit Git フックファイルを作成します。

   $ touch post-commit

   Copy to Clipboard Toggle word wrap

9. post-commit ファイルのパーミッションを 755 に設定します。

   $ chmod 755 post-commit

   Copy to Clipboard Toggle word wrap

10. #!/bin/bash と git-push-2.1-SNAPSHOT.jar を実行するコードを post-commit ファイルに追加します。

    $ echo "#\!/bin/bash\njava -jar $APP_SERVER_HOME/hooks/git-push-2.1-SNAPSHOT.jar" > hooks/post-commit

    Copy to Clipboard Toggle word wrap

11. -Dorg.uberfire.nio.git.hooks 環境変数を設定して、Business Central を起動します。以下に例を示します。

    $ ./standalone.sh -c standalone-full.xml -Dorg.uberfire.nio.git.hooks=_EAP_HOME_/hooks

    Copy to Clipboard Toggle word wrap