AWS Elastic Beanstalk部署.NET 8到自定义IIS路径失败：Command Hooks Failed

问题场景 #

使用AWS Elastic Beanstalk将.NET 8应用部署至Windows IIS服务器时，部署到默认IIS网站正常，但部署到自定义路径C:\App\TestMyApp的自定义网站失败，报错：

Exception during build: Command hooks failed

自定义部署配置文件aws-windows-deployment-manifest.json内容如下：

{
    "manifestVersion": 1,
    "iisConfig": {
        "appPools": [
            {
                "name": "mytestapp",
                "recycling": {
                    "regularTimeInterval": 60
                }
            }
        ]
    },
    "deployments": {
        "aspNetCoreWeb": [
            {
                "name": "app",
                "parameters": {
                    "appBundle": ".",
                    "appPool": "mytestapp",
                    "iisPath": "App/TestMyApp",
                    "iisWebSite": "mytestappweb"
                }
            }
        ]
    }
}

已尝试操作：

• 部署到默认IIS网站无问题
• 检查部署用户权限
  发现的潜在问题：服务器未自动创建自定义路径C:\App\TestMyApp

疑问解答 #

1. 为什么部署过程中服务器未创建自定义路径？ #

Elastic Beanstalk的默认部署流程不会自动生成自定义的磁盘目录结构，它仅负责配置IIS的站点、应用程序和应用池，不会主动创建物理路径。你指定的iisPath对应的磁盘目录必须提前存在，或者通过自定义脚本手动创建。

2. 部署到自定义IIS网站需要哪些额外步骤或配置？ #

(1) 提前创建物理路径

通过ebextensions脚本在部署阶段创建目录：
在项目根目录下创建.ebextensions文件夹，新增01-create-app-directory.config文件，内容如下：

container_commands:
  01_create_dir:
    command: "mkdir C:\\App\\TestMyApp -Force"

该命令会在部署前强制创建目标目录，确保路径存在。

(2) 完善自定义网站的IIS配置

当前配置仅定义了应用池，缺少自定义网站mytestappweb的基础配置，需要在iisConfig中添加webSites节点，指定物理路径、绑定信息等：

{
    "manifestVersion": 1,
    "iisConfig": {
        "appPools": [
            {
                "name": "mytestapp",
                "recycling": {
                    "regularTimeInterval": 60
                }
            }
        ],
        "webSites": [
            {
                "name": "mytestappweb",
                "physicalPath": "C:\\App\\TestMyApp",
                "bindings": [
                    {
                        "protocol": "http",
                        "port": 80,
                        "hostname": ""
                    }
                ]
            }
        ]
    },
    "deployments": {
        "aspNetCoreWeb": [
            {
                "name": "app",
                "parameters": {
                    "appBundle": ".",
                    "appPool": "mytestapp",
                    "iisPath": "App/TestMyApp",
                    "iisWebSite": "mytestappweb"
                }
            }
        ]
    }
}

(3) 验证权限

确保Elastic Beanstalk部署用户（默认是LocalSystem）拥有自定义路径的读写权限，避免部署时出现权限不足的错误。

3. 如何获取"Command Hooks Failed"的详细错误信息？ #

可以通过以下途径查看日志：

• 控制台下载完整日志：在Elastic Beanstalk控制台的目标环境中，进入「日志」→「请求日志」→「完整日志」，下载后重点查看C:\Program Files\Amazon\ElasticBeanstalk\logs下的cfn-init.log和eb-engine.log，这两个日志会记录命令钩子执行的具体错误。
• 远程实例查看本地日志：通过RDP连接到Windows实例，直接查看C:\Program Files\Amazon\ElasticBeanstalk\logs目录下的日志文件，也可检查IIS日志（默认路径C:\inetpub\logs\LogFiles）。
• 部署钩子日志：自定义钩子的执行日志存放在C:\Program Files\Amazon\ElasticBeanstalk\hooks对应阶段的目录下，可查看具体钩子的执行情况。

内容的提问来源于stack exchange，提问作者Tharindu Vishal