ASP.NET Core のお気に入りの機能たち (docker向け)
•Download as PPTX, PDF•
0 likes•2,694 views
Fukuoka .NET Conf 2017での登壇資料
Recommended
More Related Content
What's hot
What's hot (20)
Viewers also liked
Viewers also liked (14)
Similar to ASP.NET Core のお気に入りの機能たち (docker向け)
Similar to ASP.NET Core のお気に入りの機能たち (docker向け) (20)
More from Takayoshi Tanaka
More from Takayoshi Tanaka (20)
Recently uploaded
Recently uploaded (15)
ASP.NET Core のお気に入りの機能たち (docker向け)
- 2. 自己紹介 Red Hat K.K. 勤務 ◦ Software Maintenance Engineer ◦ 担当はOpenShiftと（いつの間にか）Microsoftとの協業分野全般 ◦ .NET Core on RHEL, Red Hat solutions on Azure, SQL Server on RHEL ◦ 会社Blog: Red Hat Developers Personal ◦福岡県北九州市出身 ◦ Microsoft MVP for VSDT ◦ Blog: 銀の光と碧い空 ◦ Build Insiderで.NET Core連載中 VSDT: Visual Studio & Development Technologies
- 3. 今日のセッションのゴール Dockerをはじめとしたコンテナ環境で ASP.NET Coreを便利に使いたい そんな時に役立つ機能のご紹介 ※kubernetes (OpenShift)の機能とあわせて紹介していますが、 他のオーケストレーションツール/サービスでも 同じような機能があるはずです kubectl: kubernetsコマンド, oc: OpenShiftクライアントコマンド
- 4. Agenda ◦ Visual StudioでのDocker support ◦ 外部ファイルを使った設定の注入 ◦ 複数コンテナでのセッション管理 ◦ リモートデバッグ ◦ EF Core: コードファースト DB migration
- 6. Docker Support ◦ ASP.NET Core プロジェクトのテンプレート選択画面
- 7. Docker Support ◦ ASP.NET Core プロジェクトのテンプレート選択画面 テンプレートによっては 利用できない Windows/Linux コンテナ選択可 ソリューションフォルダを作らないと うまく動作しない （バージョンがあった）
- 8. 何が起きるのか？ ◦ Dockerfileの追加 ◦ 単純なASP.NET Coreアプリのコンテナ だったのが15.5 Previewではちょっと手の込んだ方法に… ◦ docker-composeプロジェクトの追加 ◦ docker composerファイルの追加 ◦ ローカルのdockerへの配置とデバッグの支援 ◦ 機能自体はVisual Studio SDK側で実装されている ◦ Linux/Windowsコンテナの選択は docker-composeプロジェクトで設定してある
- 9. 新しいDockerfile FROM microsoft/aspnetcore:2.0 AS base WORKDIR /app EXPOSE 80 FROM microsoft/aspnetcore-build:2.0 AS build WORKDIR /src COPY *.sln ./ COPY WebApplication1/WebApplication1.csproj WebApplication1/ RUN dotnet restore COPY . . WORKDIR /src/WebApplication1 RUN dotnet build -c Release -o /app FROM build AS publish RUN dotnet publish -c Release -o /app FROM base AS final WORKDIR /app COPY --from=publish /app . ENTRYPOINT ["dotnet", "WebApplication1.dll"]
- 11. 何がうれしい？ ◦最終的なコンテナサイズが小さくなった ◦ 今までは.NET Core SDK (Runtime+ビルドに必要なもの) をベースにしていたので、最初からサイズがでかい ◦ Runtimeのみのコンテナではビルドできない ◦ ビルド用のコンテナを別にして、そちらはSDKこみで。 最終的な成果物のコンテナはRuntimeのみにした ◦ （おまけ）OpenShiftもTemplateとして提供しています セッション後のハイパー宣伝タイムで！
- 12. Dockerデバッグの仕組み
- 13. Docker for Windows Hyper-V Docker用仮想マシン コンテナ実行用軽量LinuxVM Docker Engine Docker クライアント Linux コンテナ プロセス
- 15. ビルド Hyper-V コンテナ実行用軽量LinuxVM Windows側で プロジェクトをビルド tail -f /dev/null で起動しっぱなし app.dll
- 16. デバッグ開始 Hyper-V コンテナ実行用軽量LinuxVM dotnet app.dll tail -f /dev/null で起動しっぱなし app.dll ./vsdbg vsdbg コンテナ内でdotnetプロセスを開始 デバッガープロセス開始 SSHこしにリモートデバッグ接続
- 17. (Note) dockerの状態 PS C:Tools> docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES e1e8b52cf67e aspnetcoreexample1:dev "tail -f /dev/null" About a minute ago Up About a minute 0.0.0.0:32768->80/tcp dockercompose9290894832686996463_aspnetcoreexample1_1 PS C:Tools> docker exec -i -t e1e8b52cf67e /bin/bash //なぜかpsコマンドが使えないので、/proc/<PID>を直接見る # cat /proc/1/cmdline tail -f /dev/null # cat /proc/5/cmdline /remote_debugger/vsdbg --interpreter=vscode # cat /proc/13/cmdline /usr/bin/dotnet --additionalProbingPath /root/.nuget/packages --additionalProbingPath /root/.nuget/fallbackpackages bin/Debug/netcoreapp2.0/AspNetCoreExample1.dll # cat /proc/820/cmdline /bin/bash
- 19. .NET Core Debugger概要 19 GDB/LLDB MICore MIDE/Engine.Impl MIDE(*)/AD7.Impl VSCode Debugger AD7 Interface *MIDE: MIDebugEngine: GitHub repository *vsdbg can be used only in VS products and might not be distributed. MIText VS Debugger VS Debugger Engine vsdbg (closed license*) windbg See more: Architecture of MIEngin
- 20. .NET CoreのDebuggerの特徴 ◦ 低レイヤーはwindbg(vsdbg?)、GDB/LLDBとOS固有 ◦ WindowsではVisual Studioがすべて面倒みてくれる ◦ Linux (Mac)ではMIEngineというツールが面倒をみる ◦ MS製OSSだけど、バイナリの利用はVS製品のみ許可 ◦ ツールは違えどインターフェースは共通 ◦ WindowsとLinux(Mac)の間で 相互にリモートデバッグが可能
- 21. リモートのDockerに接続したい ◦ 技術的には可能 ◦ vsdbgのバイナリを手動インストール (VSから使う用途はOKのはず) ◦ sshコマンドの代わりにkubectl exec/oc rshなどを使えばよい ◦ が、現状、機能としては存在しない ◦ クローズド部分なのでVSIX(VS拡張)も作れない模様 ◦ Azureはkubernetes推しなので、将来対応するのでは？ ◦ composerを直接はサポートしていないのでそこも対応を期待
- 22. Visual Studio Code なら可能 ◦ launch.jsonに追加 ◦ SSHの代わりに任意のコマンドを指定できる ◦ 月曜の夜に会社ブログに書いた記事が公開されます { "name": ".NET Core OpenShift Pod Remote Attach", "type": "coreclr", "request": "attach", "processId": "", "pipeTransport": { "pipeProgram": "oc", "pipeArgs": [ "exec", "-it", "<pod_name>", "--"], "quoteArgs":false, "debuggerPath": "/opt/app-root/vsdbg/vsdbg", "pipeCwd": "${workspaceRoot}" }, "justMyCode":false, "sourceFileMap": { "/opt/app-root/src": "${workspaceRoot}"} }
- 26. Dockerでの取り扱い ◦ 設定ファイルを含んだvolumeをDocker起動時にマウントさせる ◦ Docker使わない環境でも指定したパスにファイルを置けばよい ◦ kubernetesの場合はConfigMapを使えます $ kubectl create configmap myconfig --from-file=appsettings.json //pod.yaml spec: containers: - name: test-container volumeMounts: - name: config-volume mountPath: /opt/app-root/conf volumes: - name: config-volume configMap: name: myconfig
- 27. 機密情報を扱いたい場合 ◦ DBのパスワードなど ◦ ソースコードリポジトリには入れたくない ◦ アプリのコンテナイメージにも入れておきたくない ◦ ASP.NET CoreのUserSecret機能は開発用途なので使うべき ではない ◦ マシン固有の暗号キーでファイルに保存しておく機能 ◦ Azureの場合 Azure Key Vault と Managed Service Identity ◦ 今のところPreviewでApp ServiceとAzure Functionsのみ利用可 ◦ kubernetes/OpenShiftの場合 Secret機能
- 30. 複数コンテナでHTTPセッション デフォルトでは： ◦ コンテナごとにHTTPセッションをメモリ内に格納 ◦ コンテナでない場合もプロセスごとに別々 つまり？ ◦ コンテナへのロードバランシングがStickyセッションなら コンテナが生きている限り問題なし ◦ コンテナが死んだらセッションが維持できない ◦ Stickyじゃないとそもそもセッションが維持できない
- 31. container A cnotainer B container C ASP.NET Core ASP.NET Core ASP.NET Core それぞれのコンテナに 別々にセッションデータが格納される container AでHTTPセッション確立しても 次のHTTPリクエストがcontainer Bだと 確立したセッションの情報はない
- 32. IDistributedCache & IDataProtection IDistributedCache ◦ 名前からしてこれだけ設定すれば十分な気がする これがまちがい ◦ 分散キャッシュを提供 ◦ セッションの格納先に指定できる ◦ SQLServerとRedisを保存先とするライブラリASP.NET Coreチームが提供 IDataProtection ◦ 暗号化のキー管理を提供 ◦ HTTPセッションの暗号化にも利用されている ◦ デフォルトではコンテナ（マシン）ごとにキーを発行し、 ローカルファイルに保存 ◦ Network FilesystemとRedisとAzure Storage, Azure Fileを提供
- 33. container A container B container C ASP.NET Core ASP.NET Core ASP.NET Core Session Data A’ containerごとに異なるキー セッションデータ自体を 共有できても、キーが違うので 復号できず意味がない ~/.aspnet IDistributedCacheをRedisに設定するだけだと…
- 34. machine A machine B machine C ASP.NET Core ASP.NET Core ASP.NET Core Session Data IDataProtectionもRedisに設定 キー自体をRedisに保存して 共有するのでOK！ Redisが死んだ場合の考慮は必要
- 35. Redisを設定しましょう public void ConfigureServices(IServiceCollection services) { var conn = Configuration["REDIS_CONNECTION_STRING"]; var redis = ConnectionMultiplexer.Connect(conn); services.AddDataProtection() .PersistKeysToRedis(redis, "DataProtection-Keys"); services.AddDistributedRedisCache(option => { option.Configuration = conn; option.InstanceName = "master"; }); services.AddSession(); } httpsession.redis.cache.windows.net:6380,password=<password>,ssl=True,abortConnect=False
- 37. BlogTemplateを題材にしてみます ASP.NET Coreで作られたブログテンプレート ◦ MSDN Blogで紹介 Welcome to the New Blog Template for ASP.NET Developers ◦ ブログのデータはFilesystem上にxmlファイルとして配置するので、 EF Coreは認証まわりで利用するのみ 修正する必要はあるけどクロスプラットフォームで動きます ◦ Local SQLServer SQLite ◦ https://github.com/VenusInterns/BlogTemplate/issues/187 ◦ SQL Server on Linuxでもいいけど同じ1ファイルベースで扱えるので ◦ ファイルパスがWindows Style前提なのを共通化 ◦ https://github.com/VenusInterns/BlogTemplate/issues/188
- 39. コードからDBテーブル作ろう 必要な操作 ◦ コードはあらかじめ用意しておく ◦ 接続先情報も渡している状態 ◦ 環境変数やファイルから読む場合はアクセスできるように ◦ migrationコードを生成する ◦ [ここまで開発環境で生成しておいて、ビルド・展開する] ◦ dotnet コマンドで起動する前にupdateを実行する $ dotnet ef database update $ dotnet ef migrations add [好きな名前]
- 41. おまけ： RDBはコンテナ上で動かすべき？ コンテナで動かすことがメリットになるなら動かそう コンテナのメリット => 生成・破棄が簡単。再現性がある CI/CDでのテストやデモ用 自動復帰できればサービス断がある程度許せるアプリ (コンテナのHealth Checkがあれば容易に復旧できる場合） CPUやメモリを専有したい場合や、クラスタリング組む場合は 従来の方法がいいのでは？
- 42. まとめ Visual Studio Docker Support ◦ いろいろ進化中 ◦ kubernetes対応進むと嬉しいなあ |ω･)ﾁﾗ 設定の注入 ◦ Volumeとか環境変数経由で注入できる機能がある ◦ のでご利用のツールの機能と併せて使いましょう セッション管理 ◦ セッションデータの格納先とASP.NET Core側の設定に注意 EF Core ◦ コードファーストもあります ◦ RDBもコンテナに置いているときは、コードファーストで初期化できるのは便利かも
Editor's Notes
- ABI: Application Binary Interface