本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
停止管線執行 CodePipeline
當管道執行開始透過管道執行時,其一次會進入一個階段,並在階段中的所有動作執行正在執行時鎖定階段。這些進行中的動作必須以某種方式處理,以便在管道執行停止時,允許完成或捨棄動作。
有兩種方式可以停止管道執行:
-
停止並等待: AWS CodePipeline 等待停止執行,直到所有進行中的動作都完成 (亦即,動作具有
Succeeded
或Failed
狀態)。此選項會保留進行中的動作。執行會處於Stopping
狀態,直到進行中的動作完成為止。然後執行會處於Stopped
狀態。動作完成之後,階段就會解除鎖定。如果您選擇停止並等待,而且在執行仍處於
Stopping
狀態時改變主意,您可以選擇捨棄。 -
停止和放棄: AWS CodePipeline 停止執行,而不等待進行中的動作完成。當進行中的動作被捨棄時,執行會有非常短的時間處於
Stopping
狀態。在執行停止之後,當管道執行處於Abandoned
狀態時,動作執行會處於Stopped
狀態。階段會解除鎖定。對於處於
Stopped
狀態的管道執行,您可重試執行停止所在階段中的動作。警告
此選項可能會導致工作失敗或工作失序。
停止管道執行 (主控台)
您可以使用控制台停止管道執行。選擇執行,然後選擇停止管線執行的方法。
注意
您也可以停止作為輸入執行的管道執行。若要進一步瞭解如何停止輸入執行,請參閱停止輸入執行 (主控台)。
請登入 AWS Management Console 並開啟 CodePipeline 主控台,網址為 http://console.aws.amazon.com/codesuite/codepipeline/home
。 -
執行以下任意一項:
注意
在您停止執行之前,我們建議您停用階段前面的轉換。如此一來,當階段由於停止執行而解除鎖定時,階段就不會接受後續的管道執行。
-
在 Name (名稱) 中,選擇您想停止執行的管道名稱。在管道詳細資訊頁面上,選擇 Stop execution (停止執行)。
-
選擇 View history (檢視歷程記錄)。在歷程記錄頁面上,選擇 Stop execution (停止執行)。
-
-
在 Stop execution (停止執行) 頁面的 Select execution (選取執行) 之下,選擇您要停止的執行。
注意
只有仍在進行中的執行才會顯示。不會顯示已經完成的執行。
-
在 Select an action to apply to execution (選取要套用至執行的動作) 之下,選擇下列其中一項:
-
若要確保在所有進行中的動作都完成前,執行不會停止,請選擇 Stop and wait (停止並等待)。
注意
如果執行已處於 Stopping (停止中) 狀態,您就無法選擇停止並等待,但您可以選擇停止並捨棄。
-
若要停止而不等待進行中的動作完成,請選擇 Stop and abandon (停止並捨棄)。
警告
此選項可能會導致工作失敗或工作失序。
-
-
(選擇性) 輸入註解。這些註解以及執行狀態會顯示在執行的歷程記錄頁面上。
-
選擇停止。
重要
這個操作無法復原。
-
在管道視覺效果中檢視執行狀態,如下所示:
-
如果您選擇停止並等待,則選取的執行會繼續進行,直到進行中的動作完成為止。
-
成功橫幅訊息會顯示在主控台的頂端。
-
在目前階段中,進行中的動作會以
InProgress
狀態繼續進行。當動作正在進行時,管道執行會處於Stopping
狀態。動作完成 (也就是動作失敗或成功) 後,管道執行會變更為
Stopped
狀態,而動作會變更為Failed
或Succeeded
狀態。您也可以在執行詳細資訊頁面上檢視動作狀態。您可以在執行歷程記錄頁面或執行詳細資訊頁面上檢視執行狀態。 -
管道執行會短暫變更為
Stopping
狀態,然後變更為Stopped
狀態。您可以在執行歷程記錄頁面或執行詳細資訊頁面上檢視執行狀態。
-
-
如果您選擇停止並捨棄,則執行不會等待進行中的動作完成。
-
成功橫幅訊息會顯示在主控台的頂端。
-
在目前階段中,進行中的動作會變更為
Abandoned
狀態。您也可以在執行詳細資訊頁面上檢視動作狀態。 -
管道執行會短暫變更為
Stopping
狀態,然後變更為Stopped
狀態。您可以在執行歷程記錄頁面或執行詳細資訊頁面上檢視執行狀態。
-
您可以在執行歷程記錄檢視和詳細歷程記錄檢視中檢視管道執行狀態。
-
停止輸入執行 (主控台)
您可以使用控制台停止輸入執行。輸入執行是一種管線執行,正在等待進入停用轉換的階段。啟用轉換時,會InProgress
繼續進入階段的輸入執行。未進入階段Stopped
的輸入執行。
注意
入站執行停止後,無法重試。
如果您沒有看到輸入執行,則在停用的階段轉換中沒有擱置的執行。
-
請登入 AWS Management Console 並開啟 CodePipeline 主控台,網址為 http://console.aws.amazon.com/codesuite/codepipeline/home
。 將顯示與您的 AWS 帳戶關聯的所有管道的名稱。
-
選擇您要停止輸入執行的管道名稱,請執行下列其中一個動作:
-
在「管線」檢視中,選擇輸入執行 ID,然後選擇停止執行。
-
選擇管線,然後選擇檢視歷史記錄。在執行歷史記錄中,選擇輸入執行 ID,然後選擇停止執行。
-
-
在停止執行模式中,請按照上述部分中的步驟選取執行 ID 並指定 stop 方法。
使用get-pipeline-state命令檢視輸入執行的狀態。
停止管道執行 (CLI)
若要使用 AWS CLI 手動停止配管,請使用具有下列參數的stop-pipeline-execution指令:
-
執行 ID (必要)
-
註解 (選擇性)
-
管道名稱 (必要)
-
捨棄旗標 (選擇性,預設值為 false)
命令格式:
aws codepipeline stop-pipeline-execution --pipeline-name
Pipeline_Name
–-pipeline-execution-idExecution_ID
[--abandon | --no-abandon] [--reasonSTOP_EXECUTION_REASON
]
-
開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。
-
若要停止管道執行,請選擇下列其中一項:
-
若要確保在所有進行中的動作都完成前,執行不會停止,請選擇停止並等待。您可以納入 no-abandon 參數來完成此操作。如果您未指定參數,則命令會預設為停止並等待。使用 AWS CLI 來執行stop-pipeline-execution命令,指定管線的名稱和執行 ID。例如,若要停止以指定 stop and wait 選項命名
MyFirstPipeline
的管線:aws codepipeline stop-pipeline-execution --pipeline-name
MyFirstPipeline
--pipeline-execution-id d-EXAMPLE --no-abandon例如,若要停止名為的管線
MyFirstPipeline
、預設為 stop and wait 選項,並選擇包含註解:aws codepipeline stop-pipeline-execution --pipeline-name
MyFirstPipeline
--pipeline-execution-id d-EXAMPLE --reason "Stopping execution after the build action is done"注意
如果執行已處於 Stopping (停止中) 狀態,您就無法選擇停止並等待。您可以選擇停止並捨棄已處於 Stopping (停止中) 狀態的執行。
-
若要停止而不等待進行中的動作完成,請選擇停止並捨棄。納入 abandon 參數。使用 AWS CLI 來執行stop-pipeline-execution命令,指定管線的名稱和執行 ID。
例如,若要停止名為的管線
MyFirstPipeline
、指定放棄選項,並選擇包含註解:aws codepipeline stop-pipeline-execution --pipeline-name
MyFirstPipeline
--pipeline-execution-id d-EXAMPLE --abandon --reason "Stopping execution for a bug fix"
-
停止輸入執行 (CLI)
您可以使用 CLI 停止輸入執行。輸入執行是一種管線執行,正在等待進入停用轉換的階段。啟用轉換時,會InProgress
繼續進入階段的輸入執行。未進入階段Stopped
的輸入執行。
注意
入站執行停止後,無法重試。
如果您沒有看到輸入執行,則在停用的階段轉換中沒有擱置的執行。
若要使用 AWS CLI 手動停止輸入執行,請使用具有下列參數的stop-pipeline-execution命令:
-
輸入執行 ID (必要)
-
註解 (選擇性)
-
管道名稱 (必要)
-
捨棄旗標 (選擇性,預設值為 false)
命令格式:
aws codepipeline stop-pipeline-execution --pipeline-name
Pipeline_Name
–-pipeline-execution-idInbound_Execution_ID
[--abandon | --no-abandon] [--reasonSTOP_EXECUTION_REASON
]
按照上述程序中的步驟輸入命令並指定 stop 方法。
使用get-pipeline-state命令檢視輸入執行的狀態。