翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
QuickStart: Elastic Beanstalk に .NET Core on Linux アプリケーションをデプロイする
この QuickStart チュートリアルでは、.NET Core on Linux アプリケーションを作成し、 AWS Elastic Beanstalk 環境にデプロイするプロセスについて説明します。
注記
この QuickStart チュートリアルは、デモンストレーションを目的としています。このチュートリアルで作成したアプリケーションを本稼働トラフィックに使用しないでください。
セクション
AWS アカウント
まだ AWS のお客様でない場合は、 AWS アカウントを作成する必要があります。サインアップすると、Elastic Beanstalk やその他の必要な AWS サービスにアクセスできます。
AWS アカウントをすでにお持ちの場合は、「」に進むことができます前提条件。
にサインアップする AWS アカウント
がない場合は AWS アカウント、次の手順を実行して作成します。
にサインアップするには AWS アカウント
https://portal.aws.amazon.com/billing/signup
を開きます。 オンラインの手順に従います。
サインアップ手順の一環として、通話呼び出しを受け取り、電話キーパッドで検証コードを入力するように求められます。
にサインアップすると AWS アカウント、 AWS アカウントのルートユーザー が作成されます。ルートユーザーには、アカウントのすべての AWS のサービス とリソースへのアクセス権があります。セキュリティのベストプラクティスとして、ユーザーに管理アクセスを割り当て、ルートユーザーのみを使用してルートユーザーアクセスが必要なタスクを実行してください。
AWS サインアッププロセスが完了すると、 から確認メールが送信されます。https://aws.amazon.com/
管理アクセスを持つユーザーを作成する
にサインアップしたら AWS アカウント、日常的なタスクにルートユーザーを使用しないように、 のセキュリティを確保し AWS IAM Identity Center、 AWS アカウントのルートユーザーを有効にして、管理ユーザーを作成します。
を保護する AWS アカウントのルートユーザー
-
ルートユーザーを選択し、 AWS アカウント E メールアドレスを入力して、アカウント所有者AWS Management Console
として にサインインします。次のページでパスワードを入力します。 ルートユーザーを使用してサインインする方法については、AWS サインイン ユーザーガイドのルートユーザーとしてサインインするを参照してください。
-
ルートユーザーの多要素認証 (MFA) を有効にします。
手順については、「IAM ユーザーガイド」の AWS アカウント 「ルートユーザーの仮想 MFA デバイスを有効にする (コンソール)」を参照してください。
管理アクセスを持つユーザーを作成する
-
IAM アイデンティティセンターを有効にします。
手順については、「AWS IAM Identity Center ユーザーガイド」の「AWS IAM Identity Centerの有効化」を参照してください。
-
IAM アイデンティティセンターで、ユーザーに管理アクセスを付与します。
を ID ソース IAM アイデンティティセンターディレクトリ として使用する方法のチュートリアルについては、「 AWS IAM Identity Center ユーザーガイド」の「Configure user access with the default IAM アイデンティティセンターディレクトリ」を参照してください。
管理アクセス権を持つユーザーとしてサインインする
-
IAM アイデンティティセンターのユーザーとしてサインインするには、IAM アイデンティティセンターのユーザーの作成時に E メールアドレスに送信されたサインイン URL を使用します。
IAM Identity Center ユーザーを使用してサインインする方法については、「 ユーザーガイド」の AWS 「 アクセスポータルにサインインする」を参照してください。 AWS サインイン
前提条件
このガイドの手順に従うには、run command のためのコマンドラインターミナルまたはシェルが必要になります。コマンドは、該当する場合、プロンプト記号 ($) と現在のディレクトリの名前が前に付けられて、リストに示されます。
~/eb-project$ this is a command
this is output
Linux および macOS では、任意のシェルとパッケージ管理者を使用できます。Windows では、Linux 用の Windows サブシステムをインストール
EB CLI
このチュートリアルでは、Elastic Beanstalk コマンドラインインターフェイス (EB CLI) を使用します。EB CLI をインストールおよび設定する手順の詳細については、「Elastic Beanstalk コマンドラインインターフェイスをインストールする」および「EB CLI の設定」を参照してください。
.NET Core on Linux
ローカルマシンに .NET SDK がインストールされていない場合は、.NET ドキュメント
次のコマンドを実行して、.NET SDK のインストールを確認します。
~$ dotnet --info
ステップ 1: .NET Core on Linux アプリケーションを作成する
プロジェクトディレクトリを作成します。
~$ mkdir eb-dotnetcore
~$ cd eb-dotnetcore
次に、次のコマンドを実行して、サンプルの Hello World アプリケーションを作成します。
~/eb-dotnetcore$
dotnet new web --name HelloElasticBeanstalk
~/eb-dotnetcore$cd HelloElasticBeanstalk
ステップ 2: アプリケーションをローカルに実行する
アプリケーションをローカルで実行するには、次のコマンドを実行します。
~/eb-dotnetcore/HelloElasticBeasntalk$ dotnet run
出力は次のテキストのようになります。
Building... info: Microsoft.Hosting.Lifetime[14] Now listening on: https://localhost:7294 info: Microsoft.Hosting.Lifetime[14] Now listening on: http://localhost:5052 info: Microsoft.Hosting.Lifetime[0] Application started. Press Ctrl+C to shut down. info: Microsoft.Hosting.Lifetime[0] Hosting environment: Development info: Microsoft.Hosting.Lifetime[0]
注記
dotnet
コマンドは、アプリケーションをローカルで実行するときに、ポートをランダムに選択します。この例では、ポートは 5052 です。アプリケーションを Elastic Beanstalk 環境にデプロイすると、アプリケーションはポート 5000 で実行されます。
ウェブブラウザに URL アドレス http://localhost:
を入力します。この特定の例では、コマンドは port
http://localhost:5052
です。ウェブブラウザに「Hello World!」と表示されます。
ステップ 3: EB CLI を使用して .NET Core on Linux アプリケーションをデプロイする
次のコマンドを実行して、このアプリケーションの Elastic Beanstalk 環境を作成します。
環境を作成し、.NET Core on Linux アプリケーションをデプロイするには
アプリケーションをコンパイルしてフォルダに公開し、作成しようとしている Elastic Beanstalk 環境にデプロイします。
~$
cd eb-dotnetcore/HelloElasticBeanstalk
~/eb-dotnetcore/HelloElasticBeanstalk$dotnet publish -o site
-
アプリケーションを公開したばかりのサイトディレクトリに移動します。
~/eb-dotnetcore/HelloElasticBeanstalk$
cd site
-
eb init コマンドを使用して EB CLI リポジトリを初期化します。
コマンドで指定するプラットフォームブランチバージョンについては、次の詳細に注意してください。
次のコマンドの
を、プラットフォームブランチ .NET 6 on AL2023 の最新バージョンに置き換えます。x.y.z
最新のプラットフォームブランチバージョンを特定するには、「AWS Elastic Beanstalk プラットフォーム」ガイドの「.NET Core on Linux でサポートされているプラットフォーム」を参照してください。
バージョン番号を含むソリューションスタック名の例は
64bit-amazon-linux-2023-v3.1.1-running-.net-6
です。この例では、ブランチバージョンは 3.1.1 です。
~eb-dotnetcore/HelloElasticBeanstalk/site$
eb init -p 64bit-amazon-linux-2023-v
Application dotnetcore-tutorial has been created.x.y.z
-running-.net-6 dotnetcore-tutorial --region us-east-2このコマンドは、
dotnetcore-tutorial
という名前のアプリケーションを作成し、ローカルリポジトリを設定して、コマンドで指定された .NET Core on Linux プラットフォームバージョンで環境を作成します。 -
(オプション) eb init を再度実行してデフォルトのキーペアを設定し、アプリケーションを実行している EC2 インスタンスに SSH を使用して connect できるようにします。
~eb-dotnetcore/HelloElasticBeanstalk/site$
eb init
Do you want to set up SSH for your instances? (y/n):y
Select a keypair. 1) my-keypair 2) [ Create new KeyPair ]1 つのキーペアがすでにある場合はそれを選択するか、またはプロンプトに従ってキーペアを作成します。プロンプトが表示されないか設定を後で変更する必要がない場合は、eb init -i を実行します。
-
環境を作成し、eb create を使用してそこにアプリケーションをデプロイします。Elastic Beanstalk は、アプリケーションの zip ファイルを自動的にビルドし、ポート 5000 で起動します。
次のように変更します。
~eb-dotnetcore/HelloElasticBeanstalk/site$
eb create dotnet-tutorial
Elastic Beanstalk が環境を作成するのに約 5 分かかります。
ステップ 4: Elastic Beanstalk でアプリケーションを実行する
環境を作成するプロセスが完了したら、eb open でウェブサイトを開きます。
~eb-dotnetcore/HelloElasticBeanstalk/site$ eb open
お疲れ様でした。Elastic Beanstalk を使用して .NET Core on Linux アプリケーションをデプロイしました。これにより、アプリケーション用に作成されたドメイン名を使用してブラウザ Window が開きます。
ステップ 5:クリーンアップ
アプリケーションでの作業が終了したら、環境を終了できます。Elastic Beanstalk は、環境に関連付けられているすべての AWS リソースを終了します。
EB CLI を使用して Elastic Beanstalk 環境を終了するには、次のコマンドを実行します。
~eb-dotnetcore/HelloElasticBeanstalk/site$ eb terminate
AWS アプリケーションの リソース
1 つのインスタンスアプリケーションを作成しました。1 つの EC2 インスタンスを持つ簡単なサンプルアプリケーションとして動作するため、ロードバランシングや自動スケーリングは必要ありません。単一インスタンスアプリケーションの場合、Elastic Beanstalk は次の AWS リソースを作成します。
-
EC2 インスタンス – 選択したプラットフォームでウェブアプリケーションを実行するよう設定された Amazon EC2 仮想マシン。
各プラットフォームは、それぞれ特定の言語バージョン、フレームワーク、ウェブコンテナ、またはそれらの組み合わせをサポートするための、さまざまなソフトウェア、設定ファイル、スクリプトを実行します。ほとんどのプラットフォームでは、ウェブアプリケーションの前にウェブトラフィックを処理するリバースプロキシとして Apache または nginx のいずれかを使用します。そのプロキシがリクエストをアプリケーションに転送し、静的アセットを提供して、アクセスログとエラーログを生成します。
-
インスタンスセキュリティグループ – ポート 80 上の受信トラフィックを許可するよう設定された Amazon EC2 セキュリティグループ。このリソースでは、ロードバランサーからの HTTP トラフィックが、ウェブ・アプリケーションを実行している EC2 インスタンスに達することができます。デフォルトでは、トラフィックは他のポート上で許可されません。
-
Amazon S3 バケット – Elastic Beanstalk の使用時に作成されるソースコード、ログ、その他のアーティファクトの保存場所。
-
Amazon CloudWatch アラーム – 環境内のインスタンスの負荷を監視する 2 つの CloudWatch アラーム。負荷が高すぎる、または低すぎる場合にトリガーされます。アラームがトリガーされると、Auto Scaling グループはレスポンスとしてスケールアップまたはダウンを行います。
-
AWS CloudFormation スタック – Elastic Beanstalk は AWS CloudFormation を使用して環境内のリソースを起動し、設定変更を伝達します。リソースは、AWS CloudFormation コンソール
に表示できるテンプレートで定義されます。 -
ドメイン名 – ウェブ・アプリケーションまでのルートとなるドメイン名であり、
subdomain
.region
.elasticbeanstalk.com の形式です。
Elastic Beanstalk は、これらのリソースをすべて管理します。環境を終了すると、Elastic Beanstalk は含まれているすべてのリソースを終了します。
次のステップ
アプリケーションを実行する環境を手に入れた後、アプリケーションの新しいバージョンや、異なるアプリケーションをいつでもデプロイできるようになります。新しいアプリケーションバージョンのデプロイは、プロビジョニングや EC2 インスタンスの再開が必要ないため、非常に素早く行えます。Elastic Beanstalk コンソールを使用して新しい環境を調べることもできます。詳細な手順については、このガイドの「開始方法」の章の「環境を探索する」を参照してください。
1 つか 2 つのサンプルアプリケーションをデプロイし、ローカルで .NET Core on Linux アプリケーションを開発して実行する準備が整ったら、「Elastic Beanstalk 用の .NET Core on Linux 開発環境の設定」を参照します。
Elastic Beanstalk コンソールでデプロイする
Elastic Beanstalk コンソールを使用してサンプルアプリケーションを起動することもできます。詳細な手順については、このガイドの「開始方法」の章の「サンプルアプリケーションを作成する」を参照してください。