AWS Solutions Architect ブログ

【.NET Developer Blog】ASP.NET Core の探索 パート2: 継続的デリバリ

このシリーズの最初のポストで、ASP.NET Core アプリケーションを GitHub からデプロイするために、どのように Amazon EC2 インスタンスと AWS CodeDeploy を利用するかについて議論しました。そこでのセットアップは何の検証もなしに、GitHub に対して git プッシュしたすべての内容が実行環境に展開されると仮定しています。 この記事では、品質管理と AWS のクラウド スケールの恩恵を受けるASP.NET Core アプリケーションの AWS 環境を、どのようにして構築できるかを検証していきます。

aws-blog-net-exploring-aspnet-core リポジトリの part2 ブランチに、このポストのコードとセットアップ スクリプトがあります。

 

デプロイメントの検証  

最初のポストでは、appspac.yml ファイルが、ApplicationStart フックの実行中にアプリケーションを展開し、IIS をセットアップするために InstallApp.ps1 スクリプトを呼び出していました。アプリケーションが起動し、実行していることを検証するために、ValidateService フックの実行中に ValidateInstall.ps1 を呼び出すように appspec.yml ファイルを修正してみましょう:

version: 0.0
os: windows
files:
  - source: \
    destination: C:\ExploringAspNetCore
hooks:
  ApplicationStop:
    - location: .\RemoveApp.ps1
      timeout: 30
  ApplicationStart:
    - location: .\InstallApp.ps1
      timeout: 300
  ValidateService:
    - location: .\ValidateInstall.ps1
      timeout: 300

このスクリプトは、アプリケーションが正しく実行しているかを確かめるためのテストを呼び出すことを許可します。GitHub リポジトリ内で、 .SampleApp\src\SmokeTests の下にいくつかの xunit テストを追加しました。このサンプル アプリケーションはもはや単純な "Hello World" Web アプリケーションではありません。従って、アプリケーションに Web コールを行い、正しいレスポンスを取得するためにテストを行う必要があります。現実世界のアプリケーションでは、この検証ステップの間に実行する、はるかに徹底的なテスト スイートを持っているでしょう。

テストが実行される方法を確認するために ValidateInstall.ps1 を見てみましょう。

 

sl C:\ExploringAspNetCore\SampleApp\src\SmokeTests

# Install the latest dnx runtime
C:\Windows\system32\config\systemprofile\.dnx\bin\dnvm install latest -p

# Restore the nuget references
dnu restore

# Run the smoke tests
dnx test

exit $LastExitCode

 

テストを実行するために、テストが保存されたディレクトリに切り替えます。依存関係を復元し、dnx test コマンドを実行します。どのテストも失敗した場合は dnx が終了コードに 0 以外を返し、PowerShell スクリプトがそれを受け取ります。AWS CodeDeploy は失敗した終了コードを発見し、そのデプロイメントを失敗とマークします。失敗を確認するために AWS CodeDeploy コンソールからテストの実行のログを取得することができます。

 

AWS CodePipeline の利用 

 さて、デプロイメントがスモークテストで実行され、正しくないデプロイメントが検知できるようになりました。同様の方法で、正しくないデプロイメントによってユーザーが影響を受けないことを検証したいと思います。ペスト プラクティスはスモークテストを実行している間、ベータ ステージのパイプラインを利用することです。ベータが成功した場合のみ本番に昇格します。これによって安全なチェックに基づいて継続的デリバリを行うことができます。繰り返しますが、パート1で議論したように我々は ASP.NET  Core がソースから実行できる能力によって恩恵を受けます。このことは、パイプラインの中でビルド ステップの構成に煩わされる必要がないことを意味します。パイプラインは、 Amazon S3 か GitHub からソースをプルすることができます。PowerShell スクリプトだけでセットアップが可能な完全なサンプルを提供するために、ここでは S3 をパイプラインのソースとして利用します。AWS CodePipeline は、パイプラインを通じてプッシュされるオブジェクトの新しいバージョンを感知するために S3 をモニタします。GitHub リポジトリの構成に関する情報については、AWS CodePipeline ユーザーガイドをご参照ください。

 

セットアップ スクリプト 

リポジトリ内の PowerShell スクリプト .\EnvironmentSetup\EnvironmentSetup.ps1 は、パイプラインを通じてアプリケーションをデプロイするために必要な AWS リソースを作成します。

メモ：未使用のリソースへの課金を防ぐために、テストが完了したら、 .\EnvironmentSetup\EnvironmentTearDown.ps1 を確実に実行してください。

セットアップ スクリプトは以下のリソースをセットアップします: 

