在教學(xué)系列的第一部分中，我們將逐步完成將 PHP (Laravel) 應(yīng)用程式部署到 Amazon ECS 的步驟。我們將首先建立一個(gè) Docker 映像，將其推送到 Amazon ECR，建立 ECS 任務(wù)定義、一個(gè) ECS 叢集、一個(gè) ECS 服務(wù)並將網(wǎng)域連接到該服務(wù)。

使用 Docker 和 ECR

建立 Dockerfile 和 nginx 配置

在 git 儲(chǔ)存庫的根目錄中，建立一個(gè)包含以下內(nèi)容的 Dockerfile：

# Use the official PHP-FPM image as the base
FROM public.ecr.aws/docker/library/php:fpm

# Define a user variable
ARG user=www-data

# Install system dependencies and PHP extensions
RUN apt-get update && apt-get install -y \
    git curl \
    libpng-dev \
    libonig-dev \
    libxml2-dev \
    zip unzip libzip-dev \
    nginx \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/* \
    && docker-php-ext-install \
        pdo_mysql \
        mbstring \
        exif \
        pcntl \
        bcmath \
        gd \
        zip

# Install Composer
COPY --from=public.ecr.aws/composer/composer:latest-bin /usr/bin/composer /usr/bin/composer

# Create a system user for running Composer and Artisan commands
RUN mkdir -p /home/$user/.composer && \
    chown -R $user:$user /home/$user

# Copy Nginx configuration and entrypoint script
COPY ./docker/default.conf /etc/nginx/sites-enabled/default
COPY ./docker/entrypoint.sh /etc/entrypoint.sh

# Make the entrypoint script executable
RUN chmod +x /etc/entrypoint.sh

# Set the working directory
WORKDIR /var/www

# Copy the application code
COPY --chown=www-data:www-data . /var/www

# Install PHP dependencies
RUN composer install

# Expose port 80
EXPOSE 80

# Define the entrypoint
ENTRYPOINT ["/etc/entrypoint.sh"]

新建一個(gè)名為 docker 的資料夾，並將以下兩個(gè)檔案放入其中。

• docker/entrypoint.sh

#!/usr/bin/env bash

# Start Nginx service
service nginx start

# Run Laravel migrations
php artisan migrate --force

# Create symbolic link for storage
php artisan storage:link

# Clear and optimize the application cache
php artisan optimize:clear
php artisan optimize

# Start PHP-FPM
php-fpm

• docker/default.conf

server {
    listen 80 default_server;
    index index.php index.html;
    server_name localhost;
    error_log  /var/log/nginx/error.log;
    access_log /var/log/nginx/access.log;
    root /var/www/public;

    location ~ \.php$ {
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;

        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param PATH_INFO $fastcgi_path_info;
        fastcgi_hide_header X-Powered-By;

        # Tells PHP we're using a reverse proxy with TLS termination
        fastcgi_param HTTPS on;
        fastcgi_param HTTP_X_FORWARDED_PROTO $scheme;
        fastcgi_param HTTP_X_FORWARDED_SSL on;
        add_header Content-Security-Policy "upgrade-insecure-requests" always;
    }

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
}

並透過執(zhí)行 chmod x docker/entrypoint.sh 使entrypoint.sh可執(zhí)行。

將映像推送到 Amazon ECR

第一步是將鏡像推送到 ECR。您需要先手動(dòng)執(zhí)行此步驟，然後才能繼續(xù)將應(yīng)用程式部署到 ECS。

建立 ECR 儲(chǔ)存庫

前往 Amazon ECR 控制臺(tái)，按一下 建立儲(chǔ)存庫，然後輸入儲(chǔ)存庫名稱來建立 ECR 儲(chǔ)存庫。對(duì)於此範(fàn)例，我們將使用 demo-app。

建立後，複製儲(chǔ)存庫的 URI。稍後您將需要此 URI。

將鏡像推送至ECR

選擇您剛剛建立的儲(chǔ)存庫，按一下查看推播指令，然後在終端機(jī)中執(zhí)行指令。命令將如下所示（確保選擇正確的區(qū)域並使用正確的帳戶 ID）：

aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin 123456789012.dkr.ecr.us-east-1.amazonaws.com
docker build -t demo-app .
docker tag demo-app:latest 123456789012.dkr.ecr.us-east-1.amazonaws.com/demo-app:latest
docker push 123456789012.dkr.ecr.us-east-1.amazonaws.com/demo-app:latest

指令成功運(yùn)作後，返回Amazon ECR 控制臺(tái)，進(jìn)入儲(chǔ)存庫，並確認(rèn)鏡像已成功推送，標(biāo)籤為latest。

使用 Amazon ECS

建立 ECS 任務(wù)定義

下一步是使用我們剛剛推送到 ECR 的 Docker 映像建立 ECS 任務(wù)定義。
首先前往 Amazon ECS 控制臺(tái)，在 任務(wù)定義 下，按 建立新任務(wù)定義。

為任務(wù)定義選擇一個(gè)唯一的名稱（我們將使用 demo-app），並確保選擇 Fargate 作為啟動(dòng)類型。暫時(shí)不要更改此部分中的任何其他內(nèi)容。

向下捲動(dòng)到 Container - 1 部分，然後輸入以下值：

• 名稱：示範(fàn)?wèi)?yīng)用程式
• 圖片：123456789012.dkr.ecr.us-east-1.amazonaws.com/demo-app:latest（替換為我們之前複製的您自己的 ECR URI）

稍後，您可能需要根據(jù)您的應(yīng)用程式調(diào)整記憶體和 CPU 設(shè)定。如果需要，您也可以在此處新增環(huán)境變數(shù)和 EFS 磁碟區(qū)。我們將在單獨(dú)的教程中介紹它。

暫時(shí)不要更改此部分的任何其他內(nèi)容。向下捲動(dòng)到底部並點(diǎn)擊建立。

建立ECS集群

我們現(xiàn)在需要建立一個(gè) ECS 叢集。叢集是我們執(zhí)行剛剛建立的任務(wù)定義中定義的服務(wù)的地方。

前往Amazon ECS 控制臺(tái)，在叢集 下，點(diǎn)選建立叢集，輸入?yún)布Q，並確保選擇AWS Fargate（無伺服器） 作為基礎(chǔ)設(shè)施：

建立叢集需要幾分鐘。叢集建立偶爾會(huì)失敗，特別是對(duì)於新帳戶；只需等待幾分鐘，然後重試，選擇不同的叢集名稱。

創(chuàng)建ECS服務(wù)

開啟剛剛建立的集群，向下捲動(dòng)至 Services 表，按一下 建立，然後輸入以下值：

• 家庭：演示應(yīng)用程式
• 修訂：1（保持原樣）
• 服務(wù)名稱：demo-app

暫時(shí)不要點(diǎn)擊建立。

新增負(fù)載平衡器

由於我們可能透過 HTTPS 為應(yīng)用程式提供服務(wù)，因此我們需要新增一個(gè)負(fù)載平衡器。您以後不能再做。

向下捲動(dòng)至網(wǎng)路部分，然後選擇要將服務(wù)部署到的 VPC。確保 VPC 具有 公用子網(wǎng)路，並附加有 Internet 閘道。如果您沒有 VPC，您可以透過點(diǎn)擊建立新 VPC 並按照精靈操作來建立 VPC。

選擇 VPC 後，請(qǐng)繼續(xù)閱讀。

向下捲動(dòng)至負(fù)載平衡部分，選擇應(yīng)用程式負(fù)載平衡器，然後選擇選項(xiàng)建立新的負(fù)載平衡器。

如果此選項(xiàng)不可用，則您可能在上一個(gè)步驟中沒有選擇 VPC。

調(diào)整以下數(shù)值：

• 負(fù)載平衡器名稱：demo-app-alb
• 健康檢查寬限期：300（我建議將其設(shè)定為 300 秒，即 5 分鐘，以便您的應(yīng)用程式啟動(dòng)並穩(wěn)定）

在 Listener 部分下，保持選取 建立新監(jiān)聽器 選項(xiàng)，但調(diào)整值以使用連接埠 443 和 HTTPS 協(xié)定。要確認(rèn)此選擇，您需要您要使用的網(wǎng)域的 ACM 憑證；有關(guān)如何取得的詳細(xì)信息，請(qǐng)參閱 AWS 文件。

在目標(biāo)組部分下，調(diào)整以下值：

• 協(xié)定：HTTP（這是預(yù)設(shè)值，請(qǐng)確保保留它，因?yàn)槲覀兊?nginx 容器正在偵聽連接埠 80）
• 註銷延遲：60（我建議將其設(shè)定為 60 秒，而不是預(yù)設(shè)的 5 分鐘，以使部署更快一點(diǎn)）
• 健康檢查路徑：/（我建議將其設(shè)定為您在應(yīng)用程式中專門建立的路由，例如/healthcheck；您現(xiàn)在可以將其保留為預(yù)設(shè)值）

點(diǎn)選建立。

檢查服務(wù)狀態(tài)

服務(wù)可能需要幾分鐘才會(huì)顯示在服務(wù) 表中。如果您沒有立即看到新服務(wù)，請(qǐng)稍等一下，然後重新整理頁面。

如果一切順利，您應(yīng)該會(huì)看到服務(wù) 表中列出的服務(wù)，其狀態(tài)為活動(dòng) 和部署和任務(wù) 顯示1/1正在運(yùn)行任務(wù)。

部署錯(cuò)誤顯示如下：

要偵錯(cuò)部署錯(cuò)誤，請(qǐng)開啟服務(wù)，然後按部署標(biāo)籤；向下捲動(dòng)至 Events 部分，然後按一下最近啟動(dòng)的任務(wù)的 ID。任務(wù)執(zhí)行的日誌部分將向您顯示有關(guān)出錯(cuò)原因的更多詳細(xì)資訊。

Laravel 通常會(huì)抱怨儲(chǔ)存資料夾結(jié)構(gòu)不完整（例如，缺少框架、快取、會(huì)話之一）。我們將在單獨(dú)的教程中了解如何將 EFS 磁碟區(qū)附加到任務(wù)定義來解決此問題。

將網(wǎng)域連接到服務(wù)

您可能想要將網(wǎng)域連接到我們剛剛部署的服務(wù)。在前面的步驟中，我們已經(jīng)建立了一個(gè)應(yīng)用程式負(fù)載平衡器，它是負(fù)責(zé)將網(wǎng)路流量路由到服務(wù)的 AWS 元件。

我們也已經(jīng)配置了 ACM 證書，用於加密最終用戶和負(fù)載平衡器之間的流量。

要完成該過程並使您的應(yīng)用程式能夠透過 HTTPS 從公共互聯(lián)網(wǎng)訪問，您需要建立一條 DNS 記錄，將您的網(wǎng)域指向負(fù)載平衡器。此過程會(huì)有所不同，具體取決於您使用的 DNS 提供者；請(qǐng)參閱他們的文件以獲取更多資訊。

首先取得應(yīng)用程式負(fù)載平衡器的 DNS 名稱。導(dǎo)覽至 AWS 控制臺(tái)中的搜尋列（macOS 上的選項(xiàng) S），輸入負(fù)載平衡器，然後選擇 負(fù)載平衡器（EC2 功能）。您將看到一個(gè)表格，其中包含我們需要將網(wǎng)域連接到的負(fù)載平衡器：

複製負(fù)載平衡器的 DNS 名稱。

如果您使用 53 號(hào)公路，請(qǐng)按照以下說明操作：

• 導(dǎo)覽至 Route 53 控制臺(tái)，按一下 託管區(qū)域，然後選擇您的網(wǎng)域。
• 點(diǎn)選建立記錄按鈕。
• 將記錄類型設(shè)定為A.
• 選取別名選項(xiàng)。
• 在將流量路由到欄位中，選擇應(yīng)用程式和經(jīng)典負(fù)載平衡器的別名，然後選擇負(fù)載平衡器的區(qū)域。
• 從選擇負(fù)載平衡器下拉清單中，選擇我們需要將網(wǎng)域連接到的負(fù)載平衡器。如果您有多個(gè)負(fù)載平衡器，請(qǐng)檢查從下拉清單中選擇的負(fù)載平衡器必須與我們先前複製的負(fù)載平衡器的 DNS 名稱相符。
• 關(guān)閉評(píng)估目標(biāo)健康狀況。
• 點(diǎn)選建立記錄。

如果您不使用 53 號(hào)公路：

請(qǐng)參閱您的 DNS 提供者的文件以了解更多資訊。您可能需要建立一條 CNAME 記錄，將負(fù)載平衡器的 DNS 名稱作為其目標(biāo)/值。

恭喜你

建立 DNS 記錄後，等待幾分鐘讓它傳播，然後嘗試透過網(wǎng)域名稱存取您的應(yīng)用程式。

恭喜！ 您現(xiàn)在已成功將 PHP (Laravel) 應(yīng)用程式部署到 AWS ECS。

本教學(xué)系列即將推出

• 將 EFS 磁碟區(qū)附加到任務(wù)定義以修正 Laravel 的儲(chǔ)存資料夾結(jié)構(gòu)問題
• 使用 AWS CodePipeline 自動(dòng)將新程式碼部署到服務(wù)
• 使用 AWS CDK 自動(dòng)化基礎(chǔ)架構(gòu)配置

以上是將 PHP (Laravel) 應(yīng)用程式部署到 Amazon ECS 部分的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！