停用或移除 BGP 工作階段
您可以暫時停用 BGP 工作階段,或完全移除。在遷移至其他 BGP 對等端或對 BGP 對等端進行維護時,變更路由器設定是停用工作階段的常見原因。
事前準備
gcloud
如要使用本指南中的指令列範例,請完成下列事項:
- 安裝或更新至最新版 Google Cloud CLI。
- 設定預設地區和區域。
API
如要使用本指南提供的 API 範例,請設定 API 存取權。
停用 BGP 工作階段
您可以使用 Google Cloud 主控台、update-bgp-peer
指令或 API 停用 BGP 工作階段。根據預設,系統會啟用 BGP 工作階段。
如果停用,系統就會終止所有包含 BGP 對等點的執行中工作階段,並移除所有相關聯的轉送資訊。
如要停用 BGP 工作階段,請按照下列步驟操作。
主控台
前往 Google Cloud 控制台的「Cloud Routers」頁面。
- 選取要停用的 BGP 工作階段所屬路由器。
- 在「路由器詳細資料」頁面中,選取要停用的 BGP 工作階段。
- 在「BGP 工作階段詳細資料」頁面中,按一下 「編輯」。
- 針對「BGP 對等點」,選取「已停用」。
- 按一下 [儲存]。
gcloud
執行 update-bgp-peer
指令:
gcloud compute routers update-bgp-peer ROUTER_NAME \ --project=PROJECT_ID \ --peer-name=PEER_NAME \ --region=REGION \ --no-enabled
更改下列內容:
ROUTER_NAME
:Cloud Router 的名稱PROJECT_ID
:包含 Cloud Router 的專案PEER_NAME
:BGP 對等點名稱REGION
:Cloud Router 所在的區域
API
使用 routers.patch
方法更新 bgpPeers[]
欄位。
bgpPeers[]
欄位可接受 BGP 對等端陣列。當您 PATCH
這個欄位時,您會將要求中包含的新陣列覆寫現有的 BGP 同端陣列。
傳送
GET
要求,取得路由器目前的 BGP 對等互連陣列。詳情請參閱「查看 BGP 工作階段設定」。傳送
PATCH
要求,並附上新的 BGP 對等點陣列。針對您要停用 BGP 工作階段的每個 BGP 對等端,將bgpPeers[].enable
設為FALSE
。PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME { "bgpPeers": [ BGP_PEERS ] }
更改下列內容:
PROJECT_ID
:包含 Cloud Router 的專案REGION
:Cloud Router 所在的區域ROUTER_NAME
:Cloud Router 的名稱BGP_PEERS
:BGP 同級節點的新陣列內容
以下範例會停用第一個 BGP 對等點的工作階段:
{ "name": "peer-1", "interfaceName": "if-peer-1", "ipAddress": "169.254.10.1", "peerIpAddress": "169.254.10.2", "peerAsn": 64512, "advertisedRoutePriority": 100, "advertiseMode": "DEFAULT", "advertisedGroups": [], "advertisedIpRanges": [], "enable": "FALSE" }, { "name": "peer-2", "interfaceName": "if-peer-2", "ipAddress": "169.254.20.1", "peerIpAddress": "169.254.20.2", "peerAsn": 64513, "advertisedRoutePriority": 100, "advertiseMode": "DEFAULT", "advertisedGroups": [], "advertisedIpRanges": [] }
啟用 BGP 工作階段
您可以使用 Google Cloud 控制台、update-bgp-peer
指令或 API 啟用 BGP 工作階段。根據預設,系統會啟用 BGP 工作階段。
如果啟用,就能使用轉送資訊建立對等點連線。
如要啟用 BGP 工作階段,請按照下列步驟操作。
主控台
前往 Google Cloud 控制台的「Cloud Routers」頁面。
- 選取要啟用 BGP 工作階段的路由器。
- 在「路由器詳細資料」頁面中,選取要啟用的 BGP 工作階段。
- 在「BGP 工作階段詳細資料」頁面中,按一下 「編輯」。
- 在「BGP 對等端」部分,選取「已啟用」。
- 按一下 [儲存]。
gcloud
執行 update-bgp-peer
指令:
gcloud compute routers update-bgp-peer ROUTER_NAME \ --project=PROJECT_ID \ --peer-name=PEER_NAME \ --region=REGION \ --enabled
更改下列內容:
ROUTER_NAME
:Cloud Router 的名稱PROJECT_ID
:包含 Cloud Router 的專案PEER_NAME
:BGP 對等點名稱REGION
:Cloud Router 所在的區域
API
使用 routers.patch
方法更新 bgpPeers[]
欄位。
bgpPeers[]
欄位可接受 BGP 對等端陣列。當您使用此欄位指定 PATCH
要求時,您會將要求中包含的新陣列覆寫 BGP 同端節點的現有陣列。
傳送
GET
要求,取得路由器目前的 BGP 對等互連陣列。詳情請參閱「查看 Cloud Router 詳細資料」。傳送
PATCH
要求,並附上新的 BGP 對等點陣列。針對您要啟用 BGP 工作階段的每個 BGP 對等端,將bgpPeers[].enable
設為TRUE
。PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME { "bgpPeers": [ BGP_PEERS ] }
更改下列內容:
PROJECT_ID
:包含 Cloud Router 的專案REGION
:Cloud Router 所在的區域ROUTER_NAME
:Cloud Router 的名稱BGP_PEERS
:BGP 同級節點的新陣列內容
以下範例會為第一個 BGP 對等點啟用工作階段:
{ "name": "peer-1", "interfaceName": "if-peer-1", "ipAddress": "169.254.10.1", "peerIpAddress": "169.254.10.2", "peerAsn": 64512, "advertisedRoutePriority": 100, "advertiseMode": "DEFAULT", "advertisedGroups": [], "advertisedIpRanges": [], "enable": "TRUE" }, { "name": "peer-2", "interfaceName": "if-peer-2", "ipAddress": "169.254.20.1", "peerIpAddress": "169.254.20.2", "peerAsn": 64513, "advertisedRoutePriority": 100, "advertiseMode": "DEFAULT", "advertisedGroups": [], "advertisedIpRanges": [] }
移除 BGP 工作階段
如果您刪除與 BGP 工作階段相關聯的 Cloud VPN 通道或 VLAN 連結,系統會自動關閉該工作階段。
您可以使用 Google Cloud 主控台、remove-bgp-peer
指令或 API,手動移除 BGP 工作階段。如果您移除 BGP 工作階段,VPN 通道或 VLAN 連結會保留,但 Cloud Router 不會透過它們通告路徑。
如要移除 BGP 工作階段,請按照下列步驟操作。
主控台
前往 Google Cloud 控制台的「Cloud Routers」頁面。
- 選取要移除 BGP 工作階段的路由器。
- 針對「BGP 工作階段」,選取要移除的 BGP 工作階段。
- 按一下頁面頂端的「刪除」圖示 ,然後確認刪除。
gcloud
執行 remove-bgp-peer
指令:
gcloud compute routers remove-bgp-peer ROUTER_NAME \ --project=PROJECT_ID \ --peer-name=PEER_NAME \ --region=REGION \
更改下列內容:
ROUTER_NAME
:Cloud Router 的名稱PROJECT_ID
:包含 Cloud Router 的專案PEER_NAME
:BGP 對等點名稱REGION
:Cloud Router 所在的區域
API
如要從 Cloud Router 移除 BGP 對等項目,請使用 routers.patch
方法更新 bgpPeers[]
欄位。
bgpPeers[]
欄位可接受 BGP 對等端陣列。當您PATCH
這個欄位時,系統會將要求中包含的新陣列覆寫現有的 BGP 同端陣列。
傳送
GET
要求,取得路由器目前的 BGP 對等互連陣列。詳情請參閱「查看 Cloud Router 詳細資料」。傳送
PATCH
要求,並附上新的 BGP 對等點陣列。使用上一個步驟中GET
要求的陣列,並移除路由器中不必要的 BGP 同端。您可以傳送空陣列,移除所有 BGP 對等點。
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME { "bgpPeers": [ BGP_PEERS ] }
更改下列內容:
PROJECT_ID
:包含 Cloud Router 的專案REGION
:Cloud Router 所在的區域ROUTER_NAME
:Cloud Router 的名稱BGP_PEERS
:BGP 同級節點的新陣列內容
以下範例包含兩個 BGP 對等端:
{ "name": "peer-1", "interfaceName": "if-peer-1", "ipAddress": "169.254.10.1", "peerIpAddress": "169.254.10.2", "peerAsn": 64512, "advertisedRoutePriority": 100, "advertiseMode": "DEFAULT" }, { "name": "peer-2", "interfaceName": "if-peer-2", "ipAddress": "169.254.20.1", "peerIpAddress": "169.254.20.2", "peerAsn": 64513, "advertisedRoutePriority": 100, "advertiseMode": "DEFAULT" }
後續步驟
- 如要查看 Cloud Router 的設定、BGP 工作階段和 Cloud Router 通告的路徑,請參閱「查看 Cloud Router 詳細資料」。
- 如要瞭解 BGP 工作階段狀態,請參閱「BGP 工作階段狀態」。
- 如要排解 Cloud Router 的問題,請參閱疑難排解。