Windows Server をオートスケールして、AD参加・IISの起動・FSx for Windows File Server のアクセスを自動化させてみた

# はじめに

IIS でサービスを提供しているシステムで、Windows Server のオートスケールを行ったときに、自動的に設定を行うべきものがいくつかあります。IIS の設定・最新のアプリケーションコードの配置・FSx for Windows File Server などの SMB の参照設定、などなどです。

user data や CodeDeploy 等を活用することで実現できそうなことはわかりますが、具体的にどのように設定すればいいのかわからなかったので検証してみました。その時の構成や手順などを紹介します。



# 構成図

まず、全体的な構成図を載せます。環境によってはいくつか異なる点はあるかもですが、この記事の構成として紹介していきます。

- オートスケールで利用する AMI は、EC2 Image Builder で作成する。AMI の中には、IIS に必要なソフトウェアをインストールする
- Windows Server がオートスケールで増えたときに、user data を実行する
- user data では、CodeDeploy Agent のインストール・DNS の設定・Active Directory 参加のための Systems Manager Run Command の呼び出し、などを実行する
- Active Directory は、Microsoft AD を利用する。オンプレミスの Active Directory の場合は、AD Connector を利用すると楽に設定が可能
- CodeDeploy Agent 経由で、最新のアプリケーションの配置や、IIS の仮想ディレクトリの設定を行う
- IIS の仮想ディレクトリ経由で、FSx for Windows File Server に格納している画像ファイルを参照する
- ASP.NET のコードは、CodeCommit で管理しており、いつでも最新のコードをデプロイできるようにする

![image-20230212160650989.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/a146e463-d80c-87c3-9955-9a14eb708266.png)



# Active Directory に参加するのに、Systems Manager を活用する

EC2 に詳しい方は、もしかするとこんな疑問を持つかもしれません。

- Active Directory に参加するために、Systems Manager 使う必要ある？EC2 の設定の中に「Domain join directory」があって、これを使えば良いんじゃない？

という疑問です。

自分自身、上の疑問を思っていたのですが、結論としては Systems Manager を利用するのが良いです。理由は、Auto Scaling Group で利用する Launch Template に、「Domain join directory」に関する設定は存在しないためです。従って別の方法で Active Directory の参加を実現していくために、Systems Manager を利用します。

AWS Blog にも、Systems Manager を利用する旨が紹介されています。

https://aws.amazon.com/jp/blogs/security/how-to-configure-your-ec2-instances-to-automatically-join-a-microsoft-active-directory-domain/



それでは具体的な手順を紹介していきましょう。



# Systems Manager Document の作成

まず、Systems Manager で Active Directory に参加するための Document を作成します。

![image-20230212121817265.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/24e8b248-9d0b-5cca-5ad1-a25594e98046.png)



適当に名前を指定します

```
join-ad-domain-cloud.sugi.local
```

![image-20230202215344251.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/e0cc3b61-22ba-d419-aaa4-a31129a170ff.png)



Systems Manager には、`aws:domainJoin` プラグインが提供されており、AD 参加を簡単に定義できます。

- directoryId : Directory Service 上の ID を指定
- directoryName : Directory の名前を指定
- dnsIpAddresses : Active Directory 上の DNS IP アドレスを指定 (今回は、Microsoft AD の IP アドレス)

```json
{
  "schemaVersion": "1.2",
  "description": "Join your instances to an AWS Directory Service domain.",
  "runtimeConfig": {
    "aws:domainJoin": {
      "properties": {
        "directoryId": "d-95671f8323",
        "directoryName": "cloud.sugi.local",
        "dnsIpAddresses": [
          "10.0.1.113",
          "10.0.100.47"
        ]
      }
    }
  }
}
```



指定して、Create document を押します。

![image-20230212121847591.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/698ca2db-78e3-e6c2-6b2b-f001724bfd8a.png)



Document が作成されました。

![image-20230202215850339.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/64276921-18ad-2b86-04c5-b5d8e74effaa.png)





# Launch Template の作成

Auto Scaling Group が利用する Launch Template を作成します。

![image-20230202183125270.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/dddb1252-9ef8-db59-dea9-1b49313d8e2a.png)



名前を適当に指定します。

```
windows-autoscale
```

