本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
適用於所有環境的一般選項
命名空間
- aws:autoscaling:asg
- aws:autoscaling:launchconfiguration
- aws:autoscaling:scheduledaction
- aws:autoscaling:trigger
- aws:autoscaling:updatepolicy:rollingupdate
- aws:ec2:instances
- aws:ec2:vpc
- aws:elasticbeanstalk:應用程式
- aws:elasticbeanstalk:application:environment
- aws:elasticbeanstalk:cloudwatch:logs
- aws:elasticbeanstalk:cloudwatch:logs:health
- aws:elasticbeanstalk:command
- aws:elasticbeanstalk:environment
- aws:elasticbeanstalk:environment:process:default
- aws:elasticbeanstalk:environment:process:process_name
- aws:elasticbeanstalk:environment:proxy:staticfiles
- aws:elasticbeanstalk:healthreporting:system
- aws:elasticbeanstalk:hostmanager
- aws:elasticbeanstalk:managedactions
- aws:elasticbeanstalk:managedactions:platformupdate
- aws:elasticbeanstalk:monitoring
- aws:elasticbeanstalk:sns:topics
- aws:elasticbeanstalk:sqsd
- aws:elasticbeanstalk:trafficsplitting
- aws:elasticbeanstalk:xray
- aws:elb:healthcheck
- aws:elb:loadbalancer
- aws:elb:listener
- aws:elb:listener:listener_port
- aws:elb:policies
- aws:elb:policies:policy_name
- aws:elbv2:listener:default
- aws:elbv2:listener:listener_port
- aws:elbv2:listenerrule:rule_name
- aws:elbv2:loadbalancer
- aws:rds:dbinstance
aws:autoscaling:asg
設定您環境的 Auto Scaling 群組。如需更多詳細資訊,請參閱 適用於您 Elastic Beanstalk 環境的 Auto Scaling 群組。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
Availability Zones |
可用區域 (AZs) 是 AWS 區域中的不同位置,其設計旨在與其他 中的失敗隔離AZs。它們為AZs相同區域中的其他 提供廉價、低延遲的網路連線。選擇執行個體AZs的 數目。 |
|
|
Cooldown |
冷卻期有助於防止 Amazon EC2 Auto Scaling 在先前活動的影響可見之前啟動其他擴展活動。冷卻時間是指一個擴展活動完成後、另一個擴展活動可開始前的時間量 (以秒為單位)。 |
|
|
Custom Availability Zones |
AZs 為您的執行個體定義 。 |
無 |
|
EnableCapacityRebalancing |
指定是否為 Auto Scaling 群組中的 Spot 執行個體啟用容量重新平衡功能。如需詳細資訊,請參閱 Amazon EC2 Auto Scaling 使用者指南中的容量重新平衡。 此選項只有在 |
|
|
MinSize |
在 Auto Scaling 群組中您想要的執行個體的最小數量。 |
|
|
MaxSize |
在 Auto Scaling 群組中您想要的執行個體的最大數量。 |
|
|
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
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
DisableIMDSv1 |
設定為 設定為 根據平台作業系統,您環境的執行個體預設如下:
如需詳細資訊,請參閱設定執行個體中繼資料服務。 重要此選項設定可能會導致 Elastic Beanstalk 使用啟動範本建立環境,或將現有環境從啟動組態更新為啟動範本。如需詳細資訊,請參閱啟動範本。 |
|
|
EC2KeyName |
您可以使用金鑰對安全地登入EC2執行個體。 |
無 |
|
IamInstanceProfile |
執行個體設定檔可讓 AWS Identity and Access Management (IAM) 使用者 AWS 和服務存取臨時安全憑證來撥打電話 AWS API。指定執行個體設定檔的名稱或其 ARN。 範例:
|
無 |
執行個體設定檔名稱或 ARN。 |
ImageId |
您可以指定自己的自訂 AMI ID,覆寫預設的 Amazon Machine Image (AMI)。 範例: |
無 |
|
InstanceType |
在 Elastic Beanstalk 環境中用來執行您應用程式的執行個體類型。 重要 可用的執行個體類型會依使用的可用區域和區域而定。如果您選擇一個子網路,包含該子網路的可用區域會決定可用的執行個體類型。 |
因帳戶和區域而異。 |
一種EC2執行個體類型。 因帳戶、區域和可用區域而異。您可以取得由這些值篩選的 Amazon EC2執行個體類型清單。如需詳細資訊,請參閱 Amazon EC2使用者指南 中的可用執行個體類型。 |
LaunchTemplateTagPropagationEnabled |
設定為 Elastic Beanstalk 只能將下列資源標籤傳播到啟動範本:
此限制存在,因為 CloudFormation 僅允許針對特定資源建立範本的標籤。如需詳細資訊,請參閱 使用者指南 TagSpecification 中的 。 AWS CloudFormation 重要
如需有關啟動範本的詳細資訊,請參閱以下內容:
如需有關此選項的詳細資訊,請參閱 對啟動範本的標籤傳輸。 |
|
|
MonitoringInterval |
您希望 Amazon CloudWatch 指標傳回的間隔 (分鐘)。 |
|
|
SecurityGroups |
列出IDs要指派給 Auto Scaling 群組中EC2執行個體的 Amazon EC2安全群組,以定義執行個體的防火牆規則。 您可以提供逗號分隔值的單一字串,其中包含現有的 Amazon EC2安全群組IDs或範本中建立 AWS::EC2::SecurityGroup 資源的參考。 |
|
|
SSHSourceRestriction |
用於鎖定環境的SSH存取。例如,您可以鎖定對EC2執行個體的SSH存取,以便只有基礎主機可以存取私有子網路中的執行個體。 此字串的格式如下:
範例:
|
無 |
|
BlockDeviceMappings |
在 Auto Scaling 群組中的所有執行個體上連接其他 Amazon EBS磁碟區或執行個體存放區磁碟區。 重要此選項設定可能會導致 Elastic Beanstalk 使用啟動範本建立環境,或將現有環境從啟動組態更新為啟動範本。如需詳細資訊,請參閱啟動範本。 映射執行個體存放區時,您只需將裝置名稱映射至磁碟區名稱。不過,我們建議您在映射 Amazon EBS磁碟區時,另外指定下列部分或全部欄位 (每個欄位都必須以冒號分隔):
下列範例會連接三個 Amazon EBS磁碟區、一個空白 100GB gp2 磁碟區和一個快照、一個空白 20GB io1 磁碟區和IOPS一個已佈建 2000 的執行個體存放區磁碟區
|
無 |
|
RootVolumeType |
磁碟區類型 IOPS (磁性、一般用途SSD或已佈建 SSD),用於連接至環境EC2執行個體的根 Amazon EBS磁碟區。 重要此選項設定可能會導致 Elastic Beanstalk 使用啟動範本建立環境,或將現有環境從啟動組態更新為啟動範本。如需詳細資訊,請參閱啟動範本。 |
依平台而有所不同。 |
|
RootVolumeSize |
根 Amazon EBS磁碟區的儲存容量,以整個 GB 為單位。 如果您將 例如: |
每個 平台的磁性儲存和一般用途各不相同SSD。 佈建的 IOPS 沒有 SSD。 |
|
RootVolumeIOPS |
佈建IOPSSSD根磁碟區或一般用途 IOPS 磁碟區大小的最大比率為 500 比 1。例如,具有 3000 的磁碟區IOPS必須至少為 6 GiB |
無 |
|
RootVolumeThroughput |
每秒 MB (MiB /s) 的所需輸送量,用於佈建連接至環境EC2執行個體的 Amazon EBS根磁碟區。 注意此選項僅適用於 |
無 |
|
aws:autoscaling:scheduledaction
為您環境的 Auto Scaling 群組設定排程動作。為每個動作的各個設定指定一個除了選項名稱、命名空間與數值的resource_name
。如需範例,請參閱 aws:autoscaling:scheduledaction 命名空間。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
StartTime |
如需一次性動作,選擇執行動作的日期和時間。對於重複的動作,選擇何時要啟動該動作。 |
無 |
所有排程擴展動作中唯一的 ISO-8601 時間戳記 |
EndTime |
您希望排程擴展動作停止重複的日期和時間 (在 UTC/GMT 時區)。如果您未指定 EndTime,動作會根據 範例: 排程動作結束時,Amazon EC2 Auto Scaling 不會自動還原至先前的設定。設定第二個排定動作並視需要返回原始設定。 |
無 |
所有排程擴展動作中唯一的 ISO-8601 時間戳記 |
MaxSize |
動作執行時套用最大執行個體計數。 |
無 |
|
MinSize |
動作執行時套用最小執行個體計數。 |
無 |
|
DesiredCapacity |
為 Auto Scaling 群組設定初始所需的容量。在套用排程動作後,觸發會依它們的設定調整所需的容量。 |
無 |
|
Recurrence |
您想要排定之動作發生的頻率。如果您不指定週期,則只會發生一次縮放動作,如 |
無 |
Cron |
Suspend |
設定以 |
|
|
aws:autoscaling:trigger
為您環境的 Auto Scaling 群組設定擴展觸發程式。
注意
此命名空間中的三個選項會決定在超過其定義的限制時,觸發的指標可以維持的時間,在此時間後才啟動觸發條件。這些選項的相關如下所示:
BreachDuration = Period * EvaluationPeriods
這些選項的預設值 (分別為 5、5 和 1) 可滿足此方程式。如果您指定不一致的數值,Elastic Beanstalk 可能會修改其中一個值,以繼續滿足方程式。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
BreachDuration |
所需時間 (以分鐘為單位),指標可在叫用觸發程序前超出其定義的限制 (如 |
|
|
LowerBreachScaleIncrement |
執行擴展活動時要移除的 Amazon EC2執行個體數量。 |
|
|
LowerThreshold |
如果違反持續時間的測量低於此數值,則叫用觸發程序。 |
|
|
MeasureName |
用於 Auto Scaling 觸發條件的指標。 注意
|
|
|
Period |
指定 Amazon CloudWatch 測量觸發條件指標的頻率。此值為兩個連續期間之間的分鐘數。 |
|
|
EvaluationPeriods |
用來判斷是否發生違規的連續評估期間數。 |
|
|
Statistic |
觸發條件應使用的統計數字,例如 |
|
|
Unit |
觸發程序測量單位,例如 |
|
|
UpperBreachScaleIncrement |
指定執行擴展活動時要新增的 Amazon EC2執行個體數量。 |
|
|
UpperThreshold |
如果違反持續時間的測量高於此數值,則叫用觸發程序。 |
|
|
aws:autoscaling:updatepolicy:rollingupdate
設定輪流更新您環境的 Auto Scaling 群組。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
MaxBatchSize |
包含在每個輪流更新批次的執行個體數量。 |
Auto Scaling 群組最低大小的三分之一,四捨五入到下一個最高整數。 |
|
MinInstancesInService |
在其他執行個體終止時,必須有最少執行個體在 Auto Scaling 群組內服務中。 |
Auto Scaling 群組的規模下限或小於 Auto Scaling 群組的規模上限,以較低者為準。 |
|
RollingUpdateEnabled |
如果 將此值設為 true 會自動啟用 |
|
|
RollingUpdateType |
這包括三種類型:以時間為基礎的滾動更新、以運作狀態為基礎的滾動更新,以及不可變的更新。 以時間為基礎的滾動更新會在批次 PauseTime 之間套用 。以運作狀態為基礎的輪流更新,會在移動至下一個批次前等待新的執行個體通過運作狀態檢查。不可變動的更新,即可在新的 Auto Scaling 群組中啟動完整的執行個體。 |
|
|
PauseTime |
Elastic Beanstalk 服務在完成一個批次執行個體的更新之後,以及繼續進行下一個批次之前等待的時間量 (數秒鐘、數分鐘或數小時)。 |
根據執行個體類型和容器的自動計算。 |
|
Timeout |
取消更新之前,等待一個批次中所有執行個體通過運作狀態檢查的時間上限 (數分鐘或數小時)。 |
|
*ISO8601 持續時間 |
aws:ec2:instances
設定您環境的執行個體,包括 Spot 選項。此命名空間與 aws:autoscaling:launchconfiguration 及 aws:autoscaling:asg 相輔相成。
如需詳細資訊,請參閱適用於您 Elastic Beanstalk 環境的 Auto Scaling 群組。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
EnableSpot |
為您的環境啟用 Spot 執行個體請求。若為 重要此選項設定可能會導致 Elastic Beanstalk 使用啟動範本建立環境,或將現有環境從啟動組態更新為啟動範本。如需詳細資訊,請參閱啟動範本。 |
|
|
InstanceTypes |
您要讓環境使用的執行個體類型清單,以逗號分隔 (例如 Spot 執行個體未啟用 ( 此選項清單上的第一個執行個體類型等於 InstanceType 命名空間中 可用的執行個體類型會依使用的可用區域和區域而定。如果您選擇一個子網路,包含該子網路的可用區域會決定可用的執行個體類型。 注意有些較舊 AWS 的帳戶可能會為 Elastic Beanstalk 提供不支援 Spot 執行個體的預設執行個體類型 (例如 t1.micro)。如果您啟用 Spot 執行個體請求,並收到執行個體類型不支援 Spot 的錯誤訊息,請務必設定可支援 Spot 的執行個體類型。如要選擇 Spot 執行個體類型,請使用 Spot Instance Advisor 當您更新環境組態並從 |
包含兩個執行個體類型的清單。 因帳戶和區域而異。 |
一到四十個EC2執行個體類型。建議至少使用兩種。 因帳戶、區域和可用區域而異。您可以取得由這些值篩選的 Amazon EC2執行個體類型清單。如需詳細資訊,請參閱 Amazon EC2使用者指南 中的可用執行個體類型。 執行個體類型必須全部屬於相同架構 (
|
SpotFleetOnDemandBase |
隨著環境擴展,Auto Scaling 群組在考量 Spot 執行個體前佈建的最小隨需執行個體數量。 此選項只有在 |
|
0 命名空間中的 |
SpotFleetOnDemandAboveBasePercentage |
隨需執行個體百分比 (Auto Scaling 群組超出 此選項只有在 |
|
|
SpotMaxPrice |
在 中,USD您願意為 Spot 執行個體付費的每小時單位價格上限。如需 Spot 執行個體最高價格選項的建議,請參閱 Amazon EC2使用者指南 中的 Spot 執行個體定價歷史記錄。 此選項只有在 |
每個執行個體類型的隨需價格。在此情況下,選項的數值為 |
|
SupportedArchitectures |
您將用於環境的EC2執行個體架構類型逗號分隔清單。 Elastic Beanstalk 支援以下列處理器架構為基礎的執行個體類型:
如需處理器架構和 Amazon EC2執行個體類型的詳細資訊,請參閱 Amazon EC2執行個體類型。 |
無 |
注意大多數 Elastic Beanstalk 平台皆不支援 32 位元架構 |
aws:ec2:vpc
設定您的環境以啟動自訂 Amazon Virtual Private Cloud (Amazon ) 中的資源VPC。如果您未在此命名空間中設定 設定,Elastic Beanstalk 會在預設 中啟動 資源VPC。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
VPCId |
Amazon 的 IDVPC。 |
無 |
|
Subnets |
Auto Scaling 群組子網路IDs的 。如果您有多個子網路,請將 值指定為單一逗號分隔的子網路字串 IDs(例如 |
無 |
|
ELBSubnets |
彈性負載平衡器IDs的子網路或子網路的 。如果您有多個子網路,請將 值指定為單一逗號分隔的子網路字串 IDs(例如 |
無 |
|
ELBScheme |
指定 |
|
|
DBSubnets |
包含資料庫子網路IDs的 。只有在您想要將 Amazon RDS 資料庫執行個體新增為應用程式的一部分時才會使用此功能。如果您有多個子網路,請將 值指定為單一逗號分隔的子網路字串 IDs(例如 |
無 |
|
AssociatePublicIpAddress |
指定是否要在您的 Amazon 中使用公有 IP 地址啟動執行個體VPC。具有公有 IP 地址的執行個體不需要NAT裝置與網際網路通訊。如果要在單一公有子網路中納入您的負載平衡器與執行個體,您必須將值設為 此選項不會影響單一執行個體環境,其一律具有具有彈性 IP 地址的單一 Amazon EC2執行個體。此選項與有負載平衡且可擴展的環境相關。 |
無 |
|
aws:elasticbeanstalk:應用程式
為您的應用程式設定運作狀態檢查路徑。如需詳細資訊,請參閱基礎型運作狀態報告。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
應用程式運作狀態檢查 URL |
傳送運作狀態檢查請求的路徑。如果未設定此路徑,負載平衡器會嘗試在連接埠 80 上建立TCP連線,以驗證應用程式的運作狀態。設定為以 開頭的路徑 |
無 |
有效值包含:
|
EB CLI和 Elastic Beanstalk 主控台會套用上述選項的建議值。若您想要使用組態檔進行相同的設定,您必須移除這些設定。如需詳細資訊,請參閱「建議值」。
aws:elasticbeanstalk:application:environment
為您的應用程式設定環境屬性。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
任何環境變數名稱。 |
以金鑰數值組通過。 |
無 |
任何環境變數值。 |
如需更多資訊,請參閱環境屬性與其他軟體設定。
aws:elasticbeanstalk:cloudwatch:logs
為您的應用程式設定執行個體日誌串流。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
StreamLogs |
指定是否要在 CloudWatch 日誌中為代理和部署日誌建立群組,以及從環境中的每個執行個體串流日誌。 |
|
|
DeleteOnTerminate |
指定是否在環境終止時刪除日誌群組。若為 |
|
|
RetentionInDays |
在保留日誌事件過期之前的天數。 |
7 |
1、3、5、7、14、30、60、90、120、150、180、365、400、545、731、1827、3653 |
aws:elasticbeanstalk:cloudwatch:logs:health
為您的應用程式設定環境運作狀態日誌串流。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
HealthStreamingEnabled |
對於啟用增強型運作狀態報告的環境,指定是否要在 CloudWatch Logs 中建立群組,以用於環境運作狀態,並封存 Elastic Beanstalk 環境運作狀態資料。如需啟動增強運作狀態的相關資訊,請參閱 aws:elasticbeanstalk:healthreporting:system。 |
|
|
DeleteOnTerminate |
指定是否在環境終止時刪除日誌群組。若為 |
|
|
RetentionInDays |
在過期前保留已封存運作資料的天數。 |
7 |
1、3、5、7、14、30、60、90、120、150、180、365、400、545、731、1827、3653 |
aws:elasticbeanstalk:command
設定應用程式程式碼的部署原則。如需詳細資訊,請參閱部署政策和設定。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
DeploymentPolicy |
為應用程式版本部署選擇 部署原則。 |
|
|
Timeout |
等待執行個體完成執行命令的時間 (以秒為單位)。 Elastic Beanstalk 會在內部對 |
|
|
BatchSizeType |
在 中指定的號碼類型BatchSize。 |
|
|
BatchSize |
Auto Scaling 群組中要同時執行部署的 Amazon EC2執行個體百分比或固定數量。有效值會因使用的BatchSizeType設定而有所不同。 |
|
|
IgnoreHealthCheck |
不要因為失敗的運作狀態檢查而取消部署。 |
false
|
|
aws:elasticbeanstalk:environment
設定您的環境架構和服務角色。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
EnvironmentType |
設定為 |
|
|
ServiceRole |
Elastic Beanstalk 用來管理環境資源IAM的角色名稱。指定角色名稱 (選擇性地加上自訂路徑的字首) 或其 ARN。 範例:
|
無 |
IAM 角色名稱、路徑/名稱或 ARN |
LoadBalancerType |
您環境的負載平衡器類型。如需詳細資訊,請參閱您的 Elastic Beanstalk 環境的負載平衡器。 |
|
|
LoadBalancerIsShared |
指定環境的負載平衡器是專用還是共用。此選項僅能針對 Application Load Balancer 設定。其無法在建立環境後更改。
|
|
|
aws:elasticbeanstalk:environment:process:default
設定您環境的預設程序。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
DeregistrationDelay |
取消註冊之前等待作用中請求完成的時間 (以秒為單位)。 |
|
|
HealthCheckInterval |
Elastic Load Balancing 檢查應用程式 Amazon EC2執行個體運作狀態的時間間隔,以秒為單位。 |
使用傳統或 Application Load Balancer: 使用 Network Load Balancer: |
使用傳統或 Application Load Balancer: 使用 Network Load Balancer: |
HealthCheckPath |
HTTP 請求運作狀態檢查的路徑會傳送至 。 |
|
可路由路徑。 |
HealthCheckTimeout |
運作狀態檢查期間等待回應的時間,以秒為單位。 此選項只適用於 Application Load Balancer 的環境。 |
|
|
HealthyThresholdCount |
在 Elastic Load Balancing 變更執行個體運作狀態之前的連續成功請求數目。 |
使用傳統或 Application Load Balancer: 使用 Network Load Balancer: |
|
MatcherHTTPCode |
以逗號分隔的HTTP程式碼清單 (表示執行個體運作狀態良好)。 此選項只適用於具有 Network Load Balancer 或 Application Load Balancer 的環境。 |
|
使用 Application Load Balancer: 使用 Network Load Balancer: |
Port |
接聽處理程序的連接埠。 |
|
|
Protocol |
處理程序使用的通訊協定。 透過 Application Load Balancer,您僅能將此選項設為 透過 Network Load Balancer,您僅能將此選項設為 |
使用傳統或 Application Load Balancer: 使用 Network Load Balancer: |
|
StickinessEnabled |
設定為 true,以啟用黏性工作階段。 此選項只適用於 Application Load Balancer 的環境。 |
|
|
StickinessLBCookieDuration |
黏性工作階段 Cookie 的生命週期 (以秒為單位)。 此選項只適用於 Application Load Balancer 的環境。 |
|
|
StickinessType |
設定為 此選項只適用於 Application Load Balancer 的環境。 |
|
|
UnhealthyThresholdCount |
在 Elastic Load Balancing 變更執行個體運作狀態之前的連續不成功請求數目。 |
|
|
aws:elasticbeanstalk:environment:process:process_name
為您的環境設定額外的程序。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
DeregistrationDelay |
取消註冊之前等待作用中請求完成的時間 (以秒為單位)。 |
|
|
HealthCheckInterval |
Elastic Load Balancing 檢查應用程式 Amazon EC2執行個體運作狀態的間隔,以秒為單位。 |
使用傳統或 Application Load Balancer: 使用 Network Load Balancer: |
使用傳統或 Application Load Balancer: 使用 Network Load Balancer: |
HealthCheckPath |
HTTP 請求運作狀態檢查的路徑會傳送至 。 |
|
可路由路徑。 |
HealthCheckTimeout |
運作狀態檢查期間等待回應的時間,以秒為單位。 此選項只適用於 Application Load Balancer 的環境。 |
|
|
HealthyThresholdCount |
在 Elastic Load Balancing 變更執行個體運作狀態之前的連續成功請求數目。 |
使用傳統或 Application Load Balancer: 使用 Network Load Balancer: |
|
MatcherHTTPCode |
以逗號分隔的HTTP程式碼清單 (表示執行個體運作狀態良好)。 此選項只適用於具有 Network Load Balancer 或 Application Load Balancer 的環境。 |
|
使用 Application Load Balancer: 使用 Network Load Balancer: |
Port |
接聽處理程序的連接埠。 |
|
|
Protocol |
處理程序使用的通訊協定。 透過 Application Load Balancer,您僅能將此選項設為 透過 Network Load Balancer,您僅能將此選項設為 |
使用傳統或 Application Load Balancer: 使用 Network Load Balancer: |
|
StickinessEnabled |
設定為 true,以啟用黏性工作階段。 此選項只適用於 Application Load Balancer 的環境。 |
|
|
StickinessLBCookieDuration |
黏性工作階段 Cookie 的生命週期 (以秒為單位)。 此選項只適用於 Application Load Balancer 的環境。 |
|
|
StickinessType |
設定為 此選項只適用於 Application Load Balancer 的環境。 |
|
|
UnhealthyThresholdCount |
在 Elastic Load Balancing 變更執行個體運作狀態之前的連續不成功請求數目。 |
|
|
aws:elasticbeanstalk:environment:proxy:staticfiles
您可以使用以下命名空間,設定代理伺服器以提供靜態檔案。代理伺服器收到位於指定路徑下的檔案請求時,會直接提供檔案而非將請求路由至您的應用程式。這可減少應用程式必須處理的請求數量。
將代理伺服器提供的路徑對應至包含靜態資產之原始程式碼中的資料夾。您在此命名空間中定義的每個選項都會對應至不同路徑。
注意
此命名空間適用於以 Amazon Linux 2 和更新版本為基礎的平台分支。如果您的環境使用以 Amazon Linux 為基礎的平台版本 AMI(舊版 Amazon Linux 2),請參閱 平台特定選項 以取得平台特定的靜態檔案命名空間。
名稱 | Value |
---|---|
代理伺服器提供檔案的路徑。以 例如,指定 |
內含檔案的資料夾名稱。 例如,指定 |
aws:elasticbeanstalk:healthreporting:system
為您的環境設定增強的執行狀況報告。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
SystemType |
|
|
|
ConfigDocument | 描述要發佈至 的環境和執行個體指標JSON的文件 CloudWatch。 | 無 | |
EnhancedHealthAuthEnabled |
為 API Elastic Beanstalk 用來將環境執行個體的增強型健康資訊傳遞至 Elastic Beanstalk 服務的內部 啟用授權。 如需詳細資訊,請參閱增強型運作狀態角色。 注意此選項僅適用於增強型運作狀態報告 (例如 |
|
|
HealthCheckSuccessThreshold |
為執行個體降低閾值以通過運作狀態檢查。 |
|
|
aws:elasticbeanstalk:hostmanager
設定環境中的EC2執行個體,將輪換的日誌上傳至 Amazon S3。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
LogPublicationControl |
將應用程式的 Amazon EC2執行個體日誌檔案複製到與您應用程式相關聯的 Amazon S3 儲存貯體。 |
|
|
aws:elasticbeanstalk:managedactions
為您的環境設定受管平台更新。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
ManagedActionsEnabled |
啟用受管平台更新。 當您將此設定為 |
|
|
PreferredStartTime |
在 中設定受管動作的維護時段UTC。 例如: |
無 |
日期和時間格式:
格式。 |
ServiceRoleForManagedUpdates |
Elastic Beanstalk 用來執行環境受管平台更新IAM的角色名稱。 您可以使用與針對 |
無 |
與 或
|
aws:elasticbeanstalk:managedactions:platformupdate
為您的環境設定受管平台更新。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
UpdateLevel |
使用受管平台更新套用最高層級的更新。平台已版本化 |
無 |
僅
|
InstanceRefreshEnabled |
啟用每週執行個體替換。 這需要將 |
false |
|
aws:elasticbeanstalk:monitoring
設定您的環境以終止運作狀態檢查失敗的EC2執行個體。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
Automatically Terminate Unhealthy Instances |
如果執行個體的運作狀態檢查失敗即終止該執行個體。 注意只有舊式環境支援此選項。它根據能否達到以及以其他執行個體為基礎的指標,來判斷執行個體的運作狀態。 Elastic Beanstalk 並未提供自動根據應用程式運作狀態來終止執行個體的功能。 |
|
|
aws:elasticbeanstalk:sns:topics
為您的環境設定通知。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
Notification Endpoint |
通知影響您應用程式的重要事件端點。 |
無 |
|
Notification Protocol |
用於傳送通知給端點的通訊協定。 |
|
|
Notification Topic ARN |
您訂閱主題的 Amazon Resource Name (ARN)。 |
無 |
|
Notification Topic Name |
您訂閱的主題名稱。 |
無 |
aws:elasticbeanstalk:sqsd
設定工作者環境的 Amazon SQS佇列。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
WorkerQueueURL |
工作者環境層中常駐程式讀取訊息的URL佇列的 。 |
自動產生 |
如果您不指定數值,則 Elastic Beanstalk 會自動建立佇列。 |
HttpPath |
訊息HTTPPOST傳送至之應用程式的相對路徑。 |
/ |
|
MimeType |
在HTTPPOST請求中傳送的訊息MIME類型。 |
|
自訂MIME類型。 |
HttpConnections |
Amazon EC2執行個體內任何應用程式的並行連線數量上限。 |
|
|
ConnectTimeout |
等待成功連線到應用程式所需的時間 (以秒為單位)。 |
|
|
InactivityTimeout |
等待現有連線回應到應用程式所需的時間 (以秒為單位)。 訊息會重新處理,直到協助程式從工作者環境方案中的應用程式接收到 200 (OK) 回應或RetentionPeriod 過期。 |
|
|
VisibilityTimeout |
Amazon SQS佇列的傳入訊息會鎖定等待處理的時間長度,以秒為單位。在設定的時間數過後,該則訊息才能在佇列中被任何其他協助程式再次讀取。 |
300 |
|
ErrorVisibilityTimeout |
Elastic Beanstalk 在處理嘗試失敗並出現明確錯誤之後,傳回訊息至 Amazon SQS佇列之前經過的時間,以秒為單位。 |
|
|
RetentionPeriod |
訊息有效並主動處理所需的時間 (以秒為單位)。 |
|
|
MaxRetries |
Elastic Beanstalk 嘗試傳送訊息到 Web 應用程式的次數上限,將在該訊息移動到無效字母佇列之前處裡。 |
|
|
aws:elasticbeanstalk:trafficsplitting
設定您環境的流量分割部署。
當您將 aws:elasticbeanstalk:command 命名空間的 DeploymentPolicy
選項設為 TrafficSplitting
時,便會套用此命名空間。如需部署原則的詳細資訊,請參閱 部署政策和設定。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
NewVersionPercent |
Elastic Beanstalk 移動到執行您正在部署新應用程式版本環境用戶端的傳入用戶端流量初始百分比。 |
|
|
EvaluationTime |
時間間隔 (分鐘),Elastic Beanstalk 會在初始運作狀態良好的部署之後等待這段時間,再繼續將所有傳入用戶端流量移動到您正在部署的新應用程式版本。 |
|
|
aws:elasticbeanstalk:xray
執行 AWS X-Ray 常駐程式,從 X-Ray 整合應用程式轉送追蹤資訊。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
|
設定為 |
|
|
aws:elb:healthcheck
為 Classic Load Balancer 設定運作狀態檢查。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
HealthyThreshold |
在 Elastic Load Balancing 變更執行個體運作狀態之前的連續成功請求數目。 |
|
|
Interval |
Elastic Load Balancing 檢查應用程式 Amazon EC2執行個體運作狀態的間隔。 |
|
|
Timeout |
Elastic Load Balancing 在將執行個體視為沒有回應之前等待回應的時間 (以秒為單位)。 |
|
|
UnhealthyThreshold |
在 Elastic Load Balancing 變更執行個體運作狀態之前的連續不成功請求數目。 |
|
|
(已棄用) Target |
運作狀態檢查傳送至後端執行個體的目的地。使用 |
|
格式的目標 |
aws:elb:loadbalancer
設定您環境的 Classic Load Balancer。
在這個命名空間的數個選項已不再受到支援,以便使用 aws:elb:listener 命名空間中的接聽程式特定選項。若使用這些不再支援的選項,您只能在標準連接埠上設定兩個接聽程式 (一個安全,一個不安全)。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
CrossZone |
在所有可用區域的所有執行個體平均設定負載平衡器至路由流量,而不是只在每個區域內設定。 |
|
|
SecurityGroups |
指派一或多個安全群組,讓您建立負載平衡器。 |
無 |
一或多個安全群組 IDs。 |
ManagedSecurityGroup |
為您環境的負載平衡器指派現有的安全群組,而不用建立新的。若要使用此設定,請更新此命名空間中的 若要允許負載平衡器到環境EC2執行個體的流量,Elastic Beanstalk 會將規則新增至執行個體的安全群組,以允許來自受管安全群組的傳入流量。 |
無 | 一個安全群組 ID。 |
(已棄用) LoadBalancerHTTPPort |
不安全接聽程式的接聽連接埠。 |
|
|
(已棄用) LoadBalancerPortProtocol |
用於不安全接聽程式的通訊協定。 |
|
|
(已棄用) LoadBalancerHTTPSPort |
安全接聽程式的接聽連接埠。 |
|
|
(已棄用) LoadBalancerSSLPortProtocol |
用於安全接聽程式的通訊協定。 |
|
|
(已棄用) SSLCertificateId |
要繫結至安全接聽程式之SSL憑證的 Amazon Resource Name (ARN)。 |
無 |
aws:elb:listener
在 Classic Load Balancer 上設定預設接聽程式 (連接埠 80)。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
ListenerProtocol | 接聽程式使用的通訊協定。 | HTTP
|
|
InstancePort | 此接聽程式用來與EC2執行個體通訊的連接埠。 | 80 | 1 至 65535 |
InstanceProtocol |
此接聽程式用來與EC2執行個體通訊的通訊協定。 需與 例如,如果 |
|
HTTP 或 HTTPS ,當 ListenerProtocol 是 HTTP 或 HTTPS 時
|
PolicyNames | 套用至此接聽程式連接埠,原則名稱以逗號分隔的清單。建議您改用 aws:elb:policies 命名空間 LoadBalancerPorts 的選項。 | 無 | |
ListenerEnabled | 指定這個接聽程式是否已啟用。若您指定 false ,則接聽程式不會包含在負載平衡器中。 |
true |
|
aws:elb:listener:listener_port
Classic Load Balancer 上設定額外的接聽程式。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
ListenerProtocol |
接聽程式使用的通訊協定。 |
HTTP
|
|
InstancePort |
此接聽程式用來與EC2執行個體通訊的連接埠。 | 與 相同 listener_port . |
1 至 65535 |
InstanceProtocol |
此接聽程式用來與EC2執行個體通訊的通訊協定。 需與 例如,如果 |
|
HTTP 或 HTTPS ,當 ListenerProtocol 是 HTTP 或 HTTPS 時
|
PolicyNames |
套用至此接聽程式連接埠,原則名稱以逗號分隔的清單。我們建議您改用 aws:elb:policies 命名空間 LoadBalancerPorts 的選項。 | 無 | |
SSLCertificateId |
要繫結至接聽程式之SSL憑證的 Amazon Resource Name (ARN)。 |
無 |
|
ListenerEnabled |
指定這個接聽程式是否已啟用。若您指定 false ,則接聽程式不會包含在負載平衡器中。 |
若有設定任何其他選項即為 true ,否則為 false 。 |
|
aws:elb:policies
為 Classic Load Balancer 修改預設黏著性和全球負載平衡器原則。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
ConnectionDrainingEnabled |
指定負載平衡器維持現有連結至已變為狀態不佳或取消註冊的執行個體,以完成正在進行的請求。 |
|
|
ConnectionDrainingTimeout |
在強制關閉連接之前,負載平衡器在連接耗盡期間維持與執行個體的現有連接最大秒數。 |
|
|
ConnectionSettingIdleTimeout |
負載平衡器等待透過連線傳送或接收任何資料的時間 (以秒為單位)。如果在此段時間過後沒有資料已傳送或接收,則負載平衡器關閉連線。 |
|
|
LoadBalancerPorts |
預設原則 ( |
無 | 您可以使用 :all 以表示所有接聽程式連接埠 |
Stickiness Cookie Expiration |
每個 Cookie 有效所需的時間 (秒)。使用預設原則 ( |
|
|
Stickiness Policy |
將使用者會話繫結到特定的伺服器執行個體,以便會話期間來自使用者的所有請求都發送到相同的伺服器執行個體。使用預設原則 ( |
|
|
aws:elb:policies:policy_name
為 Classic Load Balancer 建立額外的負載平衡器原則。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
CookieName |
應用程式產生的 cookie 名稱,用於控制 AppCookieStickinessPolicyType 原則的工作階段生命週期。此政策只能與 HTTP/HTTPS 接聽程式建立關聯。 |
無 | |
InstancePorts |
此原則適用的執行個體連接埠的逗號分隔清單。 |
無 | 連接埠清單,或 :all |
LoadBalancerPorts |
此原則適用的接聽程式連接埠的逗號分隔清單。 |
無 | 連接埠清單,或 :all |
ProxyProtocol |
對於 |
無 |
|
PublicKey |
在身分驗證後端伺服器或伺服器時, |
無 | |
PublicKeyPolicyNames |
以逗號分隔清單政策名稱 (從 |
無 | |
SSLProtocols |
要為政策啟用的SSL通訊協定逗號分隔清單,該 |
無 | |
SSLReferencePolicy |
預先定義安全政策的名稱,該政策遵循 AWS 安全最佳實務,且您希望針對定義負載平衡器接受的密碼和通訊協定的政策啟用該 |
無 | |
Stickiness Cookie Expiration |
每個 Cookie 有效所需的時間 (秒)。 |
|
|
Stickiness Policy |
將使用者會話繫結到特定的伺服器執行個體,以便會話期間來自使用者的所有請求都發送到相同的伺服器執行個體。 |
|
|
aws:elbv2:listener:default
在 Application Load Balancer 或 Network Load Balancer 設定預設接聽程式 (連接埠 80)。
此命名空間不適用於使用共享負載平衡器的環境。共享負載平衡器沒有預設接聽程式。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
DefaultProcess |
當沒有相符的規則時,轉送流量至該處理程序的名稱。 |
|
程序名稱。 |
ListenerEnabled |
設定為 |
|
|
Protocol |
要處理的流量通訊協定。 |
使用 Application Load Balancer: 使用 Network Load Balancer: |
使用 Application Load Balancer: 使用 Network Load Balancer: |
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
選項。其他選項不適用於共享負載平衡器。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
DefaultProcess |
當沒有相符的規則時流量被轉發之處理程序的名稱。 |
|
程序名稱。 |
ListenerEnabled |
設定為 |
|
|
Protocol |
要處理的流量通訊協定。 |
使用 Application Load Balancer: 使用 Network Load Balancer: |
使用 Application Load Balancer: 使用 Network Load Balancer: |
Rules |
套用至接聽程式的規則清單 此選項只適用於 Application Load Balancer 的環境。 如果您的環境使用共享 Application Load Balancer,而且您沒有為任何接聽程式指定此選項,則 Elastic Beanstalk 會自動將 |
無 |
以逗號分隔的規則名稱清單。 |
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 的環境。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
HostHeaders |
要比對的主機名稱清單。例如, |
專用負載平衡器:無 共用負載平衡器:環境的 CNAME |
每個名稱最多可包含 128 個字元。模式可包含大寫和小寫字母、數字、連字號 (–),以及最多三個萬用字元 ( 如需詳細資訊,請參閱 Application Load Balancer 使用者指南中的主機條件。 |
PathPatterns |
要匹配的路徑模式 (例如 此選項只適用於 Application Load Balancer 的環境。 |
無 |
每個模式最多可包含 128 個字元。模式可包含大寫和小寫字母、數字、連字號 (–),以及最多三個萬用字元 ( 如需詳細資訊,請參閱 Application Load Balancer 使用者指南中的路徑條件。 |
Priority |
多個規則相符時,此規則的優先順序。數量較低的優先。不會同時有兩個規則有相同的優先順序。 使用共享負載平衡器時,Elastic Beanstalk 將規則優先順序視為共享環境中的相對優先順序,並在建立期間將其對應至絕對優先順序。 |
|
|
Process |
當此規則符合要求時,要轉送流量至該處理程序的名稱。 |
|
程序名稱。 |
aws:elbv2:loadbalancer
設定一個 Application Load Balancer。
對於共享負載平衡器,只有 SharedLoadBalancer
和 SecurityGroups
選項有效。
注意
這個命名空間不適用於使用 Network Load Balancer 的環境。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
AccessLogsS3Bucket |
存放存取日誌的 Amazon S3 儲存貯體。儲存貯體必須與環境位於同一個區域中,並允許負載平衡器寫入存取。 |
無 |
儲存貯體名稱。 |
AccessLogsS3Enabled |
啟用存取日誌儲存。 |
|
|
AccessLogsS3Prefix |
用於存取日誌名稱的前綴。根據預設,負載平衡器會將日誌上傳至您指定的儲存貯體 AWSLogs 中名為 的目錄。指定字首,將 AWSLogs 目錄放置在另一個目錄內。 |
無 |
|
IdleTimeout |
在關閉與用戶端和執行個體的連線之前等待請求完成的時間 (以秒為單位)。 |
無 |
|
ManagedSecurityGroup |
為您環境的負載平衡器指派現有的安全群組,而不用建立新的。若要使用此設定,請在這個命名空間包含您的安全群組 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 命名空間的 有效值的條件:
範例:
|
無 |
ARN 符合此處所述所有條件的有效負載平衡器。 |
aws:rds:dbinstance
設定連接的 Amazon RDS 資料庫執行個體。
名稱 | 描述 | 預設 | 有效值 |
---|---|---|---|
DBAllocatedStorage |
分配的資料庫儲存大小,以 GB 為單位。 |
我的 SQL: Oracle: sqlserver-se: sqlserver-ex: sqlserver-web: |
我的 SQL: Oracle: sqlserver:不能修改 |
DBDeletionPolicy |
指定在環境終止時,是否要保留、刪除或建立資料庫執行個體的快照。 此選項適合搭配 警告刪除資料庫執行個體會產生永久性資料遺失。 |
|
|
DBEngine |
要為此執行個體使用的資料庫引擎名稱。 |
|
|
DBEngineVersion |
資料庫引擎版本編號。 |
|
|
DBInstanceClass |
資料庫執行個體類型。 |
( |
如需詳細資訊,請參閱 Amazon Relational Database Service 使用者指南中的資料庫執行個體類別。 |
DBPassword |
要為此資料庫執行個體使用的主要使用者密碼名稱。 |
無 |
|
DBSnapshotIdentifier |
恢復資料庫快照的識別碼。 |
無 |
|
DBUser |
此資料庫執行個體的主要使用者名稱。 |
ebroot |
|
HasCoupledDatabase |
指定資料庫執行個體是否要與環境耦合。如果切換為 此選項適合搭配 注意注意:如果您在解耦舊有資料庫後,將此值切換回 |
|
|
MultiAZDatabase |
指定是否需要建立資料庫執行個體異地同步備份部署。如需使用 Amazon Relational Database Service (RDS) 進行多可用區域部署的詳細資訊,請參閱 Amazon Relational Database Service 使用者指南 中的區域和可用區域。 |
|
|