適用於所有環境的一般選項 - 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 彈性運算雲端 (AmazonEC2) 執行個體。

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

如需詳細資訊,請參閱您 Elastic Beanstalk 環境的 Amazon EC2 執行個體。您還可以在 Amazon 用戶指南中的 Amazon EBS 章節中參考有關 Amazon 彈性塊商店(EBS)的更多信EC2息

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

DisableIMDSv1

設定為可停true用執行處理中繼資料服務版本 1 (IMDSv1)。

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

  • Windows 伺服器AL2及更早版本 — 同時啟用IMDSv1和 IMDSv2

  • AL2023 — 僅啟用 IMDSv2

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

設定執行個體中繼資料服務 (Windows 伺服器)。

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

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

true

false

EC2KeyName

您可以使用 key pair 安全地登入執行個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

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

ImageId

您可以透過指定自己的自訂 AMI ID 來覆寫預設的 Amazon 機器映像 (AMI)。

範例:ami-1f316660

InstanceType

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

重要

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

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

因帳戶和區域而異。

一種EC2執行個體類型。

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

LaunchTemplateTagPropagationEnabled

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

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

  • EBS磁碟區

  • EC2 執行個體

  • EC2網路介面

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

此條件約束的存在是因為 CloudFormation 只允許針對特定資源建立範本時進行標記 若要取得更多資訊,請參閱使AWS CloudFormation 用指南TagSpecification中的〈

重要
  • 將現有環境的此選項值從 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 之前加入 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 磁碟區或執行個體存放磁碟區。

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

  • 快照 ID

  • 大小,以 GB 為單位

  • 在終止時刪除 (truefalse)

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

  • IOPS(僅適用於gp3io1

  • 輸送量 (僅適用於 gp3)

下列範例會附加三個 Amazon EBS 磁碟區、一個空白的 100GB gp2 磁碟區和一個快照、一個空白的 20GB io1 磁碟區 (含 2000 個佈建IOPS),以及一個執行個體存放磁碟區。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

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

依平台而有所不同。

standard 用於磁帶儲存。

gp2或用gp3於一般目的SSD。

io1用於佈建IOPSSSD。

RootVolumeSize

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

如果您設定RootVolumeType為已佈建,則為必要IOPSSSD。

例如:"64"

因磁性儲存和一般用途的平台而有所不同SSD。

無已佈建IOPSSSD。

1016384 GB 用於一般用途並佈建IOPSSSD。

81024 GB 為磁帶用途。

RootVolumeIOPS

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

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

100到 io1 佈建20000的IOPSSSD根磁碟區。

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

RootVolumeThroughput

為連接到環境執行個體的 Amazon EBS 根磁碟區佈建所需的輸送量 (MB) 每秒 (MB)。EC2

注意

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

1251000

aws:autoscaling:scheduledaction

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

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

StartTime

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

ISO-8601 時間戳記在所有已排程的擴展動作中都是唯一的。

EndTime

您希望排程縮放動作停止重複的 future 日期和GMT時間 (在UTC/時區中)。如果未指定 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

EC2執行擴展活動時要移除多少個 Amazon 執行個體。

-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

指定EC2執行擴展活動時要新增多少 Amazon 執行個體。

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 以停用輪流更新。

false

true

false

RollingUpdateType

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

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

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,此命名空間中的某些選項則無法生效。

false

true

false

InstanceTypes

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

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

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

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

注意

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

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

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

因帳戶和區域而異。

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

因帳戶、區域和可用區域而異。您可以取得依這些值篩選的 Amazon EC2 執行個體類型清單。如需詳細資訊,請參閱 Amazon 使用者指南中的可用執行個體類型或 Amazon EC2 使用者指南中的可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 執行個體最高價格選項的建議,請參閱 Amazon EC2 使用者指南中的競價型執行個體定價歷史記錄

此選項只有在 EnableSpottrue 時有用。

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

0.00120.0

null

SupportedArchitectures

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

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

  • AWS 重力子 64 位元臂架構

  • 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 (AmazonVPC) 中啟動資源。如果您未在此命名空間中配置設置,則 Elastic Beanstalk 會以默認值啟動資源。VPC

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

VPCId

您的 Amazon 的 ID VPC。

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要求傳送至該路徑。您也可以在路徑之前加入通訊協定 (HTTPHTTPSTCP、、或SSL) 和連接埠,以檢查HTTPS連線或使用非預設連接埠。

注意

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

有效值包含:

/(HTTPGET到根路徑)

/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

指定是否要在 Proxy 和部署 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 記錄中建立群組,並封存 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

Percentage

Percentage

Fixed

BatchSize

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

100

1100 (Percentage)。

1aws: 自動縮放:ASG:: () MaxSize Fixed

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

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 版或更新版本的平台版本

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 資源名稱 (ARN)。

Notification Topic Name

您訂閱的主題名稱。

aws:elasticbeanstalk:sqsd

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

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

WorkerQueueURL

Worker 環境層中的精靈從中讀取訊息URL的佇列。

注意

當您沒有指定值時,Elastic Beanstalk 自動建立的佇列就是標準的 Amazon SQS 佇列。當您提供值時,您可以URL提供標準或 FIFOAmazon SQS 佇列。請注意,如果您提供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

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

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 資源名稱 (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

要繫結至接聽程ARN式的SSL憑證的 Amazon 資源名稱 ()。

ListenerEnabled

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

aws:elb:policies

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

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

ConnectionDrainingEnabled

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

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

要繫結至接聽程ARN式的SSL憑證的 Amazon 資源名稱 ()。

此選項只適用於 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

要繫結至接聽程ARN式的SSL憑證的 Amazon 資源名稱 ()。

此選項只適用於 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 資源名稱 (ARN)。此選項僅與 Application Load Balancer 相關。當 aws:elasticbeanstalk:environment 命名空間的 LoadBalancerIsShared 選項設為 true 時,這為必要項目。建立環境ARN後,您無法變更共用負載平衡器。

有效值的條件:

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

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

  • 它不能是 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 關聯式資料庫服務 (RDS) 進行異地同步備份部署的詳細資訊,請參閱 Amazon Relational Database Service 使用者指南中的區域和可用區域。

false

true

false