![image-20230211144835013.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/1601b95b-4e5d-fdfb-96fa-b2926ad03afb.png)



適当に AMI を選びます。後述の EC2 Image Builder で上書きするので、適当に Windows Server の AMI を指定します。

```
ami-0a4abb915c37aac8e
```

![image-20230202205721779.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/5b47b753-ef43-3b28-8547-9c021f57af66.png)



Instance Type や Key Pair を指定します。

![image-20230202205819096.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/89c3efb0-d8e9-420a-3597-fc25631d14da.png)



Subnet の指定はせず、Security Group を指定します。

![image-20230202221113928.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/c05e28aa-46ad-80b2-6b2b-3481f608ef24.png)



ストレージサイズの指定をします。

![image-20230202205854858.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/c4b16f66-d325-a740-bdbf-3c386a3228d9.png)



Systems Manager の実行が許可されている IAM Role を指定します。user data 経由で実行するために必要です。

![image-20230202221328551.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/f7ec5552-b190-9428-27f4-2b5f85caf531.png)





Userdata を指定します。

- Userdata の動作確認
- CodeDeploy Agent のインストール
- DNS の設定
- Active Directory 参加の Systems Manager の Document を呼びだし

```
<powershell>
$file = $env:SystemRoot + "\Temp\" + (Get-Date).ToString("MM-dd-hh-mm") + ".txt"
New-Item $file -ItemType file
whoami | Tee-Object -FilePath $file
Set-ExecutionPolicy RemoteSigned -Force
Import-Module AWSPowerShell
New-Item -Path "c:\temp" -ItemType "directory" -Force
powershell.exe -Command Read-S3Object -BucketName aws-codedeploy-ap-northeast-1 -Key latest/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi
c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txt
Set-DnsClientServerAddress -InterfaceAlias "イーサネット 3" -ServerAddress "10.0.1.113","10.0.100.47"
$SSMCmdName="join-ad-domain-cloud.sugi.local"
Set-DefaultAWSRegion -Region ap-northeast-1
Set-Variable -name instance_id -value (Invoke-Restmethod -uri http://169.254.169.254/latest/meta-data/instance-id)
New-SSMAssociation -InstanceId $instance_id -Name $SSMCmdName
</powershell>
```



指定して、Create launch template を押します。

![image-20230211145926449.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/0fb943e6-7560-b2c7-ae41-74f5cde98c8a.png)



作成されました

![image-20230211145948814.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/21374cd2-3fa6-99d3-0593-f2e8c438b5a7.png)



# EC2 Image Builder

次に、IIS などが事前にインストールされている AMI を EC2 Image Builder から作成していきます。



## Image Recipe の作成

Image Recipe を作成します。

![image-20230202123339909.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/2a097bb6-0bc5-8fc9-ab23-85f10321b6fb.png)



名前を指定します

```
windows-autoscale-image
```

![image-20230211150401789.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/6e1db219-02fd-1396-a270-e2f3d7310899.png)



利用したい Windows Server 2022 Japanese の AMI を調べます

```
ami-0a4abb915c37aac8e
```

![image-20230202123730622.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/d8c803ac-7dfc-fcdf-a707-6418aff31531.png)



見つけた AMI ID を指定します

![image-20230202123804083.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/4680d038-cff4-0c45-01d1-ba7a14cef4a8.png)



この Windows Image にインストールするものを、既存の Component から選択します

- windows-server-iis : IIS のインストール
- dotnet-hosting-bundle-windows : IIS の稼働に必要なものを指定
- aws-cli-version-2-windows : 使わないので、指定しなくてもよかった。今後のために指定しててもいいかも

![image-20230211150626934.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/6af1fa7a-336e-209c-0f3b-2fb9495894c3.png)



EBS の容量などを指定して、Create を押します

![image-20230202124338775.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/79a63bca-b261-cca1-cc8b-6f448c2b0030.png)



Image Recipe が作成されました

![image-20230211150724397.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/18bb0041-e839-62c7-4c17-d7efff611e4e.png)



## Image Pipeline の作成

実際に AMI を作成するための image pipeline を作成します。

![image-20230202124453038.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/3d4b58ee-82f3-040b-f793-0fb911de3fa7.png)



名前を指定します

```
windows-autoscale-pipeline01
```

