Skip to content

Database governance built for humans and agents — controlling changes and access across every major database.

refactor: move release ID generation from client to server (#18969)

Danny Xu3315fa572583
diff --git a/action/README.md b/action/README.md
index 983013b978..77398125bf 100644
--- a/action/README.md
+++ b/action/README.md
@@ -20,7 +20,7 @@ Creates a new release and initiates a rollout issue in the specified Bytebase `-
If a `--plan` is specified, it rolls out that specific plan.
Otherwise, it applies the SQL files matching the `--file-pattern` to the defined `--targets`.
The rollout will proceed up to the specified `--target-stage`.
-It uses global flags for connection and file discovery (unless a plan is specified), and specific flags like `--release-title` to name the created resources in Bytebase.
+The release is named using the `--release-id-template` flag.
## Configuration
@@ -104,9 +104,6 @@ These flags are specific to the `check` subcommand (`bytebase-action check`).
These flags are specific to the `rollout` subcommand (`bytebase-action rollout`).
-- **`--release-title`**: The title of the release created in Bytebase.
- - Default: The current timestamp in RFC3339 format (e.g., `2025-04-25T17:32:07+08:00`).
-
- **`--target-stage`**: The target stage up to which the rollout should proceed. If not specified, the rollout will be created but will not wait for completion.
- Format: `environments/{environment}`
- Example: `environments/prod`
diff --git a/action/command/api.go b/action/command/api.go
index 167ff78fd4..bd83d6f7ea 100644
--- a/action/command/api.go
+++ b/action/command/api.go
@@ -145,11 +145,12 @@ func (c *Client) CheckRelease(ctx context.Context, r *v1pb.CheckReleaseRequest)
return resp.Msg, nil
}
-func (c *Client) CreateRelease(ctx context.Context, project string, r *v1pb.Release, train string) (*v1pb.Release, error) {
+func (c *Client) CreateRelease(ctx context.Context, project string, r *v1pb.Release, releaseIDTemplate, releaseIDTimezone string) (*v1pb.Release, error) {
req := connect.NewRequest(&v1pb.CreateReleaseRequest{
- Parent: project,
- Release: r,
- Train: train,
+ Parent: project,
+ Release: r,
+ ReleaseIdTemplate: releaseIDTemplate,
+ ReleaseIdTimezone: releaseIDTimezone,
})
resp, err := c.releaseClient.CreateRelease(ctx, req)
if err != nil {
diff --git a/action/command/rollout.go b/action/command/rollout.go
index 4c405566c4..3e1787cab3 100644
--- a/action/command/rollout.go
+++ b/action/command/rollout.go
@@ -28,7 +28,6 @@ func NewRolloutCommand(w *world.World) *cobra.Command {
PersistentPreRunE: rolloutPreRun(w),
RunE: runRollout(w),
}
- cmdRollout.Flags().StringVar(&w.ReleaseTitle, "release-title", "", "The title of the release. Generated from project and current timestamp if not provided.")
cmdRollout.Flags().StringVar(&w.TargetStage, "target-stage", "", "Rollout up to the target stage. Format: environments/{environment}.")
cmdRollout.Flags().StringVar(&w.Plan, "plan", "", "The plan to rollout. Format: projects/{project}/plans/{plan}. Shadows file-pattern and targets.")
cmdRollout.Flags().StringVar(&w.ReleaseIDTemplate, "release-id-template", "release_{date}-RC{iteration}", "Template for release ID. Available variables: {date}, {time}, {timestamp}, {iteration}")
@@ -36,7 +35,7 @@ func NewRolloutCommand(w *world.World) *cobra.Command {
return cmdRollout
}
-func rolloutPreRun(w *world.World) func(*cobra.Command, []string) error {
+func rolloutPreRun(_ *world.World) func(*cobra.Command, []string) error {
return func(cmd *cobra.Command, args []string) error {
if p := cmd.Parent(); p != nil {
if p.PersistentPreRunE != nil {
@@ -45,9 +44,6 @@ func rolloutPreRun(w *world.World) func(*cobra.Command, []string) error {
}
}
}
- if w.ReleaseTitle == "" {
- w.ReleaseTitle = fmt.Sprintf("[%s] %s", strings.TrimPrefix(w.Project, "projects/"), time.Now().UTC().Format(time.RFC3339))
- }
return nil
}
}
@@ -86,16 +82,11 @@ func runRollout(w *world.World) func(command *cobra.Command, _ []string) error {
if w.Declarative {
releaseType = v1pb.Release_DECLARATIVE
}
- // Render train from template
- train, err := renderTrain(w.ReleaseIDTemplate, w.ReleaseIDTimezone, time.Now())
- if err != nil {
- return errors.Wrapf(err, "failed to render train")
- }
createReleaseResponse, err := client.CreateRelease(ctx, w.Project, &v1pb.Release{
Files: releaseFiles,
VcsSource: getVCSSource(w),
Type: releaseType,
- }, train)
+ }, w.ReleaseIDTemplate, w.ReleaseIDTimezone)
if err != nil {
return errors.Wrapf(err, "failed to create release")
}
@@ -103,8 +94,11 @@ func runRollout(w *world.World) func(command *cobra.Command, _ []string) error {
release = createReleaseResponse.Name
w.OutputMap.Release = release
+ // Extract release ID from release name (format: projects/{project}/releases/{release_id})
+ releaseID := strings.TrimPrefix(release, w.Project+"/releases/")
+
planCreated, err := client.CreatePlan(ctx, w.Project, &v1pb.Plan{
- Title: "Release " + w.ReleaseTitle,
+ Title: releaseID,
Specs: []*v1pb.Plan_Spec{
{
Id: uuid.New().String(),
@@ -328,48 +322,3 @@ func getVCSSource(w *world.World) *v1pb.Release_VCSSource {
return nil
}
}
-
-func renderTrain(template, timezone string, t time.Time) (string, error) {
- // Validate template
- if err := validateTemplate(template); err != nil {
- return "", err
- }
-
- // Validate timezone
- loc, err := time.LoadLocation(timezone)
- if err != nil {
- return "", errors.Wrapf(err, "invalid timezone: %s", timezone)
- }
-
- now := t.In(loc)
-
- train := template
- train = strings.ReplaceAll(train, "{date}", now.Format("20060102"))
- train = strings.ReplaceAll(train, "{time}", now.Format("1504"))
- train = strings.ReplaceAll(train, "{timestamp}", now.Format("20060102_1504"))
- train = strings.ReplaceAll(train, "{iteration}", "")
-
- return train, nil
-}
-
-func validateTemplate(template string) error {
- // Must contain {iteration}
- if !strings.Contains(template, "{iteration}") {
- return errors.New("template must contain {iteration} placeholder")
- }
-
- // {iteration} must be at the end of the template
- if !strings.HasSuffix(template, "{iteration}") {
- return errors.New("{iteration} must be at the end of the template")
- }
-
- // Must contain at least one time variable
- hasTimeVar := strings.Contains(template, "{date}") ||
- strings.Contains(template, "{time}") ||
- strings.Contains(template, "{timestamp}")
- if !hasTimeVar {
- return errors.New("template must contain at least one of: {date}, {time}, {timestamp}")
- }
-
- return nil
-}
diff --git a/action/world/world.go b/action/world/world.go
index c8d20076d7..20ba507045 100644
--- a/action/world/world.go
+++ b/action/world/world.go
@@ -38,7 +38,6 @@ type World struct {
CustomRules string
// bytebase-action rollout flags
- ReleaseTitle string // The title of the release
// Rollout up to the target-stage.
// Format: environments/{environment}
TargetStage string
diff --git a/backend/api/mcp/gen/openapi.yaml b/backend/api/mcp/gen/openapi.yaml
index 8671b28887..00546f3792 100644
--- a/backend/api/mcp/gen/openapi.yaml
+++ b/backend/api/mcp/gen/openapi.yaml
@@ -8021,12 +8021,21 @@ components:
title: release
description: The release to create.
$ref: '#/components/schemas/bytebase.v1.Release'
- train:
+ releaseIdTemplate:
type: string
- title: train
+ title: release_id_template
description: |-
- Train for iteration tracking (template rendered without {iteration}).
- Used to group releases and determine the next iteration number.
+ Template for release ID generation.
+ Available variables: {date}, {time}, {timestamp}, {iteration}.
+ Example: "release_{date}-RC{iteration}" generates "release_20260119-RC00".
+ Default: "release_{date}-RC{iteration}".
+ releaseIdTimezone:
+ type: string
+ title: release_id_timezone
+ description: |-
+ Timezone for {date} and {time} variables in the template.
+ Must be a valid IANA timezone (e.g., "UTC", "America/Los_Angeles").
+ Default: "UTC".
title: CreateReleaseRequest
additionalProperties: false
bytebase.v1.CreateReviewConfigRequest:
diff --git a/backend/api/v1/release_service.go b/backend/api/v1/release_service.go
index c61dc4afa4..9b71e4d953 100644
--- a/backend/api/v1/release_service.go
+++ b/backend/api/v1/release_service.go
@@ -5,6 +5,8 @@ import (
"crypto/sha256"
"encoding/hex"
"slices"
+ "strings"
+ "time"
"connectrpc.com/connect"
"github.com/google/cel-go/cel"
@@ -101,9 +103,25 @@ func (s *ReleaseService) CreateRelease(ctx context.Context, req *connect.Request
}
}
+ // Set defaults for release ID template and timezone if not provided.
+ releaseIDTemplate := req.Msg.ReleaseIdTemplate
+ if releaseIDTemplate == "" {
+ releaseIDTemplate = "release_{date}-RC{iteration}"
+ }
+ releaseIDTimezone := req.Msg.ReleaseIdTimezone
+ if releaseIDTimezone == "" {
+ releaseIDTimezone = "UTC"
+ }
+
+ // Compute train from template and timezone.
+ train, err := renderTrain(releaseIDTemplate, releaseIDTimezone, time.Now())
+ if err != nil {
+ return nil, connect.NewError(connect.CodeInvalidArgument, errors.Wrapf(err, "failed to render train"))
+ }
+
releaseMessage := &store.ReleaseMessage{
ProjectID: project.ResourceID,
- Train: req.Msg.Train,
+ Train: train,
Category: req.Msg.Release.Category,
Payload: &storepb.ReleasePayload{
VcsSource: convertReleaseVcsSource(req.Msg.Release.VcsSource),
@@ -508,3 +526,48 @@ func extractCategoryFromExpr(expr celast.Expr) (string, error) {
return "", errors.Errorf("unsupported expression type")
}
}
+
+func renderTrain(template, timezone string, t time.Time) (string, error) {
+ // Validate template
+ if err := validateTemplate(template); err != nil {
+ return "", err
+ }
+
+ // Validate timezone
+ loc, err := time.LoadLocation(timezone)
+ if err != nil {
+ return "", errors.Wrapf(err, "invalid timezone: %s", timezone)
+ }
+
+ now := t.In(loc)
+
+ train := template
+ train = strings.ReplaceAll(train, "{date}", now.Format("20060102"))
+ train = strings.ReplaceAll(train, "{time}", now.Format("1504"))
+ train = strings.ReplaceAll(train, "{timestamp}", now.Format("20060102_1504"))
+ train = strings.ReplaceAll(train, "{iteration}", "")
+
+ return train, nil
+}
+
+func validateTemplate(template string) error {
+ // Must contain {iteration}
+ if !strings.Contains(template, "{iteration}") {
+ return errors.New("template must contain {iteration} placeholder")
+ }
+
+ // {iteration} must be at the end of the template
+ if !strings.HasSuffix(template, "{iteration}") {
+ return errors.New("{iteration} must be at the end of the template")
+ }
+
+ // Must contain at least one time variable
+ hasTimeVar := strings.Contains(template, "{date}") ||
+ strings.Contains(template, "{time}") ||
+ strings.Contains(template, "{timestamp}")
+ if !hasTimeVar {
+ return errors.New("template must contain at least one of: {date}, {time}, {timestamp}")
+ }
+
+ return nil
+}
diff --git a/action/command/rollout_test.go b/backend/api/v1/release_service_test.go
similarity index 99%
rename from action/command/rollout_test.go
rename to backend/api/v1/release_service_test.go
index 7d2527e4f4..cc678e80a4 100644
--- a/action/command/rollout_test.go
+++ b/backend/api/v1/release_service_test.go
@@ -1,4 +1,4 @@
-package command
+package v1
import (
"testing"
diff --git a/backend/generated-go/v1/release_service.pb.go b/backend/generated-go/v1/release_service.pb.go
index ab7a6d605f..d5b6eea562 100644
--- a/backend/generated-go/v1/release_service.pb.go
+++ b/backend/generated-go/v1/release_service.pb.go
@@ -278,11 +278,17 @@ type CreateReleaseRequest struct {
Parent string `protobuf:"bytes,1,opt,name=parent,proto3" json:"parent,omitempty"`
// The release to create.
Release *Release `protobuf:"bytes,2,opt,name=release,proto3" json:"release,omitempty"`
- // Train for iteration tracking (template rendered without {iteration}).
- // Used to group releases and determine the next iteration number.
- Train string `protobuf:"bytes,3,opt,name=train,proto3" json:"train,omitempty"`
- unknownFields protoimpl.UnknownFields
- sizeCache protoimpl.SizeCache
+ // Template for release ID generation.
+ // Available variables: {date}, {time}, {timestamp}, {iteration}.
+ // Example: "release_{date}-RC{iteration}" generates "release_20260119-RC00".
+ // Default: "release_{date}-RC{iteration}".
+ ReleaseIdTemplate string `protobuf:"bytes,3,opt,name=release_id_template,json=releaseIdTemplate,proto3" json:"release_id_template,omitempty"`
+ // Timezone for {date} and {time} variables in the template.
+ // Must be a valid IANA timezone (e.g., "UTC", "America/Los_Angeles").
+ // Default: "UTC".
+ ReleaseIdTimezone string `protobuf:"bytes,4,opt,name=release_id_timezone,json=releaseIdTimezone,proto3" json:"release_id_timezone,omitempty"`
+ unknownFields protoimpl.UnknownFields
+ sizeCache protoimpl.SizeCache
}
func (x *CreateReleaseRequest) Reset() {
@@ -329,9 +335,16 @@ func (x *CreateReleaseRequest) GetRelease() *Release {
return nil
}
-func (x *CreateReleaseRequest) GetTrain() string {
+func (x *CreateReleaseRequest) GetReleaseIdTemplate() string {
+ if x != nil {
+ return x.ReleaseIdTemplate
+ }
+ return ""
+}
+
+func (x *CreateReleaseRequest) GetReleaseIdTimezone() string {
if x != nil {
- return x.Train
+ return x.ReleaseIdTimezone
}
return ""
}
@@ -1073,12 +1086,13 @@ const file_v1_release_service_proto_rawDesc = "" +
"\x06filter\x18\x05 \x01(\tR\x06filter\"p\n" +
"\x14ListReleasesResponse\x120\n" +
"\breleases\x18\x01 \x03(\v2\x14.bytebase.v1.ReleaseR\breleases\x12&\n" +
- "\x0fnext_page_token\x18\x02 \x01(\tR\rnextPageToken\"\x97\x01\n" +
+ "\x0fnext_page_token\x18\x02 \x01(\tR\rnextPageToken\"\xe1\x01\n" +
"\x14CreateReleaseRequest\x124\n" +
"\x06parent\x18\x01 \x01(\tB\x1c\xe0A\x02\xfaA\x16\n" +
"\x14bytebase.com/ProjectR\x06parent\x123\n" +
- "\arelease\x18\x02 \x01(\v2\x14.bytebase.v1.ReleaseB\x03\xe0A\x02R\arelease\x12\x14\n" +
- "\x05train\x18\x03 \x01(\tR\x05train\"\x88\x01\n" +
+ "\arelease\x18\x02 \x01(\v2\x14.bytebase.v1.ReleaseB\x03\xe0A\x02R\arelease\x12.\n" +
+ "\x13release_id_template\x18\x03 \x01(\tR\x11releaseIdTemplate\x12.\n" +
+ "\x13release_id_timezone\x18\x04 \x01(\tR\x11releaseIdTimezone\"\x88\x01\n" +
"\x14UpdateReleaseRequest\x123\n" +
"\arelease\x18\x01 \x01(\v2\x14.bytebase.v1.ReleaseB\x03\xe0A\x02R\arelease\x12;\n" +
"\vupdate_mask\x18\x02 \x01(\v2\x1a.google.protobuf.FieldMaskR\n" +
diff --git a/backend/generated-go/v1/release_service_equal.pb.go b/backend/generated-go/v1/release_service_equal.pb.go
index d44807bddb..f0cea9e852 100644
--- a/backend/generated-go/v1/release_service_equal.pb.go
+++ b/backend/generated-go/v1/release_service_equal.pb.go
@@ -80,7 +80,10 @@ func (x *CreateReleaseRequest) Equal(y *CreateReleaseRequest) bool {
if !x.Release.Equal(y.Release) {
return false
}
- if x.Train != y.Train {
+ if x.ReleaseIdTemplate != y.ReleaseIdTemplate {
+ return false
+ }
+ if x.ReleaseIdTimezone != y.ReleaseIdTimezone {
return false
}
return true
diff --git a/backend/tests/action_test.go b/backend/tests/action_test.go
index 4d6865c58b..e90a351677 100644
--- a/backend/tests/action_test.go
+++ b/backend/tests/action_test.go
@@ -692,7 +692,6 @@ func TestActionRolloutCommand(t *testing.T) {
"--project", ctl.project.Name,
"--targets", database.Name,
"--file-pattern", migrationFile,
- "--release-title", "Test Release",
"--target-stage", "environments/prod",
"--output", outputFile,
)
@@ -838,7 +837,6 @@ func TestActionRolloutCommand(t *testing.T) {
"--project", ctl.project.Name,
"--targets", database.Name,
"--file-pattern", filepath.Join(testDataDir, "0000*.sql"),
- "--release-title", "Multi-file Release",
"--target-stage", "environments/prod",
"--output", outputFile,
)
@@ -1034,7 +1032,6 @@ func TestActionRolloutCommand(t *testing.T) {
"--project", ctl.project.Name,
"--targets", database.Name,
"--file-pattern", filepath.Join(testDataDir, "v*.sql"),
- "--release-title", "Version Order Test",
"--target-stage", "environments/prod",
)
a.NoError(err, "Rollout command should succeed")
@@ -1111,7 +1108,6 @@ func TestActionRolloutDeclarativeMode(t *testing.T) {
"--project", ctl.project.Name,
"--targets", database.Name,
"--file-pattern", schemaFile,
- "--release-title", "Declarative Release V1",
"--target-stage", "environments/prod",
"--output", outputFile,
"--declarative",
@@ -1181,7 +1177,6 @@ func TestActionRolloutDeclarativeMode(t *testing.T) {
"--project", ctl.project.Name,
"--targets", database.Name,
"--file-pattern", schemaFile,
- "--release-title", "Initial Schema",
"--target-stage", "environments/prod",
"--declarative",
)
@@ -1221,7 +1216,6 @@ func TestActionRolloutDeclarativeMode(t *testing.T) {
"--project", ctl.project.Name,
"--targets", database.Name,
"--file-pattern", schemaFile,
- "--release-title", "Evolved Schema",
"--target-stage", "environments/prod",
"--declarative",
)
@@ -1294,7 +1288,6 @@ func TestActionRolloutDeclarativeMode(t *testing.T) {
"--project", ctl.project.Name,
"--targets", database.Name,
"--file-pattern", schemaFile,
- "--release-title", "Idempotent Release 1",
"--target-stage", "environments/prod",
"--output", outputFile1,
"--declarative",
@@ -1317,7 +1310,6 @@ func TestActionRolloutDeclarativeMode(t *testing.T) {
"--project", ctl.project.Name,
"--targets", database.Name,
"--file-pattern", schemaFile,
- "--release-title", "Idempotent Release 2",
"--target-stage", "environments/prod",
"--output", outputFile2,
"--declarative",
@@ -1345,7 +1337,6 @@ func TestActionRolloutDeclarativeMode(t *testing.T) {
"--project", ctl.project.Name,
"--targets", database.Name,
"--file-pattern", schemaFile,
- "--release-title", "Idempotent Release 3",
"--target-stage", "environments/prod",
"--output", outputFile3,
"--declarative",
@@ -1460,7 +1451,6 @@ func TestActionRolloutDeclarativeMode(t *testing.T) {
"--project", ctl.project.Name,
"--targets", fmt.Sprintf("%s,%s", database1.Name, database2.Name),
"--file-pattern", schemaFile,
- "--release-title", "Multi-DB Declarative Release",
"--target-stage", "environments/prod",
"--declarative",
)
@@ -1534,7 +1524,6 @@ func TestActionRolloutDeclarativeMode(t *testing.T) {
"--project", ctl.project.Name,
"--targets", databaseGroup.Msg.Name,
"--file-pattern", schemaFile,
- "--release-title", "Declarative Group Release",
"--target-stage", "environments/prod",
"--declarative",
)
@@ -1607,7 +1596,6 @@ func TestActionRolloutDeclarativeMode(t *testing.T) {
"--project", ctl.project.Name,
"--targets", database.Name,
"--file-pattern", filepath.Join(testDataDir, "*.sql"),
- "--release-title", "Multiple Declarative Files Release",
"--target-stage", "environments/prod",
"--declarative",
)
@@ -1768,7 +1756,6 @@ func TestActionErrorScenarios(t *testing.T) {
"--project", ctl.project.Name,
"--targets", database.Name,
"--file-pattern", filepath.Join(testDataDir, "*.nonexistent"),
- "--release-title", "Empty Release",
"--target-stage", "environments/prod",
)
diff --git a/frontend/src/types/proto-es/v1/release_service_pb.d.ts b/frontend/src/types/proto-es/v1/release_service_pb.d.ts
index 196590a975..e3cf5c7453 100644
--- a/frontend/src/types/proto-es/v1/release_service_pb.d.ts
+++ b/frontend/src/types/proto-es/v1/release_service_pb.d.ts
@@ -135,12 +135,23 @@ export declare type CreateReleaseRequest = Message<"bytebase.v1.CreateReleaseReq
release?: Release;
/**
- * Train for iteration tracking (template rendered without {iteration}).
- * Used to group releases and determine the next iteration number.
+ * Template for release ID generation.
+ * Available variables: {date}, {time}, {timestamp}, {iteration}.
+ * Example: "release_{date}-RC{iteration}" generates "release_20260119-RC00".
+ * Default: "release_{date}-RC{iteration}".
*
- * @generated from field: string train = 3;
+ * @generated from field: string release_id_template = 3;
*/
- train: string;
+ releaseIdTemplate: string;
+
+ /**
+ * Timezone for {date} and {time} variables in the template.
+ * Must be a valid IANA timezone (e.g., "UTC", "America/Los_Angeles").
+ * Default: "UTC".
+ *
+ * @generated from field: string release_id_timezone = 4;
+ */
+ releaseIdTimezone: string;
};
/**
diff --git a/frontend/src/types/proto-es/v1/release_service_pb.js b/frontend/src/types/proto-es/v1/release_service_pb.js
index 11d626a2e8..64a05e62cd 100644
--- a/frontend/src/types/proto-es/v1/release_service_pb.js
+++ b/frontend/src/types/proto-es/v1/release_service_pb.js
@@ -16,7 +16,7 @@ import { file_v1_sql_service } from "./sql_service_pb";
* Describes the file v1/release_service.proto.
*/
export const file_v1_release_service = /*@__PURE__*/
- fileDesc("Chh2MS9yZWxlYXNlX3NlcnZpY2UucHJvdG8SC2J5dGViYXNlLnYxIj8KEUdldFJlbGVhc2VSZXF1ZXN0EioKBG5hbWUYASABKAlCHOBBAvpBFgoUYnl0ZWJhc2UuY29tL1JlbGVhc2UikAEKE0xpc3RSZWxlYXNlc1JlcXVlc3QSLAoGcGFyZW50GAEgASgJQhzgQQL6QRYKFGJ5dGViYXNlLmNvbS9Qcm9qZWN0EhEKCXBhZ2Vfc2l6ZRgCIAEoBRISCgpwYWdlX3Rva2VuGAMgASgJEhQKDHNob3dfZGVsZXRlZBgEIAEoCBIOCgZmaWx0ZXIYBSABKAkiVwoUTGlzdFJlbGVhc2VzUmVzcG9uc2USJgoIcmVsZWFzZXMYASADKAsyFC5ieXRlYmFzZS52MS5SZWxlYXNlEhcKD25leHRfcGFnZV90b2tlbhgCIAEoCSJ/ChRDcmVhdGVSZWxlYXNlUmVxdWVzdBIsCgZwYXJlbnQYASABKAlCHOBBAvpBFgoUYnl0ZWJhc2UuY29tL1Byb2plY3QSKgoHcmVsZWFzZRgCIAEoCzIULmJ5dGViYXNlLnYxLlJlbGVhc2VCA+BBAhINCgV0cmFpbhgDIAEoCSJzChRVcGRhdGVSZWxlYXNlUmVxdWVzdBIqCgdyZWxlYXNlGAEgASgLMhQuYnl0ZWJhc2UudjEuUmVsZWFzZUID4EECEi8KC3VwZGF0ZV9tYXNrGAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLkZpZWxkTWFzayJCChREZWxldGVSZWxlYXNlUmVxdWVzdBIqCgRuYW1lGAEgASgJQhzgQQL6QRYKFGJ5dGViYXNlLmNvbS9SZWxlYXNlIkQKFlVuZGVsZXRlUmVsZWFzZVJlcXVlc3QSKgoEbmFtZRgBIAEoCUIc4EEC+kEWChRieXRlYmFzZS5jb20vUmVsZWFzZSKWAQoTQ2hlY2tSZWxlYXNlUmVxdWVzdBIsCgZwYXJlbnQYASABKAlCHOBBAvpBFgoUYnl0ZWJhc2UuY29tL1Byb2plY3QSKgoHcmVsZWFzZRgCIAEoCzIULmJ5dGViYXNlLnYxLlJlbGVhc2VCA+BBAhIPCgd0YXJnZXRzGAMgAygJEhQKDGN1c3RvbV9ydWxlcxgEIAEoCSKwAgoUQ2hlY2tSZWxlYXNlUmVzcG9uc2USPgoHcmVzdWx0cxgBIAMoCzItLmJ5dGViYXNlLnYxLkNoZWNrUmVsZWFzZVJlc3BvbnNlLkNoZWNrUmVzdWx0EhUKDWFmZmVjdGVkX3Jvd3MYAiABKAMSKgoKcmlza19sZXZlbBgDIAEoDjIWLmJ5dGViYXNlLnYxLlJpc2tMZXZlbBqUAQoLQ2hlY2tSZXN1bHQSDAoEZmlsZRgBIAEoCRIOCgZ0YXJnZXQYAiABKAkSJAoHYWR2aWNlcxgDIAMoCzITLmJ5dGViYXNlLnYxLkFkdmljZRIVCg1hZmZlY3RlZF9yb3dzGAQgASgDEioKCnJpc2tfbGV2ZWwYBSABKA4yFi5ieXRlYmFzZS52MS5SaXNrTGV2ZWwiTAocTGlzdFJlbGVhc2VDYXRlZ29yaWVzUmVxdWVzdBIsCgZwYXJlbnQYASABKAlCHOBBAvpBFgoUYnl0ZWJhc2UuY29tL1Byb2plY3QiMwodTGlzdFJlbGVhc2VDYXRlZ29yaWVzUmVzcG9uc2USEgoKY2F0ZWdvcmllcxgBIAMoCSKEBQoHUmVsZWFzZRIRCgRuYW1lGAEgASgJQgPgQQMSEAoIY2F0ZWdvcnkYAiABKAkSKAoFZmlsZXMYAyADKAsyGS5ieXRlYmFzZS52MS5SZWxlYXNlLkZpbGUSMgoKdmNzX3NvdXJjZRgEIAEoCzIeLmJ5dGViYXNlLnYxLlJlbGVhc2UuVkNTU291cmNlEhQKB2NyZWF0b3IYBSABKAlCA+BBAxI0CgtjcmVhdGVfdGltZRgGIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXBCA+BBAxImCgVzdGF0ZRgHIAEoDjISLmJ5dGViYXNlLnYxLlN0YXRlQgPgQQMSJwoEdHlwZRgIIAEoDjIZLmJ5dGViYXNlLnYxLlJlbGVhc2UuVHlwZRqWAQoERmlsZRIMCgRwYXRoGAIgASgJEg8KB3ZlcnNpb24YBiABKAkSFAoMZW5hYmxlX2dob3N0GAkgASgIEiYKBXNoZWV0GAMgASgJQhf6QRQKEmJ5dGViYXNlLmNvbS9TaGVldBIWCglzdGF0ZW1lbnQYByABKAxCA+BBBBIZCgxzaGVldF9zaGEyNTYYBCABKAlCA+BBAxpACglWQ1NTb3VyY2USJgoIdmNzX3R5cGUYASABKA4yFC5ieXRlYmFzZS52MS5WQ1NUeXBlEgsKA3VybBgCIAEoCSI8CgRUeXBlEhQKEFRZUEVfVU5TUEVDSUZJRUQQABINCglWRVJTSU9ORUQQARIPCgtERUNMQVJBVElWRRACOkDqQT0KFGJ5dGViYXNlLmNvbS9SZWxlYXNlEiVwcm9qZWN0cy97cHJvamVjdH0vcmVsZWFzZXMve3JlbGVhc2V9MsAKCg5SZWxlYXNlU2VydmljZRKKAQoKR2V0UmVsZWFzZRIeLmJ5dGViYXNlLnYxLkdldFJlbGVhc2VSZXF1ZXN0GhQuYnl0ZWJhc2UudjEuUmVsZWFzZSJG2kEEbmFtZYrqMA9iYi5yZWxlYXNlcy5nZXSQ6jABgtPkkwIiEiAvdjEve25hbWU9cHJvamVjdHMvKi9yZWxlYXNlcy8qfRKeAQoMTGlzdFJlbGVhc2VzEiAuYnl0ZWJhc2UudjEuTGlzdFJlbGVhc2VzUmVxdWVzdBohLmJ5dGViYXNlLnYxLkxpc3RSZWxlYXNlc1Jlc3BvbnNlIknaQQZwYXJlbnSK6jAQYmIucmVsZWFzZXMubGlzdJDqMAGC0+STAiISIC92MS97cGFyZW50PXByb2plY3RzLyp9L3JlbGVhc2VzEqYBCg1DcmVhdGVSZWxlYXNlEiEuYnl0ZWJhc2UudjEuQ3JlYXRlUmVsZWFzZVJlcXVlc3QaFC5ieXRlYmFzZS52MS5SZWxlYXNlIlzaQQ5wYXJlbnQscmVsZWFzZYrqMBJiYi5yZWxlYXNlcy5jcmVhdGWQ6jABgtPkkwIrOgdyZWxlYXNlIiAvdjEve3BhcmVudD1wcm9qZWN0cy8qfS9yZWxlYXNlcxKzAQoNVXBkYXRlUmVsZWFzZRIhLmJ5dGViYXNlLnYxLlVwZGF0ZVJlbGVhc2VSZXF1ZXN0GhQuYnl0ZWJhc2UudjEuUmVsZWFzZSJp2kETcmVsZWFzZSx1cGRhdGVfbWFza4rqMBJiYi5yZWxlYXNlcy51cGRhdGWQ6jABgtPkkwIzOgdyZWxlYXNlMigvdjEve3JlbGVhc2UubmFtZT1wcm9qZWN0cy8qL3JlbGVhc2VzLyp9EpUBCg1EZWxldGVSZWxlYXNlEiEuYnl0ZWJhc2UudjEuRGVsZXRlUmVsZWFzZVJlcXVlc3QaFi5nb29nbGUucHJvdG9idWYuRW1wdHkiSdpBBG5hbWWK6jASYmIucmVsZWFzZXMuZGVsZXRlkOowAYLT5JMCIiogL3YxL3tuYW1lPXByb2plY3RzLyovcmVsZWFzZXMvKn0SmwEKD1VuZGVsZXRlUmVsZWFzZRIjLmJ5dGViYXNlLnYxLlVuZGVsZXRlUmVsZWFzZVJlcXVlc3QaFC5ieXRlYmFzZS52MS5SZWxlYXNlIk2K6jAUYmIucmVsZWFzZXMudW5kZWxldGWQ6jABgtPkkwIrIikvdjEve25hbWU9cHJvamVjdHMvKi9yZWxlYXNlcy8qfTp1bmRlbGV0ZRKfAQoMQ2hlY2tSZWxlYXNlEiAuYnl0ZWJhc2UudjEuQ2hlY2tSZWxlYXNlUmVxdWVzdBohLmJ5dGViYXNlLnYxLkNoZWNrUmVsZWFzZVJlc3BvbnNlIkqK6jARYmIucmVsZWFzZXMuY2hlY2uQ6jABgtPkkwIrOgEqIiYvdjEve3BhcmVudD1wcm9qZWN0cy8qfS9yZWxlYXNlczpjaGVjaxLIAQoVTGlzdFJlbGVhc2VDYXRlZ29yaWVzEikuYnl0ZWJhc2UudjEuTGlzdFJlbGVhc2VDYXRlZ29yaWVzUmVxdWVzdBoqLmJ5dGViYXNlLnYxLkxpc3RSZWxlYXNlQ2F0ZWdvcmllc1Jlc3BvbnNlIljaQQZwYXJlbnSK6jAQYmIucmVsZWFzZXMubGlzdJDqMAGC0+STAjESLy92MS97cGFyZW50PXByb2plY3RzLyp9L3JlbGVhc2VzOmxpc3RDYXRlZ29yaWVzQqkBCg9jb20uYnl0ZWJhc2UudjFCE1JlbGVhc2VTZXJ2aWNlUHJvdG9QAVo0Z2l0aHViLmNvbS9ieXRlYmFzZS9ieXRlYmFzZS9iYWNrZW5kL2dlbmVyYXRlZC1nby92MaICA0JYWKoCC0J5dGViYXNlLlYxygILQnl0ZWJhc2VcVjHiAhdCeXRlYmFzZVxWMVxHUEJNZXRhZGF0YeoCDEJ5dGViYXNlOjpWMWIGcHJvdG8z", [file_google_api_annotations, file_google_api_client, file_google_api_field_behavior, file_google_api_resource, file_google_protobuf_empty, file_google_protobuf_field_mask, file_google_protobuf_timestamp, file_v1_annotation, file_v1_common, file_v1_sql_service]);
+ fileDesc("Chh2MS9yZWxlYXNlX3NlcnZpY2UucHJvdG8SC2J5dGViYXNlLnYxIj8KEUdldFJlbGVhc2VSZXF1ZXN0EioKBG5hbWUYASABKAlCHOBBAvpBFgoUYnl0ZWJhc2UuY29tL1JlbGVhc2UikAEKE0xpc3RSZWxlYXNlc1JlcXVlc3QSLAoGcGFyZW50GAEgASgJQhzgQQL6QRYKFGJ5dGViYXNlLmNvbS9Qcm9qZWN0EhEKCXBhZ2Vfc2l6ZRgCIAEoBRISCgpwYWdlX3Rva2VuGAMgASgJEhQKDHNob3dfZGVsZXRlZBgEIAEoCBIOCgZmaWx0ZXIYBSABKAkiVwoUTGlzdFJlbGVhc2VzUmVzcG9uc2USJgoIcmVsZWFzZXMYASADKAsyFC5ieXRlYmFzZS52MS5SZWxlYXNlEhcKD25leHRfcGFnZV90b2tlbhgCIAEoCSKqAQoUQ3JlYXRlUmVsZWFzZVJlcXVlc3QSLAoGcGFyZW50GAEgASgJQhzgQQL6QRYKFGJ5dGViYXNlLmNvbS9Qcm9qZWN0EioKB3JlbGVhc2UYAiABKAsyFC5ieXRlYmFzZS52MS5SZWxlYXNlQgPgQQISGwoTcmVsZWFzZV9pZF90ZW1wbGF0ZRgDIAEoCRIbChNyZWxlYXNlX2lkX3RpbWV6b25lGAQgASgJInMKFFVwZGF0ZVJlbGVhc2VSZXF1ZXN0EioKB3JlbGVhc2UYASABKAsyFC5ieXRlYmFzZS52MS5SZWxlYXNlQgPgQQISLwoLdXBkYXRlX21hc2sYAiABKAsyGi5nb29nbGUucHJvdG9idWYuRmllbGRNYXNrIkIKFERlbGV0ZVJlbGVhc2VSZXF1ZXN0EioKBG5hbWUYASABKAlCHOBBAvpBFgoUYnl0ZWJhc2UuY29tL1JlbGVhc2UiRAoWVW5kZWxldGVSZWxlYXNlUmVxdWVzdBIqCgRuYW1lGAEgASgJQhzgQQL6QRYKFGJ5dGViYXNlLmNvbS9SZWxlYXNlIpYBChNDaGVja1JlbGVhc2VSZXF1ZXN0EiwKBnBhcmVudBgBIAEoCUIc4EEC+kEWChRieXRlYmFzZS5jb20vUHJvamVjdBIqCgdyZWxlYXNlGAIgASgLMhQuYnl0ZWJhc2UudjEuUmVsZWFzZUID4EECEg8KB3RhcmdldHMYAyADKAkSFAoMY3VzdG9tX3J1bGVzGAQgASgJIrACChRDaGVja1JlbGVhc2VSZXNwb25zZRI+CgdyZXN1bHRzGAEgAygLMi0uYnl0ZWJhc2UudjEuQ2hlY2tSZWxlYXNlUmVzcG9uc2UuQ2hlY2tSZXN1bHQSFQoNYWZmZWN0ZWRfcm93cxgCIAEoAxIqCgpyaXNrX2xldmVsGAMgASgOMhYuYnl0ZWJhc2UudjEuUmlza0xldmVsGpQBCgtDaGVja1Jlc3VsdBIMCgRmaWxlGAEgASgJEg4KBnRhcmdldBgCIAEoCRIkCgdhZHZpY2VzGAMgAygLMhMuYnl0ZWJhc2UudjEuQWR2aWNlEhUKDWFmZmVjdGVkX3Jvd3MYBCABKAMSKgoKcmlza19sZXZlbBgFIAEoDjIWLmJ5dGViYXNlLnYxLlJpc2tMZXZlbCJMChxMaXN0UmVsZWFzZUNhdGVnb3JpZXNSZXF1ZXN0EiwKBnBhcmVudBgBIAEoCUIc4EEC+kEWChRieXRlYmFzZS5jb20vUHJvamVjdCIzCh1MaXN0UmVsZWFzZUNhdGVnb3JpZXNSZXNwb25zZRISCgpjYXRlZ29yaWVzGAEgAygJIoQFCgdSZWxlYXNlEhEKBG5hbWUYASABKAlCA+BBAxIQCghjYXRlZ29yeRgCIAEoCRIoCgVmaWxlcxgDIAMoCzIZLmJ5dGViYXNlLnYxLlJlbGVhc2UuRmlsZRIyCgp2Y3Nfc291cmNlGAQgASgLMh4uYnl0ZWJhc2UudjEuUmVsZWFzZS5WQ1NTb3VyY2USFAoHY3JlYXRvchgFIAEoCUID4EEDEjQKC2NyZWF0ZV90aW1lGAYgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcEID4EEDEiYKBXN0YXRlGAcgASgOMhIuYnl0ZWJhc2UudjEuU3RhdGVCA+BBAxInCgR0eXBlGAggASgOMhkuYnl0ZWJhc2UudjEuUmVsZWFzZS5UeXBlGpYBCgRGaWxlEgwKBHBhdGgYAiABKAkSDwoHdmVyc2lvbhgGIAEoCRIUCgxlbmFibGVfZ2hvc3QYCSABKAgSJgoFc2hlZXQYAyABKAlCF/pBFAoSYnl0ZWJhc2UuY29tL1NoZWV0EhYKCXN0YXRlbWVudBgHIAEoDEID4EEEEhkKDHNoZWV0X3NoYTI1NhgEIAEoCUID4EEDGkAKCVZDU1NvdXJjZRImCgh2Y3NfdHlwZRgBIAEoDjIULmJ5dGViYXNlLnYxLlZDU1R5cGUSCwoDdXJsGAIgASgJIjwKBFR5cGUSFAoQVFlQRV9VTlNQRUNJRklFRBAAEg0KCVZFUlNJT05FRBABEg8KC0RFQ0xBUkFUSVZFEAI6QOpBPQoUYnl0ZWJhc2UuY29tL1JlbGVhc2USJXByb2plY3RzL3twcm9qZWN0fS9yZWxlYXNlcy97cmVsZWFzZX0ywAoKDlJlbGVhc2VTZXJ2aWNlEooBCgpHZXRSZWxlYXNlEh4uYnl0ZWJhc2UudjEuR2V0UmVsZWFzZVJlcXVlc3QaFC5ieXRlYmFzZS52MS5SZWxlYXNlIkbaQQRuYW1liuowD2JiLnJlbGVhc2VzLmdldJDqMAGC0+STAiISIC92MS97bmFtZT1wcm9qZWN0cy8qL3JlbGVhc2VzLyp9Ep4BCgxMaXN0UmVsZWFzZXMSIC5ieXRlYmFzZS52MS5MaXN0UmVsZWFzZXNSZXF1ZXN0GiEuYnl0ZWJhc2UudjEuTGlzdFJlbGVhc2VzUmVzcG9uc2UiSdpBBnBhcmVudIrqMBBiYi5yZWxlYXNlcy5saXN0kOowAYLT5JMCIhIgL3YxL3twYXJlbnQ9cHJvamVjdHMvKn0vcmVsZWFzZXMSpgEKDUNyZWF0ZVJlbGVhc2USIS5ieXRlYmFzZS52MS5DcmVhdGVSZWxlYXNlUmVxdWVzdBoULmJ5dGViYXNlLnYxLlJlbGVhc2UiXNpBDnBhcmVudCxyZWxlYXNliuowEmJiLnJlbGVhc2VzLmNyZWF0ZZDqMAGC0+STAis6B3JlbGVhc2UiIC92MS97cGFyZW50PXByb2plY3RzLyp9L3JlbGVhc2VzErMBCg1VcGRhdGVSZWxlYXNlEiEuYnl0ZWJhc2UudjEuVXBkYXRlUmVsZWFzZVJlcXVlc3QaFC5ieXRlYmFzZS52MS5SZWxlYXNlImnaQRNyZWxlYXNlLHVwZGF0ZV9tYXNriuowEmJiLnJlbGVhc2VzLnVwZGF0ZZDqMAGC0+STAjM6B3JlbGVhc2UyKC92MS97cmVsZWFzZS5uYW1lPXByb2plY3RzLyovcmVsZWFzZXMvKn0SlQEKDURlbGV0ZVJlbGVhc2USIS5ieXRlYmFzZS52MS5EZWxldGVSZWxlYXNlUmVxdWVzdBoWLmdvb2dsZS5wcm90b2J1Zi5FbXB0eSJJ2kEEbmFtZYrqMBJiYi5yZWxlYXNlcy5kZWxldGWQ6jABgtPkkwIiKiAvdjEve25hbWU9cHJvamVjdHMvKi9yZWxlYXNlcy8qfRKbAQoPVW5kZWxldGVSZWxlYXNlEiMuYnl0ZWJhc2UudjEuVW5kZWxldGVSZWxlYXNlUmVxdWVzdBoULmJ5dGViYXNlLnYxLlJlbGVhc2UiTYrqMBRiYi5yZWxlYXNlcy51bmRlbGV0ZZDqMAGC0+STAisiKS92MS97bmFtZT1wcm9qZWN0cy8qL3JlbGVhc2VzLyp9OnVuZGVsZXRlEp8BCgxDaGVja1JlbGVhc2USIC5ieXRlYmFzZS52MS5DaGVja1JlbGVhc2VSZXF1ZXN0GiEuYnl0ZWJhc2UudjEuQ2hlY2tSZWxlYXNlUmVzcG9uc2UiSorqMBFiYi5yZWxlYXNlcy5jaGVja5DqMAGC0+STAis6ASoiJi92MS97cGFyZW50PXByb2plY3RzLyp9L3JlbGVhc2VzOmNoZWNrEsgBChVMaXN0UmVsZWFzZUNhdGVnb3JpZXMSKS5ieXRlYmFzZS52MS5MaXN0UmVsZWFzZUNhdGVnb3JpZXNSZXF1ZXN0GiouYnl0ZWJhc2UudjEuTGlzdFJlbGVhc2VDYXRlZ29yaWVzUmVzcG9uc2UiWNpBBnBhcmVudIrqMBBiYi5yZWxlYXNlcy5saXN0kOowAYLT5JMCMRIvL3YxL3twYXJlbnQ9cHJvamVjdHMvKn0vcmVsZWFzZXM6bGlzdENhdGVnb3JpZXNCqQEKD2NvbS5ieXRlYmFzZS52MUITUmVsZWFzZVNlcnZpY2VQcm90b1ABWjRnaXRodWIuY29tL2J5dGViYXNlL2J5dGViYXNlL2JhY2tlbmQvZ2VuZXJhdGVkLWdvL3YxogIDQlhYqgILQnl0ZWJhc2UuVjHKAgtCeXRlYmFzZVxWMeICF0J5dGViYXNlXFYxXEdQQk1ldGFkYXRh6gIMQnl0ZWJhc2U6OlYxYgZwcm90bzM", [file_google_api_annotations, file_google_api_client, file_google_api_field_behavior, file_google_api_resource, file_google_protobuf_empty, file_google_protobuf_field_mask, file_google_protobuf_timestamp, file_v1_annotation, file_v1_common, file_v1_sql_service]);
/**
* Describes the message bytebase.v1.GetReleaseRequest.
diff --git a/proto/gen/grpc-doc/openapi.yaml b/proto/gen/grpc-doc/openapi.yaml
index 7308ed1ceb..17ccc8a3ff 100644
--- a/proto/gen/grpc-doc/openapi.yaml
+++ b/proto/gen/grpc-doc/openapi.yaml
@@ -7469,17 +7469,34 @@ paths:
required: true
schema:
type: string
- - name: train
+ - name: releaseIdTemplate
in: query
description: |-
- Train for iteration tracking (template rendered without {iteration}).
- Used to group releases and determine the next iteration number.
+ Template for release ID generation.
+ Available variables: {date}, {time}, {timestamp}, {iteration}.
+ Example: "release_{date}-RC{iteration}" generates "release_20260119-RC00".
+ Default: "release_{date}-RC{iteration}".
schema:
type: string
- title: train
+ title: release_id_template
description: |-
- Train for iteration tracking (template rendered without {iteration}).
- Used to group releases and determine the next iteration number.
+ Template for release ID generation.
+ Available variables: {date}, {time}, {timestamp}, {iteration}.
+ Example: "release_{date}-RC{iteration}" generates "release_20260119-RC00".
+ Default: "release_{date}-RC{iteration}".
+ - name: releaseIdTimezone
+ in: query
+ description: |-
+ Timezone for {date} and {time} variables in the template.
+ Must be a valid IANA timezone (e.g., "UTC", "America/Los_Angeles").
+ Default: "UTC".
+ schema:
+ type: string
+ title: release_id_timezone
+ description: |-
+ Timezone for {date} and {time} variables in the template.
+ Must be a valid IANA timezone (e.g., "UTC", "America/Los_Angeles").
+ Default: "UTC".
requestBody:
description: The release to create.
content:
@@ -11736,12 +11753,21 @@ components:
title: release
description: The release to create.
$ref: '#/components/schemas/bytebase.v1.Release'
- train:
+ releaseIdTemplate:
+ type: string
+ title: release_id_template
+ description: |-
+ Template for release ID generation.
+ Available variables: {date}, {time}, {timestamp}, {iteration}.
+ Example: "release_{date}-RC{iteration}" generates "release_20260119-RC00".
+ Default: "release_{date}-RC{iteration}".
+ releaseIdTimezone:
type: string
- title: train
+ title: release_id_timezone
description: |-
- Train for iteration tracking (template rendered without {iteration}).
- Used to group releases and determine the next iteration number.
+ Timezone for {date} and {time} variables in the template.
+ Must be a valid IANA timezone (e.g., "UTC", "America/Los_Angeles").
+ Default: "UTC".
title: CreateReleaseRequest
required:
- parent
diff --git a/proto/gen/grpc-doc/v1/README.md b/proto/gen/grpc-doc/v1/README.md
index 8105f70cb2..1718238c52 100644
--- a/proto/gen/grpc-doc/v1/README.md
+++ b/proto/gen/grpc-doc/v1/README.md
@@ -8354,7 +8354,8 @@ Check result for a single release file on a target database.
| ----- | ---- | ----- | ----------- |
| parent | [string](#string) | | Format: projects/{project} |
| release | [Release](#bytebase-v1-Release) | | The release to create. |
-| train | [string](#string) | | Train for iteration tracking (template rendered without {iteration}). Used to group releases and determine the next iteration number. |
+| release_id_template | [string](#string) | | Template for release ID generation. Available variables: {date}, {time}, {timestamp}, {iteration}. Example: &#34;release_{date}-RC{iteration}&#34; generates &#34;release_20260119-RC00&#34;. Default: &#34;release_{date}-RC{iteration}&#34;. |
+| release_id_timezone | [string](#string) | | Timezone for {date} and {time} variables in the template. Must be a valid IANA timezone (e.g., &#34;UTC&#34;, &#34;America/Los_Angeles&#34;). Default: &#34;UTC&#34;. |
diff --git a/proto/gen/grpc-doc/v1/index.html b/proto/gen/grpc-doc/v1/index.html
index bab7c00c1d..4b265199fb 100644
--- a/proto/gen/grpc-doc/v1/index.html
+++ b/proto/gen/grpc-doc/v1/index.html
@@ -23651,11 +23651,22 @@ Should be a database. Format: instances/{instance}/databases/{database} </p></td
</tr>
<tr>
- <td>train</td>
+ <td>release_id_template</td>
<td><a href="#string">string</a></td>
<td></td>
- <td><p>Train for iteration tracking (template rendered without {iteration}).
-Used to group releases and determine the next iteration number. </p></td>
+ <td><p>Template for release ID generation.
+Available variables: {date}, {time}, {timestamp}, {iteration}.
+Example: &#34;release_{date}-RC{iteration}&#34; generates &#34;release_20260119-RC00&#34;.
+Default: &#34;release_{date}-RC{iteration}&#34;. </p></td>
+ </tr>
+
+ <tr>
+ <td>release_id_timezone</td>
+ <td><a href="#string">string</a></td>
+ <td></td>
+ <td><p>Timezone for {date} and {time} variables in the template.
+Must be a valid IANA timezone (e.g., &#34;UTC&#34;, &#34;America/Los_Angeles&#34;).
+Default: &#34;UTC&#34;. </p></td>
</tr>
</tbody>
diff --git a/proto/v1/v1/release_service.proto b/proto/v1/v1/release_service.proto
index fba66d4fcf..91b451f32c 100644
--- a/proto/v1/v1/release_service.proto
+++ b/proto/v1/v1/release_service.proto
@@ -158,9 +158,16 @@ message CreateReleaseRequest {
// The release to create.
Release release = 2 [(google.api.field_behavior) = REQUIRED];
- // Train for iteration tracking (template rendered without {iteration}).
- // Used to group releases and determine the next iteration number.
- string train = 3;
+ // Template for release ID generation.
+ // Available variables: {date}, {time}, {timestamp}, {iteration}.
+ // Example: "release_{date}-RC{iteration}" generates "release_20260119-RC00".
+ // Default: "release_{date}-RC{iteration}".
+ string release_id_template = 3;
+
+ // Timezone for {date} and {time} variables in the template.
+ // Must be a valid IANA timezone (e.g., "UTC", "America/Los_Angeles").
+ // Default: "UTC".
+ string release_id_timezone = 4;
}
message UpdateReleaseRequest {