kkamegawa's weblog

Visual Studio,TFS,ALM関係のことについていろいろと書いていきます。Google Analyticsで解析を行っています

dotnetConf関西2017を開催しました

connpass.com Photo by No.1

f:id:kkamegawa:20171015172950j:plain

あいにくの天候でしたが、参加してくださった方、スピーカーを引き受けてくれた方、スタッフの皆さん、会場を提供していただいた日本マイクロソフト様、ありがとうございました。今回は早々に参加者が定員上限に達して、あまり宣伝しなくてもいいかなという感じでほんと助かりました。

あいにく、ご都合が悪く、参加できなかった方もちゃんとキャンセル処理していただけたのも助かります。

前回よりも早々に枠が埋まったので、.NET(Core)をもう一度評価してみようとか、最近英語情報ばかりで日本語情報が必要なのか、その辺りはわかりませんが、アンケート結果によってはGlobal Azure Bootcampの前に1-2回程度何かやるかもしれません。

スピーカー陣のスライドやネタとなったツィートを #dotnetconf ハッシュタグから拾ってきました。漏れていたらすいません。

今後もイベント開催するときはよろしくお願いします。

VSTSでASP.NET CoreアプリのCI/CDを行う

はじめに

以前、VSTSとAzure App ServivesのCI/CDの話を書きました。

kkamegawa.hatenablog.jp

今はちょっとやり方が変わっているので、改めて紹介します。VSTSで書いていますが、基本はJenkinsやTFSでも変わりありません。

Build定義作成

VSTSのビルドテンプレートからVisual StudioもしくはASP.NET(Preview)を選んでください。

f:id:kkamegawa:20170505133249p:plain

dotnet restoreコマンドでもいいのですが、せっかくテンプレートに入っているNugetタスクを使います。重要なポイントとして、必ず、3.5以上を選択してください。ここでは4.0にしています。

NuGet 4.0はHosted VS2017であれば入っています。

f:id:kkamegawa:20170505133251p:plain

Visual Studioタスクで使用するVisual Studioを必ずVisual Studio 2017にします。

f:id:kkamegawa:20170505133218p:plain

Azure App Serviceへのデプロイにwebdeployを使うので、dotnet publishコマンドを使用します。引数に以下の値を指定します。

publish -c $(BuildConfiguration) -o $(Build.ArtifactStagingDirectory)

これで、ビルド構成(Release, Debugなど)でビルドした結果を -o で指定された出力先にコピーします。ArtifactStagingDirectoryでエージェントの中間生成領域です。

f:id:kkamegawa:20170505133220p:plain

WebDeployはzipファイルなので、ArtifactStagingDirectoryに出力した内容をzipファイルに圧縮します。

f:id:kkamegawa:20170505133221p:plain

生成されたzipファイルをリリース機能でデプロイするための領域にコピーします。

f:id:kkamegawa:20170505133225p:plain

Optionsの中にあるAgentsで必ずHosted VS2017を選んでください。これで準備完了です。

Release機能を使う

f:id:kkamegawa:20170505133223p:plain

リリース定義を作成し、App Serviceへのリリース用の環境を作ります。ここではJapan Westを作りました。

注意点として、Stagingスロットを作っていない場合、一度App Serviceをstopで止めてから入れ替えしないといけないようです。確かこれはASP.NET Coreのissueにも挙がっていた気がします。

止めて、デプロイしてから再度startタスクを実行します。容量にもよりますが、それなりに時間がかかるので、Staging作ってswapさせたほうがいいように思います。

成果物の受け渡しに関しては、以前の記事などを参照してください。

Global Azure BootCamp /w OzCode Kansaiを開催しました

Global Azure BootCamp

connpass.com

昨日の話ですが、Global Azure BootCamp /w OzCodeというイベントを開催しました。Global Azure BootCampとは年に一度この時期?に全世界同一日程でAzureのイベントをやろうというものです。今年はたまたまOzCode社の方がワールドツアーで来日されていたので、一緒のイベントとして実施しました。

