Skip to content

README.md

Latest commit

 

History

History
118 lines (80 loc) · 4.66 KB

README.md

File metadata and controls

118 lines (80 loc) · 4.66 KB
Raw

ASPNETWebService を Docker で動かす

Samples4NetCore/Backend/ASPNETWebService（ResourceServerTemplate、net10.0）を Linux コンテナで動かす（#582）。

構成は ../MVC_Sample/README.md と同じである。 方式（ホストビルド型）・設定の置き方・証明書の扱い・本番へ持って行くときの注意は、 あちらが一次情報なので、ここには書かない。

ここに書くのはこの Resource Server だけの事情である。

前提

MVC_Sample と同じ。DB は LocalServicesOnDocker が提供するものに相乗りするので、先に起動しておくこと。

手順

# 1. HTTPS の開発用証明書を作る（初回のみ）
powershell -NoProfile -ExecutionPolicy Bypass -File .\0_SetupCert.ps1

# 2. publish してコンテナを起動する
.\1_PublishAndUp.bat

# 3. 動いているか確かめる（**画面が無いので、これがクライアント**）
powershell -NoProfile -ExecutionPolicy Bypass -File .\3_Test.ps1

# 4. 止める
.\2_Down.bat
HTTP  : http://localhost:8090   （HTTPS へリダイレクト）
HTTPS : https://localhost:8091
IDL   : https://localhost:8091/openapi/v1.json

MVC_Sample との違い

① ホスト側のポートが 8090 / 8091

MVC_Sample（8080 / 8081）と同時に起動できるようにしてある。 Resource Server を MVC から呼ぶ構成を、そのまま試せる。

コンテナ内の待ち受けは両者とも 8080 / 8081 のままである （ASPNETCORE_HTTP_PORTS / ASPNETCORE_HTTPS_PORTS）。 変えているのは docker-compose.yml の ports の左側だけ。

② Cookie を使わない

OAuth2 の Resource Server であり、認証は Authorization: Bearer ヘッダである。 Cookie 認証・セッションを持たないため、次は設定していない。

MVC_Sample こちら
CookieSecurePolicy always 書かない（効かない）
DataProtectionKeyPath /app/keys 書かない（同上）

Startup.cs 側もコメントアウトで残してある。 消していないのは、Cookie 認証へ広げるときの手本になるためである。

/app/keys のボリュームだけは用意してある。 今は使わないが、Cookie 認証を足した時点で必ず要る （コンテナを作り直すたびに鍵が変わり、認証 Cookie が失効するため）。 そのとき docker-compose.yml を書き換えずに済む。

③ 画面が無い

静的ファイル（/wwwroot）も Razor も持たない。 ブラウザで確認するなら IDL（/openapi/v1.json） を開く。

動作の確認は 3_Test.ps1 で行う

画面が無いため、確かめる手段（クライアント）が要る。 それがこのスクリプトである。

OK   HTTP -> HTTPS リダイレクト     307 -> https://localhost:8091/... （辿れる）
OK   OpenAPI (IDL)                  openapi 3.1.1 / paths 16 件
OK   WebAPI /api/Json/test          200
OK   WebAPI /api/BatchUpdate/SelectCount   200 / count

どれも「200 が返る」だけでは足りない。

  • リダイレクトは飛び先のポートと、実際に辿れるかまで見る
  • IDL は openapi の版と、代表的な API が名前で載っているかまで見る （疎通テストの判定も同じ。SMOKETEST.md 3 節）
  • SelectCount は DB まで通るので、リソースと接続文字列の確認になる

リダイレクトの判定は、最初「3xx かつ https で始まる」だけだった。 それでは飛び先がコンテナ内のポート（8081）でも OK になり、 実際にホストから辿れない状態を見逃していた（下記）。

踏んだところ : リダイレクト先はホスト側のポートで与える

UseHttpsRedirection が読むのは 単数形の ASPNETCORE_HTTPS_PORT である （複数形の ASPNETCORE_HTTPS_PORTS は Kestrel の待ち受け。Startup.cs のコメント）。

ここにコンテナ内の 8081 を与えると、ホストから辿れない URL へ飛ばす。 ports で 8091:8081 に付け替えているため。 docker-compose.yml で ASPNETCORE_HTTPS_PORT=8091 を与えている。

MVC_Sample は 1:1（8080/8081）なので、この指定が要らない。

対象外

Samples/WS_sample/ASPNETWebService（net48）は対象外。 クラシック ASP.NET であり、Linux コンテナでは動かない。