• 初期デプロイメント ソースとしての zip アーカイブを含む S3 バケット
• ベータ用の1つの t2.small EC2 インスタンス
• t2.medium インスタンスを使用したロードバランサ付きのオートスケール グループ
• t2.small EC2 インスタンスを利用するベータ用のAWS CodeDeploy アプリケーション
• オートスケール グループを利用する本番用の AWS CodeDeploy アプリケーション
• ソースとしての S3 バケットを伴った AWS CodePipeline と AWS CodeDeploy アプリケーションが利用するように構成されたベータと本番用のステージ

スクリプトが完了したら、ベータ用の EC2 インスタンスと本番用のロード バランサのパブリック DNS が出力されます。両方のステージでデプロイメントが成功したかどうかを見るために、パイプラインの進捗を AWS CodePipeline コンソールでモニタすることができます。

https://cdn.amazonblogs.com/net_awsblog/images/SuccessCodePipeline.png"/>

AWS CodeDeploy デプロイメントのスモークテストは成功しているので、アプリケーションは両方の環境にデプロイされています。

 

失敗したデプロイメント 

 デプロイメントが失敗した時に何が起こるかを見てみましょう。.\SampleApp\src\SmokeTests\WebsiteTests.cs テスト ファイルを開いて、テストが失敗するように変更を加えることで強制的にテストを失敗させます。

?

1 2 3 4 5 6 7 8 9 10

[Fact] public async Task PassingTest() {     using (var client = new HttpClient())     {         var response = await client.GetStringAsync("http://localhost-not-a-real-host/");           Assert.Equal("Exploring ASP.NET Core with AWS.", response);     } }

リポジトリの中で、.\DeployToPipeline.ps1 スクリプトを実行できます。このスクリプトはアーイブを Zip 圧縮し、パイプラインで利用する S3 ロケーションにアップロードします。これによってベータ環境でデプロイメントが開始されます。（間違ったテストにより、デプロイメントは失敗します）

ベータで失敗したため、デプロイメントは本番ステージを試みようとはしません。これによって本番の健康状態が保たれます。何が起こっているのかを見るために、AWS CodeDeploy コンソールのデプロイメント ログを見ることができます。

結論

AWS CodeDeploy と AWS CodePipeline で、ASP.NET Core アプリケーションをデプロイする完全な継続的デプロイ システムを構築することができました。サンプルとスタートアップ スクリプトを GitHub リポジトリからチェックアウトしてください。このシリーズの次のポストでは、ASP.NET Core のクロス プラットフォーム サポートについて探索していきます。

 

日本語訳はSA 福井 厚が担当しました。原文はこちらです。
https://blogs.aws.amazon.com/net/post/Tx2EHIJAM9LIW8G/Exploring-ASP-NET-Core-Part-2-Continuous-Delivery

 

 

【.NET Developer Blog】ASP.NET Core の探索 パート1： GitHub からデプロイする

ASP.NET Core は、以前は ASP.NET 5 と呼ばれていましたが、.NET アプリケーションを展開するための多くの可能性を提供するプラットフォームです。この連載ポストでは、 AWS 上に展開する ASP.NET の選択肢について探っていきます。

 

ASP.NET Core とは何か？

ASP.NET Core は、新しいオープン ソース、クロス プラットフォーム、モジュール化された ASP.NET の実装です。現在開発中ですので、アップデートや変更についての将来のポストを期待してください。（例えば、新しいCLIなど） 

 

GitHub からデプロイする

AWS CodeDeploy デプロイメント サービスを GitHub からのデプロイメントをトリガーするために構成することができます。ASP.NET Core 以前は、.NET アプリケーションは展開される前に、ビルドされなければなりませんでした。ASP.NET Core アプリケーションはソースコードから展開し、実行することができます。

 

サンプル コードとセットアップ スクリプト

このブログのコードとセットアップ スクリプトは、aws-blog-net-exploring-aspnet-core リポジトリの part1 ブランチで見つけることができます。

 

AWS CodeDeploy のセットアップ

AWS CodeDeploy は、デプロイメント グループとしてセットアップし構成した、 Amazon EC2 インスタンスのデプロイメントを自動化します。より詳しい情報いついては、AWS CodeDeploy ユーザーガイドをご参照ください。

ASP.NET Core は、クロスプラットフォーム サポートを売りにしていますが、このポストでは Microsoft Windows Server 2012 R2 を実行するインスタンスを利用します。Windows EC2 インスタンスには、 IIS と HttpPlatformHandler がインストールされている必要があります。HttpPlatformHanlder は、 IIS と ASP.NET Core Web サーバーの Kestrel と通信するために必要です。