global.azurebootcamp.net

私も余った時間…というか、時間が押してしまって予定のことがほとんどできませんでした…すいません。資料はこちらに置いています。

当日やるはずだったデモは録画なりフォローアップします。

OzCode

www.oz-code.jp

今回OzCodeのCTOであるOmer氏をはじめ、三名で世界各国を周ってプロモーションを行なっているそうです。日本でも東京、名古屋、大阪で開催されています。今日もう一度東京で実際されるようです。Omer氏自らによる解説は非常にわかりやすかったです。

Omer氏のキャリアは医療機器向けのエンジニアから始まっていて、デバッグに時間がかかっていることから、デバッグは心理学ではないか?と思い始めて、デバッグ拡張機能に注力を始めたそうです。

特に便利そうなのが、Switch〜Caseの分岐予測、パターンマッチにも対応しています。NULL referense発生する場所の色分け(結構困るんですよ)、LINQの対象条件の件数と内容抽出、メンバーをお気に入りにして、そのメンバーのみを専用のウォッチウィンドウに表示とExpressionでのカスタム表示などですね。

半年間有効なフリーライセンスのURLも提供していただいています。共有OKだそうです。一人ずつではなく、オフィスなら5人までだったかな?いいらしいです。

OSS開発者向けには無償で提供してくれるそうです。

www.oz-code.jp

当日の質疑応答から覚えている限りで。

C++/CLIも対応してる?

今の所C# に注力しているので、C#以外の対応は予定にないようです。

グラフィックスを扱っているけど、インラインでイメージデータを表示したい

残念ながらそういう機能はないそうですが、面白いねみたいにおっしゃってました。

メンバーのお気に入りは非常に便利だけど、AというメソッドとBというメソッドで違うメンバーをお気に入りにしたい

ないそうです…残念。

LINQは遅延評価だから、LINQデバッグ時に出ている件数は確定でないのでは?

その通り。そこは意識しておく必要があります。

ソースコードだけしかないプログラムのデバッグをしなければならなくなった、何かいい支援機能がある?

例えば、例外を起こした場合、その変数がどこで使われているか、ヒープから検索することができる。特定の変数であれば、トレースという機能を使って、追跡できます。

C#7みなさん使っていますか?(Omer氏)

OzCodeはC#7にも対応しているので、ValueTuple(英語では「トゥープル」みたいな発音するんですね)、パターンマッチ、outの変数宣言といった、Omer氏が気に入っているC# 7の新機能をOzCode使いながら紹介してくれました。

Hosted VS2017エージェントを使ってXamarinプロジェクトを継続的インテグレーションする

追加でこういう質問を受けたので、調べてみました。結論から言えばできます。もちろん、C# 7の機能を使っていても、対応するNuGetパッケージを入れていれば大丈夫です(一緒に生成されるライブラリプロジェクトに追加して確認)。

f:id:kkamegawa:20170411212250p:plain

一つだけ注意点として、NuGet Restoreタスクで使用するNuGetを明示的に3.5以上にしてください。ここでは4.0を指定していますが、Hosted VS2017であれば入っているので、大丈夫です。

f:id:kkamegawa:20170411212245p:plain

テンプレートから作っただけのXamarin.Formsアプリですが、こんな風にビルドできます。どうも"Visual Studio 2017"のHosted Agentなので、元からXamarinをはじめ、VS 2017に入っている機能は全部入っているようです。

f:id:kkamegawa:20170411214322p:plain

もう一つ、直接の問題ではありませんが、どうもHosted VS2017 AgentにはGit LFSが入っていないようです。フィードバックしていますので、そのうち治ると思います。

(2017/4/22更新)
4/19にVSTSの更新が入ったので、確認してみたところ、Hosted VS2017にGit LFS入ったようです。正しくビルドできました。

f:id:kkamegawa:20170422003445p:plain

C# 7.0のプロジェクトをVSTSで継続的インテグレーションする

前振り

という話があったので、ちょっと書いてみます。

C# 7.0プロジェクトを作る

f:id:kkamegawa:20170411062240p:plain

こんな風にC# 7.0の新機能であるタプルを書いてみます。

引用:ufcpp.net

もちろん素のVS2017ではエラーになるので、NuGetでValueTupleを追加します。

f:id:kkamegawa:20170411062239p:plain

ビルド定義作成

VSTSにプッシュしたら、VSTSのビルド定義を作ります。注意点は二つ。

  • Hosted AgentにVS2017を選ぶ
  • Visual Studio 2017を選択する。

f:id:kkamegawa:20170411062236p:plain

Visual Studio 2017を選びます。

f:id:kkamegawa:20170411062233p:plain

OptionsにあるエージェントからHosted VS2017を選びます。

ビルドしてみる

f:id:kkamegawa:20170411062231p:plain

Hosted VS 2017では成功します。

f:id:kkamegawa:20170411062254p:plain

普通のHosted Agentを選択すると失敗します。ちょっと前までVS2017というHosted Agentがなかったのですが、Side by Sideで動かすより、VS2017はしばしば更新されるから別にしたんでしょうかね。

Visual Studio Team Servicesに接続して開発する(6日目)

ようやく今日からVisual Studioをつないで開発を行います。

Gitリポジトリ

まず、VSTSにGitリポジトリを作成してからVisual Studioで接続します。

初期化

f:id:kkamegawa:20161205204215p:plain

最初はこのような画面が表示されます。既存のローカルリポジトリがあればそれをpushしてもいいですが、最初にVSTSで作ってからクライアントにcloneすれば.gitignoreの手間が省けます。

一番下にあるor initialize with a README or gitignoreにあるinitializeをクリックすれば指定したgitignore形式で作ります。

f:id:kkamegawa:20161205204214p:plain

注意点として、C#やVB.NETという設定はなく、Visual Studioになっています。

f:id:kkamegawa:20161205204212p:plain

cloneするためのツールも多く対応しています。.NET開発以外にもPhpStormやRubyMineとかにも対応しています。

f:id:kkamegawa:20161205204213p:plain

(あまりないかもしれませんが)GitHubなどの外部リポジトリから引っ越すこともできます。Requires authorizationにチェックすると、非公開な認証が必要なリポジトリもインポートできます。

f:id:kkamegawa:20161205204211p:plain

VSTS側で初期化した直後の状態です。.gitigonoreなどがあるので、このままクローンしてください。

f:id:kkamegawa:20161205204216p:plain

リポジトリのメニューを開いて、リポジトリ名のそばにある☆をクリックすると、該当リポジトリがお気に入りとして扱われ、アクセスしやすくなります。ほかの人が作ったリポジトリに素早くアクセスする場合に使ってください。

f:id:kkamegawa:20161205204217p:plain

一つのチームプロジェクトには複数(上限は非公表)のGitリポジトリを作ることができます。ビルドツールチェインはリポジトリ単位になるので、ある程度は分割したほうが便利でしょう。この辺はほかのGitサービスと考え方は変わらないはずです。

Gitセキュリティ設定

f:id:kkamegawa:20161205204218p:plain

歯車アイコンから、Securityハブを使用して、チームプロジェクトにアクセスできるユーザーもしくはグループを設定します。コードの編集権を付けるにはContributorsグループに追加します。

f:id:kkamegawa:20161205204208p:plain

チームプロジェクト内のリポジトリごとに設定することもできます。

f:id:kkamegawa:20161205204220p:plain

特定のブランチ(通常masterやリリース用のブランチ)にむやみやたらにpushされて、ビルドが通らなくなるというのはよくあることです。

そのような事故を防ぐためにブランチ単位でブランチポリシーという機能を使って、レビューやCIおよび、テストが通っていないコミットを拒否することができます。

