Skip to content

docs: update 3.16.1#1058

Closed
adela-bytebase wants to merge 1 commit intomainfrom
a-branch-116
Closed

docs: update 3.16.1#1058
adela-bytebase wants to merge 1 commit intomainfrom
a-branch-116

Conversation

@adela-bytebase
Copy link
Contributor

No description provided.

@vercel
Copy link

vercel bot commented Mar 26, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
bytebase-com Ready Ready Preview, Comment Mar 26, 2026 8:43am

Request Review

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates Bytebase 3.16.1 documentation by modernizing the Terraform “general settings” tutorial to use CEL-based Custom Approval rules (instead of Terraform risk policies), and makes a small changelog correction plus adds a Node version pin for docs tooling.

Changes:

  • Remove the Terraform risk policy step from the “Manage General Settings with Terraform” tutorial and switch to CEL-based approval rules under settings/WORKSPACE_APPROVAL.
  • Update 3.16.1 changelog database label for the schema dump fix.
  • Add docs/.node-version to pin the Node major version for docs workflows.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File Description
docs/tutorials/manage-general-settings-with-terraform.mdx Removes Terraform risk-policy section and documents CEL-based approval rules + updated verification notes
docs/changelog/bytebase-3-16-1.mdx Changes the DB label for the pg_bitmapindex schema dump fix
docs/.node-version Pins Node major version for docs tooling

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

- Fall back to DBA approval for all other operations

### Step 4 - Apply Configuration
### Step 3 - Apply Configuration
Copy link

Copilot AI Mar 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The step numbering is now inconsistent after removing the old Risk step: this section is labeled "Step 3", but the next heading is still "Step 5 - Verify Configuration". Please renumber the remaining steps so they are sequential (e.g., Apply = Step 3, Verify = Step 4) to avoid confusing readers.

Copilot uses AI. Check for mistakes.
| Sample file | [approval_flow.tf](https://github.com/bytebase/terraform-provider-bytebase/blob/main/examples/setup/approval_flow.tf) |

Create `4-3-approval-flow.tf` with approval flow configuration that requires multiple approvals for risky operations:
Create `4-2-approval-flow.tf` with approval flow configuration. Conditions are defined directly on each rule using CEL expressions:
Copy link

Copilot AI Mar 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The table links to a sample file named approval_flow.tf, but the tutorial instructs creating 4-2-approval-flow.tf. Consider aligning the filenames (or explicitly stating that the local filename is arbitrary and the linked file is just a reference) to reduce confusion.

Suggested change
Create `4-2-approval-flow.tf` with approval flow configuration. Conditions are defined directly on each rule using CEL expressions:
Create a local file (for example, `4-2-approval-flow.tf`) with the following approval flow configuration. Conditions are defined directly on each rule using CEL expressions:

Copilot uses AI. Check for mistakes.
Comment on lines +141 to +145
This creates approval rules that:

- DML operations with MODERATE risk level
- DDL operations with HIGH risk level
- Require three-step approval (Project Owner -> DBA -> Admin) for database changes in production affecting 100+ rows
- Require Project Owner approval for exporting data from the `employee` table in production
- Fall back to DBA approval for all other operations
Copy link

Copilot AI Mar 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section was updated to use approval rules/CEL conditions and no longer introduces Terraform risk policies, but the earlier "What You'll Learn" bullets still mention defining risk policies and risk-based approval flows. Please update that intro section to match the new approach (approval rules defined via CEL, without a separate risk-policy Terraform step).

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants