meta_srv/procedure/region_migration/
update_metadata.rs1pub(crate) mod downgrade_leader_region;
16pub(crate) mod rollback_downgraded_region;
17pub(crate) mod upgrade_candidate_region;
18
19use std::any::Any;
20
21use common_procedure::{Context as ProcedureContext, Status};
22use common_telemetry::warn;
23use serde::{Deserialize, Serialize};
24
25use crate::error::Result;
26use crate::procedure::region_migration::close_downgraded_region::CloseDowngradedRegion;
27use crate::procedure::region_migration::downgrade_leader_region::DowngradeLeaderRegion;
28use crate::procedure::region_migration::migration_abort::RegionMigrationAbort;
29use crate::procedure::region_migration::{Context, State};
30
31#[derive(Debug, Serialize, Deserialize)]
32#[serde(tag = "UpdateMetadata")]
33pub enum UpdateMetadata {
34 Downgrade,
36 Upgrade,
38 Rollback,
40}
41
42#[async_trait::async_trait]
43#[typetag::serde]
44impl State for UpdateMetadata {
45 async fn next(
46 &mut self,
47 ctx: &mut Context,
48 procedure_ctx: &ProcedureContext,
49 ) -> Result<(Box<dyn State>, Status)> {
50 match self {
51 UpdateMetadata::Downgrade => {
52 self.downgrade_leader_region(ctx, &procedure_ctx.provider)
53 .await?;
54
55 Ok((
56 Box::<DowngradeLeaderRegion>::default(),
57 Status::executing(false),
58 ))
59 }
60 UpdateMetadata::Upgrade => {
61 let result = self
62 .upgrade_candidate_region(ctx, &procedure_ctx.provider)
63 .await;
64
65 if let Err(err) = ctx.invalidate_table_cache().await {
67 warn!(
68 "Failed to broadcast the invalidate table cache message during the upgrade candidate, error: {err:?}"
69 );
70 };
71 result?;
72 Ok((Box::new(CloseDowngradedRegion), Status::executing(false)))
73 }
74 UpdateMetadata::Rollback => {
75 ctx.volatile_ctx.opening_region_guards.clear();
77 self.rollback_downgraded_region(ctx, &procedure_ctx.provider)
78 .await?;
79
80 if let Err(err) = ctx.invalidate_table_cache().await {
81 warn!(
82 "Failed to broadcast the invalidate table cache message during the rollback, error: {err:?}"
83 );
84 };
85 Ok((
86 Box::new(RegionMigrationAbort::new(
87 "Failed to upgrade the candidate region.",
88 )),
89 Status::executing(false),
90 ))
91 }
92 }
93 }
94
95 fn as_any(&self) -> &dyn Any {
96 self
97 }
98}