![image-20230211150830929.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/6d225284-d8b0-2e46-be01-f8f2e0ccc9aa.png)



pipeline の実行は、Manual を指定します。Windows Update を指定しておいて、定期実行していくのも良いと思います。

![image-20230202124627634.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/e5284777-08ae-3b36-d9f6-b05c8adc1a2b.png)



利用する Recipe を指定します

![image-20230211151034657.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/c032ee02-b263-c793-5735-2d4654977dbe.png)



Next

![image-20230211151052307.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/897a4a10-ec38-a5ae-2d3e-b269db980423.png)



Build 用の環境を指定可能。デフォルトのまま

![image-20230202125328093.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/d80d2e96-71a1-ac81-b95c-0c25e9dc55ca.png)



distribution settings を行います。これを設定することで、Launch Template で利用する AMI に自動的に反映させることが出来ます。

![image-20230211151357701.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/9800392e-c38c-0acf-37e5-ea5cb7620eb3.png)



AMI の名前や、自動反映する Launch Template を指定します

![image-20230211151453307.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/a8d8b43b-27da-7330-6315-715a7e2dcc06.png)



前の手順で作成した Launch Template を指定します

![image-20230211151517029.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/abff7500-7163-cdb8-5270-1c51c4a11e07.png)



Next

![image-20230202235633155.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/1b3ee1bc-fe82-8e2e-db81-17a6709e7471.png)



Create Pipeline をおします

![image-20230202125443950.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/81af61f0-06c4-703a-735e-d9a402a2d4b3.png)



Image Pipeline が作成されました

![image-20230211151613462.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/f57b1f1b-1281-b9b8-e637-d9086a9db011.png)



## Image の Build

Image Pipeline を手動でうごかして、AMI を作成します

![image-20230211151714710.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/4791dc99-0eff-9dd5-6c32-5eb0edc2fda9.png)



Build が開始しました。

![image-20230211151805425.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/1b1f6256-b261-5ce7-65eb-affac10ae197.png)



一定時間後、Build が完了します。(20分くらいかかるかも？)

![image-20230211155542943.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/eded21e7-6236-6959-2145-6c9413758853.png)



Launch Template の実行前の状態が次の状態でしたが

![image-20230211151953803.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/d11426a2-2c81-05c1-f583-10081e6be9fa.png)



EC2 Image Builder の実行によって、自動的に Launch Template の AMI が更新されました。すごい。

![image-20230211155621229.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/f149a83a-7c45-1363-08f4-0ddc08922063.png)



# CodeCommit

ASP.NET のコードを管理するために、CodeCommit を利用します。GitHub など、他のサポートしているモノでも大丈夫です。

## CodeCommit Repository

今回の記事では、Visual Studio で AWS.NET のサンプルプログラムを作成します。Visual Studio から CodeCommit を利用するために、AWS Toolkit for Visual Studio をインストールします。

https://aws.amazon.com/jp/visualstudio/

![image-20230204200824412.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/0652b269-9d80-ad3c-945c-dc6e559731f4.png)



Visual Studio でチームエクスプローラ―を開き、CodeCommit に Connect を押します。

![image-20230204201609535.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/332e7ec9-058b-268c-9e74-38c870010ef6.png)



プロファイル名や、Access Key ID 等を指定します。

![image-20230204201738584.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/dd689dc5-af96-ce10-3fcb-0ac7284daea9.png)



CodeCommit の Create を押します。

![image-20230204202420238.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/fd3140c0-d243-569d-767a-6bd768f4806e.png)



Repository 名を指定して、OK を押します。

![image-20230211152652174.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/14467265-c145-c1b5-5e1e-2b30c6fd4bd8.png)



Git Credentials も指定します。

![image-20230204203011321.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/901a2120-747e-ecc9-d726-3e962c411b89.png)



CodeCommit 上で新たな Repository が作成され、Visual Studio にクローンされました。この Project を使って、サンプルプログラムを作成します。

![image-20230211153147406.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/d03dddf6-fa67-9754-9dbe-1d9368b74703.png)



ASP.NET Core Web アプリを指定します。

![image-20230204204341121.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/c9fd27d8-af15-54ce-1367-fbe81153f771.png)



プロジェクト名を指定して、次へを押します。

![image-20230211153257737.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/31f2e50b-5e62-eb94-0bd9-3f4b8351fb30.png)



作成を押して、サンプルアプリが読み込まれました。

![image-20230204204431703.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/e6273464-c817-bba6-9a18-c54ffacd7909.png)



## ASP.NET 6 アプリケーション

右側から、index.cshtml を開きます。

![image-20230128202238741.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/072215c3-3533-f39d-2d64-9e00cbae1786.png)



見た目を変更するために、次ように変更します。

```
@page
@model IndexModel
@{
    ViewData["Title"] = "Home page";
}

<div class="text-center">
    <h1 class="display-4">Welcome</h1>
    <p>This is ASP.NET Sample App!</p>
</div>
```



Visual Studio 上で実行してみます。

![image-20230204191611234.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/9eb9e29b-b17e-4340-1942-89eb735aff40.png)



Localhost でひらかれ、無事にサンプルアプリが動くことがわかります。

![image-20230211153525487.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/66df4af5-0f8f-4b4d-9020-1d4b06fa2fa6.png)



## Push

動くことがわかったので、CodeCommit に Push をします。

![image-20230204204829876.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/8f8ab032-8ee3-db03-07a6-d0f79f0d2a1c.png)



Push を押します。

![image-20230211153737772.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/4380c813-0ecc-91c1-a7f8-61cd04f0dc88.png)



無事に、Code Commit に Push されました。

![image-20230211153841237.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/6bef0067-d216-f172-2f51-3d91d17a8119.png)



# Auto Scaling Group の作成

Auto Scaling Group を作成します。

![image-20230204210150576.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/1943d0cb-b478-94fb-64ac-482ae4cc6ff8.png)



名前と、Launch Template を指定します。

```
windows-autoscale-group
```

![image-20230211154126590.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/c462ea82-30f5-ad80-4dc0-548ce3c40f44.png)



VPC や Subnet を指定します。

![image-20230204210434091.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/c7a6f807-1529-8665-12e6-7f3141ac5382.png)



あたらしい LoadBalancer と連携をします。

![image-20230211154413142.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/0bf01442-c33c-d598-c99b-0ff304515f0b.png)



Subnet などを指定します。

![image-20230211154502679.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/91b4f933-28f2-c945-1dd2-8e285b8af5bc.png)



Next

![image-20230204210621564.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/f7c72cdc-6c63-d127-a91f-a6cb51b71017.png)



Desired Capacity は 2 台でやってみます。

![image-20230204210651484.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/8c952d74-f17b-683e-78a4-f1fee1c3de50.png)



Auto Scaling Group 配下で作成される、EC2 インスタンスの名前の指定をします。

![image-20230211154620787.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/186dab23-e922-678c-2d52-36a8b6c8caab.png)



Create を押します。

![image-20230204210706224.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/0930aea5-339f-9e47-b430-0ffffdbd0ab4.png)



この時点で、新たに EC2 インスタンスが起動してきます。この時点で次の 2 つが動きます。

- AD の自動参加
- IIS の起動



# Deploy Pipeline

次に、CodeCommit で管理している ASP.NET のコードを利用するために、CodeBuild や CodeDeploy, CodePipeline などの設定をしていきます。



## CodeBuild

CodeBuild の設定をしていきます。構成図で示したように、CodeBuild の動作を指定するために、buildspec.yml を作成します。

![image-20230204234328461.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/31481fed-b37b-302d-1417-207591ac1a3a.png)



buildspec.yml を手動で作成します。

![image-20230211155840662.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/5c06cf00-925c-0431-3e10-0858953034fb.png)



buildspec.yml を変更して、以下の設定を行います。

- dotnet core の install
- CodeCommit から送られてきたソースコードを build (`dotnet publish`)
- build した結果を、 `/root/publishdir/**/*` で指定して CodeDeploy に送る
- `appspec.yml` や `before-install.ps1` も忘れずに指定する

```yaml
version: 0.2
phases:
  pre_build:
    commands:
      - sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
      - sudo yum install dotnet-sdk-6.0 -y

  build:
    commands:
      - cd ./dotnet-hello-app2/dotnet-hello-app2/
      - mkdir /root/publishdir/
      - dotnet publish -o /root/publishdir/

  post_build:
    commands:
      - codebuild-breakpoint

artifacts:
    files: 
      - appspec.yml
      - /root/publishdir/**/*
      - before-install.ps1
```



