適用於所有環境的一般選項 - AWS Elastic Beanstalk

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

適用於所有環境的一般選項

aws:autoscaling:asg

設定您環境的 Auto Scaling 群組。如需更多詳細資訊,請參閱 適用於您 Elastic Beanstalk 環境的 Auto Scaling 群組

命名空間:aws:autoscaling:asg
名稱 描述 預設 有效值

Availability Zones

可用區域 (AZs) 是 AWS 區域中的不同位置,其設計旨在與其他 中的失敗隔離AZs。它們為AZs相同區域中的其他 提供廉價、低延遲的網路連線。選擇執行個體AZs的 數目。

Any

Any

Any 1

Any 2

Any 3

Cooldown

冷卻期有助於防止 Amazon EC2 Auto Scaling 在先前活動的影響可見之前啟動其他擴展活動。冷卻時間是指一個擴展活動完成後、另一個擴展活動可開始前的時間量 (以秒為單位)。

360

010000

Custom Availability Zones

AZs 為您的執行個體定義 。

us-east-1a

us-east-1b

us-east-1c

us-east-1d

us-east-1e

eu-central-1

EnableCapacityRebalancing

指定是否為 Auto Scaling 群組中的 Spot 執行個體啟用容量重新平衡功能。如需詳細資訊,請參閱 Amazon EC2 Auto Scaling 使用者指南中的容量重新平衡

此選項只有在 EnableSpotaws:ec2:instances 命名空間中設定為 true,且 Auto Scaling 群組中至少有一個 Spot 執行個體時有用。

false

true

false

MinSize

在 Auto Scaling 群組中您想要的執行個體的最小數量。

1

110000

MaxSize

在 Auto Scaling 群組中您想要的執行個體的最大數量。

4

110000

aws:autoscaling:launchconfiguration

為您的環境設定 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體。

用於您環境的執行個體會使用 Amazon EC2啟動範本或 Auto Scaling 群組啟動組態資源建立。以下選項可與這兩種資源類型搭配使用。

如需詳細資訊,請參閱Elastic Beanstalk 環境的 Amazon EC2執行個體。您也可以在 Amazon 使用者指南 的 Amazon EBS 章節中,參考有關 Amazon Elastic Block Store (EBS) 的詳細資訊。 EC2

命名空間:aws:autoscaling:launchconfiguration
名稱 描述 預設 有效值

DisableIMDSv1

設定為 true以停用執行個體中繼資料服務第 1 版 (IMDSv1) 並強制執行 IMDSv2。

設定為 false以啟用 IMDSv1和 IMDSv2。