AWS CodeDeploy 環境をセットアップするために、 GitHub リポジトリにある .\EnvironmentSetup\EnvironmentSetup.ps1 PowerShell スクリプトを実行することができます。このスクリプトは、 EC2 インスタンスをセットアップし、 AWS CodeDeploy と IIS を構成する AWS CloudFormation スタックを作成します。そして、その後に ExploringAspNetCorePart1 という AWS CodeDeploy アプリケーションをセットアップします。（約注：Windows PowerShell for AWS のデフォルトのリージョンを Set-DefaultAWSRegion で us-east-1 に設定します。）

継続して AWS リソースに対して課金されることを避けるために、テストが終わったら、.\EnvironmentSetup\EnvironmentTearDown.ps1 PowerShell スクリプトを忘れずに実行してください。

GitHub と AWS CodeDeploy

AWS CodeDeploy コンソールを利用して、AWS CodeDeploy アプリケーションを GitHub リポジトリへ接続することができます。次に GitHub リポジトリとコミットID を指定することで、 AWS CodeDeploy アプリケーションへのデプロイメントを開始することができます。 AWS CodeDeploy チームが、AWS CodeDeploy アプリケーションに自動的にデプロイメントをプッシュするために、リポジトリを設定する方法についてブログをポストしています。

 

ソースからデプロイする

GitHub からデプロイする場合、デプロイメント バンドルはリポジトリの Zip アーカイブです。リポジトリのルート内に、 AWS CodeDeploy アプリケーションをどのように展開するか記述している appspec.yml ファイルが存在します。 我々のアプリケーションでは、 appspec.yml は非常にシンプルになっています：

version: 0.0
os: windows
files:
  - source: \
    destination: C:\ExploringAspNetCore
hooks:
  ApplicationStop:
    - location: .\RemoveApp.ps1
      timeout: 30
  ApplicationStart:
    - location: .\InstallApp.ps1
      timeout: 300

 

このファイルは、AWS CodeDeploy にリポジトリからファイルを C:\ExploringAspNetCore 上に解凍し、そしてその後にアプリケーションを開始するために PowerShell スクリプト InstallApp.ps1を実行するように指示しています。スクリプトは 3つのパートに分かれています。最初のパートは最新の dnx ランタイムをインストールします。

 

# Download the bootstrapper dnvm install script
iex ((new-object net.webclient).DownloadString('https://dist.asp.net/dnvm/dnvminstall.ps1'))

# Install the latest dnx runtime
C:\Windows\system32\config\systemprofile\.dnx\bin\dnvm install latest -p

 

２番目のパートは、アプリケーションを発行するために必要なすべての依存関係とパッケージを取得します。

 

# Restore the nuget references
dnu restore

# Publish application with all of its dependencies and runtime for IIS to use
dnu publish --configuration release -o c:\ExploringAspNetCore\publish --runtime active

 

３番目のパートは、配布フォルダの wwwroot をポイントするように IIS を更新します。 AWS CodeDeploy エージェントは 32 ビットのアプリケーションなので、 PowerShell スクリプトを 32 ビット バージョンの PowerShell で実行します。 PowerShell から IIS へアクセスするためには、64 ビットの PowerShell を利用する必要があります。従って、このセクションではスクリプトを 64 ビット バージョンの PowerSHell.exe に渡します。

 

C:\Windows\SysNative\WindowsPowerShell\v1.0\powershell.exe -Command {
             Import-Module WebAdministration
             Set-ItemProperty 'IIS:\sites\Default Web Site' 
                 -Name physicalPath -Value c:\ExploringAspNetCore\publish\wwwroot
}

 

メモ： この行は読みやすさのために書式を整えています。正しい文法は、リポジトリ内のスクリプトを参照してください。

 

AWS CodeDeploy へデプロイメントをプッシュするために GitHub リポジトリを構成済みであれば、すべてのプッシュごとに、コードの変更は Zip 圧縮されて AWS CodeDeploy に送信されます。その後、AWS CodeDeploy は、appspec.yml と InstallApp.ps1 を実行し、EC2 インスタンスは最新のコードで更新されます --- ビルドのステップは要求されません。

フィードバックを共有してください

aws-blog-net-exploring-aspnet-core リポジトリからチェックアウトして、どのように思ったかを我々に教えてください。我々は継続してリポジトリにアイデアを追加していきます。ASP.NET Core アプリケーションのデプロイに対するあなた自身のアイデアを共有するために、遠慮せずに課題をオープンしてください。

（日本語訳はSA 福井 厚が担当しました。原文はこちらです。 https://blogs.aws.amazon.com/net/post/TxSBK1AHRGLHVC/Exploring-ASP-NET-Core-Part-1-Deploying-from-GitHub