Git push を行います。

![image-20230204234539372.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/de9c6b61-f3b9-2161-4ff2-3a065e08528f.png)



次に、CodeBuild の Build Project を作成します。

![image-20230204230108892.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/fb71e2d2-024a-075d-52dc-fad5ef375ab3.png)



名前を指定します。

```
windows-autoscale-build
```

![image-20230211160044694.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/081dbdde-01a5-1348-5b5f-ce21c8fbf2d3.png)



Source Provider で CodeCommit を指定します。Repository も、Visual Studio と連携しているものを指定します。

![image-20230211160111082.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/005829e9-89ff-0093-c9b6-80c2ae68258e.png)



CodeBuild の実行環境として、Amazon Linux 2 を選択します。ASP.NET は、Linux 上でも Build が可能です。

![image-20230204233105467.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/df67cd34-dfa0-d558-359d-f661fe2bc149.png)



IAM Role を指定します。

![image-20230204234656557.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/e028ec0a-a10a-1005-0e22-9a2c08d90596.png)



buildspec.yml を利用する旨を指定します。

![image-20230204234745782.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/4eaa42b0-5a30-68bc-a880-951e7f1a743b.png)



Artifacts の指定をします。適当に、Artifacts 用の S3 を指定しておきます。

![image-20230211160638665.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/7db5f9dc-aa28-1b16-0f38-fc36355dbe9b.png)



Create を押します。

![image-20230211160656913.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/6c3f9893-acf2-6717-39a4-5992fc5a393c.png)



Build Project が作成されました。

![image-20230211160718597.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/7d0f93cf-afab-4b03-8ef8-305900d6e996.png)



## CodeDeploy

次に、CodeDeploy 用の設定をしていきます。CodeBuild 用の appspec.yml を作成します。

![image-20230204234328461.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/93b37a88-a36c-fa6b-877c-90f293b4fb3b.png)



appspec.yml を手動で作成します。

![image-20230211160933325.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/6302b0f2-cf3f-cc9b-4b6c-f23ad8020ba5.png)



appspec.yml を次のように指定します。

- IIS の公開ディレクトリに、ビルド済みのファイル群を配置

```
version: 0.0
os: windows
files:
  - source: .\root\publishdir\
    destination: C:\inetpub\wwwroot
hooks:
  BeforeInstall:
    - location: before-install.ps1
      timeout: 900
```



同様に、before-install.ps1 を作成します。(afetr-install.ps1 は作成しなくてよいです)

![image-20230212154704337.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/176ee1f4-965e-5e95-7c1a-a77c677dbf9b.png)



before-install.ps1 の中身を次のように指定します。

- CodeDeploy は、デフォルトで 32 bit 版の Powershell を実行する。Powershell の作りによっては、64 bit で実行が必要となる。今回の記事では、64 bit でしか動かないコードとなっており、64 bit 版を呼びだす指定をしている
  - (これが原因で 2 週間くらいハマりました・・・)
  - https://docs.aws.amazon.com/codedeploy/latest/userguide/troubleshooting-deployments.html#troubleshooting-deployments-powershell

- IIS の仮想ディレクトリ (Virtual Directory) を指定している。これは、FSx for Windows File Server で公開している画像を指定している。
- 仮想ディレクトリ (Virtual Directory) に接続するためのユーザーをハードコードしている。**本来であれば、Secret Manager など外部で保管するのが良い**

```
if ($PSHOME -like "*SysWOW64*")
{
  Write-Warning "Restarting this script under 64-bit Windows PowerShell."
  & (Join-Path ($PSHOME -replace "SysWOW64", "SysNative") powershell.exe) -File `
    (Join-Path $PSScriptRoot $MyInvocation.MyCommand) @args

  Exit $LastExitCode
}

