* 目次 [#i097eb1f]
#contents
** JHipsterのCI/CDのページ [#x83b0348]
https://www.jhipster.tech/setting-up-ci/
** GitLabのCI/CDのページ [#ofc55fbb]
dockerで動かす際の説明
https://docs.gitlab.com/runner/install/docker.html
https://about.gitlab.com/features/continuous-integration/
** .gitlab-ci.yml ファイルとは [#e450d961]
.gitlab-ci.yml ファイルはパイプラインの構造と順序を定義し、以下のことを決めます。
- GitLab Runnerを使って実行する内容。
- 特定の状況において、どのような判断をするか。例えば、処理が成功した場合と失敗した場合。
** .gitlab-ci.ymlのリファレンス [#h1cf516a]
https://gitlab-docs.creationline.com/ee/ci/yaml/
*** GitLabのクイックスタート [#xee0cfc6]
https://gitlab-docs.creationline.com/ee/ci/quick_start/README.html
** GitLabの設定サンプル [#dd8c86af]
https://gitlab-docs.creationline.com/ee/ci/examples/README.html
*** mavenを使った例 [#z4fd2745]
https://gitlab-docs.creationline.com/ee/ci/examples/artifactory_and_gitlab/index.html
*** spring-bootを使った例 [#pa163e7d]
https://gitlab-docs.creationline.com/ee/ci/examples/deploy_spring_boot_to_cloud_foundry/index.html
** jhipster ci-cdをためす [#bcee8a31]
jhipster ci-cd
を実行してみる
選択枝でGitLabを選ぶ
In GitLab CI, perform the build in a docker container
となる。
y
を選ぶ
.gitlab-ci.yml
が変更になる
** .gitlab-ci.yml に追加されたコード [#z53e08e5]
追加のタスクは何もなしで進むと以下のコードが追加された
image: jhipster/jhipster:v7.9.3
cache:
key: '$CI_COMMIT_REF_NAME'
paths:
- .maven/
stages:
- check
- build
- test
- analyze
- package
- release
- deploy
before_script:
- export MAVEN_USER_HOME=`pwd`/.maven
nohttp:
stage: check
script:
- ./mvnw -ntp checkstyle:check -Dmaven.repo.local=$MAVEN_USER_HOME
maven-compile:
stage: build
script:
- ./mvnw -ntp compile -P-webapp -Dmaven.repo.local=$MAVEN_USER_HOME
artifacts:
paths:
- target/classes/
- target/generated-sources/
expire_in: 1 day
maven-test:
services:
- docker:dind
variables:
# Instruct Testcontainers to use the daemon of DinD.
DOCKER_HOST: 'tcp://docker:2375'
# Improve performance with overlayfs.
DOCKER_DRIVER: overlay2
stage: test
script:
- ./mvnw -ntp verify -P-webapp -Dmaven.repo.local=$MAVEN_USER_HOME
artifacts:
reports:
junit:
- target/surefire-reports/TEST-*.xml
- target/failsafe-reports/TEST-*.xml
paths:
- target/surefire-reports
- target/failsafe-reports
- target/site
expire_in: 1 day
frontend-test:
stage: test
script:
- npm install
- npm test
artifacts:
reports:
junit: target/test-results/TESTS-results-jest.xml
paths:
- target/test-results
- target/jacoco
expire_in: 1 day
maven-package:
stage: package
script:
- ./mvnw -ntp verify -Pprod -DskipTests -Dmaven.repo.local=$MAVEN_USER_HOME
artifacts:
paths:
- target/*.jar
- target/classes
expire_in: 1 day
# Uncomment the following line to use gitlabs container registry. You need to adapt the REGISTRY_URL in case you are not using gitlab.com
#docker-push:
# stage: release
# variables:
# REGISTRY_URL: registry.gitlab.com
# IMAGE_TAG: $CI_REGISTRY_IMAGE:$CI_COMMIT_REF_SLUG-$CI_COMMIT_SHA
# dependencies:
# - maven-package
# script:
# - ./mvnw -ntp jib:build -Pprod -Djib.to.image=$IMAGE_TAG -Djib.to.auth.username=gitlab-ci-token -Djib.to.auth.password=$CI_BUILD_TOKEN -Dmaven.repo.local=$MAVEN_USER_HOME
* GitLab Runnerは別サーバー？ [#qef7020e]
もしかしてGitLabRunnerは別サーバにたてるのだろうか？
以下に構築方法を解説しているサイトがあった。
https://www.alpha.co.jp/blog/202208_01#%E3%82%AD%E3%83%A3%E3%83%83%E3%82%B7%E3%83%A5%E3%82%A2%E3%83%BC%E3%83%86%E3%82%A3%E3%83%95%E3%82%A1%E3%82%AF%E3%83%88%E3%83%AC%E3%82%B8%E3%82%B9%E3%83%88%E3%83%AA%E3%81%AE%E6%A0%BC%E7%B4%8D%E5%A0%B4%E6%89%80
* Dockerコンテナでgitlabとgitlab-runnerを構築してCI/CD [#j72672bb]
https://syachiku.net/docker-gitlab-gitlab-runner/
* docker-composeに追加するコード [#cab9639f]
gitlab-runner:
image: gitlab/gitlab-runner:latest
container_name: gitlab-runner
restart: always
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- /root/gitlab/gitlab-runner-config:/etc/gitlab-runner
ports:
- "8093:8093"
** 必要なディレクトリやファイルを作成 [#v7daa150]
mkdir -p /root/gitlab/gitlab-runner-config
** GitLab Runnerを使用する前に、GitLabの管理者アカウントでGitLab Runnerを登録する必要があります。 [#de7649ef]
*** GitLabの公式ドキュメント [#kfa9f19c]
https://docs.gitlab.com/runner/
正直、オンプレミスではどうしたらよいのか親切には書いてない。
* 日本語の解説サイト [#z19e0b20]
** GitLab Runner構築のススメ [#v2853f1d]
https://www.gitlab.jp/blog/2022/09/26/runner-summary/
画面のキャプチャとかあって、本家よりわかりやすいかもしれない。インストール部分は、自分はdocker-composeを使ったので、参考にしてないが、GitRunnerの登録の仕方が本家の説明で要領を得なかったので、ここを参考にした。
*** 手順 [#yf300046]
- GitLab全体の基本設定のほうではなく、プロジェクトのサイドメニューから設定->CI/CD->Runnerを開いてください。
- Specific runnersに表示されているURL (GitLabのURLです)とregistration tokenの二つをメモする
メモしたい項目の具体的な項目名:
- Register the runner with this URL:
- And this registration token:
*** gitlab-runnerのコンテナ名の調査 [#x6580623]
docker-compose ps
起動させてあるのが、前提条件ですが、上記のコマンドで、実行済みのgitlab-runnerのコンテナ名を調べます。
*** docker-imageへのログイン [#c23330d0]
docker exec -it 上記手順で調べたドッカーコンテナ名 bash
*** 登録コマンドの実行 [#rfc64fc7]
コマンドを実行する前に、どのようなコマンドがあるのか確認してみましょう。
gitlab-runner --help
登録に実行するコマンドは、以下のコマンドですが、、
gitlab-runner register
上記コマンドだと、インタラクティブなのですが、コマンドラインだけでやる方法もあります。
gitlab-runner register --non-interactive --locked=false --url=<URL> --registration-token=<token> --name=container-runner --tag-list=tag-runner --executor=docker --docker-privileged=true --docker-image=docker:20.10.15-dind
Shell
で、参考にしたサイトは
https://e-penguiner.com/build-gitlab-runner-with-docker/
です。
実行すると、上記の場合は質問されないです。いろいろなサイトで見つけるやり方だといくつか質問をしてくるので、上記手順でメモした内容で答えていきます。
実行タイプはdockerを選んだほうがdocker上のGitLabに認識してもらえるので、いいかと思います。
質問結果は以下に保存されます。
/etc/gitlab-runner/config.toml
*** gitlab-runnerのサービスのインストール [#x35928ae]
gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner
実行は、
gitlab-runner run &
です。
停止は、
gitlab-runner stop
です。
