Skip to content

Commit 8dd2cb0

Browse files
docs: update step by step change schema (#976)
* update step-by-step change schema * update * update plan * update * update * update
1 parent 6337390 commit 8dd2cb0

27 files changed

+32
-78
lines changed

docs/change-database/plan.mdx

Lines changed: 15 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -2,42 +2,32 @@
22
title: Plan
33
---
44

5-
A **Plan** is the core component of Bytebase’s CI/CD pipeline. It defines a series of schema or data changes to be applied to one or more databases.
5+
A **Plan** is the core component of Bytebase’s CI/CD pipeline. It defines a series of schema or data changes to be applied to one or more databases. It can be converted into an **Issue** for review and deployment.
66

7-
### 1. Create a New Plan
8-
In your project, go to **CI/CD** > **Plans** in the left menu and click **New Plan**.
7+
### 1. Create Plan
98

10-
![new-plan](/content/docs/change-database/plan/bb-new-plan.webp)
9+
In your project, navigate to **CI/CD** > **Plans** and click **+ New Plan**.
1110

12-
### 2. Choose the Change Type
13-
Select either **Schema Migration (DDL)** or **Data Migration (DML)**. After adding the first change, you can continue to add more.
11+
### 2. Select Databases
1412

15-
![plan-change-type](/content/docs/change-database/plan/bb-plan-change-type.webp)
13+
Choose one or moretarget databases and click **Confirm**.
1614

17-
### 3. Select Target Databases
18-
Choose one or more databases where the changes will be applied. Click **Confirm** to proceed.
15+
### 3. Add Changes
1916

20-
![plan-targets](/content/docs/change-database/plan/bb-plan-targets.webp)
17+
Add SQL statements (multiple allowed by clicking **+ Add Change**) and click **Create**. The plan will be in `Draft` status with automatic SQL review.
2118

22-
### 4. Add Changes
23-
Fill in the SQL statement. You can add multiple changes to the same plan. Once done, click **Create**.
19+
![bb-plan-warning-detail](/content/docs/change-database/plan/bb-plan-warning-detail.webp)
2420

25-
![plan-add-change](/content/docs/change-database/plan/bb-plan-add-change.webp)
26-
![plan-2-change](/content/docs/change-database/plan/bb-plan-2-change.webp)
21+
### 4. Submit for Review (Enterprise)
2722

28-
### 5. Submit for Review
29-
The plan starts in a `draft` state. Click **Ready for Review** to submit it for approval.
23+
Fix the warning, and click **Ready for Review**. The plan will be converted into an issue and await approval. Approval follows [configured rules](/change-database/approval).
3024

31-
![plan-draft](/content/docs/change-database/plan/bb-plan-draft.webp)
25+
![plan-approval](/content/docs/change-database/plan/bb-plan-approval.webp)
3226

33-
### 6. Approve and Roll Out
34-
Once approved, go to the **Rollout** section to begin deployment.
27+
### 5. Deploy
3528

36-
![plan-approval](/content/docs/change-database/plan/bb-plan-approval.webp)
37-
![plan-ready-rollout](/content/docs/change-database/plan/bb-plan-ready-rollout.webp)
29+
After approval, go to the **Rollout** section to deploy changes. You may configure the rollout policy to `Automatic` in the [environment](/change-database/environment-policy/rollout-policy).
3830

39-
### 7. Deploy to Environments
40-
First, deploy to the `Test` environment. If successful, proceed to deploy to `Prod`.
31+
![bb-issue-2-targets-to-rollout](/content/docs/change-database/plan/bb-issue-2-targets-to-rollout.webp)
4132

42-
![plan-rollout-test](/content/docs/change-database/plan/bb-plan-rollout-test.webp)
43-
![plan-rollout-prod](/content/docs/change-database/plan/bb-plan-rollout-prod.webp)
33+
Deploy to `Test` first, then `Prod` after success.
18.6 KB
Loading
-29.7 KB
Binary file not shown.
-61.6 KB
Binary file not shown.
-58.1 KB
Binary file not shown.
-40.7 KB
Binary file not shown.
-61.9 KB
Binary file not shown.
-70.4 KB
Binary file not shown.
-46.8 KB
Binary file not shown.
-49.4 KB
Binary file not shown.

0 commit comments

Comments
 (0)