Import-Module WebAdministration
New-WebVirtualDirectory -Site "Default Web Site" -Name assets -PhysicalPath "\\amznfsx15yznriq.cloud.sugi.local\share\wwwroot\assets"
Set-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST' -filter "system.applicationHost/sites/site[@name='Default Web Site']/application[@path='/']/virtualDirectory[@path='/assets']" -name "userName" -value "cloud.sugi.local\Admin"
Set-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST' -filter "system.applicationHost/sites/site[@name='Default Web Site']/application[@path='/']/virtualDirectory[@path='/assets']" -name "password" -value "secret your password"
Set-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST' -filter "system.applicationHost/sites/site[@name='Default Web Site']/application[@path='/']/virtualDirectory[@path='/assets']" -name "logonMethod" -value "ClearText"
exit 0
```



Git Push をします。

![image-20230211161350559.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/b1ee689e-70bf-a5c3-ca0d-b6a7b71a7a91.png)



CodeDeploy の Application を指定します。

![image-20230205023632581.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/d9c85ad6-a9d7-74d7-2af6-f94980f98edb.png)



名前を指定します。

```
windows-autoscale-applicaton
```

![image-20230211161459543.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/6e26dbd8-5c83-02f5-1100-48a4f7605c52.png)



Deployment Group も作成します。

![image-20230211161529702.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/5f698127-8617-083b-054f-cddd11d9ef61.png)



名前を指定します。

```
windows-autoscale-deployment-group
```

![image-20230211162052681.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/3a82ab75-a97d-828d-4971-188a1c6e42a8.png)



デプロイ方法を Blue/Green を指定し、デプロイ対象の Auto Scaling Group を指定します。

![image-20230211162122213.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/b045f077-e60e-e9b0-78b1-9c63944f4bd1.png)





この手順では動作確認がしたいため、Blue 環境 (古い環境) をすぐ削除する設定をします。実際の本番環境ではロールバックが簡単に出来るように、一定時間保持する設定も可能です。

![image-20230212001308107.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/923cbde9-84c8-a5f8-af41-e2d8c918e892.png)



ロードバランサーも指定します。

![image-20230211162253093.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/a2c76d9a-16a0-e527-758b-89047814c920.png)



作成されました。

![image-20230211162337051.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/970670dc-52ab-9dc4-1088-f4ea9ee0d123.png)



## CodePipeline

CodePipeline を作成します。

![image-20230204225711060.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/9339d0fa-0851-d431-8f08-7985fe17e747.png)



IAM Role を指定します。

![image-20230211162456607.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/35e34ba3-82fe-e11c-83a3-d70184b354cc.png)



連携する CodeCommit の Repository を指定します。

![image-20230211162532319.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/838b4c4a-e5b3-89e4-9057-acab1abe11e9.png)



作成した CodeBuild を指定します 

![image-20230211162615795.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/02fd08bb-1de5-62fe-8808-bca62440229c.png)



作成した CodeBuild を指定します。

![image-20230211162700324.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/63999408-87f2-42ca-427a-72d8917b484e.png)



Create を押します。

![image-20230211162711946.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/d914285f-e225-fb6a-de01-4fce91436fcf.png)



CodePipeline が定義され、自動的に Deploy が走ります。

![image-20230211162728332.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/00318ce7-e7b2-8634-4b9d-1860aaab38a5.png)



設定が問題なければ、一定時間後に Deploy が完了します。

![image-20230212001354920.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/6c12a610-1665-baf1-2e82-b9fe1ea1a102.png)



# 確認

## Web アクセス

ALB のホスト名にアクセスすると、ALB 配下で稼働しているアプリケーションにアクセスができます。

![image-20230212160052348.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/749338ac-8340-8134-8e81-236f7481393f.png)



また、IIS の仮想ディレクトリで指定した FSx for Windows File Server 上の画像も参照できることが確認できます。

![image-20230212160153099.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/baa91e23-d805-2354-a3b4-c996efdaf09b.png)



## AD 参加

自動的に Active Directory に参加していることがわかります

![image-20230212160558808.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/f09f7b29-9934-34c2-a122-ac2db0867dbf.png)



## Windows Server の IIS 設定・FSx for Windows File Server

IIS の公開ディレクトリに、ASP.NET のプログラムが自動配置されている

![image-20230212161117918.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/7ab71860-e40e-d409-f9f3-f8acb470a37c.png)



IIS では、仮想ディレクトリが自動的に設定され、FSx for Windows File Server を参照している。

![image-20230212161027928.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/73aa6209-7f6e-fe59-1e59-7814a3ee9a70.png)



ユーザーを指定した接続が成功している

![image-20230212161239487.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/ee84c907-473c-d6c9-fce2-ae6214a9b045.png)



実際に、FSx for Windows File Server を開くと、テスト画像が格納されている。

![image-20230212161821626.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/51a73b5b-0f80-693c-b215-5450ebc0ff1e.png)



## スケール変更

Desired Capacity が 2 になっているのを、Edit で 3 に変更します

![image-20230212161606195.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/815c4653-ead4-d745-d2e1-7ff74fc7ca1d.png)



3 に変更

![image-20230212161619641.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/c332a9b9-9f43-cb1c-eb23-2fdce47c080c.png)



新たなインスタンスが立ち上がり、自動的に CodeDeploy と連携して最新のアプリが起動した

![image-20230212162754111.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/8a086fd0-370f-e67c-0f0e-b30c1b54aae7.png)



# 検証を通じてわかったこと

- Launch Template には、Directory Join のための機能が無いため、user data を使って SSM Document を実行し、Active Directory に参加する構成が選択できる

- CodeBuild は、breakpoint で一時停止が可能。これでデバッグ作業が快適に進む。

  - https://docs.aws.amazon.com/ja_jp/codebuild/latest/userguide/session-manager.html

- User data を初回実行するときは、「Administrator」アカウントで実行される。2 回目以降に起動させた場合、「nt authority\system」アカウントで実行される

- Systems Manager の RunCommands は、「nt authority\system」アカウントで実行される

- CodeDeploy の RunCommands は、「nt authority\system」アカウントで実行される

- CodeDeploy で PowerShell を実行するときには、32bt, 64bit の違いに気を付ける必要がある。デフォルトは 32 bit が呼び出されるため、場合によっては 64 bit に呼び出し直しが必要。コマンドレットを利用していると、32 bit では動作しないことが起こりえる。

  - この記事の PowerShell スクリプトは、64 bit じゃないとうごかなかった
  - https://docs.aws.amazon.com/codedeploy/latest/userguide/troubleshooting-deployments.html#troubleshooting-deployments-powershell

- 「nt authority\system」で、Invoke-Restmethod が利用できない問題がある

  - 対処方法としては、「-UseBasicParsing」の利用などが説明されている
  - https://dimitri.janczak.net/2022/03/01/invoke-webrequest-under-the-system-account/
  - また、Powershell7 の利用も検討できるかもしれない (未検証)
  - https://news.mynavi.jp/article/win10tips-492/

- CodeDeploy の実行ログは以下のディレクトリに格納されている

  - ```
    C:\ProgramData\Amazon\CodeDeploy\
    ```

- 今回の記事では触れなかったが、Windows Server で全ユーザープロファイルに対して、ドライブマウントをさせるコマンドがある。
  - `net use` コマンドでは、実行したユーザーしか反映されない
  - その代わり、`New-SmbGlobalMapping ` コマンドを利用することで、全ユーザーへマウントが可能
  - https://medium.com/@bberkayilmaz/mounting-aws-fsx-with-autoscaling-in-terraform-eee3d115d49c
  - https://hacknote.jp/archives/20787/



# 付録 : CodeBuild で Breakpoint

```
version: 0.2
phases:
  pre_build:
    commands:
      - echo Entered the pre_build phase...
      - echo "Hello World" > /tmp/hello-world
      - codebuild-breakpoint
```



実行

![image-20230204235432269.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/b39328d1-035d-51fe-95db-af81cc81a6f8.png)



Advanced

![image-20230204235451764.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/5e1933cd-a1cb-211d-30e9-67d49cb6dbf4.png)



チェック

![image-20230204235515515.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/c0828549-70a7-0212-6faa-d0ac91635926.png)



Start

![image-20230204235532427.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/ae3fce1a-f526-9b36-cbbe-03f0b17b0cd0.png)



開始され、Break point で止まる

![image-20230204235725582.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/a3b2b20c-6848-509a-0ced-335ed8e54c31.png)



普通にリモートアクセスできる。

![image-20230204235754203.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1002774/f6c20fe0-783f-c93f-c742-63d63487efbf.png)





# 参考 URL

https://github.com/d2eason/aws-codedeploy-windows-scripts