まだビルドがないので、上記の画面ではビルドの指定ができていません(^^;。Require a new build if older than xx hoursというのは、Gitでは細かい単位でコミットを行うこともあります。

単なるtypoやCSSの色修正でビルドやテストを全部やっていたら時間がいくらあっても足りません。そこで、直近xx時間以内のビルドは許容する、という指定です。開発が活発になって、しょっちゅうコミットするような状態になったら検討したほうがいいでしょう。

f:id:kkamegawa:20161205204221p:plain

ブランチポリシーでレビュワーの指定ができます。この人(たち)がレビューしないとマージが行われません。

f:id:kkamegawa:20161205204219p:plain

ブランチの…をクリックすると、既定ブランチにするか、ブランチを誤って削除できないようにします。devとかpull request作った後も残っていてほしいブランチは指定するといいでしょう。

ブランチと作業項目を関連付ける

f:id:kkamegawa:20161204170815p:plain

ブランチはfeature,Backlog, Taskのいずれでも作成できます。機能レベルであれば、Backlogあたりで作るのがいいかもしれません。この辺りはいろいろ試行錯誤してルールを作ってみてください。タスクやissue単位でブランチを作るのもいいでしょう。

ブランチ名は / で区切ると階層になります。ここでは「チーム/backlog/id」というルールで切ってみました。こうするとブランチ名が何に関連づいているかわかりやすいでしょう。

f:id:kkamegawa:20161205204222p:plain

タスクに着手したので、タスクをIn Progressに変更します。

Visual StudioからVSTSへ接続する

f:id:kkamegawa:20161205204159p:plain

チームエクスプローラーから「接続の管理」を使用して「チームプロジェクトへ接続」をクリックします。なお、VSTSがサポートするVisual StudioはVS 2008 SP1 GDR1を適用したもの以降だそうです。

www.visualstudio.com

とはいえ、CIツールとして使う場合、Visual Studio 2013以降じゃないと、新しいビルドツールがサポートしていないとかいろいろ困ると思います。さらに、チームプロジェクトのリポジトリをGitで作った場合、サポートされるのはVisual Studio 2015 Update 1以降となっていますので、本当に使おうと思った場合、Visual Studio 2015 Update3を検討してください。

f:id:kkamegawa:20161205204201p:plain

さて、接続しましょう。ここもTeam Foundation Serverと書いていますが、気にせず「追加」をクリックします。なお、Visual Studio 2017ではこのUIがまた少し変わっています。

f:id:kkamegawa:20161205204200p:plain

接続するサーバーを追加するので「サーバー」をクリックします。

f:id:kkamegawa:20161205204202p:plain

VSTSにつなぐ場合、アカウント名.visualstudio.comを指定して、OKをクリックします。

f:id:kkamegawa:20161205204203p:plain

接続に使うアカウント名を選択します。

f:id:kkamegawa:20161205204204p:plain

追加されましたので、「閉じる」をクリックします。

f:id:kkamegawa:20161205204205p:plain

接続するチームプロジェクトを選択します。ちなみにVisual Studio 2017ではここでGitとTFVCの選択がやりやすくなっていますが、VS2015ではTFVCが優先されるようなUIです。

f:id:kkamegawa:20161205204206p:plain

接続すると、複製(git clone)します。基本的に作成したリポジトリのクローンを先に行ってください。

f:id:kkamegawa:20161205204207p:plain

複製先のフォルダを指定します。既定値はDocumentsフォルダのRepsの下に作成となっていますが、昨今のJavaScriptライブラリをcloneすると、ファイル名が簡単に260バイト超えてしまいます。

こんな風にc:\とかに短いフォルダを作成して、その下にcloneしましょう。

Gitの設定

f:id:kkamegawa:20161205204210p:plain

チームプロジェクト内にある、Gitの設定を行っておきましょう。グローバル設定(全Gitリポジトリに共通)と、リポジトリの設定(リポジトリ毎)の二種類があります。リポジトリの設定はVSTSでリポジトリを初期化するとVisual Studioに最適化されたGit設定(.gitignore)がダウンロードされているので、設定する必要はありません。

Gitのグローバル設定ではメールアドレスと、氏名だけは必ず設定しておきましょう。何も設定しないとWindowsのログオンアカウントが使用されてしまいます。

プロジェクトを作成する

git clone後、いよいよVisual Studioで作成します。

f:id:kkamegawa:20161205204224p:plain

.NET のWebアプリケーションを作ります。

f:id:kkamegawa:20161205204225p:plain

.NET Coreでやってみます。

f:id:kkamegawa:20161205204223p:plain

Application Insightsも構成してみます。

f:id:kkamegawa:20161205204226p:plain

App Serviceを設定して、完成。

まとめ

ようやく開発らしいところになりました。ここから先、ようやく開発関係の機能紹介を行います。

.NET CoreアプリをVSTSで継続的インテグレーションする(Linux版)

Linuxビルドエージェントを構成する

.NET - Powerful Open Source Development

Linuxのディストリビューションごとに手順が違うので、注意してください。私はUbuntu Server 16.04 LTSでやっています。

ビルド定義を作る

Windows版と同じ感じで作ります。

f:id:kkamegawa:20160919120826p:plain

違うのはZipパッケージの作成と、リリース用PowerShellスクリプトの代わりにシェルスクリプトが用意されていることですね。タスクはほとんどUtilityにある、Shell Scriptを使用します。

シェルスクリプトとタスクの単位

dotnet restore/buildのように連続するタスクは一つのシェルスクリプトで実施してもかまわないのでしょうが、個人的にはビルドタスク単位で別にしたほうがわかりやすいかと思います。

作成したシェルスクリプトはSolutionフォルダ内に適当なシェル用のフォルダを作って入れておくといいでしょう。

NuGetパッケージのリストア

NuGetパッケージのリストアに必要なシェルはこのようになります。

#!/bin/sh  
/usr/bin/dotnet restore  

パッケージリストア用のシェルスクリプトはテストプロジェクトでも使用できるので、使いまわしてください。

プロジェクトのビルド

ビルドに必要な最低限のシェルはこのようになります。

#!/bin/sh
/usr/bin/dotnet build -c $BUILDCONFIGURATION

$BUILDCONFIGURATIONはVariablesに定義された値です。Variablesでは大文字小文字があるように見えますが、bashではこの定義済みの値は全て大文字として定義されています。

f:id:kkamegawa:20160919141406p:plain

テストプロジェクトの実行

テストプロジェクトにあるテストを実行するにはこのようなスクリプトを実行します。テストプロジェクトを実行する前に必ずNuGetパッケージのリストアタスクをテストプロジェクトのフォルダで実行してください。

#!/bin/sh
/usr/bin/dotnet test -xml Test-Result1.xml

Windowsのビルド定義のところでも書きましたが、-xmlオプションでXMLファイルにテスト結果を出力します。複数のテストプロジェクトの結果をマージする場合、この引数はシェルスクリプトの引数として外出できるようにしてください。

パッケージを出力する

特定のプロジェクトをWebサーバーへデプロイするための最低限のスクリプトはこのようになります。

#!/bin/sh
/usr/bin/dotnet publish src/{プロジェクト名} --configuration $BUILDCONFIGURATION --output $PUBLISHOUTPUT  --framework $NETCOREVERSION

$PUBLISHOUTPUTは出力先フォルダを定義した値です。これもWindows版と同様に、システムに.NET Coreがインストールされているという前提のパッケージです。

Windows版にも書きましたが、必ず--configurationでreleaseと指定して、Release版をデプロイしてください。

場合によってはここで一気にデプロイまでやってもいいのですが、別にしています。

まとめ

Windows版と同様ですが、タスクごとにシェルスクリプト作らないといけないのが少し面倒かもしれませんね。外部にビルドサーバーが必要になるし、どうしてもLinuxでなくてはならないビルドを行う以外はHostedエージェントを使ったほうがいいように思います。
次はリリースについて紹介します。