へっぽこプログラマーの備忘録
プログラムを中心とした個人的なメモ用のブログです。 タイトルは迷走中。
内容の保証はできませんのであしからずご了承ください。
menu
keyboard_arrow_up
Top
search
close
home
ホーム
computer
PC一般
construction
開発環境・ツール
code
プログラミング
home
ホーム
computer
PC一般
construction
開発環境・ツール
code
プログラミング
Home
›
SonarQube
›
[C#] GitLab CI と SonarQube で .NET アプリケーションの CI を行う
2017/12/28
[C#] GitLab CI と SonarQube で .NET アプリケーションの CI を行う
update
event_note
label
.NET Core
label
C#
label
GitLab
label
SonarQube
以前の記事で SonarQube を使って .NET アプリケーションの静的解析を行いました。 今回はこれに GitLab CI を使って継続的インテグレーションを行います。
具体的には Push をトリガーとして自動的にコードを解析を行い、またその解析結果をマージリクエストの画面に表示します。 尚、Jenkins 等の他の CI ツールは必要ありません。 ## 環境 - GitLab 10.2.0 - gitlab-runner 10.2.0 - SonarQube 6.7 - SonarQube Scanner for MSBuild 4.0 - .NET Core 2.0 ## 準備 GitLab と SonarQube の環境構築は済んでいる前提です。 Docker を使った環境構築については以下を参考にしてください。 - [GitLab を docker-compose で動かしてみる](http://kuttsun.blogspot.jp/2016/09/dockergitlab.html) - [SonarQube を docker-compose で動かしてみる](http://kuttsun.blogspot.jp/2017/12/sonarqube-docker-compose.html) また、GitLab CI を使うためにはタスクランナーとして gitlab-runner が必要です。 以下の記事に書いたように、C# プログラムのコード解析には OpenCover と SonarQube Scanner を使っていますが、これらは Windows 上でしか動作しません。 - [[C#] OpenCover でコードカバレッジを計測する](http://kuttsun.blogspot.jp/2017/12/opencover.html) - [[C#] SonarQube で .NET アプリケーションのコード解析を行う](http://kuttsun.blogspot.jp/2017/12/sonarqube-net.html) 従って、gitlab-runner は Windows 上にインストールしたものを使う必要があります。 gitlab-runner を Windows にインストールする手順については以下の記事を参照してください。 - [GitLab Runner を Windows で動かす](http://kuttsun.blogspot.jp/2017/12/gitlab-runner-windows.html) GitLab に gitlab-runner を登録するところまでも済んでいる前提とします。 ## GitLab の設定 ### ユーザーの追加 SonarQube から GitLab に通知するためのユーザーを GitLab に作成します。 後で SonarQube の設定を行うときに作成したユーザーのトークンが必要になります。 トークンは作成したユーザーでログインし、Account のメニューの Private Token で確認できます。 もちろん、別途トークンを作成しても OK です。 ### Pipeline 失敗時のマージ拒否 Pipeline で失敗している場合にマージリクエストをマージできないようにしたい場合は、該当のプロジェクトで以下を設定します。 [Edit Project] > `Only allow merge requests to be merged if the build succeeds` を ON にし、`Save changes` をクリック ## SonarQube の設定 管理者アカウントでログインして以下のことを行います。 ### GitLab Plugin のインストール [Administration] > [Marketplace] > `GitLab` で検索し、`GitLab` をインストールします。
インストールしたら SonarQube を再起動します。 ### GitLab Plugin の設定 [Administration] > [Configuration] > サイドメニューより `GitLab` を選択します。 `GitLab url` と `GitLab User Token` を設定します。 `GitLab User Token` には、あらかじめ GitLab に作成しておいたアカウントのトークンを設定します。
詳細は以下を参照してください。 - https://gitlab.talanlabs.com/gabriel-allaigre/sonar-gitlab-plugin ### プロジェクトの設定 該当のプロジェクトの画面で以下を設定します。 [Administration] > [General Settings] > サイドメニューより `GitLab` を選択します。 `GitLab Project id` を設定します。
## .gitlab-ci.yml の作成 GitLab と SonarQube の設定が完了したら、.gitlab-ci.yml を作成します。 SonarQube のコード解析の部分だけのサンプルですが、例えば以下のような感じです。 ```xml variables: SONARSCANNER: "C:\\SonarQube\\sonar-scanner-msbuild-4.0.0.821\\MSBuild.SonarQube.Runner.exe" SONARHOST: "http://localhost:9000" SONARKEY: "projectkey" REPORT: "coverage.xml" stages: - test Job1: stage: test script: # GitLab のコンソールログでの文字化け対策 - chcp 65001 # SonarQube による解析(環境変数を先頭に置くと yaml パーサーでエラーになるので call をつけている) - call %SONARSCANNER% begin /d:sonar.host.url=%SONARHOST% /k:%SONARKEY% /v:"1.0" /d:sonar.analysis.mode=preview /d:sonar.cs.opencover.reportsPaths=%REPORT% /d:sonar.gitlab.commit_sha=%CI_COMMIT_SHA% /d:sonar.gitlab.project_id=%CI_PROJECT_ID% /d:sonar.gitlab.ref_name=%CI_COMMIT_REF_NAME% - dotnet build - call .\OpenCover.bat %REPORT% - call %SONARSCANNER% end tags: - windows ``` OpenCover の解析部分はバッチファイルにしていますが、中身については以下の記事を参考にしてください。 - [[C#] OpenCover でコードカバレッジを計測する](http://kuttsun.blogspot.jp/2017/12/opencover.html) SonarQube の解析も、後述するように SonarQube Server と GitLab の通知のために2回行うことを前提にするならば、バッチファイルにして処理を共通化したほうが良いかなと思います。 まぁそれはともかく、とりあえずこれで全て完了です。 これで以下のように動作します。 - GitLab に Push したタイミングで GitLab CI の機能により、最新コミットのコード解析が行われる - SonarQube での解析結果が GitLab に通知される - 解析を行ったコミットが含まれるマージリクエストに指摘事項が表示される マージリクエストの画面にはこんな感じで表示されます。
SonarQube Scanner for MSBuild のパラメータの一覧は以下を参照してください。 - https://gitlab.talanlabs.com/gabriel-allaigre/sonar-gitlab-plugin .gitlab-ci.yml で使用できる環境変数の一覧は以下を参照してください。 - https://docs.gitlab.com/ee/ci/variables/README.html 今回使用しているパラメータについては以下に簡単に説明します。 **sonar.analysis.mode** デフォルトは `publish` で、この場合、解析結果が SonarQube Server にアップロードされます。 GitLab に通知したい場合は、`preview` を指定する必要があります。 SonarQube Server と GitLab の両方に通知したい場合は、面倒ですが `sonar.analysis.mode` の値を変えて2回解析を実行する必要があります。 尚、`publish` の場合に後述の GitLab 関連のオプションを設定していると解析に失敗するので注意です。 **sonar.host.url** SonarQube Server の URL を指定します。 **sonar.cs.opencover.reportsPaths** OpenCover の出力ファイルを指定します。 **sonar.gitlab.commit_sha** 解析対象の Git のコミットのハッシュ値を指定します。 **sonar.gitlab.project_id** GitLab のプロジェクト ID を指定します。 SonarQube のプロジェクト設定で設定済みの場合は不要っぽいです。 **sonar.gitlab.ref_name** ブランチ名を指定します。 **sonar.gitlab.user_token** GitLab に通知する際のユーザーのトークンを指定します。 SonarQube で設定済みの場合は不要っぽいです。 ## はまったところ 何度見直しても正しく設定しているはずなのに、解析結果が GitLab に通知されずずっと悩んでいました。 解析ログをよく見ると、以下の警告が表示されていました。 ``` The project does not have a valid "ProjectGuid." ``` `ProjectGuid` が何なのかわからないまま調べてみると、どうやら .NET Core の ProjectGuid 変更になったらしく、これを手動で追加すると解析結果が GitLab に通知されるようになりました。 詳細は以下の記事を参照してください。 - http://kuttsun.blogspot.jp/2017/12/net-core-projectguid.html ## 参考 URL - http://codeout.hatenablog.com/entry/2015/08/21/012706 - https://qiita.com/bremen/items/f47f383b9931a840a25c - https://gitlab.talanlabs.com/gabriel-allaigre/sonar-gitlab-plugin - https://qiita.com/ynott/items/1ff698868ef85e50f5a1 - https://eliot-jones.com/2017/12/configure-gitlab-sonarqube-teamcity - https://docs.gitlab.com/ce/ci/variables/README.html#using-the-ci-variables-in-your-job-scripts - http://blog.applibot.co.jp/blog/2017/09/14/static-code-analysis-with-sonarqube/ - https://github.com/gabrie-allaigre/sonar-gitlab-plugin/issues/75 - https://github.com/mibexsoftware/sonar-bitbucket-plugin/issues/25 - https://qiita.com/teradonburi/items/776e4735395af872320a - https://qiita.com/ijoji/items/f7dce812c84a5cfa91cf
tweet
facebook
Pocket
B!
はてブ
LINE
chevron_left
chevron_right
Translate
Popular Posts
Docker for Windows の設定
TortoiseGit でコミットメッセージを変更する
image
NO IMAGE
smbclient で session setup failed: NT_STATUS_LOGON_FAILURE が表示される
TortoiseGit でブランチ間の差分を見る
image
NO IMAGE
マージ元ブランチとマージ先ブランチ
[Python] 文字列の判定で、None と空文字を同時に判定する
[Python] Tesseract で OCR を行ったら `UnicodeEncodeError: 'ascii' codec can't encode characters` のエラーが表示された
image
NO IMAGE
GitLab Runner でクローンする URL を変更する
[Python] matplotlib で plot する際に "Tcl_AsyncDelete: async handler deleted by the wrong thread" というエラーがでる
image
NO IMAGE
[JavaScript] コンストラクタで await したい
Labels
.NET Core
31
.NET Framework
17
.NET Standard
2
AdminLTE
1
AI
1
Apache
3
AppVeyor
2
AsciiDoc
3
ASP.NET Core
55
Atom
4
AWS
5
AWS Cloud9
4
blockdiag
1
Blogger
13
Bootstrap
3
C/C++
6
C#
106
CentOS
3
Chrome
1
Chronograf
3
chrony
1
Codecov
1
CSS
1
Docker
79
DokuWiki
4
Doxygen
1
draw.io
1
EasyTag
1
Electron
1
Electron.NET
2
Entity Framework Core
9
Excel
2
FFmpeg
3
Firefox
6
Flask
1
Git
19
GitBook
4
GitBucket
7
GitHub
7
GitLab
39
Go
1
Google
1
Google Cloud Platform
1
Grafana
13
GStreamer
2
HTML
5
IIS
8
InfluxDB
14
JavaScript
15
Jenkins
7
Linux
33
Log4View
1
MahApps.Metro
3
MaterialDesignInXamlToolkit
1
MkDocs
2
MongoDB
5
MVC
1
MVVM
6
nginx
3
NLog
3
Node.js
8
npm
1
NVIDIA
3
onvif
1
OpenAPI
2
OpenCV
4
OpenSSL
3
OpenVINO
2
ownCloud
2
pandas
1
Pine Script
1
PlantUML
5
Portainer
3
PowerShell
8
Prism
2
PySide
17
Python
85
PyTorch
1
RabbitVCS
1
Razor
3
Redmine
33
Redoc
1
remark.js
2
rocketchat
10
Ruby
3
scikit-learn
1
SignalR
1
Slack
1
Socket.IO
1
SonarQube
5
Sphinx
10
SQL Server
5
SQLite
1
StableDiffusion
1
Subversion
2
Swagger
1
Swarmpit
1
Syslog
3
Telegraf
6
Tesseract
3
TestLink
2
Tomcat
2
TortoiseGit
11
TortoiseSVN
2
Trading View
1
Traefik
3
Travis CI
1
Ubuntu
31
Visual Studio
39
Visual Studio Code
10
VSCode
8
Vue.js
8
Windows
62
Windows 10
5
Windows ADK
1
Windows API
2
Windows Embedded
4
wkhtmltopdf
2
Word
3
WPF
12
WSL
5
WSL2
5
Xamarin
1
xUnit
5
yaml
1
yolo
1
アプリケーション
1
デザインパターン
1
テスト
1
バッチファイル
2
プログラミング
4
ライセンス
1
暗号資産(仮想通貨)
1
英語
2
確定申告
1
機械学習
1
強化学習
1
雑記
1
書籍
1
数学
1
正規表現
1
Blog Archive
►
2024
(7)
►
3月
(1)
►
2月
(5)
►
1月
(1)
►
2023
(30)
►
12月
(3)
►
11月
(5)
►
10月
(2)
►
9月
(1)
►
8月
(2)
►
7月
(4)
►
6月
(2)
►
5月
(3)
►
4月
(2)
►
3月
(2)
►
2月
(3)
►
1月
(1)
►
2022
(106)
►
12月
(5)
►
11月
(1)
►
10月
(3)
►
9月
(6)
►
8月
(7)
►
7月
(6)
►
6月
(13)
►
5月
(9)
►
4月
(15)
►
3月
(11)
►
2月
(14)
►
1月
(16)
►
2021
(85)
►
12月
(11)
►
11月
(6)
►
10月
(4)
►
9月
(10)
►
8月
(8)
►
7月
(4)
►
6月
(18)
►
5月
(7)
►
4月
(8)
►
3月
(2)
►
2月
(2)
►
1月
(5)
►
2020
(56)
►
12月
(1)
►
11月
(3)
►
10月
(3)
►
9月
(3)
►
8月
(3)
►
7月
(7)
►
6月
(7)
►
5月
(2)
►
4月
(6)
►
3月
(6)
►
2月
(3)
►
1月
(12)
►
2019
(92)
►
12月
(13)
►
11月
(9)
►
10月
(3)
►
9月
(2)
►
8月
(3)
►
7月
(5)
►
6月
(11)
►
5月
(6)
►
4月
(17)
►
3月
(9)
►
2月
(6)
►
1月
(8)
►
2018
(100)
►
12月
(1)
►
11月
(11)
►
10月
(8)
►
9月
(6)
►
8月
(10)
►
7月
(10)
►
6月
(8)
►
5月
(9)
►
4月
(8)
►
3月
(14)
►
2月
(4)
►
1月
(11)
▼
2017
(117)
▼
12月
(14)
[C#] GitLab CI と SonarQube で .NET アプリケーションの CI を行う
.NET Core の ProjectGUID
IIS に AdminScripts フォルダがないのでインストールする方法
IIS をコマンドで操作する
Windows 7 に OpenSSH をインストールする
.gitlab-ci.yml で変数を使う(ただし Windows 環境で)
[C#] SonarQube で .NET アプリケーションのコード解析を行う
GitPitch を docker-compose で動かしてみる
GitLab Runner を Windows で動かす
ASP.NET Core で DataAnnotations の多言語対応を行う
多言語対応のための共通のリソースファイルの作成
[C#] AppVeyor と Codecov でカバレッジを計測する
SonarQube を docker-compose で動かしてみる
[C#] OpenCover でコードカバレッジを計測する
►
11月
(20)
►
10月
(17)
►
9月
(19)
►
8月
(10)
►
7月
(8)
►
6月
(3)
►
5月
(6)
►
4月
(5)
►
3月
(2)
►
2月
(8)
►
1月
(5)
►
2016
(91)
►
12月
(5)
►
11月
(9)
►
10月
(11)
►
9月
(9)
►
8月
(6)
►
7月
(14)
►
6月
(14)
►
5月
(11)
►
4月
(10)
►
3月
(2)
►
2015
(23)
►
12月
(4)
►
11月
(2)
►
10月
(8)
►
9月
(8)
►
7月
(1)
►
2013
(3)
►
11月
(1)
►
9月
(1)
►
7月
(1)
►
2012
(2)
►
7月
(1)
►
6月
(1)
►
2011
(1)
►
9月
(1)
►
2009
(1)
►
7月
(1)
►
2008
(2)
►
11月
(1)
►
7月
(1)
►
2007
(3)
►
10月
(3)