根據平台作業系統,您環境的執行個體預設如下:

  • Windows 伺服器 AL2和更早版本 – 同時啟用 IMDSv1和 IMDSv2(DisableIMDSv1 預設為 false

  • AL2023 – 僅啟用 IMDSv2(DisableIMDSv1 預設為 true

如需詳細資訊,請參閱設定執行個體中繼資料服務

重要

此選項設定可能會導致 Elastic Beanstalk 使用啟動範本建立環境,或將現有環境從啟動組態更新為啟動範本。如需詳細資訊,請參閱啟動範本

false – 以 Windows 伺服器、Amazon Linux 2 和更早版本為基礎的平台

true – 以 Amazon Linux 2023 為基礎的平台

true

false

EC2KeyName

您可以使用金鑰對安全地登入EC2執行個體。

注意

如果使用 Elastic Beanstalk 主控台建立環境,您無法在組態檔案中設定此選項。主控台會以建議值覆寫此選項。

IamInstanceProfile

執行個體設定檔可讓 AWS Identity and Access Management (IAM) 使用者 AWS 和服務存取臨時安全憑證來撥打電話 AWS API。指定執行個體設定檔的名稱或其 ARN。

範例:

  • aws-elasticbeanstalk-ec2-role

  • arn:aws:iam::123456789012:instance-profile/aws-elasticbeanstalk-ec2-role

注意

如果您使用 Elastic Beanstalk 主控台或 EB CLI來建立環境,則無法在組態檔案 中設定此選項。主控台和 EB 會使用建議值 CLI覆寫此選項。

執行個體設定檔名稱或 ARN。

ImageId

您可以指定自己的自訂 AMI ID,覆寫預設的 Amazon Machine Image (AMI)。

範例:ami-1f316660

InstanceType

在 Elastic Beanstalk 環境中用來執行您應用程式的執行個體類型。

重要

InstanceType 選項已淘汰。這個選項會由 aws:ec2:instances 命名空間中更新、功能更強的 InstanceTypes 選項取代。您可以使用此新選項為環境指定一個或多個執行個體類型的清單。該清單上的第一個值等於這裡所述 aws:autoscaling:launchconfiguration 命名空間中包含的 InstanceType 選項。我們建議您使用新選項來指定執行個體類型。如果已指定,則新選項會優先於舊選項。如需詳細資訊,請參閱aws:ec2:instances 命名空間

可用的執行個體類型會依使用的可用區域和區域而定。如果您選擇一個子網路,包含該子網路的可用區域會決定可用的執行個體類型。

  • Elastic Beanstalk 不支援 Amazon EC2 Mac 執行個體類型。

  • 如需 Amazon EC2執行個體系列和類型的詳細資訊,請參閱 Amazon EC2使用者指南 中的執行個體類型

  • 如需跨區域可用執行個體類型的詳細資訊,請參閱 Amazon EC2使用者指南 中的可用執行個體類型

注意

如果您使用 Elastic Beanstalk 主控台或 EB CLI來建立環境,則無法在組態檔案 中設定此選項。主控台和 EB 會使用建議值 CLI覆寫此選項。

因帳戶和區域而異。

一種EC2執行個體類型。

因帳戶、區域和可用區域而異。您可以取得由這些值篩選的 Amazon EC2執行個體類型清單。如需詳細資訊,請參閱 Amazon EC2使用者指南 中的可用執行個體類型

LaunchTemplateTagPropagationEnabled

設定為 true,即可啟用對啟動範本傳播佈建至環境的特定資源的標籤。

Elastic Beanstalk 只能將下列資源標籤傳播到啟動範本:

  • EBS 磁碟區

  • EC2 執行個體

  • EC2 網路介面

  • AWS CloudFormation 定義資源的啟動範本

此限制存在,因為 CloudFormation 僅允許針對特定資源建立範本的標籤。如需詳細資訊,請參閱 使用者指南 TagSpecification 中的 。 AWS CloudFormation

重要
  • 將現有環境的此選項值從 false 變更為 true 可能導致現有標籤發生重大變更。

  • 啟用此功能時,標籤傳播將需要EC2替換,這可能會導致停機時間。您可以啟用滾動式更新,批次套用組態變更,從而避免在更新程序期間停機。如需詳細資訊,請參閱組態變更

如需有關啟動範本的詳細資訊,請參閱以下內容:

如需有關此選項的詳細資訊,請參閱 對啟動範本的標籤傳輸

false

true

false

MonitoringInterval

您希望 Amazon CloudWatch 指標傳回的間隔 (分鐘)。

5 minute

1 minute

5 minute

SecurityGroups

列出IDs要指派給 Auto Scaling 群組中EC2執行個體的 Amazon EC2安全群組,以定義執行個體的防火牆規則。

您可以提供逗號分隔值的單一字串,其中包含現有的 Amazon EC2安全群組IDs或範本中建立 AWS::EC2::SecurityGroup 資源的參考。

elasticbeanstalk-default

SSHSourceRestriction

用於鎖定環境的SSH存取。例如,您可以鎖定對EC2執行個體的SSH存取,以便只有基礎主機可以存取私有子網路中的執行個體。

此字串的格式如下:

protocol, fromPort, toPort, source_restriction

protocol

傳入規則的通訊協定。

fromPort

起始連接埠號碼。

toPort

結束連接埠號碼。

source_restriction

無類別網域間路由 (CIDR) 範圍或流量必須路由的安全群組。使用安全群組 ID 指定安全群組。

若要從另一個帳戶指定安全群組,請在安全群組 ID 之前包含 AWS 帳戶 ID,並以正斜線分隔。另一個帳戶必須位於相同的 AWS 區域。請注意語法:aws-account-id/security-group-id。例如:123456789012/sg-99999999

範例:
  • tcp, 22, 22, 54.240.196.185/32

  • tcp, 22, 22, my-security-group-id

  • tcp, 22, 22, 123456789012/their-security-group-id

BlockDeviceMappings

在 Auto Scaling 群組中的所有執行個體上連接其他 Amazon EBS磁碟區或執行個體存放區磁碟區。

重要

此選項設定可能會導致 Elastic Beanstalk 使用啟動範本建立環境,或將現有環境從啟動組態更新為啟動範本。如需詳細資訊,請參閱啟動範本

映射執行個體存放區時,您只需將裝置名稱映射至磁碟區名稱。不過,我們建議您在映射 Amazon EBS磁碟區時,另外指定下列部分或全部欄位 (每個欄位都必須以冒號分隔):

  • 快照 ID

  • 大小,以 GB 為單位

  • 在終止時刪除 (truefalse)

  • 儲存類型 (僅適用於 gp3gp2standardst1sc1io1)

  • IOPS (僅適用於 gp3io1

  • 輸送量 (僅適用於 gp3)

下列範例會連接三個 Amazon EBS磁碟區、一個空白 100GB gp2 磁碟區和一個快照、一個空白 20GB io1 磁碟區和IOPS一個已佈建 2000 的執行個體存放區磁碟區ephemeral0。如果該執行個體類型支援的話,則可以連接多個執行個體存放區磁碟區。

/dev/sdj=:100:true:gp2,/dev/sdh=snap-51eef269,/dev/sdi=:20:true:io1:2000,/dev/sdb=ephemeral0

  • 大小 — 必須介於 500 到 16384 GiB 之間

  • 輸送量 — 必須介於每秒 125 到 1000 MiB (MiB/s) 之間

RootVolumeType

磁碟區類型 IOPS (磁性、一般用途SSD或已佈建 SSD),用於連接至環境EC2執行個體的根 Amazon EBS磁碟區。

重要

此選項設定可能會導致 Elastic Beanstalk 使用啟動範本建立環境,或將現有環境從啟動組態更新為啟動範本。如需詳細資訊,請參閱啟動範本

依平台而有所不同。

standard 用於磁帶儲存。

gp2gp3用於一般用途SSD。

io1 針對已佈建的 IOPS SSD。

RootVolumeSize

根 Amazon EBS磁碟區的儲存容量,以整個 GB 為單位。

如果您將 RootVolumeType設定為已佈建的 IOPS ,則此為必要項目SSD。

例如:"64"

每個 平台的磁性儲存和一般用途各不相同SSD。

佈建的 IOPS 沒有 SSD。

1016384 GB 用於一般用途和佈建的 IOPS SSD。

81024 GB 為磁帶用途。

RootVolumeIOPS

佈建IOPSSSD根磁碟區或一般用途gp3SSD根磁碟區所需的每秒輸入/輸出操作 (IOPS)。

IOPS 磁碟區大小的最大比率為 500 比 1。例如,具有 3000 的磁碟區IOPS必須至少為 6 GiB

100 20000適用於 io1 佈建IOPSSSD根磁碟區的 至 。

3000 16000一般用途gp3SSD根磁碟區的 。

RootVolumeThroughput

每秒 MB (MiB /s) 的所需輸送量,用於佈建連接至環境EC2執行個體的 Amazon EBS根磁碟區。

注意

此選項僅適用於 gp3 儲存類型。

1251000

aws:autoscaling:scheduledaction

為您環境的 Auto Scaling 群組設定排程動作。為每個動作的各個設定指定一個除了選項名稱、命名空間與數值的resource_name。如需範例,請參閱 aws:autoscaling:scheduledaction 命名空間

命名空間:aws:autoscaling:scheduledaction
名稱 描述 預設 有效值

StartTime

如需一次性動作,選擇執行動作的日期和時間。對於重複的動作,選擇何時要啟動該動作。

所有排程擴展動作中唯一的 ISO-8601 時間戳記

EndTime

您希望排程擴展動作停止重複的日期和時間 (在 UTC/GMT 時區)。如果您未指定 EndTime,動作會根據Recurrence表達式重複執行。

範例:2015-04-28T04:07:2Z

排程動作結束時,Amazon EC2 Auto Scaling 不會自動還原至先前的設定。設定第二個排定動作並視需要返回原始設定。

所有排程擴展動作中唯一的 ISO-8601 時間戳記

MaxSize

動作執行時套用最大執行個體計數。

010000

MinSize

動作執行時套用最小執行個體計數。

010000

DesiredCapacity

為 Auto Scaling 群組設定初始所需的容量。在套用排程動作後,觸發會依它們的設定調整所需的容量。

010000

Recurrence

您想要排定之動作發生的頻率。如果您不指定週期,則只會發生一次縮放動作,如 StartTime

Cron 表達式。

Suspend

設定以 true 暫時停用重複排定的動作。

false

true

false

aws:autoscaling:trigger

為您環境的 Auto Scaling 群組設定擴展觸發程式。

注意

此命名空間中的三個選項會決定在超過其定義的限制時,觸發的指標可以維持的時間,在此時間後才啟動觸發條件。這些選項的相關如下所示:

BreachDuration = Period * EvaluationPeriods

這些選項的預設值 (分別為 5、5 和 1) 可滿足此方程式。如果您指定不一致的數值,Elastic Beanstalk 可能會修改其中一個值,以繼續滿足方程式。

命名空間:aws:autoscaling:trigger
名稱 描述 預設 有效值

BreachDuration

所需時間 (以分鐘為單位),指標可在叫用觸發程序前超出其定義的限制 (如 UpperThresholdLowerThreshold)。

5

1600

LowerBreachScaleIncrement

執行擴展活動時要移除的 Amazon EC2執行個體數量。

-1

LowerThreshold

如果違反持續時間的測量低於此數值,則叫用觸發程序。

2000000

020000000

MeasureName

用於 Auto Scaling 觸發條件的指標。

注意

HealthyHostCountUnhealthyHostCountTargetResponseTime 僅適用於具有專用負載平衡器的環境。對於使用共用負載平衡器設定的環境,這些不是有效的指標值。如需負載平衡器類型的詳細資訊,請參閱您的 Elastic Beanstalk 環境的負載平衡器

NetworkOut

CPUUtilization

NetworkIn

NetworkOut

DiskWriteOps

DiskReadBytes

DiskReadOps

DiskWriteBytes

Latency

RequestCount

HealthyHostCount

UnhealthyHostCount

TargetResponseTime

Period

指定 Amazon CloudWatch 測量觸發條件指標的頻率。此值為兩個連續期間之間的分鐘數。

5

1600

EvaluationPeriods

用來判斷是否發生違規的連續評估期間數。

1

1600

Statistic

觸發條件應使用的統計數字,例如 Average

Average

Minimum

Maximum

Sum

Average

Unit

觸發程序測量單位,例如 Bytes

Bytes

Seconds

Percent

Bytes

Bits

Count

Bytes/Second

Bits/Second

Count/Second

None

UpperBreachScaleIncrement

指定執行擴展活動時要新增的 Amazon EC2執行個體數量。

1

UpperThreshold

如果違反持續時間的測量高於此數值,則叫用觸發程序。

6000000

020000000

aws:autoscaling:updatepolicy:rollingupdate

設定輪流更新您環境的 Auto Scaling 群組。

命名空間:aws:autoscaling:updatepolicy:rollingupdate
名稱 描述 預設 有效值

MaxBatchSize

包含在每個輪流更新批次的執行個體數量。

Auto Scaling 群組最低大小的三分之一,四捨五入到下一個最高整數。

110000

MinInstancesInService

在其他執行個體終止時,必須有最少執行個體在 Auto Scaling 群組內服務中。

Auto Scaling 群組的規模下限或小於 Auto Scaling 群組的規模上限,以較低者為準。

09999

RollingUpdateEnabled

如果 true,其會為環境啟用滾動更新。輪流更新有助您為 Elastic Beanstalk 軟體應用程式進行小型、頻繁的更新,也能避免應用程式的停機時間。

將此值設為 true 會自動啟用MaxBatchSizeMinInstancesInService、和 PauseTime 選項。設定這些選項還會自動將 RollingUpdateEnabled 選項值設為 true。設定此選項 false 以停用輪流更新。

注意

如果您使用 Elastic Beanstalk 主控台或 EB CLI來建立環境,則無法在組態檔案 中設定此選項。主控台和 EB 會使用建議值 CLI覆寫此選項。

false

true

false

RollingUpdateType

這包括三種類型:以時間為基礎的滾動更新、以運作狀態為基礎的滾動更新,以及不可變的更新。

以時間為基礎的滾動更新會在批次 PauseTime 之間套用 。以運作狀態為基礎的輪流更新,會在移動至下一個批次前等待新的執行個體通過運作狀態檢查。不可變動的更新,即可在新的 Auto Scaling 群組中啟動完整的執行個體。

注意

如果您使用 Elastic Beanstalk 主控台或 EB CLI來建立環境,則無法在組態檔案 中設定此選項。主控台和 EB 會使用建議值 CLI覆寫此選項。

Time

Time

Health

Immutable

PauseTime

Elastic Beanstalk 服務在完成一個批次執行個體的更新之後,以及繼續進行下一個批次之前等待的時間量 (數秒鐘、數分鐘或數小時)。

根據執行個體類型和容器的自動計算。

PT0S* (0 秒) 至PT1H (1 小時)

Timeout

取消更新之前,等待一個批次中所有執行個體通過運作狀態檢查的時間上限 (數分鐘或數小時)。

PT30M (30 分鐘)

PT5M* (5 分鐘) 至PT1H (1 小時)

*ISO8601 持續時間格式:PT#H#M#S其中每個 # 分別是小時、分鐘和/或秒數。

aws:ec2:instances

設定您環境的執行個體,包括 Spot 選項。此命名空間與 aws:autoscaling:launchconfigurationaws:autoscaling:asg 相輔相成。

如需詳細資訊,請參閱適用於您 Elastic Beanstalk 環境的 Auto Scaling 群組

命名空間:aws:ec2:instances
名稱 描述 預設 有效值

EnableSpot

為您的環境啟用 Spot 執行個體請求。若為 false,此命名空間中的某些選項則無法生效。

重要

此選項設定可能會導致 Elastic Beanstalk 使用啟動範本建立環境,或將現有環境從啟動組態更新為啟動範本。如需詳細資訊,請參閱啟動範本

false

true

false

InstanceTypes

您要讓環境使用的執行個體類型清單,以逗號分隔 (例如 t2.micro,t3.micro)。

Spot 執行個體未啟用 (EnableSpotfalse) 時,系統只會使用清單上的第一個執行個體類型。

此選項清單上的第一個執行個體類型等於 InstanceType 命名空間中 aws:autoscaling:launchconfiguration 選項的數值。我們不建議使用後一個選項,因為其已淘汰。如果您同時指定這兩者,則會使用 InstanceTypes 選項清單上的第一個執行個體類型,並忽略 InstanceType

可用的執行個體類型會依使用的可用區域和區域而定。如果您選擇一個子網路,包含該子網路的可用區域會決定可用的執行個體類型。

  • Elastic Beanstalk 不支援 Amazon EC2 Mac 執行個體類型。

  • 如需 Amazon EC2執行個體系列和類型的詳細資訊,請參閱 Amazon EC2使用者指南 中的執行個體類型

  • 如需跨區域可用執行個體類型的詳細資訊,請參閱 Amazon EC2使用者指南 中的可用執行個體類型

注意

有些較舊 AWS 的帳戶可能會為 Elastic Beanstalk 提供不支援 Spot 執行個體的預設執行個體類型 (例如 t1.micro)。如果您啟用 Spot 執行個體請求,並收到執行個體類型不支援 Spot 的錯誤訊息,請務必設定可支援 Spot 的執行個體類型。如要選擇 Spot 執行個體類型,請使用 Spot Instance Advisor

當您更新環境組態並從 InstanceTypes 選項中移除一或多個執行個體類型時,Elastic Beanstalk 會終止在任何已移除EC2的執行個體類型上執行的任何 Amazon 執行個體。然後,您環境的 Auto Scaling 群組會視需要啟動新執行個體,以使用目前指定的執行個體類型來完成所需的容量。

包含兩個執行個體類型的清單。

因帳戶和區域而異。

一到四十個EC2執行個體類型。建議至少使用兩種。

因帳戶、區域和可用區域而異。您可以取得由這些值篩選的 Amazon EC2執行個體類型清單。如需詳細資訊,請參閱 Amazon EC2使用者指南 中的可用執行個體類型

執行個體類型必須全部屬於相同架構 (arm64x86_64i386)。

SupportedArchitectures 也是這個命名空間的一部分。如果您針對 SupportedArchitectures 提供任何值,您為 InstanceTypes 輸入的值必須屬於您為 SupportedArchitectures 提供的任何一個架構,而且只能屬於這個架構。

SpotFleetOnDemandBase

隨著環境擴展,Auto Scaling 群組在考量 Spot 執行個體前佈建的最小隨需執行個體數量。

此選項只有在 EnableSpottrue 時有用。

0

0 命名空間中的 MaxSizeaws:autoscaling:asg 選項

SpotFleetOnDemandAboveBasePercentage

隨需執行個體百分比 (Auto Scaling 群組超出 SpotOnDemandBase 個執行個體數量所怖建的一部分額外容量)。

此選項只有在 EnableSpottrue 時有用。

0:適用於單一執行個體環境

70:適用於負載平衡的環境

0100

SpotMaxPrice

在 中,USD您願意為 Spot 執行個體付費的每小時單位價格上限。如需 Spot 執行個體最高價格選項的建議,請參閱 Amazon EC2使用者指南 中的 Spot 執行個體定價歷史記錄

此選項只有在 EnableSpottrue 時有用。

每個執行個體類型的隨需價格。在此情況下,選項的數值為 null

0.00120.0

null

SupportedArchitectures

您將用於環境的EC2執行個體架構類型逗號分隔清單。

Elastic Beanstalk 支援以下列處理器架構為基礎的執行個體類型:

  • AWS Graviton 64 位元 Arm 架構 (arm64)

  • 64 位元架構 (x86_64)

  • 32 位元架構 (i386)

如需處理器架構和 Amazon EC2執行個體類型的詳細資訊,請參閱 Amazon EC2執行個體類型

arm64

x86_64

i386

注意

大多數 Elastic Beanstalk 平台皆不支援 32 位元架構 i386。建議您改為選擇 x86_64arm64 架構類型。

aws:ec2:vpc

設定您的環境以啟動自訂 Amazon Virtual Private Cloud (Amazon ) 中的資源VPC。如果您未在此命名空間中設定 設定,Elastic Beanstalk 會在預設 中啟動 資源VPC。

命名空間:aws:ec2:vpc
名稱 描述 預設 有效值

VPCId

Amazon 的 IDVPC。

Subnets

Auto Scaling 群組子網路IDs的 。如果您有多個子網路,請將 值指定為單一逗號分隔的子網路字串 IDs(例如 "subnet-11111111,subnet-22222222")。

ELBSubnets

彈性負載平衡器IDs的子網路或子網路的 。如果您有多個子網路,請將 值指定為單一逗號分隔的子網路字串 IDs(例如 "subnet-11111111,subnet-22222222")。

ELBScheme

指定internal您是否要在 Amazon 中建立內部負載平衡器,VPC以便無法從 Amazon 外部存取 Elastic Beanstalk 應用程式VPC。如果您指定 publicinternal 以外的數值,Elastic Beanstalk 會忽略該數值。

public

public

internal

DBSubnets

包含資料庫子網路IDs的 。只有在您想要將 Amazon RDS 資料庫執行個體新增為應用程式的一部分時才會使用此功能。如果您有多個子網路,請將 值指定為單一逗號分隔的子網路字串 IDs(例如 "subnet-11111111,subnet-22222222")。

AssociatePublicIpAddress

指定是否要在您的 Amazon 中使用公有 IP 地址啟動執行個體VPC。具有公有 IP 地址的執行個體不需要NAT裝置與網際網路通訊。如果要在單一公有子網路中納入您的負載平衡器與執行個體,您必須將值設為 true

此選項不會影響單一執行個體環境,其一律具有具有彈性 IP 地址的單一 Amazon EC2執行個體。此選項與有負載平衡且可擴展的環境相關。

true

false

aws:elasticbeanstalk:應用程式

為您的應用程式設定運作狀態檢查路徑。如需詳細資訊,請參閱基礎型運作狀態報告

命名空間:aws:elasticbeanstalk:application
名稱 描述 預設 有效值

應用程式運作狀態檢查 URL

傳送運作狀態檢查請求的路徑。如果未設定此路徑,負載平衡器會嘗試在連接埠 80 上建立TCP連線,以驗證應用程式的運作狀態。設定為以 開頭的路徑/,以將HTTPGET請求傳送至該路徑。您也可以在檢查HTTPS連線或使用非預設連接埠的路徑之前包含通訊協定HTTP HTTPS(TCP、、 或 SSL) 和連接埠。

注意

如果使用 Elastic Beanstalk 主控台建立環境,您無法在組態檔案中設定此選項。主控台會以建議值覆寫此選項。

有效值包含:

/ (HTTP GET 至根路徑)

/health

HTTPS:443/

HTTPS:443/health

EB CLI和 Elastic Beanstalk 主控台會套用上述選項的建議值。若您想要使用組態檔進行相同的設定,您必須移除這些設定。如需詳細資訊,請參閱「建議值」。

aws:elasticbeanstalk:application:environment

為您的應用程式設定環境屬性。

命名空間:aws:elasticbeanstalk:application:environment
名稱 描述 預設 有效值

任何環境變數名稱。

以金鑰數值組通過。

任何環境變數值。

如需更多資訊,請參閱環境屬性與其他軟體設定

aws:elasticbeanstalk:cloudwatch:logs

為您的應用程式設定執行個體日誌串流。

命名空間:aws:elasticbeanstalk:cloudwatch:logs
名稱 描述 預設 有效值

StreamLogs

指定是否要在 CloudWatch 日誌中為代理和部署日誌建立群組,以及從環境中的每個執行個體串流日誌。

false

true

false

DeleteOnTerminate

指定是否在環境終止時刪除日誌群組。若為 false,日誌將保留 RetentionInDays 日。

false

true

false

RetentionInDays

在保留日誌事件過期之前的天數。

7

1、3、5、7、14、30、60、90、120、150、180、365、400、545、731、1827、3653

aws:elasticbeanstalk:cloudwatch:logs:health

為您的應用程式設定環境運作狀態日誌串流。

命名空間:aws:elasticbeanstalk:cloudwatch:logs:health
名稱 描述 預設 有效值

HealthStreamingEnabled

對於啟用增強型運作狀態報告的環境,指定是否要在 CloudWatch Logs 中建立群組,以用於環境運作狀態,並封存 Elastic Beanstalk 環境運作狀態資料。如需啟動增強運作狀態的相關資訊,請參閱 aws:elasticbeanstalk:healthreporting:system

false

true

false

DeleteOnTerminate

指定是否在環境終止時刪除日誌群組。若為 false,運作狀態資料會保留 RetentionInDays 天。

false

true

false

RetentionInDays

在過期前保留已封存運作資料的天數。

7

1、3、5、7、14、30、60、90、120、150、180、365、400、545、731、1827、3653

aws:elasticbeanstalk:command

設定應用程式程式碼的部署原則。如需詳細資訊,請參閱部署政策和設定

命名空間:aws:elasticbeanstalk:command
名稱 描述 預設 有效值

DeploymentPolicy

為應用程式版本部署選擇 部署原則

注意

如果使用 Elastic Beanstalk 主控台建立環境,您無法在組態檔案中設定此選項。主控台會以建議值覆寫此選項。

AllAtOnce

AllAtOnce

Rolling

RollingWithAdditionalBatch

Immutable

TrafficSplitting

Timeout

等待執行個體完成執行命令的時間 (以秒為單位)。

Elastic Beanstalk 會在內部對 Timeout 值增加 240 秒 (四分鐘)。例如,預設的有效逾時是 840 秒 (600 + 240) 或 14 分鐘。

600

13600

BatchSizeType

在 中指定的號碼類型BatchSize

注意

如果您使用 Elastic Beanstalk 主控台或 EB CLI來建立環境,則無法在組態檔案 中設定此選項。主控台和 EB 會使用建議值 CLI覆寫此選項。

Percentage

Percentage

Fixed

BatchSize

Auto Scaling 群組中要同時執行部署的 Amazon EC2執行個體百分比或固定數量。有效值會因使用的BatchSizeType設定而有所不同。

注意

如果您使用 Elastic Beanstalk 主控台或 EB CLI來建立環境,則無法在組態檔案 中設定此選項。主控台和 EB 會使用建議值 CLI覆寫此選項。

100

1100 (Percentage)。

1aws:autoscaling:asg::MaxSizeFixed

IgnoreHealthCheck

不要因為失敗的運作狀態檢查而取消部署。

false

true

false

aws:elasticbeanstalk:environment

設定您的環境架構和服務角色。

命名空間:aws:elasticbeanstalk:environment
名稱 描述 預設 有效值

EnvironmentType

設定為 SingleInstance 以啟動沒有負載平衡器的EC2執行個體。

LoadBalanced

SingleInstance

LoadBalanced

ServiceRole

Elastic Beanstalk 用來管理環境資源IAM的角色名稱。指定角色名稱 (選擇性地加上自訂路徑的字首) 或其 ARN。

範例:

  • aws-elasticbeanstalk-service-role

  • custom-path/custom-role

  • arn:aws:iam::123456789012:role/aws-elasticbeanstalk-service-role

注意

如果您使用 Elastic Beanstalk 主控台或 EB CLI來建立環境,則無法在組態檔案 中設定此選項。主控台和 EB 會使用建議值 CLI覆寫此選項。

IAM 角色名稱、路徑/名稱或 ARN

LoadBalancerType

您環境的負載平衡器類型。如需詳細資訊,請參閱您的 Elastic Beanstalk 環境的負載平衡器

classic

classic

application

network

LoadBalancerIsShared

指定環境的負載平衡器是專用還是共用。此選項僅能針對 Application Load Balancer 設定。其無法在建立環境後更改。

false 時,環境有自己的專用負載平衡器,由 Elastic Beanstalk 建立和管理。使用 true 時,環境會使用由您建立的共享負載平衡器,並在 aws:elbv2:loadbalancer 命名空間的 SharedLoadBalancer 選項中指定。

false

true

false

aws:elasticbeanstalk:environment:process:default

設定您環境的預設程序。

命名空間:aws:elasticbeanstalk:environment:process:default
名稱 描述 預設 有效值

DeregistrationDelay

取消註冊之前等待作用中請求完成的時間 (以秒為單位)。

20

03600

HealthCheckInterval

Elastic Load Balancing 檢查應用程式 Amazon EC2執行個體運作狀態的時間間隔,以秒為單位。

使用傳統或 Application Load Balancer:15

使用 Network Load Balancer:30

使用傳統或 Application Load Balancer:5300

使用 Network Load Balancer:1030

HealthCheckPath

HTTP 請求運作狀態檢查的路徑會傳送至 。

/

可路由路徑。

HealthCheckTimeout

運作狀態檢查期間等待回應的時間,以秒為單位。

此選項只適用於 Application Load Balancer 的環境。

5

160

HealthyThresholdCount

在 Elastic Load Balancing 變更執行個體運作狀態之前的連續成功請求數目。

使用傳統或 Application Load Balancer:3

使用 Network Load Balancer:5

210

MatcherHTTPCode

以逗號分隔的HTTP程式碼清單 (表示執行個體運作狀態良好)。

此選項只適用於具有 Network Load Balancer 或 Application Load Balancer 的環境。

200

使用 Application Load Balancer:200499

使用 Network Load Balancer:200399

Port

接聽處理程序的連接埠。

80

165535

Protocol

處理程序使用的通訊協定。

透過 Application Load Balancer,您僅能將此選項設為HTTPHTTPS

透過 Network Load Balancer,您僅能將此選項設為TCP

使用傳統或 Application Load Balancer:HTTP

使用 Network Load Balancer:TCP

TCP

HTTP

HTTPS

StickinessEnabled

設定為 true,以啟用黏性工作階段。

此選項只適用於 Application Load Balancer 的環境。

'false'

'false'

'true'

StickinessLBCookieDuration

黏性工作階段 Cookie 的生命週期 (以秒為單位)。

此選項只適用於 Application Load Balancer 的環境。

86400 (一天)

1604800

StickinessType

設定為 lb_cookie以為黏性工作階段使用 cookies。

此選項只適用於 Application Load Balancer 的環境。

lb_cookie

lb_cookie

UnhealthyThresholdCount

在 Elastic Load Balancing 變更執行個體運作狀態之前的連續不成功請求數目。

5

210

aws:elasticbeanstalk:environment:process:process_name

為您的環境設定額外的程序。

命名空間:aws:elasticbeanstalk:environment:process:process_name
名稱 描述 預設 有效值

DeregistrationDelay

取消註冊之前等待作用中請求完成的時間 (以秒為單位)。

20

03600

HealthCheckInterval

Elastic Load Balancing 檢查應用程式 Amazon EC2執行個體運作狀態的間隔,以秒為單位。

使用傳統或 Application Load Balancer:15

使用 Network Load Balancer:30

使用傳統或 Application Load Balancer:5300

使用 Network Load Balancer:1030

HealthCheckPath

HTTP 請求運作狀態檢查的路徑會傳送至 。

/

可路由路徑。

HealthCheckTimeout

運作狀態檢查期間等待回應的時間,以秒為單位。

此選項只適用於 Application Load Balancer 的環境。

5

160

HealthyThresholdCount

在 Elastic Load Balancing 變更執行個體運作狀態之前的連續成功請求數目。

使用傳統或 Application Load Balancer:3

使用 Network Load Balancer:5

210

MatcherHTTPCode

以逗號分隔的HTTP程式碼清單 (表示執行個體運作狀態良好)。

此選項只適用於具有 Network Load Balancer 或 Application Load Balancer 的環境。

200

使用 Application Load Balancer:200499

使用 Network Load Balancer:200399

Port

接聽處理程序的連接埠。

80

165535

Protocol

處理程序使用的通訊協定。

透過 Application Load Balancer,您僅能將此選項設為HTTPHTTPS

透過 Network Load Balancer,您僅能將此選項設為TCP

使用傳統或 Application Load Balancer:HTTP

使用 Network Load Balancer:TCP

TCP

HTTP

HTTPS

StickinessEnabled

設定為 true,以啟用黏性工作階段。

此選項只適用於 Application Load Balancer 的環境。

'false'

'false'

'true'

StickinessLBCookieDuration

黏性工作階段 Cookie 的生命週期 (以秒為單位)。

此選項只適用於 Application Load Balancer 的環境。

86400 (一天)

1604800

StickinessType

設定為 lb_cookie以為黏性工作階段使用 cookies。

此選項只適用於 Application Load Balancer 的環境。

lb_cookie

lb_cookie

UnhealthyThresholdCount

在 Elastic Load Balancing 變更執行個體運作狀態之前的連續不成功請求數目。

5

210

aws:elasticbeanstalk:environment:proxy:staticfiles

您可以使用以下命名空間,設定代理伺服器以提供靜態檔案。代理伺服器收到位於指定路徑下的檔案請求時,會直接提供檔案而非將請求路由至您的應用程式。這可減少應用程式必須處理的請求數量。

將代理伺服器提供的路徑對應至包含靜態資產之原始程式碼中的資料夾。您在此命名空間中定義的每個選項都會對應至不同路徑。

注意

此命名空間適用於以 Amazon Linux 2 和更新版本為基礎的平台分支。如果您的環境使用以 Amazon Linux 為基礎的平台版本 AMI(舊版 Amazon Linux 2),請參閱 平台特定選項 以取得平台特定的靜態檔案命名空間。

命名空間:aws:elasticbeanstalk:environment:proxy:staticfiles
名稱 Value

代理伺服器提供檔案的路徑。以 / 啟動值。

例如,指定 /images 以在 subdomain.eleasticbeanstalk.com/images 提供檔案。

內含檔案的資料夾名稱。

例如,指定 staticimages 以從原始碼套件最上層名為 staticimages 的資料夾提供檔案。

aws:elasticbeanstalk:healthreporting:system

為您的環境設定增強的執行狀況報告。

命名空間:aws:elasticbeanstalk:healthreporting:system
名稱 描述 預設 有效值

SystemType

運作狀態報告系統 (基本增強)。增強式運作狀態報告需要一個服務角色和第 2 版或更新版本的平台版本

注意

如果您使用 Elastic Beanstalk 主控台或 EB CLI來建立環境,則無法在組態檔案 中設定此選項。主控台和 EB 會使用建議值 CLI覆寫此選項。

basic

basic

enhanced

ConfigDocument 描述要發佈至 的環境和執行個體指標JSON的文件 CloudWatch。

EnhancedHealthAuthEnabled

為 API Elastic Beanstalk 用來將環境執行個體的增強型健康資訊傳遞至 Elastic Beanstalk 服務的內部 啟用授權。

如需詳細資訊,請參閱增強型運作狀態角色

注意

此選項僅適用於增強型運作狀態報告 (例如 SystemType 設為 enhanced 時)。

true

true

false

HealthCheckSuccessThreshold

為執行個體降低閾值以通過運作狀態檢查。

注意

如果使用 Elastic Beanstalk 主控台建立環境,您無法在組態檔案中設定此選項。主控台會以建議值覆寫此選項。

Ok

Ok

Warning

Degraded

Severe

aws:elasticbeanstalk:hostmanager

設定環境中的EC2執行個體,將輪換的日誌上傳至 Amazon S3。

命名空間:aws:elasticbeanstalk:hostmanager
名稱 描述 預設 有效值

LogPublicationControl

將應用程式的 Amazon EC2執行個體日誌檔案複製到與您應用程式相關聯的 Amazon S3 儲存貯體。

false

true

false

aws:elasticbeanstalk:managedactions

為您的環境設定受管平台更新。

命名空間:aws:elasticbeanstalk:managedactions
名稱 描述 預設 有效值

ManagedActionsEnabled

啟用受管平台更新

當您將此設定為 true,您還必須指定 PreferredStartTimeUpdateLevel

false

true

false

PreferredStartTime

在 中設定受管動作的維護時段UTC。

例如:"Tue:09:00"

日期和時間格式:

day:hour:minute

格式。

ServiceRoleForManagedUpdates

Elastic Beanstalk 用來執行環境受管平台更新IAM的角色名稱。

您可以使用與針對 ServiceRole 命名空間之 aws:elasticbeanstalk:environment 選項所指定相同的角色,或使用您帳戶的受管更新服務連結角色。在後者的情況中,如果帳戶還沒有受管更新服務連結角色,則 Elastic Beanstalk 會建立。

ServiceRole 相同

AWSServiceRoleForElasticBeanstalkManagedUpdates

aws:elasticbeanstalk:managedactions:platformupdate

為您的環境設定受管平台更新。

命名空間:aws:elasticbeanstalk:managedactions:platformupdate
名稱 描述 預設 有效值

UpdateLevel

使用受管平台更新套用最高層級的更新。平台已版本化 major.minor.patch。 例如,2.0.8 的主要版本為 2,次要版本為 0,修補程式版本為 8。

patch適用於修補程式版本更新。

minor 次要和修補程式版本更新。

InstanceRefreshEnabled

啟用每週執行個體替換。

這需要將 ManagedActionsEnabled 設定為 true

false

true

false

aws:elasticbeanstalk:monitoring

設定您的環境以終止運作狀態檢查失敗的EC2執行個體。

命名空間:aws:elasticbeanstalk:monitoring
名稱 描述 預設 有效值

Automatically Terminate Unhealthy Instances

如果執行個體的運作狀態檢查失敗即終止該執行個體。

注意

只有舊式環境支援此選項。它根據能否達到以及以其他執行個體為基礎的指標,來判斷執行個體的運作狀態。

Elastic Beanstalk 並未提供自動根據應用程式運作狀態來終止執行個體的功能。

true

true

false

aws:elasticbeanstalk:sns:topics

為您的環境設定通知。

命名空間:aws:elasticbeanstalk:sns:topics
名稱 描述 預設 有效值

Notification Endpoint

通知影響您應用程式的重要事件端點。

注意

如果使用 Elastic Beanstalk 主控台建立環境,您無法在組態檔案中設定此選項。主控台會以建議值覆寫此選項。

Notification Protocol

用於傳送通知給端點的通訊協定。

email

http

https

email

email-json

sqs

Notification Topic ARN

您訂閱主題的 Amazon Resource Name (ARN)。

Notification Topic Name

您訂閱的主題名稱。

aws:elasticbeanstalk:sqsd

設定工作者環境的 Amazon SQS佇列。

命名空間:aws:elasticbeanstalk:sqsd
名稱 描述 預設 有效值

WorkerQueueURL

工作者環境層中常駐程式讀取訊息的URL佇列的 。

注意

當您未指定值時,Elastic Beanstalk 自動建立的佇列是標準 Amazon SQS佇列。當您提供 值時,您可以提供標準或 Amazon FIFO SQS佇列URL的 。請注意,如果您提供FIFO佇列,則不支援定期任務

自動產生

如果您不指定數值,則 Elastic Beanstalk 會自動建立佇列。

HttpPath

訊息HTTPPOST傳送至之應用程式的相對路徑。

/

MimeType

在HTTPPOST請求中傳送的訊息MIME類型。

application/json

application/json

application/x-www-form-urlencoded

application/xml

text/plain

自訂MIME類型。

HttpConnections

Amazon EC2執行個體內任何應用程式的並行連線數量上限。

注意

如果使用 Elastic Beanstalk 主控台建立環境,您無法在組態檔案中設定此選項。主控台會以建議值覆寫此選項。

50

1100

ConnectTimeout

等待成功連線到應用程式所需的時間 (以秒為單位)。

5

160

InactivityTimeout

等待現有連線回應到應用程式所需的時間 (以秒為單位)。

訊息會重新處理,直到協助程式從工作者環境方案中的應用程式接收到 200 (OK) 回應或 RetentionPeriod 過期。

299

136000

VisibilityTimeout

Amazon SQS佇列的傳入訊息會鎖定等待處理的時間長度,以秒為單位。在設定的時間數過後,該則訊息才能在佇列中被任何其他協助程式再次讀取。

300

043200

ErrorVisibilityTimeout

Elastic Beanstalk 在處理嘗試失敗並出現明確錯誤之後,傳回訊息至 Amazon SQS佇列之前經過的時間,以秒為單位。

2

043200

RetentionPeriod

訊息有效並主動處理所需的時間 (以秒為單位)。

345600

601209600

MaxRetries

Elastic Beanstalk 嘗試傳送訊息到 Web 應用程式的次數上限,將在該訊息移動到無效字母佇列之前處裡。

10

1100

aws:elasticbeanstalk:trafficsplitting

設定您環境的流量分割部署。

當您將 aws:elasticbeanstalk:command 命名空間的 DeploymentPolicy 選項設為 TrafficSplitting 時,便會套用此命名空間。如需部署原則的詳細資訊,請參閱 部署政策和設定

命名空間:aws:elasticbeanstalk:trafficsplitting
名稱 描述 預設 有效值

NewVersionPercent

Elastic Beanstalk 移動到執行您正在部署新應用程式版本環境用戶端的傳入用戶端流量初始百分比。

10

1100

EvaluationTime

時間間隔 (分鐘),Elastic Beanstalk 會在初始運作狀態良好的部署之後等待這段時間,再繼續將所有傳入用戶端流量移動到您正在部署的新應用程式版本。

5

3600

aws:elasticbeanstalk:xray

執行 AWS X-Ray 常駐程式,從 X-Ray 整合應用程式轉送追蹤資訊。

命名空間:aws:elasticbeanstalk:xray
名稱 描述 預設 有效值

XRayEnabled

設定為 true 以在您環境的執行個體執行 X-Ray 協助程式。

false

true

false

aws:elb:healthcheck

為 Classic Load Balancer 設定運作狀態檢查。

命名空間:aws:elb:healthcheck
名稱 描述 預設 有效值

HealthyThreshold

在 Elastic Load Balancing 變更執行個體運作狀態之前的連續成功請求數目。

3

210

Interval

Elastic Load Balancing 檢查應用程式 Amazon EC2執行個體運作狀態的間隔。

10

5300

Timeout

Elastic Load Balancing 在將執行個體視為沒有回應之前等待回應的時間 (以秒為單位)。

5

260

UnhealthyThreshold

在 Elastic Load Balancing 變更執行個體運作狀態之前的連續不成功請求數目。

5

210

(已棄用) Target

運作狀態檢查傳送至後端執行個體的目的地。使用 Application Healthcheck URLaws:elasticbeanstalk:application 命名空間。

TCP:80

格式的目標 PROTOCOL:PORT/PATH

aws:elb:loadbalancer

設定您環境的 Classic Load Balancer。

在這個命名空間的數個選項已不再受到支援,以便使用 aws:elb:listener 命名空間中的接聽程式特定選項。若使用這些不再支援的選項,您只能在標準連接埠上設定兩個接聽程式 (一個安全,一個不安全)。

命名空間:aws:elb:loadbalancer
名稱 描述 預設 有效值

CrossZone

在所有可用區域的所有執行個體平均設定負載平衡器至路由流量,而不是只在每個區域內設定。

注意

如果您使用 Elastic Beanstalk 主控台或 EB CLI來建立環境,則無法在組態檔案 中設定此選項。主控台和 EB 會使用建議值 CLI覆寫此選項。

false

true

false

SecurityGroups

指派一或多個安全群組,讓您建立負載平衡器。

一或多個安全群組 IDs。

ManagedSecurityGroup

為您環境的負載平衡器指派現有的安全群組,而不用建立新的。若要使用此設定,請更新此命名空間中的 SecurityGroups 設定以包含安全群組的 ID,並移除自動建立之安全群組的 ID (如果已建立)。

若要允許負載平衡器到環境EC2執行個體的流量,Elastic Beanstalk 會將規則新增至執行個體的安全群組,以允許來自受管安全群組的傳入流量。

一個安全群組 ID。

(已棄用) LoadBalancerHTTPPort

不安全接聽程式的接聽連接埠。

80

OFF

80

(已棄用) LoadBalancerPortProtocol

用於不安全接聽程式的通訊協定。

HTTP

HTTP

TCP

(已棄用) LoadBalancerHTTPSPort

安全接聽程式的接聽連接埠。

OFF

OFF

443

8443

(已棄用) LoadBalancerSSLPortProtocol

用於安全接聽程式的通訊協定。

HTTPS

HTTPS

SSL

(已棄用) SSLCertificateId

要繫結至安全接聽程式之SSL憑證的 Amazon Resource Name (ARN)。

aws:elb:listener

在 Classic Load Balancer 上設定預設接聽程式 (連接埠 80)。

命名空間:aws:elb:listener
名稱 描述 預設 有效值
ListenerProtocol 接聽程式使用的通訊協定。 HTTP HTTP TCP
InstancePort 此接聽程式用來與EC2執行個體通訊的連接埠。 80 165535
InstanceProtocol

此接聽程式用來與EC2執行個體通訊的通訊協定。

需與 ListenerProtocol 有相同的網際網路通訊協定。也必須與任何其他接聽程式有相同的安全性等級,使用 InstancePort 作為此接聽程式。

例如,如果 ListenerProtocolHTTPS (應用程式層級,使用安全連線),您可以將 InstanceProtocol 設為 HTTP (也在應用程式層級,使用不安全的連線)。此外,若您將 InstancePort 設為 80,必須在所有 InstanceProtocol 設為 HTTP 的其他接聽程式中將 InstancePort 設為 80

HTTP,當 ListenerProtocolHTTP

TCP,當 ListenerProtocolTCP

HTTPHTTPS,當 ListenerProtocolHTTPHTTPS

TCPSSL,當 ListenerProtocolTCPSSL

PolicyNames 套用至此接聽程式連接埠,原則名稱以逗號分隔的清單。建議您改用 aws:elb:policies 命名空間 LoadBalancerPorts 的選項。
ListenerEnabled 指定這個接聽程式是否已啟用。若您指定 false,則接聽程式不會包含在負載平衡器中。 true

true

false

aws:elb:listener:listener_port

Classic Load Balancer 上設定額外的接聽程式。

命名空間:aws:elb:listener:listener_port
名稱 描述 預設 有效值

ListenerProtocol

接聽程式使用的通訊協定。 HTTP HTTP HTTPS TCP SSL

InstancePort

此接聽程式用來與EC2執行個體通訊的連接埠。 與 相同 listener_port. 165535

InstanceProtocol

此接聽程式用來與EC2執行個體通訊的通訊協定。

需與 ListenerProtocol 有相同的網際網路通訊協定。也必須與任何其他接聽程式有相同的安全性等級,使用 InstancePort 作為此接聽程式。

例如,如果 ListenerProtocolHTTPS (應用程式層級,使用安全連線),您可以將 InstanceProtocol 設為 HTTP (也在應用程式層級,使用不安全的連線)。此外,若您將 InstancePort 設為 80,必須在所有 InstanceProtocol 設為 HTTP 的其他接聽程式中將 InstancePort 設為 80

HTTP,當 ListenerProtocolHTTPHTTPS

TCP,當 ListenerProtocolTCPSSL

HTTPHTTPS,當 ListenerProtocolHTTPHTTPS

TCPSSL,當 ListenerProtocolTCPSSL

PolicyNames

套用至此接聽程式連接埠,原則名稱以逗號分隔的清單。我們建議您改用 aws:elb:policies 命名空間 LoadBalancerPorts 的選項。

SSLCertificateId

要繫結至接聽程式之SSL憑證的 Amazon Resource Name (ARN)。

ListenerEnabled

指定這個接聽程式是否已啟用。若您指定 false,則接聽程式不會包含在負載平衡器中。 若有設定任何其他選項即為 true,否則為 false true false

aws:elb:policies

為 Classic Load Balancer 修改預設黏著性和全球負載平衡器原則。

命名空間:aws:elb:policies
名稱 描述 預設 有效值

ConnectionDrainingEnabled

指定負載平衡器維持現有連結至已變為狀態不佳或取消註冊的執行個體,以完成正在進行的請求。

注意

如果您使用 Elastic Beanstalk 主控台或 EB CLI來建立環境,則無法在組態檔案 中設定此選項。主控台和 EB 會使用建議值 CLI覆寫此選項。

false

true

false

ConnectionDrainingTimeout

在強制關閉連接之前,負載平衡器在連接耗盡期間維持與執行個體的現有連接最大秒數。

注意

如果使用 Elastic Beanstalk 主控台建立環境,您無法在組態檔案中設定此選項。主控台會以建議值覆寫此選項。

20

13600

ConnectionSettingIdleTimeout

負載平衡器等待透過連線傳送或接收任何資料的時間 (以秒為單位)。如果在此段時間過後沒有資料已傳送或接收,則負載平衡器關閉連線。

60

13600

LoadBalancerPorts

預設原則 (AWSEB-ELB-StickinessPolicy) 適用的接聽程式連接埠的逗號分隔清單。

您可以使用 :all 以表示所有接聽程式連接埠

Stickiness Cookie Expiration

每個 Cookie 有效所需的時間 (秒)。使用預設原則 (AWSEB-ELB-StickinessPolicy)。

0

01000000

Stickiness Policy

將使用者會話繫結到特定的伺服器執行個體,以便會話期間來自使用者的所有請求都發送到相同的伺服器執行個體。使用預設原則 (AWSEB-ELB-StickinessPolicy)。

false

true false

aws:elb:policies:policy_name

為 Classic Load Balancer 建立額外的負載平衡器原則。

命名空間:aws:elb:policies:policy_name
名稱 描述 預設 有效值

CookieName

應用程式產生的 cookie 名稱,用於控制 AppCookieStickinessPolicyType原則的工作階段生命週期。此政策只能與 HTTP/HTTPS 接聽程式建立關聯。

InstancePorts

此原則適用的執行個體連接埠的逗號分隔清單。

連接埠清單,或 :all

LoadBalancerPorts

此原則適用的接聽程式連接埠的逗號分隔清單。

連接埠清單,或 :all

ProxyProtocol

對於ProxyProtocolPolicyType政策,指定是否包含TCP訊息原始請求的 IP 地址和連接埠。此政策只能與 TCP/SSL 接聽程式建立關聯。

true false

PublicKey

在身分驗證後端伺服器或伺服器時,PublicKeyPolicyType 政策所使用的公有金鑰內容。此政策無法直接套用至後端伺服器或接聽程式。它必須是 BackendServerAuthenticationPolicyType 政策的一部分。

PublicKeyPolicyNames

以逗號分隔清單政策名稱 (從 PublicKeyPolicyType 政策) 的 BackendServerAuthenticationPolicyType 政策,控制身分驗證到後端伺服器或伺服器。此政策只能與使用 HTTPS/ 的後端伺服器相關聯SSL。

SSLProtocols

要為政策啟用的SSL通訊協定逗號分隔清單,該SSLNegotiationPolicyType政策定義了負載平衡器接受的密碼和通訊協定。此政策只能與 HTTPS/SSL 接聽程式建立關聯。

SSLReferencePolicy

預先定義安全政策的名稱,該政策遵循 AWS 安全最佳實務,且您希望針對定義負載平衡器接受的密碼和通訊協定的政策啟用該SSLNegotiationPolicyType政策。此政策只能與 HTTPS/SSL 接聽程式建立關聯。

Stickiness Cookie Expiration

每個 Cookie 有效所需的時間 (秒)。

0

01000000

Stickiness Policy

將使用者會話繫結到特定的伺服器執行個體,以便會話期間來自使用者的所有請求都發送到相同的伺服器執行個體。

false

true false

aws:elbv2:listener:default

在 Application Load Balancer 或 Network Load Balancer 設定預設接聽程式 (連接埠 80)。

此命名空間不適用於使用共享負載平衡器的環境。共享負載平衡器沒有預設接聽程式。

命名空間:aws:elbv2:listener:default
名稱 描述 預設 有效值

DefaultProcess

當沒有相符的規則時,轉送流量至該處理程序的名稱。

default

程序名稱。

ListenerEnabled

設定為false以停用接聽程式。您可以使用此選項,停用連接埠 80 上的預設接聽程式。

true

true

false

Protocol

要處理的流量通訊協定。

使用 Application Load Balancer:HTTP

使用 Network Load Balancer:TCP

使用 Application Load Balancer:HTTPHTTPS

使用 Network Load Balancer:TCP

Rules

套用至接聽程式的規則清單

此選項只適用於 Application Load Balancer 的環境。

以逗號分隔的規則名稱清單。

SSLCertificateArns

要繫結至接聽程式之SSL憑證的 Amazon Resource Name (ARN)。

此選項只適用於 Application Load Balancer 的環境。

儲存在 IAM或 中的憑證ARN的 ACM。

SSLPolicy

指定安全原則以套用到接聽程式。

此選項只適用於 Application Load Balancer 的環境。

無 (ELB 預設)

負載平衡器安全原則名稱。

aws:elbv2:listener:listener_port

在 Application Load Balancer 或 Network Load Balancer 設定額外接聽程式。

注意

如果是共享 Application Load Balancer,您只能指定 Rule 選項。其他選項不適用於共享負載平衡器。

命名空間:aws:elbv2:listener:listener_port
名稱 描述 預設 有效值

DefaultProcess

當沒有相符的規則時流量被轉發之處理程序的名稱。

default

程序名稱。

ListenerEnabled

設定為false以停用接聽程式。您可以使用此選項,停用連接埠 80 上的預設接聽程式。

true

true

false

Protocol

要處理的流量通訊協定。

使用 Application Load Balancer:HTTP

使用 Network Load Balancer:TCP

使用 Application Load Balancer:HTTPHTTPS

使用 Network Load Balancer:TCP

Rules

套用至接聽程式的規則清單

此選項只適用於 Application Load Balancer 的環境。

如果您的環境使用共享 Application Load Balancer,而且您沒有為任何接聽程式指定此選項,則 Elastic Beanstalk 會自動將 default 規則與連線埠 80 接聽程式產生關聯。

以逗號分隔的規則名稱清單。

SSLCertificateArns

要繫結至接聽程式之SSL憑證的 Amazon Resource Name (ARN)。

此選項只適用於 Application Load Balancer 的環境。

儲存在 IAM或 中的憑證ARN的 ACM。

SSLPolicy

指定安全原則以套用到接聽程式。

此選項只適用於 Application Load Balancer 的環境。

無 (ELB 預設)

負載平衡器安全原則名稱。

aws:elbv2:listenerrule:rule_name

定義 Application Load Balancer 的接聽程式規則。如果請求符合規則中的主機名稱或路徑,負載平衡器會將請求轉發到指定的程序中。若要使用規則,將其新增到 Rules 命名空間中的 aws:elbv2:listener:listener_port 選項。

注意

這個命名空間不適用於使用 Network Load Balancer 的環境。

命名空間:aws:elbv2:listenerrule:rule_name
名稱 描述 預設 有效值

HostHeaders

要比對的主機名稱清單。例如,my.example.com

專用負載平衡器:無

共用負載平衡器:環境的 CNAME

每個名稱最多可包含 128 個字元。模式可包含大寫和小寫字母、數字、連字號 (–),以及最多三個萬用字元 (* 等同於零個或多個字元,? 等同於一個字元)。您可列出多個名稱,且以逗號分隔各個名稱。Application Load Balancer 最多支援五個合併的 HostHeaderPathPattern 規則。

如需詳細資訊,請參閱 Application Load Balancer 使用者指南中的主機條件

PathPatterns

要匹配的路徑模式 (例如 /img/*)。

此選項只適用於 Application Load Balancer 的環境。

每個模式最多可包含 128 個字元。模式可包含大寫和小寫字母、數字、連字號 (–),以及最多三個萬用字元 (* 等同於零個或多個字元,? 等同於一個字元)。您可以新增多個以逗號分隔的路徑模式。Application Load Balancer 最多支援五個合併的 HostHeaderPathPattern 規則。

如需詳細資訊,請參閱 Application Load Balancer 使用者指南中的路徑條件

Priority

多個規則相符時,此規則的優先順序。數量較低的優先。不會同時有兩個規則有相同的優先順序。

使用共享負載平衡器時,Elastic Beanstalk 將規則優先順序視為共享環境中的相對優先順序,並在建立期間將其對應至絕對優先順序。

1

11000

Process

當此規則符合要求時,要轉送流量至該處理程序的名稱。

default

程序名稱。

aws:elbv2:loadbalancer

設定一個 Application Load Balancer。

對於共享負載平衡器,只有 SharedLoadBalancerSecurityGroups 選項有效。

注意

這個命名空間不適用於使用 Network Load Balancer 的環境。

命名空間:aws:elbv2:loadbalancer
名稱 描述 預設 有效值

AccessLogsS3Bucket

存放存取日誌的 Amazon S3 儲存貯體。儲存貯體必須與環境位於同一個區域中,並允許負載平衡器寫入存取。

儲存貯體名稱。

AccessLogsS3Enabled

啟用存取日誌儲存。

false

true

false

AccessLogsS3Prefix

用於存取日誌名稱的前綴。根據預設,負載平衡器會將日誌上傳至您指定的儲存貯體 AWSLogs 中名為 的目錄。指定字首,將 AWSLogs 目錄放置在另一個目錄內。

IdleTimeout

在關閉與用戶端和執行個體的連線之前等待請求完成的時間 (以秒為單位)。

13600

ManagedSecurityGroup

為您環境的負載平衡器指派現有的安全群組,而不用建立新的。若要使用此設定,請在這個命名空間包含您的安全群組 ID 以更新SecurityGroups設定,並移除自動建立的安全群組 ID (若有的話)。

若要允許從負載平衡器到環境EC2執行個體的流量,Elastic Beanstalk 會將規則新增至執行個體的安全群組,以允許來自受管安全群組的傳入流量。

Elastic Beanstalks 為您的負載平衡器建立的安全群組。

一個安全群組 ID。

SecurityGroups

連接到負載平衡器的安全群組清單。

對於共享負載平衡器,如果您未指定此值,Elastic Beanstalk 會檢查其管理的現有安全群組是否已連接至負載平衡器。如果沒有連接到負載平衡器,Elastic Beanstalk 會建立安全群組並將其連接到負載平衡器。當共享負載平衡器的最後一個環境終止時,Elastic Beanstalk 會刪除此安全群組。

負載平衡器安全群組用於設定 Amazon EC2執行個體安全群組傳入規則。

Elastic Beanstalk 為您的負載平衡器建立的安全群組。

安全群組 的逗號分隔清單IDs。

SharedLoadBalancer

共用負載平衡器的 Amazon Resource Name (ARN)。此選項僅與 Application Load Balancer 相關。當 aws:elasticbeanstalk:environment 命名空間的 LoadBalancerIsShared 選項設為 true 時,這為必要項目。您無法在建立環境ARN後變更共用負載平衡器。

有效值的條件:

  • 它必須是環境所在 AWS 區域中有效且作用中的負載平衡器。

  • 它必須與環境位於相同的 Amazon Virtual Private Cloud (Amazon VPC) 中。

  • 它不能是 Elastic Beanstalk 作為另一個環境的專用負載平衡器所建立的負載平衡器。您可以透過前綴 awseb- 來識別這些專用負載平衡器。

範例:

arn:aws:elasticloadbalancing:us-east-2:123456789012:loadbalancer/app/FrontEndLB/0dbf78d8ad96abbc

ARN 符合此處所述所有條件的有效負載平衡器。

aws:rds:dbinstance

設定連接的 Amazon RDS 資料庫執行個體。

命名空間:aws:rds:dbinstance
名稱 描述 預設 有效值

DBAllocatedStorage

分配的資料庫儲存大小,以 GB 為單位。

我的 SQL: 5

Oracle: 10

sqlserver-se:200

sqlserver-ex:30

sqlserver-web:30

我的 SQL: 5-1024

Oracle: 10-1024

sqlserver:不能修改

DBDeletionPolicy

指定在環境終止時,是否要保留、刪除或建立資料庫執行個體的快照。

此選項適合搭配 HasCoupledDatabase 使用,也是此命名空間的一個選項。

警告

刪除資料庫執行個體會產生永久性資料遺失。

Delete

Delete

Retain

Snapshot

DBEngine

要為此執行個體使用的資料庫引擎名稱。

mysql

mysql

oracle-se1

sqlserver-ex

sqlserver-web

sqlserver-se

postgres

DBEngineVersion

資料庫引擎版本編號。

5.5

DBInstanceClass

資料庫執行個體類型。

db.t2.micro

db.m1.large適用於未在 Amazon 中執行的環境VPC)

如需詳細資訊,請參閱 Amazon Relational Database Service 使用者指南中的資料庫執行個體類別

DBPassword

要為此資料庫執行個體使用的主要使用者密碼名稱。

DBSnapshotIdentifier

恢復資料庫快照的識別碼。

DBUser

此資料庫執行個體的主要使用者名稱。

ebroot

HasCoupledDatabase

指定資料庫執行個體是否要與環境耦合。如果切換為 true,Elastic Beanstalk 會建立與您環境耦合的新資料庫執行個體。如果切換為 false,Elastic Beanstalk 會從您的環境啟動資料庫執行個體的解耦。

此選項適合搭配 DBDeletionPolicy 使用,也是此命名空間的一個選項。

注意

注意:如果您在解耦舊有資料庫後,將此值切換回 true,則 Elastic Beanstalk 會使用舊有資料庫選項設定來建立新資料庫。不過,為了維護環境的安全性,其不會保留現有的 DBUserDBPassword 設定。您需要再次指定 DBUserDBPassword

false

true

false

MultiAZDatabase

指定是否需要建立資料庫執行個體異地同步備份部署。如需使用 Amazon Relational Database Service (RDS) 進行多可用區域部署的詳細資訊,請參閱 Amazon Relational Database Service 使用者指南 中的區域和可用區域

false

true

false