Skip to content

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

feat: add category filter for releases (#18948)

Danny Xu76db3ba7b7d2
diff --git a/backend/api/mcp/gen/openapi.yaml b/backend/api/mcp/gen/openapi.yaml
index 743e503bba..29cf7ca72e 100644
--- a/backend/api/mcp/gen/openapi.yaml
+++ b/backend/api/mcp/gen/openapi.yaml
@@ -3883,6 +3883,44 @@ paths:
application/json:
schema:
$ref: '#/components/schemas/bytebase.v1.Release'
+ /bytebase.v1.ReleaseService/ListReleaseCategories:
+ post:
+ tags:
+ - bytebase.v1.ReleaseService
+ summary: 'Lists all unique categories in a project. Permissions required: bb.releases.list'
+ description: |-
+ Lists all unique categories in a project.
+ Permissions required: bb.releases.list
+ operationId: bytebase.v1.ReleaseService.ListReleaseCategories
+ parameters:
+ - name: Connect-Protocol-Version
+ in: header
+ required: true
+ schema:
+ $ref: '#/components/schemas/connect-protocol-version'
+ - name: Connect-Timeout-Ms
+ in: header
+ schema:
+ $ref: '#/components/schemas/connect-timeout-header'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/bytebase.v1.ListReleaseCategoriesRequest'
+ required: true
+ responses:
+ default:
+ description: Error
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/connect.error'
+ "200":
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/bytebase.v1.ListReleaseCategoriesResponse'
/bytebase.v1.ReleaseService/ListReleases:
post:
tags:
@@ -11623,6 +11661,26 @@ components:
If this field is omitted, there are no subsequent pages.
title: ListProjectsResponse
additionalProperties: false
+ bytebase.v1.ListReleaseCategoriesRequest:
+ type: object
+ properties:
+ parent:
+ type: string
+ title: parent
+ description: 'Format: projects/{project}'
+ title: ListReleaseCategoriesRequest
+ additionalProperties: false
+ bytebase.v1.ListReleaseCategoriesResponse:
+ type: object
+ properties:
+ categories:
+ type: array
+ items:
+ type: string
+ title: categories
+ description: The unique category values in the project.
+ title: ListReleaseCategoriesResponse
+ additionalProperties: false
bytebase.v1.ListReleasesRequest:
type: object
properties:
@@ -11651,6 +11709,18 @@ components:
type: boolean
title: show_deleted
description: Show deleted releases if specified.
+ filter:
+ type: string
+ title: filter
+ description: |-
+ Filter is used to filter releases returned in the list.
+ The syntax and semantics of CEL are documented at https://github.com/google/cel-spec
+
+ Supported filters:
+ - category: release category, support "==" operator.
+
+ For example:
+ category == "webapp"
title: ListReleasesRequest
additionalProperties: false
bytebase.v1.ListReleasesResponse:
@@ -13657,6 +13727,12 @@ components:
type: string
title: name
description: 'Format: projects/{project}/releases/{release}'
+ category:
+ type: string
+ title: category
+ description: |-
+ Category extracted from release name (e.g., "webapp", "analytics").
+ Set by Bytebase action during release creation.
files:
type: array
items:
diff --git a/backend/api/v1/release_service.go b/backend/api/v1/release_service.go
index e59fe1f1f8..c61dc4afa4 100644
--- a/backend/api/v1/release_service.go
+++ b/backend/api/v1/release_service.go
@@ -7,6 +7,9 @@ import (
"slices"
"connectrpc.com/connect"
+ "github.com/google/cel-go/cel"
+ celast "github.com/google/cel-go/common/ast"
+ celoperators "github.com/google/cel-go/common/operators"
"github.com/pkg/errors"
"google.golang.org/protobuf/types/known/emptypb"
"google.golang.org/protobuf/types/known/timestamppb"
@@ -101,6 +104,7 @@ func (s *ReleaseService) CreateRelease(ctx context.Context, req *connect.Request
releaseMessage := &store.ReleaseMessage{
ProjectID: project.ResourceID,
Train: req.Msg.Train,
+ Category: req.Msg.Release.Category,
Payload: &storepb.ReleasePayload{
VcsSource: convertReleaseVcsSource(req.Msg.Release.VcsSource),
Type: storepb.SchemaChangeType(req.Msg.Release.Type),
@@ -194,6 +198,17 @@ func (s *ReleaseService) ListReleases(ctx context.Context, req *connect.Request[
ShowDeleted: req.Msg.ShowDeleted,
}
+ // Parse filter for category
+ if req.Msg.Filter != "" {
+ category, err := parseCategoryFilter(req.Msg.Filter)
+ if err != nil {
+ return nil, connect.NewError(connect.CodeInvalidArgument, errors.Wrapf(err, "invalid filter"))
+ }
+ if category != "" {
+ releaseFind.Category = &category
+ }
+ }
+
releaseMessages, err := s.store.ListReleases(ctx, releaseFind)
if err != nil {
return nil, connect.NewError(connect.CodeInternal, errors.Wrapf(err, "failed to list releases"))
@@ -284,6 +299,7 @@ func convertToReleases(releases []*store.ReleaseMessage) []*v1pb.Release {
func convertToRelease(release *store.ReleaseMessage) *v1pb.Release {
r := &v1pb.Release{
Name: common.FormatReleaseName(release.ProjectID, release.ReleaseID),
+ Category: release.Category,
Creator: common.FormatUserEmail(release.Creator),
CreateTime: timestamppb.New(release.At),
VcsSource: convertToReleaseVcsSource(release.Payload.VcsSource),
@@ -417,3 +433,78 @@ func validateAndSanitizeReleaseFiles(ctx context.Context, s *store.Store, files
}
}), nil
}
+
+func (s *ReleaseService) ListReleaseCategories(ctx context.Context, req *connect.Request[v1pb.ListReleaseCategoriesRequest]) (*connect.Response[v1pb.ListReleaseCategoriesResponse], error) {
+ projectID, err := common.GetProjectID(req.Msg.Parent)
+ if err != nil {
+ return nil, connect.NewError(connect.CodeInvalidArgument, errors.Wrapf(err, "failed to get project id"))
+ }
+
+ project, err := s.store.GetProject(ctx, &store.FindProjectMessage{ResourceID: &projectID})
+ if err != nil {
+ return nil, connect.NewError(connect.CodeInternal, errors.Wrapf(err, "failed to find project"))
+ }
+ if project == nil {
+ return nil, connect.NewError(connect.CodeNotFound, errors.Errorf("project %s not found", projectID))
+ }
+
+ categories, err := s.store.ListReleaseCategories(ctx, project.ResourceID)
+ if err != nil {
+ return nil, connect.NewError(connect.CodeInternal, errors.Wrapf(err, "failed to list release categories"))
+ }
+
+ return connect.NewResponse(&v1pb.ListReleaseCategoriesResponse{
+ Categories: categories,
+ }), nil
+}
+
+// parseCategoryFilter parses CEL filter expression and extracts the category value.
+// Supports: category == "value"
+func parseCategoryFilter(filter string) (string, error) {
+ if filter == "" {
+ return "", nil
+ }
+
+ e, err := cel.NewEnv()
+ if err != nil {
+ return "", errors.Wrap(err, "failed to create CEL environment")
+ }
+
+ ast, iss := e.Parse(filter)
+ if iss != nil {
+ return "", errors.Errorf("failed to parse filter: %v", iss.String())
+ }
+
+ category, err := extractCategoryFromExpr(ast.NativeRep().Expr())
+ if err != nil {
+ return "", errors.Wrap(err, "failed to extract category")
+ }
+
+ return category, nil
+}
+
+// extractCategoryFromExpr walks the CEL AST to extract the category value.
+func extractCategoryFromExpr(expr celast.Expr) (string, error) {
+ switch expr.Kind() {
+ case celast.CallKind:
+ call := expr.AsCall()
+ functionName := call.FunctionName()
+
+ // Handle: category == "value"
+ if functionName == celoperators.Equals {
+ variable, value := getVariableAndValueFromExpr(expr)
+ if variable == "category" {
+ if categoryValue, ok := value.(string); ok {
+ return categoryValue, nil
+ }
+ return "", errors.Errorf("category value must be a string, got %T", value)
+ }
+ return "", errors.Errorf("unsupported filter variable: %s", variable)
+ }
+
+ return "", errors.Errorf("unsupported operator: %s (only '==' is supported)", functionName)
+
+ default:
+ return "", errors.Errorf("unsupported expression type")
+ }
+}
diff --git a/backend/generated-go/v1/release_service.pb.go b/backend/generated-go/v1/release_service.pb.go
index db0b66386f..ab7a6d605f 100644
--- a/backend/generated-go/v1/release_service.pb.go
+++ b/backend/generated-go/v1/release_service.pb.go
@@ -75,7 +75,7 @@ func (x Release_Type) Number() protoreflect.EnumNumber {
// Deprecated: Use Release_Type.Descriptor instead.
func (Release_Type) EnumDescriptor() ([]byte, []int) {
- return file_v1_release_service_proto_rawDescGZIP(), []int{9, 0}
+ return file_v1_release_service_proto_rawDescGZIP(), []int{11, 0}
}
type GetReleaseRequest struct {
@@ -138,7 +138,16 @@ type ListReleasesRequest struct {
// the call that provided the page token.
PageToken string `protobuf:"bytes,3,opt,name=page_token,json=pageToken,proto3" json:"page_token,omitempty"`
// Show deleted releases if specified.
- ShowDeleted bool `protobuf:"varint,4,opt,name=show_deleted,json=showDeleted,proto3" json:"show_deleted,omitempty"`
+ ShowDeleted bool `protobuf:"varint,4,opt,name=show_deleted,json=showDeleted,proto3" json:"show_deleted,omitempty"`
+ // Filter is used to filter releases returned in the list.
+ // The syntax and semantics of CEL are documented at https://github.com/google/cel-spec
+ //
+ // Supported filters:
+ // - category: release category, support "==" operator.
+ //
+ // For example:
+ // category == "webapp"
+ Filter string `protobuf:"bytes,5,opt,name=filter,proto3" json:"filter,omitempty"`
unknownFields protoimpl.UnknownFields
sizeCache protoimpl.SizeCache
}
@@ -201,6 +210,13 @@ func (x *ListReleasesRequest) GetShowDeleted() bool {
return false
}
+func (x *ListReleasesRequest) GetFilter() string {
+ if x != nil {
+ return x.Filter
+ }
+ return ""
+}
+
type ListReleasesResponse struct {
state protoimpl.MessageState `protogen:"open.v1"`
// The releases from the specified request.
@@ -608,10 +624,103 @@ func (x *CheckReleaseResponse) GetRiskLevel() RiskLevel {
return RiskLevel_RISK_LEVEL_UNSPECIFIED
}
+type ListReleaseCategoriesRequest struct {
+ state protoimpl.MessageState `protogen:"open.v1"`
+ // Format: projects/{project}
+ Parent string `protobuf:"bytes,1,opt,name=parent,proto3" json:"parent,omitempty"`
+ unknownFields protoimpl.UnknownFields
+ sizeCache protoimpl.SizeCache
+}
+
+func (x *ListReleaseCategoriesRequest) Reset() {
+ *x = ListReleaseCategoriesRequest{}
+ mi := &file_v1_release_service_proto_msgTypes[9]
+ ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+ ms.StoreMessageInfo(mi)
+}
+
+func (x *ListReleaseCategoriesRequest) String() string {
+ return protoimpl.X.MessageStringOf(x)
+}
+
+func (*ListReleaseCategoriesRequest) ProtoMessage() {}
+
+func (x *ListReleaseCategoriesRequest) ProtoReflect() protoreflect.Message {
+ mi := &file_v1_release_service_proto_msgTypes[9]
+ if x != nil {
+ ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+ if ms.LoadMessageInfo() == nil {
+ ms.StoreMessageInfo(mi)
+ }
+ return ms
+ }
+ return mi.MessageOf(x)
+}
+
+// Deprecated: Use ListReleaseCategoriesRequest.ProtoReflect.Descriptor instead.
+func (*ListReleaseCategoriesRequest) Descriptor() ([]byte, []int) {
+ return file_v1_release_service_proto_rawDescGZIP(), []int{9}
+}
+
+func (x *ListReleaseCategoriesRequest) GetParent() string {
+ if x != nil {
+ return x.Parent
+ }
+ return ""
+}
+
+type ListReleaseCategoriesResponse struct {
+ state protoimpl.MessageState `protogen:"open.v1"`
+ // The unique category values in the project.
+ Categories []string `protobuf:"bytes,1,rep,name=categories,proto3" json:"categories,omitempty"`
+ unknownFields protoimpl.UnknownFields
+ sizeCache protoimpl.SizeCache
+}
+
+func (x *ListReleaseCategoriesResponse) Reset() {
+ *x = ListReleaseCategoriesResponse{}
+ mi := &file_v1_release_service_proto_msgTypes[10]
+ ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+ ms.StoreMessageInfo(mi)
+}
+
+func (x *ListReleaseCategoriesResponse) String() string {
+ return protoimpl.X.MessageStringOf(x)
+}
+
+func (*ListReleaseCategoriesResponse) ProtoMessage() {}
+
+func (x *ListReleaseCategoriesResponse) ProtoReflect() protoreflect.Message {
+ mi := &file_v1_release_service_proto_msgTypes[10]
+ if x != nil {
+ ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+ if ms.LoadMessageInfo() == nil {
+ ms.StoreMessageInfo(mi)
+ }
+ return ms
+ }
+ return mi.MessageOf(x)
+}
+
+// Deprecated: Use ListReleaseCategoriesResponse.ProtoReflect.Descriptor instead.
+func (*ListReleaseCategoriesResponse) Descriptor() ([]byte, []int) {
+ return file_v1_release_service_proto_rawDescGZIP(), []int{10}
+}
+
+func (x *ListReleaseCategoriesResponse) GetCategories() []string {
+ if x != nil {
+ return x.Categories
+ }
+ return nil
+}
+
type Release struct {
state protoimpl.MessageState `protogen:"open.v1"`
// Format: projects/{project}/releases/{release}
Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
+ // Category extracted from release name (e.g., "webapp", "analytics").
+ // Set by Bytebase action during release creation.
+ Category string `protobuf:"bytes,2,opt,name=category,proto3" json:"category,omitempty"`
// The SQL files included in the release.
Files []*Release_File `protobuf:"bytes,3,rep,name=files,proto3" json:"files,omitempty"`
// The version control source of the release.
@@ -629,7 +738,7 @@ type Release struct {
func (x *Release) Reset() {
*x = Release{}
- mi := &file_v1_release_service_proto_msgTypes[9]
+ mi := &file_v1_release_service_proto_msgTypes[11]
ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
ms.StoreMessageInfo(mi)
}
@@ -641,7 +750,7 @@ func (x *Release) String() string {
func (*Release) ProtoMessage() {}
func (x *Release) ProtoReflect() protoreflect.Message {
- mi := &file_v1_release_service_proto_msgTypes[9]
+ mi := &file_v1_release_service_proto_msgTypes[11]
if x != nil {
ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
if ms.LoadMessageInfo() == nil {
@@ -654,7 +763,7 @@ func (x *Release) ProtoReflect() protoreflect.Message {
// Deprecated: Use Release.ProtoReflect.Descriptor instead.
func (*Release) Descriptor() ([]byte, []int) {
- return file_v1_release_service_proto_rawDescGZIP(), []int{9}
+ return file_v1_release_service_proto_rawDescGZIP(), []int{11}
}
func (x *Release) GetName() string {
@@ -664,6 +773,13 @@ func (x *Release) GetName() string {
return ""
}
+func (x *Release) GetCategory() string {
+ if x != nil {
+ return x.Category
+ }
+ return ""
+}
+
func (x *Release) GetFiles() []*Release_File {
if x != nil {
return x.Files
@@ -726,7 +842,7 @@ type CheckReleaseResponse_CheckResult struct {
func (x *CheckReleaseResponse_CheckResult) Reset() {
*x = CheckReleaseResponse_CheckResult{}
- mi := &file_v1_release_service_proto_msgTypes[10]
+ mi := &file_v1_release_service_proto_msgTypes[12]
ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
ms.StoreMessageInfo(mi)
}
@@ -738,7 +854,7 @@ func (x *CheckReleaseResponse_CheckResult) String() string {
func (*CheckReleaseResponse_CheckResult) ProtoMessage() {}
func (x *CheckReleaseResponse_CheckResult) ProtoReflect() protoreflect.Message {
- mi := &file_v1_release_service_proto_msgTypes[10]
+ mi := &file_v1_release_service_proto_msgTypes[12]
if x != nil {
ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
if ms.LoadMessageInfo() == nil {
@@ -814,7 +930,7 @@ type Release_File struct {
func (x *Release_File) Reset() {
*x = Release_File{}
- mi := &file_v1_release_service_proto_msgTypes[11]
+ mi := &file_v1_release_service_proto_msgTypes[13]
ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
ms.StoreMessageInfo(mi)
}
@@ -826,7 +942,7 @@ func (x *Release_File) String() string {
func (*Release_File) ProtoMessage() {}
func (x *Release_File) ProtoReflect() protoreflect.Message {
- mi := &file_v1_release_service_proto_msgTypes[11]
+ mi := &file_v1_release_service_proto_msgTypes[13]
if x != nil {
ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
if ms.LoadMessageInfo() == nil {
@@ -839,7 +955,7 @@ func (x *Release_File) ProtoReflect() protoreflect.Message {
// Deprecated: Use Release_File.ProtoReflect.Descriptor instead.
func (*Release_File) Descriptor() ([]byte, []int) {
- return file_v1_release_service_proto_rawDescGZIP(), []int{9, 0}
+ return file_v1_release_service_proto_rawDescGZIP(), []int{11, 0}
}
func (x *Release_File) GetPath() string {
@@ -897,7 +1013,7 @@ type Release_VCSSource struct {
func (x *Release_VCSSource) Reset() {
*x = Release_VCSSource{}
- mi := &file_v1_release_service_proto_msgTypes[12]
+ mi := &file_v1_release_service_proto_msgTypes[14]
ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
ms.StoreMessageInfo(mi)
}
@@ -909,7 +1025,7 @@ func (x *Release_VCSSource) String() string {
func (*Release_VCSSource) ProtoMessage() {}
func (x *Release_VCSSource) ProtoReflect() protoreflect.Message {
- mi := &file_v1_release_service_proto_msgTypes[12]
+ mi := &file_v1_release_service_proto_msgTypes[14]
if x != nil {
ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
if ms.LoadMessageInfo() == nil {
@@ -922,7 +1038,7 @@ func (x *Release_VCSSource) ProtoReflect() protoreflect.Message {
// Deprecated: Use Release_VCSSource.ProtoReflect.Descriptor instead.
func (*Release_VCSSource) Descriptor() ([]byte, []int) {
- return file_v1_release_service_proto_rawDescGZIP(), []int{9, 1}
+ return file_v1_release_service_proto_rawDescGZIP(), []int{11, 1}
}
func (x *Release_VCSSource) GetVcsType() VCSType {
@@ -946,14 +1062,15 @@ const file_v1_release_service_proto_rawDesc = "" +
"\x18v1/release_service.proto\x12\vbytebase.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x13v1/annotation.proto\x1a\x0fv1/common.proto\x1a\x14v1/sql_service.proto\"E\n" +
"\x11GetReleaseRequest\x120\n" +
"\x04name\x18\x01 \x01(\tB\x1c\xe0A\x02\xfaA\x16\n" +
- "\x14bytebase.com/ReleaseR\x04name\"\xaa\x01\n" +
+ "\x14bytebase.com/ReleaseR\x04name\"\xc2\x01\n" +
"\x13ListReleasesRequest\x124\n" +
"\x06parent\x18\x01 \x01(\tB\x1c\xe0A\x02\xfaA\x16\n" +
"\x14bytebase.com/ProjectR\x06parent\x12\x1b\n" +
"\tpage_size\x18\x02 \x01(\x05R\bpageSize\x12\x1d\n" +
"\n" +
"page_token\x18\x03 \x01(\tR\tpageToken\x12!\n" +
- "\fshow_deleted\x18\x04 \x01(\bR\vshowDeleted\"p\n" +
+ "\fshow_deleted\x18\x04 \x01(\bR\vshowDeleted\x12\x16\n" +
+ "\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" +
@@ -989,9 +1106,17 @@ const file_v1_release_service_proto_rawDesc = "" +
"\aadvices\x18\x03 \x03(\v2\x13.bytebase.v1.AdviceR\aadvices\x12#\n" +
"\raffected_rows\x18\x04 \x01(\x03R\faffectedRows\x125\n" +
"\n" +
- "risk_level\x18\x05 \x01(\x0e2\x16.bytebase.v1.RiskLevelR\triskLevel\"\xf5\x05\n" +
+ "risk_level\x18\x05 \x01(\x0e2\x16.bytebase.v1.RiskLevelR\triskLevel\"T\n" +
+ "\x1cListReleaseCategoriesRequest\x124\n" +
+ "\x06parent\x18\x01 \x01(\tB\x1c\xe0A\x02\xfaA\x16\n" +
+ "\x14bytebase.com/ProjectR\x06parent\"?\n" +
+ "\x1dListReleaseCategoriesResponse\x12\x1e\n" +
+ "\n" +
+ "categories\x18\x01 \x03(\tR\n" +
+ "categories\"\x91\x06\n" +
"\aRelease\x12\x17\n" +
- "\x04name\x18\x01 \x01(\tB\x03\xe0A\x03R\x04name\x12/\n" +
+ "\x04name\x18\x01 \x01(\tB\x03\xe0A\x03R\x04name\x12\x1a\n" +
+ "\bcategory\x18\x02 \x01(\tR\bcategory\x12/\n" +
"\x05files\x18\x03 \x03(\v2\x19.bytebase.v1.Release.FileR\x05files\x12=\n" +
"\n" +
"vcs_source\x18\x04 \x01(\v2\x1e.bytebase.v1.Release.VCSSourceR\tvcsSource\x12\x1d\n" +
@@ -1015,7 +1140,8 @@ const file_v1_release_service_proto_rawDesc = "" +
"\x10TYPE_UNSPECIFIED\x10\x00\x12\r\n" +
"\tVERSIONED\x10\x01\x12\x0f\n" +
"\vDECLARATIVE\x10\x02:@\xeaA=\n" +
- "\x14bytebase.com/Release\x12%projects/{project}/releases/{release}2\xf5\b\n" +
+ "\x14bytebase.com/Release\x12%projects/{project}/releases/{release}2\xc0\n" +
+ "\n" +
"\x0eReleaseService\x12\x8a\x01\n" +
"\n" +
"GetRelease\x12\x1e.bytebase.v1.GetReleaseRequest\x1a\x14.bytebase.v1.Release\"F\xdaA\x04name\x8a\xea0\x0fbb.releases.get\x90\xea0\x01\x82\xd3\xe4\x93\x02\"\x12 /v1/{name=projects/*/releases/*}\x12\x9e\x01\n" +
@@ -1024,7 +1150,8 @@ const file_v1_release_service_proto_rawDesc = "" +
"\rUpdateRelease\x12!.bytebase.v1.UpdateReleaseRequest\x1a\x14.bytebase.v1.Release\"i\xdaA\x13release,update_mask\x8a\xea0\x12bb.releases.update\x90\xea0\x01\x82\xd3\xe4\x93\x023:\arelease2(/v1/{release.name=projects/*/releases/*}\x12\x95\x01\n" +
"\rDeleteRelease\x12!.bytebase.v1.DeleteReleaseRequest\x1a\x16.google.protobuf.Empty\"I\xdaA\x04name\x8a\xea0\x12bb.releases.delete\x90\xea0\x01\x82\xd3\xe4\x93\x02\"* /v1/{name=projects/*/releases/*}\x12\x9b\x01\n" +
"\x0fUndeleteRelease\x12#.bytebase.v1.UndeleteReleaseRequest\x1a\x14.bytebase.v1.Release\"M\x8a\xea0\x14bb.releases.undelete\x90\xea0\x01\x82\xd3\xe4\x93\x02+\")/v1/{name=projects/*/releases/*}:undelete\x12\x9f\x01\n" +
- "\fCheckRelease\x12 .bytebase.v1.CheckReleaseRequest\x1a!.bytebase.v1.CheckReleaseResponse\"J\x8a\xea0\x11bb.releases.check\x90\xea0\x01\x82\xd3\xe4\x93\x02+:\x01*\"&/v1/{parent=projects/*}/releases:checkB\xa9\x01\n" +
+ "\fCheckRelease\x12 .bytebase.v1.CheckReleaseRequest\x1a!.bytebase.v1.CheckReleaseResponse\"J\x8a\xea0\x11bb.releases.check\x90\xea0\x01\x82\xd3\xe4\x93\x02+:\x01*\"&/v1/{parent=projects/*}/releases:check\x12\xc8\x01\n" +
+ "\x15ListReleaseCategories\x12).bytebase.v1.ListReleaseCategoriesRequest\x1a*.bytebase.v1.ListReleaseCategoriesResponse\"X\xdaA\x06parent\x8a\xea0\x10bb.releases.list\x90\xea0\x01\x82\xd3\xe4\x93\x021\x12//v1/{parent=projects/*}/releases:listCategoriesB\xa9\x01\n" +
"\x0fcom.bytebase.v1B\x13ReleaseServiceProtoP\x01Z4github.com/bytebase/bytebase/backend/generated-go/v1\xa2\x02\x03BXX\xaa\x02\vBytebase.V1\xca\x02\vBytebase\\V1\xe2\x02\x17Bytebase\\V1\\GPBMetadata\xea\x02\fBytebase::V1b\x06proto3"
var (
@@ -1040,7 +1167,7 @@ func file_v1_release_service_proto_rawDescGZIP() []byte {
}
var file_v1_release_service_proto_enumTypes = make([]protoimpl.EnumInfo, 1)
-var file_v1_release_service_proto_msgTypes = make([]protoimpl.MessageInfo, 13)
+var file_v1_release_service_proto_msgTypes = make([]protoimpl.MessageInfo, 15)
var file_v1_release_service_proto_goTypes = []any{
(Release_Type)(0), // 0: bytebase.v1.Release.Type
(*GetReleaseRequest)(nil), // 1: bytebase.v1.GetReleaseRequest
@@ -1052,34 +1179,36 @@ var file_v1_release_service_proto_goTypes = []any{
(*UndeleteReleaseRequest)(nil), // 7: bytebase.v1.UndeleteReleaseRequest
(*CheckReleaseRequest)(nil), // 8: bytebase.v1.CheckReleaseRequest
(*CheckReleaseResponse)(nil), // 9: bytebase.v1.CheckReleaseResponse
- (*Release)(nil), // 10: bytebase.v1.Release
- (*CheckReleaseResponse_CheckResult)(nil), // 11: bytebase.v1.CheckReleaseResponse.CheckResult
- (*Release_File)(nil), // 12: bytebase.v1.Release.File
- (*Release_VCSSource)(nil), // 13: bytebase.v1.Release.VCSSource
- (*fieldmaskpb.FieldMask)(nil), // 14: google.protobuf.FieldMask
- (RiskLevel)(0), // 15: bytebase.v1.RiskLevel
- (*timestamppb.Timestamp)(nil), // 16: google.protobuf.Timestamp
- (State)(0), // 17: bytebase.v1.State
- (*Advice)(nil), // 18: bytebase.v1.Advice
- (VCSType)(0), // 19: bytebase.v1.VCSType
- (*emptypb.Empty)(nil), // 20: google.protobuf.Empty
+ (*ListReleaseCategoriesRequest)(nil), // 10: bytebase.v1.ListReleaseCategoriesRequest
+ (*ListReleaseCategoriesResponse)(nil), // 11: bytebase.v1.ListReleaseCategoriesResponse
+ (*Release)(nil), // 12: bytebase.v1.Release
+ (*CheckReleaseResponse_CheckResult)(nil), // 13: bytebase.v1.CheckReleaseResponse.CheckResult
+ (*Release_File)(nil), // 14: bytebase.v1.Release.File
+ (*Release_VCSSource)(nil), // 15: bytebase.v1.Release.VCSSource
+ (*fieldmaskpb.FieldMask)(nil), // 16: google.protobuf.FieldMask
+ (RiskLevel)(0), // 17: bytebase.v1.RiskLevel
+ (*timestamppb.Timestamp)(nil), // 18: google.protobuf.Timestamp
+ (State)(0), // 19: bytebase.v1.State
+ (*Advice)(nil), // 20: bytebase.v1.Advice
+ (VCSType)(0), // 21: bytebase.v1.VCSType
+ (*emptypb.Empty)(nil), // 22: google.protobuf.Empty
}
var file_v1_release_service_proto_depIdxs = []int32{
- 10, // 0: bytebase.v1.ListReleasesResponse.releases:type_name -> bytebase.v1.Release
- 10, // 1: bytebase.v1.CreateReleaseRequest.release:type_name -> bytebase.v1.Release
- 10, // 2: bytebase.v1.UpdateReleaseRequest.release:type_name -> bytebase.v1.Release
- 14, // 3: bytebase.v1.UpdateReleaseRequest.update_mask:type_name -> google.protobuf.FieldMask
- 10, // 4: bytebase.v1.CheckReleaseRequest.release:type_name -> bytebase.v1.Release
- 11, // 5: bytebase.v1.CheckReleaseResponse.results:type_name -> bytebase.v1.CheckReleaseResponse.CheckResult
- 15, // 6: bytebase.v1.CheckReleaseResponse.risk_level:type_name -> bytebase.v1.RiskLevel
- 12, // 7: bytebase.v1.Release.files:type_name -> bytebase.v1.Release.File
- 13, // 8: bytebase.v1.Release.vcs_source:type_name -> bytebase.v1.Release.VCSSource
- 16, // 9: bytebase.v1.Release.create_time:type_name -> google.protobuf.Timestamp
- 17, // 10: bytebase.v1.Release.state:type_name -> bytebase.v1.State
+ 12, // 0: bytebase.v1.ListReleasesResponse.releases:type_name -> bytebase.v1.Release
+ 12, // 1: bytebase.v1.CreateReleaseRequest.release:type_name -> bytebase.v1.Release
+ 12, // 2: bytebase.v1.UpdateReleaseRequest.release:type_name -> bytebase.v1.Release
+ 16, // 3: bytebase.v1.UpdateReleaseRequest.update_mask:type_name -> google.protobuf.FieldMask
+ 12, // 4: bytebase.v1.CheckReleaseRequest.release:type_name -> bytebase.v1.Release
+ 13, // 5: bytebase.v1.CheckReleaseResponse.results:type_name -> bytebase.v1.CheckReleaseResponse.CheckResult
+ 17, // 6: bytebase.v1.CheckReleaseResponse.risk_level:type_name -> bytebase.v1.RiskLevel
+ 14, // 7: bytebase.v1.Release.files:type_name -> bytebase.v1.Release.File
+ 15, // 8: bytebase.v1.Release.vcs_source:type_name -> bytebase.v1.Release.VCSSource
+ 18, // 9: bytebase.v1.Release.create_time:type_name -> google.protobuf.Timestamp
+ 19, // 10: bytebase.v1.Release.state:type_name -> bytebase.v1.State
0, // 11: bytebase.v1.Release.type:type_name -> bytebase.v1.Release.Type
- 18, // 12: bytebase.v1.CheckReleaseResponse.CheckResult.advices:type_name -> bytebase.v1.Advice
- 15, // 13: bytebase.v1.CheckReleaseResponse.CheckResult.risk_level:type_name -> bytebase.v1.RiskLevel
- 19, // 14: bytebase.v1.Release.VCSSource.vcs_type:type_name -> bytebase.v1.VCSType
+ 20, // 12: bytebase.v1.CheckReleaseResponse.CheckResult.advices:type_name -> bytebase.v1.Advice
+ 17, // 13: bytebase.v1.CheckReleaseResponse.CheckResult.risk_level:type_name -> bytebase.v1.RiskLevel
+ 21, // 14: bytebase.v1.Release.VCSSource.vcs_type:type_name -> bytebase.v1.VCSType
1, // 15: bytebase.v1.ReleaseService.GetRelease:input_type -> bytebase.v1.GetReleaseRequest
2, // 16: bytebase.v1.ReleaseService.ListReleases:input_type -> bytebase.v1.ListReleasesRequest
4, // 17: bytebase.v1.ReleaseService.CreateRelease:input_type -> bytebase.v1.CreateReleaseRequest
@@ -1087,15 +1216,17 @@ var file_v1_release_service_proto_depIdxs = []int32{
6, // 19: bytebase.v1.ReleaseService.DeleteRelease:input_type -> bytebase.v1.DeleteReleaseRequest
7, // 20: bytebase.v1.ReleaseService.UndeleteRelease:input_type -> bytebase.v1.UndeleteReleaseRequest
8, // 21: bytebase.v1.ReleaseService.CheckRelease:input_type -> bytebase.v1.CheckReleaseRequest
- 10, // 22: bytebase.v1.ReleaseService.GetRelease:output_type -> bytebase.v1.Release
- 3, // 23: bytebase.v1.ReleaseService.ListReleases:output_type -> bytebase.v1.ListReleasesResponse
- 10, // 24: bytebase.v1.ReleaseService.CreateRelease:output_type -> bytebase.v1.Release
- 10, // 25: bytebase.v1.ReleaseService.UpdateRelease:output_type -> bytebase.v1.Release
- 20, // 26: bytebase.v1.ReleaseService.DeleteRelease:output_type -> google.protobuf.Empty
- 10, // 27: bytebase.v1.ReleaseService.UndeleteRelease:output_type -> bytebase.v1.Release
- 9, // 28: bytebase.v1.ReleaseService.CheckRelease:output_type -> bytebase.v1.CheckReleaseResponse
- 22, // [22:29] is the sub-list for method output_type
- 15, // [15:22] is the sub-list for method input_type
+ 10, // 22: bytebase.v1.ReleaseService.ListReleaseCategories:input_type -> bytebase.v1.ListReleaseCategoriesRequest
+ 12, // 23: bytebase.v1.ReleaseService.GetRelease:output_type -> bytebase.v1.Release
+ 3, // 24: bytebase.v1.ReleaseService.ListReleases:output_type -> bytebase.v1.ListReleasesResponse
+ 12, // 25: bytebase.v1.ReleaseService.CreateRelease:output_type -> bytebase.v1.Release
+ 12, // 26: bytebase.v1.ReleaseService.UpdateRelease:output_type -> bytebase.v1.Release
+ 22, // 27: bytebase.v1.ReleaseService.DeleteRelease:output_type -> google.protobuf.Empty
+ 12, // 28: bytebase.v1.ReleaseService.UndeleteRelease:output_type -> bytebase.v1.Release
+ 9, // 29: bytebase.v1.ReleaseService.CheckRelease:output_type -> bytebase.v1.CheckReleaseResponse
+ 11, // 30: bytebase.v1.ReleaseService.ListReleaseCategories:output_type -> bytebase.v1.ListReleaseCategoriesResponse
+ 23, // [23:31] is the sub-list for method output_type
+ 15, // [15:23] is the sub-list for method input_type
15, // [15:15] is the sub-list for extension type_name
15, // [15:15] is the sub-list for extension extendee
0, // [0:15] is the sub-list for field type_name
@@ -1115,7 +1246,7 @@ func file_v1_release_service_proto_init() {
GoPackagePath: reflect.TypeOf(x{}).PkgPath(),
RawDescriptor: unsafe.Slice(unsafe.StringData(file_v1_release_service_proto_rawDesc), len(file_v1_release_service_proto_rawDesc)),
NumEnums: 1,
- NumMessages: 13,
+ NumMessages: 15,
NumExtensions: 0,
NumServices: 1,
},
diff --git a/backend/generated-go/v1/release_service.pb.gw.go b/backend/generated-go/v1/release_service.pb.gw.go
index 4d5f1b3da9..21c7040bf7 100644
--- a/backend/generated-go/v1/release_service.pb.gw.go
+++ b/backend/generated-go/v1/release_service.pb.gw.go
@@ -390,6 +390,45 @@ func local_request_ReleaseService_CheckRelease_0(ctx context.Context, marshaler
return msg, metadata, err
}
+func request_ReleaseService_ListReleaseCategories_0(ctx context.Context, marshaler runtime.Marshaler, client ReleaseServiceClient, req *http.Request, pathParams map[string]string) (proto.Message, runtime.ServerMetadata, error) {
+ var (
+ protoReq ListReleaseCategoriesRequest
+ metadata runtime.ServerMetadata
+ err error
+ )
+ if req.Body != nil {
+ _, _ = io.Copy(io.Discard, req.Body)
+ }
+ val, ok := pathParams["parent"]
+ if !ok {
+ return nil, metadata, status.Errorf(codes.InvalidArgument, "missing parameter %s", "parent")
+ }
+ protoReq.Parent, err = runtime.String(val)
+ if err != nil {
+ return nil, metadata, status.Errorf(codes.InvalidArgument, "type mismatch, parameter: %s, error: %v", "parent", err)
+ }
+ msg, err := client.ListReleaseCategories(ctx, &protoReq, grpc.Header(&metadata.HeaderMD), grpc.Trailer(&metadata.TrailerMD))
+ return msg, metadata, err
+}
+
+func local_request_ReleaseService_ListReleaseCategories_0(ctx context.Context, marshaler runtime.Marshaler, server ReleaseServiceServer, req *http.Request, pathParams map[string]string) (proto.Message, runtime.ServerMetadata, error) {
+ var (
+ protoReq ListReleaseCategoriesRequest
+ metadata runtime.ServerMetadata
+ err error
+ )
+ val, ok := pathParams["parent"]
+ if !ok {
+ return nil, metadata, status.Errorf(codes.InvalidArgument, "missing parameter %s", "parent")
+ }
+ protoReq.Parent, err = runtime.String(val)
+ if err != nil {
+ return nil, metadata, status.Errorf(codes.InvalidArgument, "type mismatch, parameter: %s, error: %v", "parent", err)
+ }
+ msg, err := server.ListReleaseCategories(ctx, &protoReq)
+ return msg, metadata, err
+}
+
// RegisterReleaseServiceHandlerServer registers the http handlers for service ReleaseService to "mux".
// UnaryRPC :call ReleaseServiceServer directly.
// StreamingRPC :currently unsupported pending https://github.com/grpc/grpc-go/issues/906.
@@ -536,6 +575,26 @@ func RegisterReleaseServiceHandlerServer(ctx context.Context, mux *runtime.Serve
}
forward_ReleaseService_CheckRelease_0(annotatedContext, mux, outboundMarshaler, w, req, resp, mux.GetForwardResponseOptions()...)
})
+ mux.Handle(http.MethodGet, pattern_ReleaseService_ListReleaseCategories_0, func(w http.ResponseWriter, req *http.Request, pathParams map[string]string) {
+ ctx, cancel := context.WithCancel(req.Context())
+ defer cancel()
+ var stream runtime.ServerTransportStream
+ ctx = grpc.NewContextWithServerTransportStream(ctx, &stream)
+ inboundMarshaler, outboundMarshaler := runtime.MarshalerForRequest(mux, req)
+ annotatedContext, err := runtime.AnnotateIncomingContext(ctx, mux, req, "/bytebase.v1.ReleaseService/ListReleaseCategories", runtime.WithHTTPPathPattern("/v1/{parent=projects/*}/releases:listCategories"))
+ if err != nil {
+ runtime.HTTPError(ctx, mux, outboundMarshaler, w, req, err)
+ return
+ }
+ resp, md, err := local_request_ReleaseService_ListReleaseCategories_0(annotatedContext, inboundMarshaler, server, req, pathParams)
+ md.HeaderMD, md.TrailerMD = metadata.Join(md.HeaderMD, stream.Header()), metadata.Join(md.TrailerMD, stream.Trailer())
+ annotatedContext = runtime.NewServerMetadataContext(annotatedContext, md)
+ if err != nil {
+ runtime.HTTPError(annotatedContext, mux, outboundMarshaler, w, req, err)
+ return
+ }
+ forward_ReleaseService_ListReleaseCategories_0(annotatedContext, mux, outboundMarshaler, w, req, resp, mux.GetForwardResponseOptions()...)
+ })
return nil
}
@@ -695,25 +754,44 @@ func RegisterReleaseServiceHandlerClient(ctx context.Context, mux *runtime.Serve
}
forward_ReleaseService_CheckRelease_0(annotatedContext, mux, outboundMarshaler, w, req, resp, mux.GetForwardResponseOptions()...)
})
+ mux.Handle(http.MethodGet, pattern_ReleaseService_ListReleaseCategories_0, func(w http.ResponseWriter, req *http.Request, pathParams map[string]string) {
+ ctx, cancel := context.WithCancel(req.Context())
+ defer cancel()
+ inboundMarshaler, outboundMarshaler := runtime.MarshalerForRequest(mux, req)
+ annotatedContext, err := runtime.AnnotateContext(ctx, mux, req, "/bytebase.v1.ReleaseService/ListReleaseCategories", runtime.WithHTTPPathPattern("/v1/{parent=projects/*}/releases:listCategories"))
+ if err != nil {
+ runtime.HTTPError(ctx, mux, outboundMarshaler, w, req, err)
+ return
+ }
+ resp, md, err := request_ReleaseService_ListReleaseCategories_0(annotatedContext, inboundMarshaler, client, req, pathParams)
+ annotatedContext = runtime.NewServerMetadataContext(annotatedContext, md)
+ if err != nil {
+ runtime.HTTPError(annotatedContext, mux, outboundMarshaler, w, req, err)
+ return
+ }
+ forward_ReleaseService_ListReleaseCategories_0(annotatedContext, mux, outboundMarshaler, w, req, resp, mux.GetForwardResponseOptions()...)
+ })
return nil
}
var (
- pattern_ReleaseService_GetRelease_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 1, 0, 2, 2, 1, 0, 4, 4, 5, 3}, []string{"v1", "projects", "releases", "name"}, ""))
- pattern_ReleaseService_ListReleases_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 1, 0, 4, 2, 5, 2, 2, 3}, []string{"v1", "projects", "parent", "releases"}, ""))
- pattern_ReleaseService_CreateRelease_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 1, 0, 4, 2, 5, 2, 2, 3}, []string{"v1", "projects", "parent", "releases"}, ""))
- pattern_ReleaseService_UpdateRelease_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 1, 0, 2, 2, 1, 0, 4, 4, 5, 3}, []string{"v1", "projects", "releases", "release.name"}, ""))
- pattern_ReleaseService_DeleteRelease_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 1, 0, 2, 2, 1, 0, 4, 4, 5, 3}, []string{"v1", "projects", "releases", "name"}, ""))
- pattern_ReleaseService_UndeleteRelease_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 1, 0, 2, 2, 1, 0, 4, 4, 5, 3}, []string{"v1", "projects", "releases", "name"}, "undelete"))
- pattern_ReleaseService_CheckRelease_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 1, 0, 4, 2, 5, 2, 2, 3}, []string{"v1", "projects", "parent", "releases"}, "check"))
+ pattern_ReleaseService_GetRelease_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 1, 0, 2, 2, 1, 0, 4, 4, 5, 3}, []string{"v1", "projects", "releases", "name"}, ""))
+ pattern_ReleaseService_ListReleases_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 1, 0, 4, 2, 5, 2, 2, 3}, []string{"v1", "projects", "parent", "releases"}, ""))
+ pattern_ReleaseService_CreateRelease_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 1, 0, 4, 2, 5, 2, 2, 3}, []string{"v1", "projects", "parent", "releases"}, ""))
+ pattern_ReleaseService_UpdateRelease_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 1, 0, 2, 2, 1, 0, 4, 4, 5, 3}, []string{"v1", "projects", "releases", "release.name"}, ""))
+ pattern_ReleaseService_DeleteRelease_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 1, 0, 2, 2, 1, 0, 4, 4, 5, 3}, []string{"v1", "projects", "releases", "name"}, ""))
+ pattern_ReleaseService_UndeleteRelease_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 1, 0, 2, 2, 1, 0, 4, 4, 5, 3}, []string{"v1", "projects", "releases", "name"}, "undelete"))
+ pattern_ReleaseService_CheckRelease_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 1, 0, 4, 2, 5, 2, 2, 3}, []string{"v1", "projects", "parent", "releases"}, "check"))
+ pattern_ReleaseService_ListReleaseCategories_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 1, 0, 4, 2, 5, 2, 2, 3}, []string{"v1", "projects", "parent", "releases"}, "listCategories"))
)
var (
- forward_ReleaseService_GetRelease_0 = runtime.ForwardResponseMessage
- forward_ReleaseService_ListReleases_0 = runtime.ForwardResponseMessage
- forward_ReleaseService_CreateRelease_0 = runtime.ForwardResponseMessage
- forward_ReleaseService_UpdateRelease_0 = runtime.ForwardResponseMessage
- forward_ReleaseService_DeleteRelease_0 = runtime.ForwardResponseMessage
- forward_ReleaseService_UndeleteRelease_0 = runtime.ForwardResponseMessage
- forward_ReleaseService_CheckRelease_0 = runtime.ForwardResponseMessage
+ forward_ReleaseService_GetRelease_0 = runtime.ForwardResponseMessage
+ forward_ReleaseService_ListReleases_0 = runtime.ForwardResponseMessage
+ forward_ReleaseService_CreateRelease_0 = runtime.ForwardResponseMessage
+ forward_ReleaseService_UpdateRelease_0 = runtime.ForwardResponseMessage
+ forward_ReleaseService_DeleteRelease_0 = runtime.ForwardResponseMessage
+ forward_ReleaseService_UndeleteRelease_0 = runtime.ForwardResponseMessage
+ forward_ReleaseService_CheckRelease_0 = runtime.ForwardResponseMessage
+ forward_ReleaseService_ListReleaseCategories_0 = runtime.ForwardResponseMessage
)
diff --git a/backend/generated-go/v1/release_service_equal.pb.go b/backend/generated-go/v1/release_service_equal.pb.go
index 65655b6b96..d44807bddb 100644
--- a/backend/generated-go/v1/release_service_equal.pb.go
+++ b/backend/generated-go/v1/release_service_equal.pb.go
@@ -40,6 +40,9 @@ func (x *ListReleasesRequest) Equal(y *ListReleasesRequest) bool {
if x.ShowDeleted != y.ShowDeleted {
return false
}
+ if x.Filter != y.Filter {
+ return false
+ }
return true
}
@@ -210,6 +213,37 @@ func (x *CheckReleaseResponse) Equal(y *CheckReleaseResponse) bool {
return true
}
+func (x *ListReleaseCategoriesRequest) Equal(y *ListReleaseCategoriesRequest) bool {
+ if x == y {
+ return true
+ }
+ if x == nil || y == nil {
+ return x == nil && y == nil
+ }
+ if x.Parent != y.Parent {
+ return false
+ }
+ return true
+}
+
+func (x *ListReleaseCategoriesResponse) Equal(y *ListReleaseCategoriesResponse) bool {
+ if x == y {
+ return true
+ }
+ if x == nil || y == nil {
+ return x == nil && y == nil
+ }
+ if len(x.Categories) != len(y.Categories) {
+ return false
+ }
+ for i := 0; i < len(x.Categories); i++ {
+ if x.Categories[i] != y.Categories[i] {
+ return false
+ }
+ }
+ return true
+}
+
func (x *Release_File) Equal(y *Release_File) bool {
if x == y {
return true
@@ -264,6 +298,9 @@ func (x *Release) Equal(y *Release) bool {
if x.Name != y.Name {
return false
}
+ if x.Category != y.Category {
+ return false
+ }
if len(x.Files) != len(y.Files) {
return false
}
diff --git a/backend/generated-go/v1/release_service_grpc.pb.go b/backend/generated-go/v1/release_service_grpc.pb.go
index 77f122ba5c..2c81e7eda9 100644
--- a/backend/generated-go/v1/release_service_grpc.pb.go
+++ b/backend/generated-go/v1/release_service_grpc.pb.go
@@ -20,13 +20,14 @@ import (
const _ = grpc.SupportPackageIsVersion9
const (
- ReleaseService_GetRelease_FullMethodName = "/bytebase.v1.ReleaseService/GetRelease"
- ReleaseService_ListReleases_FullMethodName = "/bytebase.v1.ReleaseService/ListReleases"
- ReleaseService_CreateRelease_FullMethodName = "/bytebase.v1.ReleaseService/CreateRelease"
- ReleaseService_UpdateRelease_FullMethodName = "/bytebase.v1.ReleaseService/UpdateRelease"
- ReleaseService_DeleteRelease_FullMethodName = "/bytebase.v1.ReleaseService/DeleteRelease"
- ReleaseService_UndeleteRelease_FullMethodName = "/bytebase.v1.ReleaseService/UndeleteRelease"
- ReleaseService_CheckRelease_FullMethodName = "/bytebase.v1.ReleaseService/CheckRelease"
+ ReleaseService_GetRelease_FullMethodName = "/bytebase.v1.ReleaseService/GetRelease"
+ ReleaseService_ListReleases_FullMethodName = "/bytebase.v1.ReleaseService/ListReleases"
+ ReleaseService_CreateRelease_FullMethodName = "/bytebase.v1.ReleaseService/CreateRelease"
+ ReleaseService_UpdateRelease_FullMethodName = "/bytebase.v1.ReleaseService/UpdateRelease"
+ ReleaseService_DeleteRelease_FullMethodName = "/bytebase.v1.ReleaseService/DeleteRelease"
+ ReleaseService_UndeleteRelease_FullMethodName = "/bytebase.v1.ReleaseService/UndeleteRelease"
+ ReleaseService_CheckRelease_FullMethodName = "/bytebase.v1.ReleaseService/CheckRelease"
+ ReleaseService_ListReleaseCategories_FullMethodName = "/bytebase.v1.ReleaseService/ListReleaseCategories"
)
// ReleaseServiceClient is the client API for ReleaseService service.
@@ -57,6 +58,9 @@ type ReleaseServiceClient interface {
// Validates a release by dry-running checks on target databases.
// Permissions required: bb.releases.check
CheckRelease(ctx context.Context, in *CheckReleaseRequest, opts ...grpc.CallOption) (*CheckReleaseResponse, error)
+ // Lists all unique categories in a project.
+ // Permissions required: bb.releases.list
+ ListReleaseCategories(ctx context.Context, in *ListReleaseCategoriesRequest, opts ...grpc.CallOption) (*ListReleaseCategoriesResponse, error)
}
type releaseServiceClient struct {
@@ -137,6 +141,16 @@ func (c *releaseServiceClient) CheckRelease(ctx context.Context, in *CheckReleas
return out, nil
}
+func (c *releaseServiceClient) ListReleaseCategories(ctx context.Context, in *ListReleaseCategoriesRequest, opts ...grpc.CallOption) (*ListReleaseCategoriesResponse, error) {
+ cOpts := append([]grpc.CallOption{grpc.StaticMethod()}, opts...)
+ out := new(ListReleaseCategoriesResponse)
+ err := c.cc.Invoke(ctx, ReleaseService_ListReleaseCategories_FullMethodName, in, out, cOpts...)
+ if err != nil {
+ return nil, err
+ }
+ return out, nil
+}
+
// ReleaseServiceServer is the server API for ReleaseService service.
// All implementations must embed UnimplementedReleaseServiceServer
// for forward compatibility.
@@ -165,6 +179,9 @@ type ReleaseServiceServer interface {
// Validates a release by dry-running checks on target databases.
// Permissions required: bb.releases.check
CheckRelease(context.Context, *CheckReleaseRequest) (*CheckReleaseResponse, error)
+ // Lists all unique categories in a project.
+ // Permissions required: bb.releases.list
+ ListReleaseCategories(context.Context, *ListReleaseCategoriesRequest) (*ListReleaseCategoriesResponse, error)
mustEmbedUnimplementedReleaseServiceServer()
}
@@ -196,6 +213,9 @@ func (UnimplementedReleaseServiceServer) UndeleteRelease(context.Context, *Undel
func (UnimplementedReleaseServiceServer) CheckRelease(context.Context, *CheckReleaseRequest) (*CheckReleaseResponse, error) {
return nil, status.Error(codes.Unimplemented, "method CheckRelease not implemented")
}
+func (UnimplementedReleaseServiceServer) ListReleaseCategories(context.Context, *ListReleaseCategoriesRequest) (*ListReleaseCategoriesResponse, error) {
+ return nil, status.Error(codes.Unimplemented, "method ListReleaseCategories not implemented")
+}
func (UnimplementedReleaseServiceServer) mustEmbedUnimplementedReleaseServiceServer() {}
func (UnimplementedReleaseServiceServer) testEmbeddedByValue() {}
@@ -343,6 +363,24 @@ func _ReleaseService_CheckRelease_Handler(srv interface{}, ctx context.Context,
return interceptor(ctx, in, info, handler)
}
+func _ReleaseService_ListReleaseCategories_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
+ in := new(ListReleaseCategoriesRequest)
+ if err := dec(in); err != nil {
+ return nil, err
+ }
+ if interceptor == nil {
+ return srv.(ReleaseServiceServer).ListReleaseCategories(ctx, in)
+ }
+ info := &grpc.UnaryServerInfo{
+ Server: srv,
+ FullMethod: ReleaseService_ListReleaseCategories_FullMethodName,
+ }
+ handler := func(ctx context.Context, req interface{}) (interface{}, error) {
+ return srv.(ReleaseServiceServer).ListReleaseCategories(ctx, req.(*ListReleaseCategoriesRequest))
+ }
+ return interceptor(ctx, in, info, handler)
+}
+
// ReleaseService_ServiceDesc is the grpc.ServiceDesc for ReleaseService service.
// It's only intended for direct use with grpc.RegisterService,
// and not to be introspected or modified (even as a copy)
@@ -378,6 +416,10 @@ var ReleaseService_ServiceDesc = grpc.ServiceDesc{
MethodName: "CheckRelease",
Handler: _ReleaseService_CheckRelease_Handler,
},
+ {
+ MethodName: "ListReleaseCategories",
+ Handler: _ReleaseService_ListReleaseCategories_Handler,
+ },
},
Streams: []grpc.StreamDesc{},
Metadata: "v1/release_service.proto",
diff --git a/backend/generated-go/v1/v1connect/release_service.connect.go b/backend/generated-go/v1/v1connect/release_service.connect.go
index 5309e8c7c6..9067677047 100644
--- a/backend/generated-go/v1/v1connect/release_service.connect.go
+++ b/backend/generated-go/v1/v1connect/release_service.connect.go
@@ -55,6 +55,9 @@ const (
// ReleaseServiceCheckReleaseProcedure is the fully-qualified name of the ReleaseService's
// CheckRelease RPC.
ReleaseServiceCheckReleaseProcedure = "/bytebase.v1.ReleaseService/CheckRelease"
+ // ReleaseServiceListReleaseCategoriesProcedure is the fully-qualified name of the ReleaseService's
+ // ListReleaseCategories RPC.
+ ReleaseServiceListReleaseCategoriesProcedure = "/bytebase.v1.ReleaseService/ListReleaseCategories"
)
// ReleaseServiceClient is a client for the bytebase.v1.ReleaseService service.
@@ -81,6 +84,9 @@ type ReleaseServiceClient interface {
// Validates a release by dry-running checks on target databases.
// Permissions required: bb.releases.check
CheckRelease(context.Context, *connect.Request[v1.CheckReleaseRequest]) (*connect.Response[v1.CheckReleaseResponse], error)
+ // Lists all unique categories in a project.
+ // Permissions required: bb.releases.list
+ ListReleaseCategories(context.Context, *connect.Request[v1.ListReleaseCategoriesRequest]) (*connect.Response[v1.ListReleaseCategoriesResponse], error)
}
// NewReleaseServiceClient constructs a client for the bytebase.v1.ReleaseService service. By
@@ -136,18 +142,25 @@ func NewReleaseServiceClient(httpClient connect.HTTPClient, baseURL string, opts
connect.WithSchema(releaseServiceMethods.ByName("CheckRelease")),
connect.WithClientOptions(opts...),
),
+ listReleaseCategories: connect.NewClient[v1.ListReleaseCategoriesRequest, v1.ListReleaseCategoriesResponse](
+ httpClient,
+ baseURL+ReleaseServiceListReleaseCategoriesProcedure,
+ connect.WithSchema(releaseServiceMethods.ByName("ListReleaseCategories")),
+ connect.WithClientOptions(opts...),
+ ),
}
}
// releaseServiceClient implements ReleaseServiceClient.
type releaseServiceClient struct {
- getRelease *connect.Client[v1.GetReleaseRequest, v1.Release]
- listReleases *connect.Client[v1.ListReleasesRequest, v1.ListReleasesResponse]
- createRelease *connect.Client[v1.CreateReleaseRequest, v1.Release]
- updateRelease *connect.Client[v1.UpdateReleaseRequest, v1.Release]
- deleteRelease *connect.Client[v1.DeleteReleaseRequest, emptypb.Empty]
- undeleteRelease *connect.Client[v1.UndeleteReleaseRequest, v1.Release]
- checkRelease *connect.Client[v1.CheckReleaseRequest, v1.CheckReleaseResponse]
+ getRelease *connect.Client[v1.GetReleaseRequest, v1.Release]
+ listReleases *connect.Client[v1.ListReleasesRequest, v1.ListReleasesResponse]
+ createRelease *connect.Client[v1.CreateReleaseRequest, v1.Release]
+ updateRelease *connect.Client[v1.UpdateReleaseRequest, v1.Release]
+ deleteRelease *connect.Client[v1.DeleteReleaseRequest, emptypb.Empty]
+ undeleteRelease *connect.Client[v1.UndeleteReleaseRequest, v1.Release]
+ checkRelease *connect.Client[v1.CheckReleaseRequest, v1.CheckReleaseResponse]
+ listReleaseCategories *connect.Client[v1.ListReleaseCategoriesRequest, v1.ListReleaseCategoriesResponse]
}
// GetRelease calls bytebase.v1.ReleaseService.GetRelease.
@@ -185,6 +198,11 @@ func (c *releaseServiceClient) CheckRelease(ctx context.Context, req *connect.Re
return c.checkRelease.CallUnary(ctx, req)
}
+// ListReleaseCategories calls bytebase.v1.ReleaseService.ListReleaseCategories.
+func (c *releaseServiceClient) ListReleaseCategories(ctx context.Context, req *connect.Request[v1.ListReleaseCategoriesRequest]) (*connect.Response[v1.ListReleaseCategoriesResponse], error) {
+ return c.listReleaseCategories.CallUnary(ctx, req)
+}
+
// ReleaseServiceHandler is an implementation of the bytebase.v1.ReleaseService service.
type ReleaseServiceHandler interface {
// Retrieves a release by name.
@@ -209,6 +227,9 @@ type ReleaseServiceHandler interface {
// Validates a release by dry-running checks on target databases.
// Permissions required: bb.releases.check
CheckRelease(context.Context, *connect.Request[v1.CheckReleaseRequest]) (*connect.Response[v1.CheckReleaseResponse], error)
+ // Lists all unique categories in a project.
+ // Permissions required: bb.releases.list
+ ListReleaseCategories(context.Context, *connect.Request[v1.ListReleaseCategoriesRequest]) (*connect.Response[v1.ListReleaseCategoriesResponse], error)
}
// NewReleaseServiceHandler builds an HTTP handler from the service implementation. It returns the
@@ -260,6 +281,12 @@ func NewReleaseServiceHandler(svc ReleaseServiceHandler, opts ...connect.Handler
connect.WithSchema(releaseServiceMethods.ByName("CheckRelease")),
connect.WithHandlerOptions(opts...),
)
+ releaseServiceListReleaseCategoriesHandler := connect.NewUnaryHandler(
+ ReleaseServiceListReleaseCategoriesProcedure,
+ svc.ListReleaseCategories,
+ connect.WithSchema(releaseServiceMethods.ByName("ListReleaseCategories")),
+ connect.WithHandlerOptions(opts...),
+ )
return "/bytebase.v1.ReleaseService/", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
switch r.URL.Path {
case ReleaseServiceGetReleaseProcedure:
@@ -276,6 +303,8 @@ func NewReleaseServiceHandler(svc ReleaseServiceHandler, opts ...connect.Handler
releaseServiceUndeleteReleaseHandler.ServeHTTP(w, r)
case ReleaseServiceCheckReleaseProcedure:
releaseServiceCheckReleaseHandler.ServeHTTP(w, r)
+ case ReleaseServiceListReleaseCategoriesProcedure:
+ releaseServiceListReleaseCategoriesHandler.ServeHTTP(w, r)
default:
http.NotFound(w, r)
}
@@ -312,3 +341,7 @@ func (UnimplementedReleaseServiceHandler) UndeleteRelease(context.Context, *conn
func (UnimplementedReleaseServiceHandler) CheckRelease(context.Context, *connect.Request[v1.CheckReleaseRequest]) (*connect.Response[v1.CheckReleaseResponse], error) {
return nil, connect.NewError(connect.CodeUnimplemented, errors.New("bytebase.v1.ReleaseService.CheckRelease is not implemented"))
}
+
+func (UnimplementedReleaseServiceHandler) ListReleaseCategories(context.Context, *connect.Request[v1.ListReleaseCategoriesRequest]) (*connect.Response[v1.ListReleaseCategoriesResponse], error) {
+ return nil, connect.NewError(connect.CodeUnimplemented, errors.New("bytebase.v1.ReleaseService.ListReleaseCategories is not implemented"))
+}
diff --git a/backend/migrator/migration/3.15/0002##add_category_to_release.sql b/backend/migrator/migration/3.15/0002##add_category_to_release.sql
new file mode 100644
index 0000000000..9aa97eeb76
--- /dev/null
+++ b/backend/migrator/migration/3.15/0002##add_category_to_release.sql
@@ -0,0 +1,8 @@
+-- Add category column to release table for filtering releases by category
+ALTER TABLE release ADD COLUMN category TEXT NOT NULL DEFAULT '';
+
+-- Backfill existing releases with category = 'release'
+UPDATE release SET category = 'release' WHERE category = '';
+
+-- Create index for efficient category filtering
+CREATE INDEX idx_release_category ON release(project, category);
diff --git a/backend/migrator/migration/LATEST.sql b/backend/migrator/migration/LATEST.sql
index 5bd23cb8eb..d5de241a80 100644
--- a/backend/migrator/migration/LATEST.sql
+++ b/backend/migrator/migration/LATEST.sql
@@ -530,6 +530,7 @@ CREATE TABLE release (
created_at timestamptz NOT NULL DEFAULT now(),
train text NOT NULL DEFAULT '',
iteration integer NOT NULL DEFAULT 0,
+ category text NOT NULL DEFAULT '',
-- Stored as ReleasePayload (proto/store/store/release.proto)
payload jsonb NOT NULL DEFAULT '{}'
);
@@ -539,6 +540,7 @@ ALTER SEQUENCE release_id_seq RESTART WITH 101;
CREATE INDEX idx_release_project ON release(project);
CREATE UNIQUE INDEX idx_release_project_train_iteration ON release(project, train, iteration);
CREATE INDEX idx_release_project_release_id ON release(project, release_id);
+CREATE INDEX idx_release_category ON release(project, category);
-- OAuth2 tables
CREATE TABLE oauth2_client (
diff --git a/backend/migrator/migrator_test.go b/backend/migrator/migrator_test.go
index e16f8161be..895687c5c8 100644
--- a/backend/migrator/migrator_test.go
+++ b/backend/migrator/migrator_test.go
@@ -12,8 +12,8 @@ import (
func TestLatestVersion(t *testing.T) {
files, err := getSortedVersionedFiles()
require.NoError(t, err)
- require.Equal(t, semver.MustParse("3.15.1"), *files[len(files)-1].version)
- require.Equal(t, "migration/3.15/0001##add_database_release_field.sql", files[len(files)-1].path)
+ require.Equal(t, semver.MustParse("3.15.2"), *files[len(files)-1].version)
+ require.Equal(t, "migration/3.15/0002##add_category_to_release.sql", files[len(files)-1].path)
}
func TestVersionUnique(t *testing.T) {
diff --git a/backend/store/release.go b/backend/store/release.go
index 4441279ecb..e31a26c6e8 100644
--- a/backend/store/release.go
+++ b/backend/store/release.go
@@ -24,11 +24,13 @@ type ReleaseMessage struct {
At time.Time
Train string
Iteration int32
+ Category string
}
type FindReleaseMessage struct {
ProjectID *string
ReleaseID *string
+ Category *string
Limit *int
Offset *int
ShowDeleted bool
@@ -38,8 +40,9 @@ type UpdateReleaseMessage struct {
ProjectID string
ReleaseID string
- Deleted *bool
- Payload *storepb.ReleasePayload
+ Deleted *bool
+ Payload *storepb.ReleasePayload
+ Category *string
}
func (s *Store) CreateRelease(ctx context.Context, release *ReleaseMessage, creator string) (*ReleaseMessage, error) {
@@ -82,16 +85,18 @@ func (s *Store) CreateRelease(ctx context.Context, release *ReleaseMessage, crea
payload,
release_id,
train,
- iteration
+ iteration,
+ category
) VALUES (
?,
?,
?,
?,
?,
+ ?,
?
) RETURNING id, created_at
- `, creator, release.ProjectID, p, releaseID, release.Train, nextIteration)
+ `, creator, release.ProjectID, p, releaseID, release.Train, nextIteration, release.Category)
query, args, err := q.ToSQL()
if err != nil {
@@ -140,7 +145,8 @@ func (s *Store) ListReleases(ctx context.Context, find *FindReleaseMessage) ([]*
payload,
release_id,
train,
- iteration
+ iteration,
+ category
FROM release
WHERE TRUE
`)
@@ -151,6 +157,9 @@ func (s *Store) ListReleases(ctx context.Context, find *FindReleaseMessage) ([]*
if v := find.ReleaseID; v != nil {
q.And("release_id = ?", *v)
}
+ if v := find.Category; v != nil {
+ q.And("category = ?", *v)
+ }
if !find.ShowDeleted {
q.And("deleted = ?", false)
}
@@ -196,6 +205,7 @@ func (s *Store) ListReleases(ctx context.Context, find *FindReleaseMessage) ([]*
&r.ReleaseID,
&r.Train,
&r.Iteration,
+ &r.Category,
); err != nil {
return nil, errors.Wrapf(err, "failed to scan rows")
}
@@ -230,6 +240,9 @@ func (s *Store) UpdateRelease(ctx context.Context, update *UpdateReleaseMessage)
}
set.Comma("payload = ?", payload)
}
+ if v := update.Category; v != nil {
+ set.Comma("category = ?", *v)
+ }
if set.Len() == 0 {
return nil, errors.New("no update field provided")
@@ -259,3 +272,45 @@ func (s *Store) UpdateRelease(ctx context.Context, update *UpdateReleaseMessage)
ReleaseID: &update.ReleaseID,
})
}
+
+func (s *Store) ListReleaseCategories(ctx context.Context, projectID string) ([]string, error) {
+ query := `
+ SELECT DISTINCT category
+ FROM release
+ WHERE project = $1
+ AND category != ''
+ AND deleted = FALSE
+ ORDER BY category ASC
+ `
+
+ tx, err := s.GetDB().BeginTx(ctx, &sql.TxOptions{ReadOnly: true})
+ if err != nil {
+ return nil, errors.Wrapf(err, "failed to begin tx")
+ }
+ defer tx.Rollback()
+
+ rows, err := tx.QueryContext(ctx, query, projectID)
+ if err != nil {
+ return nil, errors.Wrapf(err, "failed to query rows")
+ }
+ defer rows.Close()
+
+ var categories []string
+ for rows.Next() {
+ var category string
+ if err := rows.Scan(&category); err != nil {
+ return nil, errors.Wrapf(err, "failed to scan row")
+ }
+ categories = append(categories, category)
+ }
+
+ if err := rows.Err(); err != nil {
+ return nil, errors.Wrapf(err, "rows err")
+ }
+
+ if err := tx.Commit(); err != nil {
+ return nil, errors.Wrapf(err, "failed to commit tx")
+ }
+
+ return categories, nil
+}
diff --git a/docs/plans/2026-01-16-release-category-filter-design.md b/docs/plans/2026-01-16-release-category-filter-design.md
new file mode 100644
index 0000000000..692f1995c0
--- /dev/null
+++ b/docs/plans/2026-01-16-release-category-filter-design.md
@@ -0,0 +1,312 @@
+# Release Category Filter Design
+
+**Date:** 2026-01-16
+**Author:** Claude
+**Status:** Implementation
+
+## Overview
+
+Add category-based filtering to the Release dashboard to help users separate releases targeting different database schemas (e.g., webapp releases vs analytics releases) within the same project.
+
+## Background
+
+In GitOps workflows, users often have multiple database groups with different schemas in the same project:
+- `webapp` databases with application schema
+- `analytics` databases with analytics schema
+
+Users create separate Bytebase action workflows that create releases with different naming prefixes:
+- `webapp-001`, `webapp-002`, etc.
+- `analytics-001`, `analytics-002`, etc.
+
+Currently, all releases are mixed together in the release dashboard, making it difficult to:
+- View only webapp-related releases
+- View only analytics-related releases
+- Distinguish release types at a glance
+
+## Goals
+
+1. Allow releases to have an explicit `category` field
+2. Filter releases by category in the UI
+3. Support URL-based filtering (bookmarkable, shareable)
+4. Maintain backward compatibility with existing releases
+
+## Non-Goals
+
+- Rollout dashboard filtering (deferred to future work)
+- Multi-category filtering (single category only)
+- Category management UI (categories are derived from release names)
+- Category validation rules (flexible, set by Bytebase action)
+
+## Design
+
+### Architecture
+
+**Data Flow:**
+1. Bytebase action extracts category from release name prefix (e.g., "webapp" from "webapp-001")
+2. Action sets `category` field when calling `CreateRelease` API
+3. Backend stores category in database
+4. Frontend fetches available categories via `ListReleaseCategories` API
+5. User selects category from dropdown
+6. Frontend updates URL and fetches filtered releases via `ListReleases` with CEL filter
+
+### Proto Changes
+
+#### 1. Add category to Release
+
+```protobuf
+message Release {
+ string name = 1;
+
+ // Category extracted from release name (e.g., "webapp", "analytics")
+ // Set by Bytebase action during release creation
+ string category = 2;
+
+ repeated File files = 3;
+ // ... other fields
+}
+```
+
+#### 2. Add filter to ListReleasesRequest
+
+```protobuf
+message ListReleasesRequest {
+ string parent = 1;
+ int32 page_size = 2;
+ string page_token = 3;
+ bool show_deleted = 4;
+
+ // Filter expression using CEL
+ // Supported filters:
+ // - category: release category, support "==" operator only.
+ //
+ // Example:
+ // category == "webapp"
+ string filter = 5;
+}
+```
+
+#### 3. Add ListReleaseCategories RPC
+
+```protobuf
+service ReleaseService {
+ // ... existing methods ...
+
+ // Lists all unique categories in a project
+ // Permissions required: bb.releases.list
+ rpc ListReleaseCategories(ListReleaseCategoriesRequest) returns (ListReleaseCategoriesResponse) {
+ option (google.api.http) = {get: "/v1/{parent=projects/*}/releases:listCategories"};
+ option (google.api.method_signature) = "parent";
+ option (bytebase.v1.permission) = "bb.releases.list";
+ option (bytebase.v1.auth_method) = IAM;
+ }
+}
+
+message ListReleaseCategoriesRequest {
+ string parent = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+message ListReleaseCategoriesResponse {
+ repeated string categories = 1;
+}
+```
+
+### Database Schema
+
+**Migration:**
+```sql
+ALTER TABLE release ADD COLUMN category TEXT NOT NULL DEFAULT '';
+CREATE INDEX idx_release_category ON release(project_id, category) WHERE row_status = 'NORMAL';
+```
+
+**Index rationale:**
+- Filtering by category is a common query pattern
+- Index on (project_id, category) enables efficient lookups
+- Partial index excludes deleted releases (row_status = 'NORMAL')
+
+### Backend Implementation
+
+#### Store Layer
+
+**ReleaseMessage:**
+```go
+type ReleaseMessage struct {
+ UID string
+ ProjectID string
+ Category string // NEW
+ // ... other fields
+}
+
+type FindReleaseMessage struct {
+ ProjectID *string
+ Category *string // NEW: Single category filter
+ // ... other fields
+}
+```
+
+**New method:**
+```go
+func (s *Store) ListReleaseCategories(ctx context.Context, projectResourceID string) ([]string, error)
+```
+
+#### API Service Layer
+
+**CEL Filter Parser:**
+- Parse `category == "value"` expressions
+- Extract category value
+- Return error for unsupported operators
+
+**ListReleaseCategories handler:**
+- Validate project access
+- Query distinct categories from database
+- Return sorted list
+
+### Frontend Implementation
+
+#### URL Structure
+
+- Single category: `?category=webapp`
+- No category (all): `/releases` (no query param)
+
+#### UI Components
+
+**Filter toolbar:**
+```
+┌─────────────────────────────────────────────────────────┐
+│ Releases [+] │
+├─────────────────────────────────────────────────────────┤
+│ Category: [All ▼] [webapp] [analytics] │
+├─────────────────────────────────────────────────────────┤
+│ Name │ Files │ Created │
+```
+
+**Implementation:**
+- Single-select dropdown (NSelect)
+- "All" option shows all releases (no filter)
+- URL query param synced with selection
+- Browser back/forward navigation supported
+
+#### Files to Modify
+
+- `frontend/src/utils/releaseFilter.ts` - URL/filter conversion utilities
+- `frontend/src/composables/useReleaseCategories.ts` - Category fetching
+- Release list view (TBD: find correct file) - Filter UI
+- `frontend/src/locales/en-US.json` - i18n strings
+
+### Bytebase Action Integration
+
+The Bytebase GitHub Action will:
+
+```go
+func createRelease(opts *CreateOptions) error {
+ // Extract category from release name (before first hyphen)
+ category := extractCategory(opts.ReleaseName)
+
+ request := &v1pb.CreateReleaseRequest{
+ Release: &v1pb.Release{
+ Category: category,
+ // ... other fields
+ },
+ }
+}
+
+func extractCategory(releaseName string) string {
+ parts := strings.SplitN(releaseName, "-", 2)
+ if len(parts) > 0 {
+ return parts[0]
+ }
+ return ""
+}
+```
+
+## Migration Strategy
+
+### Existing Releases
+
+Releases created before this feature will have `category = ""` (empty string).
+
+**Options:**
+1. Show as "Uncategorized" in UI
+2. Provide backfill script to extract category from existing release names
+3. Leave empty and let them age out
+
+**Recommendation:** Option 1 (show as "Uncategorized") - simplest, no data migration needed.
+
+### Rollout
+
+1. Deploy backend changes (database migration + API)
+2. Deploy frontend changes (UI updates)
+3. Update Bytebase action to set category
+4. Document category extraction logic for users
+
+## Testing
+
+### Unit Tests
+
+- CEL filter parser tests
+- Store layer tests (category filtering, listing)
+- Frontend utility tests (URL conversion)
+
+### Integration Tests
+
+- End-to-end release creation with category
+- Category listing
+- Release filtering
+
+### Manual Testing
+
+- Create releases with categories
+- Filter by category
+- Verify URL updates
+- Test browser navigation
+- Test with empty categories
+- Test with special characters
+
+## Alternatives Considered
+
+### 1. Infer from Database Group
+
+**Approach:** Store target database group in Release, filter by group
+
+**Rejected because:**
+- Requires more proto changes
+- Less flexible (what if release targets multiple groups?)
+- Category is more explicit and clear
+
+### 2. Pattern-Based Auto-Categorization
+
+**Approach:** Configure regex patterns in project settings
+
+**Rejected because:**
+- Brittle (breaks if naming changes)
+- Complex configuration
+- Less explicit than setting category directly
+
+### 3. Multi-Category Filtering
+
+**Approach:** Support `category in ["webapp", "analytics"]`
+
+**Rejected because:**
+- More complex UI (multi-select)
+- More complex CEL parsing
+- Single category filter meets current requirements
+
+## Future Enhancements
+
+1. **Rollout dashboard filtering** - Add category to Rollout proto, filter rollouts
+2. **Category management** - Bulk rename, merge categories
+3. **Category metadata** - Description, color, icon
+4. **Multi-category filter** - If users need to view multiple categories simultaneously
+5. **Category-based permissions** - Restrict access by category
+
+## Success Metrics
+
+- Users can filter releases by category
+- URL-based filtering works (shareable links)
+- No performance regression (filter query < 100ms)
+- Zero breaking changes for existing users
+
+## References
+
+- Similar pattern: `ListRolloutsRequest.filter` field
+- CEL documentation: https://github.com/google/cel-spec
+- Google AIP-160: Filtering
diff --git a/frontend/src/components/Project/ProjectReleasesPanel.vue b/frontend/src/components/Project/ProjectReleasesPanel.vue
index c9ea7dbdce..0e1f4e8fa8 100644
--- a/frontend/src/components/Project/ProjectReleasesPanel.vue
+++ b/frontend/src/components/Project/ProjectReleasesPanel.vue
@@ -7,8 +7,28 @@
class="ml-1"
/>
</NAlert>
+
+ <!-- Category Filter -->
+ <div class="flex items-center gap-x-4">
+ <NSelect
+ v-model:value="selectedCategory"
+ :options="categoryOptions"
+ :placeholder="$t('release.filter-by-category')"
+ :loading="categoriesLoading"
+ clearable
+ class="w-64"
+ />
+ <NButton
+ v-if="selectedCategory"
+ @click="clearFilters"
+ quaternary
+ >
+ {{ $t('common.clear-filters') }}
+ </NButton>
+ </div>
+
<PagedTable
- :key="project.name"
+ :key="`${project.name}-${selectedCategory || 'all'}`"
:session-key="`project-${project.name}-releases`"
:fetch-list="fetchReleaseList"
>
@@ -24,19 +44,68 @@
</template>
<script lang="ts" setup>
-import { NAlert } from "naive-ui";
+import { NAlert, NButton, NSelect } from "naive-ui";
+import { computed, ref, watch } from "vue";
+import { useRoute, useRouter } from "vue-router";
import LearnMoreLink from "@/components/LearnMoreLink.vue";
import PagedTable from "@/components/v2/Model/PagedTable.vue";
+import { useReleaseCategories } from "@/composables/useReleaseCategories";
import { useReleaseStore } from "@/store";
import type { Project } from "@/types/proto-es/v1/project_service_pb";
+import {
+ buildCategoryFilter,
+ buildCategoryQuery,
+ parseCategoryFromUrl,
+} from "@/utils/releaseFilter";
import ReleaseDataTable from "../Release/ReleaseDataTable.vue";
const props = defineProps<{
project: Project;
}>();
+const route = useRoute();
+const router = useRouter();
const releaseStore = useReleaseStore();
+// Categories
+const projectName = computed(() => props.project.name);
+const { categories, loading: categoriesLoading } =
+ useReleaseCategories(projectName);
+
+// Selected category from URL
+const selectedCategory = ref<string | undefined>(
+ parseCategoryFromUrl(route.query)
+);
+
+// Category options for dropdown
+const categoryOptions = computed(() => {
+ const options = categories.value.map((category) => ({
+ label: category,
+ value: category,
+ }));
+
+ // Add "All" option
+ return [{ label: "All", value: undefined }, ...options];
+});
+
+// Update URL when selection changes
+watch(selectedCategory, (newCategory) => {
+ const query = buildCategoryQuery(newCategory);
+ router.replace({ query });
+});
+
+// Update selection when URL changes (browser back/forward)
+watch(
+ () => route.query,
+ (newQuery) => {
+ selectedCategory.value = parseCategoryFromUrl(newQuery);
+ }
+);
+
+const clearFilters = () => {
+ selectedCategory.value = undefined;
+};
+
const fetchReleaseList = async ({
pageToken,
pageSize,
@@ -44,10 +113,12 @@ const fetchReleaseList = async ({
pageToken: string;
pageSize: number;
}) => {
+ const filter = buildCategoryFilter(selectedCategory.value);
const { nextPageToken, releases } = await releaseStore.fetchReleasesByProject(
props.project.name,
{ pageSize, pageToken },
- false
+ false,
+ filter
);
return {
nextPageToken,
diff --git a/frontend/src/composables/useReleaseCategories.ts b/frontend/src/composables/useReleaseCategories.ts
new file mode 100644
index 0000000000..8040de0f01
--- /dev/null
+++ b/frontend/src/composables/useReleaseCategories.ts
@@ -0,0 +1,45 @@
+import { create } from "@bufbuild/protobuf";
+import { computed, type Ref, ref, watch } from "vue";
+import { releaseServiceClientConnect } from "@/connect";
+import { ListReleaseCategoriesRequestSchema } from "@/types/proto-es/v1/release_service_pb";
+
+export const useReleaseCategories = (projectName: Ref<string>) => {
+ const categories = ref<string[]>([]);
+ const loading = ref(false);
+
+ const fetchCategories = async () => {
+ if (!projectName.value) {
+ categories.value = [];
+ return;
+ }
+
+ loading.value = true;
+ try {
+ const request = create(ListReleaseCategoriesRequestSchema, {
+ parent: projectName.value,
+ });
+ const response =
+ await releaseServiceClientConnect.listReleaseCategories(request);
+ categories.value = response.categories;
+ } catch (error) {
+ console.error("Failed to fetch release categories:", error);
+ categories.value = [];
+ } finally {
+ loading.value = false;
+ }
+ };
+
+ watch(
+ () => projectName.value,
+ () => {
+ fetchCategories();
+ },
+ { immediate: true }
+ );
+
+ return {
+ categories: computed(() => categories.value),
+ loading: computed(() => loading.value),
+ refresh: fetchCategories,
+ };
+};
diff --git a/frontend/src/locales/en-US.json b/frontend/src/locales/en-US.json
index d25b3590b3..d0d0c426a8 100644
--- a/frontend/src/locales/en-US.json
+++ b/frontend/src/locales/en-US.json
@@ -203,6 +203,7 @@
"info": "Info",
"minutes": "Minutes",
"filter-by-name": "Filter by name",
+ "clear-filters": "Clear filters",
"license": "License",
"view-details": "View details",
"force-verb": "Force {verb}",
@@ -2824,7 +2825,8 @@
"vcs-type": {
"unspecified": "Unspecified"
},
- "usage-description": "A release is a versioned application artifact whose deployment to an environment is triggered by a GitOps workflow."
+ "usage-description": "A release is a versioned application artifact whose deployment to an environment is triggered by a GitOps workflow.",
+ "filter-by-category": "Filter by category"
},
"export-data": {
"export-rows": "Export rows",
diff --git a/frontend/src/locales/es-ES.json b/frontend/src/locales/es-ES.json
index af549d8b41..8717a10493 100644
--- a/frontend/src/locales/es-ES.json
+++ b/frontend/src/locales/es-ES.json
@@ -203,6 +203,7 @@
"info": "Información",
"minutes": "Minutos",
"filter-by-name": "Filtrar por nombre",
+ "clear-filters": "Limpiar filtros",
"license": "Licencia",
"view-details": "Ver detalles",
"force-verb": "forzar {verbo}",
@@ -2824,7 +2825,8 @@
"vcs-type": {
"unspecified": "No especificado"
},
- "usage-description": "Un lanzamiento es un artefacto de aplicación versionado cuyo despliegue a un entorno es activado por un flujo de trabajo GitOps."
+ "usage-description": "Un lanzamiento es un artefacto de aplicación versionado cuyo despliegue a un entorno es activado por un flujo de trabajo GitOps.",
+ "filter-by-category": "Filtrar por categoría"
},
"export-data": {
"export-rows": "Exportar filas",
diff --git a/frontend/src/locales/ja-JP.json b/frontend/src/locales/ja-JP.json
index 350a682e17..adc3a99381 100644
--- a/frontend/src/locales/ja-JP.json
+++ b/frontend/src/locales/ja-JP.json
@@ -203,6 +203,7 @@
"info": "情報",
"minutes": "分",
"filter-by-name": "名前でフィルタリングする",
+ "clear-filters": "フィルタをクリア",
"license": "ライセンス",
"view-details": "詳細を確認する",
"force-verb": "フォース{verb}",
@@ -2824,7 +2825,8 @@
"vcs-type": {
"unspecified": "未指定"
},
- "usage-description": "リリースは、GitOpsワークフローによって環境へのデプロイがトリガーされるバージョン管理されたアプリケーションアーティファクトです。"
+ "usage-description": "リリースは、GitOpsワークフローによって環境へのデプロイがトリガーされるバージョン管理されたアプリケーションアーティファクトです。",
+ "filter-by-category": "カテゴリでフィルタリング"
},
"export-data": {
"export-rows": "エクスポート行数",
diff --git a/frontend/src/locales/vi-VN.json b/frontend/src/locales/vi-VN.json
index 2db726d6d1..dfd05313b9 100644
--- a/frontend/src/locales/vi-VN.json
+++ b/frontend/src/locales/vi-VN.json
@@ -203,6 +203,7 @@
"info": "Thông tin",
"minutes": "Phút",
"filter-by-name": "Lọc theo tên",
+ "clear-filters": "Xóa bộ lọc",
"license": "Giấy phép",
"view-details": "Xem chi tiết",
"force-verb": "Buộc {verb}",
@@ -2824,7 +2825,8 @@
"vcs-type": {
"unspecified": "Không xác định"
},
- "usage-description": "Bản phát hành là một artifact ứng dụng có phiên bản mà việc triển khai vào môi trường được kích hoạt bởi quy trình GitOps."
+ "usage-description": "Bản phát hành là một artifact ứng dụng có phiên bản mà việc triển khai vào môi trường được kích hoạt bởi quy trình GitOps.",
+ "filter-by-category": "Lọc theo danh mục"
},
"export-data": {
"export-rows": "Xuất số dòng",
diff --git a/frontend/src/locales/zh-CN.json b/frontend/src/locales/zh-CN.json
index 3fff60caf1..3a2f3cac0c 100644
--- a/frontend/src/locales/zh-CN.json
+++ b/frontend/src/locales/zh-CN.json
@@ -203,6 +203,7 @@
"info": "信息",
"minutes": "分钟",
"filter-by-name": "按名称过滤",
+ "clear-filters": "清除过滤",
"license": "证书",
"view-details": "查看详情",
"force-verb": "强制{verb}",
@@ -2824,7 +2825,8 @@
"vcs-type": {
"unspecified": "未指定"
},
- "usage-description": "发布包是版本化的应用制品。GitOps 工作流将发布包部署到环境。"
+ "usage-description": "发布包是版本化的应用制品。GitOps 工作流将发布包部署到环境。",
+ "filter-by-category": "按类别过滤"
},
"export-data": {
"export-rows": "导出行数",
diff --git a/frontend/src/store/modules/release.ts b/frontend/src/store/modules/release.ts
index 6d8bd141f0..832e5cfbb5 100644
--- a/frontend/src/store/modules/release.ts
+++ b/frontend/src/store/modules/release.ts
@@ -27,13 +27,15 @@ export const useReleaseStore = defineStore("release", () => {
const fetchReleasesByProject = async (
project: string,
pagination?: Pagination,
- showDeleted?: boolean
+ showDeleted?: boolean,
+ filter?: string
) => {
const request = create(ListReleasesRequestSchema, {
parent: project,
pageSize: pagination?.pageSize,
pageToken: pagination?.pageToken || "",
showDeleted: Boolean(showDeleted),
+ filter: filter || "",
});
const resp = await releaseServiceClientConnect.listReleases(request);
const releases = resp.releases;
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 874326dccd..196590a975 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
@@ -68,6 +68,20 @@ export declare type ListReleasesRequest = Message<"bytebase.v1.ListReleasesReque
* @generated from field: bool show_deleted = 4;
*/
showDeleted: boolean;
+
+ /**
+ * Filter is used to filter releases returned in the list.
+ * The syntax and semantics of CEL are documented at https://github.com/google/cel-spec
+ *
+ * Supported filters:
+ * - category: release category, support "==" operator.
+ *
+ * For example:
+ * category == "webapp"
+ *
+ * @generated from field: string filter = 5;
+ */
+ filter: string;
};
/**
@@ -325,6 +339,42 @@ export declare type CheckReleaseResponse_CheckResult = Message<"bytebase.v1.Chec
*/
export declare const CheckReleaseResponse_CheckResultSchema: GenMessage<CheckReleaseResponse_CheckResult>;
+/**
+ * @generated from message bytebase.v1.ListReleaseCategoriesRequest
+ */
+export declare type ListReleaseCategoriesRequest = Message<"bytebase.v1.ListReleaseCategoriesRequest"> & {
+ /**
+ * Format: projects/{project}
+ *
+ * @generated from field: string parent = 1;
+ */
+ parent: string;
+};
+
+/**
+ * Describes the message bytebase.v1.ListReleaseCategoriesRequest.
+ * Use `create(ListReleaseCategoriesRequestSchema)` to create a new message.
+ */
+export declare const ListReleaseCategoriesRequestSchema: GenMessage<ListReleaseCategoriesRequest>;
+
+/**
+ * @generated from message bytebase.v1.ListReleaseCategoriesResponse
+ */
+export declare type ListReleaseCategoriesResponse = Message<"bytebase.v1.ListReleaseCategoriesResponse"> & {
+ /**
+ * The unique category values in the project.
+ *
+ * @generated from field: repeated string categories = 1;
+ */
+ categories: string[];
+};
+
+/**
+ * Describes the message bytebase.v1.ListReleaseCategoriesResponse.
+ * Use `create(ListReleaseCategoriesResponseSchema)` to create a new message.
+ */
+export declare const ListReleaseCategoriesResponseSchema: GenMessage<ListReleaseCategoriesResponse>;
+
/**
* @generated from message bytebase.v1.Release
*/
@@ -336,6 +386,14 @@ export declare type Release = Message<"bytebase.v1.Release"> & {
*/
name: string;
+ /**
+ * Category extracted from release name (e.g., "webapp", "analytics").
+ * Set by Bytebase action during release creation.
+ *
+ * @generated from field: string category = 2;
+ */
+ category: string;
+
/**
* The SQL files included in the release.
*
@@ -586,5 +644,16 @@ export declare const ReleaseService: GenService<{
input: typeof CheckReleaseRequestSchema;
output: typeof CheckReleaseResponseSchema;
},
+ /**
+ * Lists all unique categories in a project.
+ * Permissions required: bb.releases.list
+ *
+ * @generated from rpc bytebase.v1.ReleaseService.ListReleaseCategories
+ */
+ listReleaseCategories: {
+ methodKind: "unary";
+ input: typeof ListReleaseCategoriesRequestSchema;
+ output: typeof ListReleaseCategoriesResponseSchema;
+ },
}>;
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 2a92ec9006..11d626a2e8 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("Chh2MS9yZWxlYXNlX3NlcnZpY2UucHJvdG8SC2J5dGViYXNlLnYxIj8KEUdldFJlbGVhc2VSZXF1ZXN0EioKBG5hbWUYASABKAlCHOBBAvpBFgoUYnl0ZWJhc2UuY29tL1JlbGVhc2UigAEKE0xpc3RSZWxlYXNlc1JlcXVlc3QSLAoGcGFyZW50GAEgASgJQhzgQQL6QRYKFGJ5dGViYXNlLmNvbS9Qcm9qZWN0EhEKCXBhZ2Vfc2l6ZRgCIAEoBRISCgpwYWdlX3Rva2VuGAMgASgJEhQKDHNob3dfZGVsZXRlZBgEIAEoCCJXChRMaXN0UmVsZWFzZXNSZXNwb25zZRImCghyZWxlYXNlcxgBIAMoCzIULmJ5dGViYXNlLnYxLlJlbGVhc2USFwoPbmV4dF9wYWdlX3Rva2VuGAIgASgJIn8KFENyZWF0ZVJlbGVhc2VSZXF1ZXN0EiwKBnBhcmVudBgBIAEoCUIc4EEC+kEWChRieXRlYmFzZS5jb20vUHJvamVjdBIqCgdyZWxlYXNlGAIgASgLMhQuYnl0ZWJhc2UudjEuUmVsZWFzZUID4EECEg0KBXRyYWluGAMgASgJInMKFFVwZGF0ZVJlbGVhc2VSZXF1ZXN0EioKB3JlbGVhc2UYASABKAsyFC5ieXRlYmFzZS52MS5SZWxlYXNlQgPgQQISLwoLdXBkYXRlX21hc2sYAiABKAsyGi5nb29nbGUucHJvdG9idWYuRmllbGRNYXNrIkIKFERlbGV0ZVJlbGVhc2VSZXF1ZXN0EioKBG5hbWUYASABKAlCHOBBAvpBFgoUYnl0ZWJhc2UuY29tL1JlbGVhc2UiRAoWVW5kZWxldGVSZWxlYXNlUmVxdWVzdBIqCgRuYW1lGAEgASgJQhzgQQL6QRYKFGJ5dGViYXNlLmNvbS9SZWxlYXNlIpYBChNDaGVja1JlbGVhc2VSZXF1ZXN0EiwKBnBhcmVudBgBIAEoCUIc4EEC+kEWChRieXRlYmFzZS5jb20vUHJvamVjdBIqCgdyZWxlYXNlGAIgASgLMhQuYnl0ZWJhc2UudjEuUmVsZWFzZUID4EECEg8KB3RhcmdldHMYAyADKAkSFAoMY3VzdG9tX3J1bGVzGAQgASgJIrACChRDaGVja1JlbGVhc2VSZXNwb25zZRI+CgdyZXN1bHRzGAEgAygLMi0uYnl0ZWJhc2UudjEuQ2hlY2tSZWxlYXNlUmVzcG9uc2UuQ2hlY2tSZXN1bHQSFQoNYWZmZWN0ZWRfcm93cxgCIAEoAxIqCgpyaXNrX2xldmVsGAMgASgOMhYuYnl0ZWJhc2UudjEuUmlza0xldmVsGpQBCgtDaGVja1Jlc3VsdBIMCgRmaWxlGAEgASgJEg4KBnRhcmdldBgCIAEoCRIkCgdhZHZpY2VzGAMgAygLMhMuYnl0ZWJhc2UudjEuQWR2aWNlEhUKDWFmZmVjdGVkX3Jvd3MYBCABKAMSKgoKcmlza19sZXZlbBgFIAEoDjIWLmJ5dGViYXNlLnYxLlJpc2tMZXZlbCLyBAoHUmVsZWFzZRIRCgRuYW1lGAEgASgJQgPgQQMSKAoFZmlsZXMYAyADKAsyGS5ieXRlYmFzZS52MS5SZWxlYXNlLkZpbGUSMgoKdmNzX3NvdXJjZRgEIAEoCzIeLmJ5dGViYXNlLnYxLlJlbGVhc2UuVkNTU291cmNlEhQKB2NyZWF0b3IYBSABKAlCA+BBAxI0CgtjcmVhdGVfdGltZRgGIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXBCA+BBAxImCgVzdGF0ZRgHIAEoDjISLmJ5dGViYXNlLnYxLlN0YXRlQgPgQQMSJwoEdHlwZRgIIAEoDjIZLmJ5dGViYXNlLnYxLlJlbGVhc2UuVHlwZRqWAQoERmlsZRIMCgRwYXRoGAIgASgJEg8KB3ZlcnNpb24YBiABKAkSFAoMZW5hYmxlX2dob3N0GAkgASgIEiYKBXNoZWV0GAMgASgJQhf6QRQKEmJ5dGViYXNlLmNvbS9TaGVldBIWCglzdGF0ZW1lbnQYByABKAxCA+BBBBIZCgxzaGVldF9zaGEyNTYYBCABKAlCA+BBAxpACglWQ1NTb3VyY2USJgoIdmNzX3R5cGUYASABKA4yFC5ieXRlYmFzZS52MS5WQ1NUeXBlEgsKA3VybBgCIAEoCSI8CgRUeXBlEhQKEFRZUEVfVU5TUEVDSUZJRUQQABINCglWRVJTSU9ORUQQARIPCgtERUNMQVJBVElWRRACOkDqQT0KFGJ5dGViYXNlLmNvbS9SZWxlYXNlEiVwcm9qZWN0cy97cHJvamVjdH0vcmVsZWFzZXMve3JlbGVhc2V9MvUICg5SZWxlYXNlU2VydmljZRKKAQoKR2V0UmVsZWFzZRIeLmJ5dGViYXNlLnYxLkdldFJlbGVhc2VSZXF1ZXN0GhQuYnl0ZWJhc2UudjEuUmVsZWFzZSJG2kEEbmFtZYrqMA9iYi5yZWxlYXNlcy5nZXSQ6jABgtPkkwIiEiAvdjEve25hbWU9cHJvamVjdHMvKi9yZWxlYXNlcy8qfRKeAQoMTGlzdFJlbGVhc2VzEiAuYnl0ZWJhc2UudjEuTGlzdFJlbGVhc2VzUmVxdWVzdBohLmJ5dGViYXNlLnYxLkxpc3RSZWxlYXNlc1Jlc3BvbnNlIknaQQZwYXJlbnSK6jAQYmIucmVsZWFzZXMubGlzdJDqMAGC0+STAiISIC92MS97cGFyZW50PXByb2plY3RzLyp9L3JlbGVhc2VzEqYBCg1DcmVhdGVSZWxlYXNlEiEuYnl0ZWJhc2UudjEuQ3JlYXRlUmVsZWFzZVJlcXVlc3QaFC5ieXRlYmFzZS52MS5SZWxlYXNlIlzaQQ5wYXJlbnQscmVsZWFzZYrqMBJiYi5yZWxlYXNlcy5jcmVhdGWQ6jABgtPkkwIrOgdyZWxlYXNlIiAvdjEve3BhcmVudD1wcm9qZWN0cy8qfS9yZWxlYXNlcxKzAQoNVXBkYXRlUmVsZWFzZRIhLmJ5dGViYXNlLnYxLlVwZGF0ZVJlbGVhc2VSZXF1ZXN0GhQuYnl0ZWJhc2UudjEuUmVsZWFzZSJp2kETcmVsZWFzZSx1cGRhdGVfbWFza4rqMBJiYi5yZWxlYXNlcy51cGRhdGWQ6jABgtPkkwIzOgdyZWxlYXNlMigvdjEve3JlbGVhc2UubmFtZT1wcm9qZWN0cy8qL3JlbGVhc2VzLyp9EpUBCg1EZWxldGVSZWxlYXNlEiEuYnl0ZWJhc2UudjEuRGVsZXRlUmVsZWFzZVJlcXVlc3QaFi5nb29nbGUucHJvdG9idWYuRW1wdHkiSdpBBG5hbWWK6jASYmIucmVsZWFzZXMuZGVsZXRlkOowAYLT5JMCIiogL3YxL3tuYW1lPXByb2plY3RzLyovcmVsZWFzZXMvKn0SmwEKD1VuZGVsZXRlUmVsZWFzZRIjLmJ5dGViYXNlLnYxLlVuZGVsZXRlUmVsZWFzZVJlcXVlc3QaFC5ieXRlYmFzZS52MS5SZWxlYXNlIk2K6jAUYmIucmVsZWFzZXMudW5kZWxldGWQ6jABgtPkkwIrIikvdjEve25hbWU9cHJvamVjdHMvKi9yZWxlYXNlcy8qfTp1bmRlbGV0ZRKfAQoMQ2hlY2tSZWxlYXNlEiAuYnl0ZWJhc2UudjEuQ2hlY2tSZWxlYXNlUmVxdWVzdBohLmJ5dGViYXNlLnYxLkNoZWNrUmVsZWFzZVJlc3BvbnNlIkqK6jARYmIucmVsZWFzZXMuY2hlY2uQ6jABgtPkkwIrOgEqIiYvdjEve3BhcmVudD1wcm9qZWN0cy8qfS9yZWxlYXNlczpjaGVja0KpAQoPY29tLmJ5dGViYXNlLnYxQhNSZWxlYXNlU2VydmljZVByb3RvUAFaNGdpdGh1Yi5jb20vYnl0ZWJhc2UvYnl0ZWJhc2UvYmFja2VuZC9nZW5lcmF0ZWQtZ28vdjGiAgNCWFiqAgtCeXRlYmFzZS5WMcoCC0J5dGViYXNlXFYx4gIXQnl0ZWJhc2VcVjFcR1BCTWV0YWRhdGHqAgxCeXRlYmFzZTo6VjFiBnByb3RvMw", [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("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]);
/**
* Describes the message bytebase.v1.GetReleaseRequest.
@@ -88,32 +88,46 @@ export const CheckReleaseResponseSchema = /*@__PURE__*/
export const CheckReleaseResponse_CheckResultSchema = /*@__PURE__*/
messageDesc(file_v1_release_service, 8, 0);
+/**
+ * Describes the message bytebase.v1.ListReleaseCategoriesRequest.
+ * Use `create(ListReleaseCategoriesRequestSchema)` to create a new message.
+ */
+export const ListReleaseCategoriesRequestSchema = /*@__PURE__*/
+ messageDesc(file_v1_release_service, 9);
+
+/**
+ * Describes the message bytebase.v1.ListReleaseCategoriesResponse.
+ * Use `create(ListReleaseCategoriesResponseSchema)` to create a new message.
+ */
+export const ListReleaseCategoriesResponseSchema = /*@__PURE__*/
+ messageDesc(file_v1_release_service, 10);
+
/**
* Describes the message bytebase.v1.Release.
* Use `create(ReleaseSchema)` to create a new message.
*/
export const ReleaseSchema = /*@__PURE__*/
- messageDesc(file_v1_release_service, 9);
+ messageDesc(file_v1_release_service, 11);
/**
* Describes the message bytebase.v1.Release.File.
* Use `create(Release_FileSchema)` to create a new message.
*/
export const Release_FileSchema = /*@__PURE__*/
- messageDesc(file_v1_release_service, 9, 0);
+ messageDesc(file_v1_release_service, 11, 0);
/**
* Describes the message bytebase.v1.Release.VCSSource.
* Use `create(Release_VCSSourceSchema)` to create a new message.
*/
export const Release_VCSSourceSchema = /*@__PURE__*/
- messageDesc(file_v1_release_service, 9, 1);
+ messageDesc(file_v1_release_service, 11, 1);
/**
* Describes the enum bytebase.v1.Release.Type.
*/
export const Release_TypeSchema = /*@__PURE__*/
- enumDesc(file_v1_release_service, 9, 0);
+ enumDesc(file_v1_release_service, 11, 0);
/**
* The type of schema change.
diff --git a/frontend/src/utils/releaseFilter.ts b/frontend/src/utils/releaseFilter.ts
new file mode 100644
index 0000000000..360e164cbc
--- /dev/null
+++ b/frontend/src/utils/releaseFilter.ts
@@ -0,0 +1,22 @@
+// Convert category value to CEL filter expression
+export const buildCategoryFilter = (category: string | undefined): string => {
+ if (!category) return "";
+ return `category == "${category}"`;
+};
+
+// Parse category from URL query params
+export const parseCategoryFromUrl = (
+ query: Record<string, unknown>
+): string | undefined => {
+ const category = query.category;
+ if (!category || typeof category !== "string") return undefined;
+ return category;
+};
+
+// Build URL query params from category
+export const buildCategoryQuery = (
+ category: string | undefined
+): Record<string, string> => {
+ if (!category) return {};
+ return { category };
+};
diff --git a/proto/gen/grpc-doc/openapi.yaml b/proto/gen/grpc-doc/openapi.yaml
index c4add606c7..54af01857e 100644
--- a/proto/gen/grpc-doc/openapi.yaml
+++ b/proto/gen/grpc-doc/openapi.yaml
@@ -7439,6 +7439,29 @@ paths:
type: boolean
title: show_deleted
description: Show deleted releases if specified.
+ - name: filter
+ in: query
+ description: |-
+ Filter is used to filter releases returned in the list.
+ The syntax and semantics of CEL are documented at https://github.com/google/cel-spec
+
+ Supported filters:
+ - category: release category, support "==" operator.
+
+ For example:
+ category == "webapp"
+ schema:
+ type: string
+ title: filter
+ description: |-
+ Filter is used to filter releases returned in the list.
+ The syntax and semantics of CEL are documented at https://github.com/google/cel-spec
+
+ Supported filters:
+ - category: release category, support "==" operator.
+
+ For example:
+ category == "webapp"
responses:
"200":
description: Success
@@ -7676,6 +7699,29 @@ paths:
application/json:
schema:
$ref: '#/components/schemas/bytebase.v1.CheckReleaseResponse'
+ /v1/projects/{project}/releases:listCategories:
+ get:
+ tags:
+ - ReleaseService
+ summary: ListReleaseCategories
+ description: |-
+ Lists all unique categories in a project.
+ Permissions required: bb.releases.list
+ operationId: ReleaseService_ListReleaseCategories
+ parameters:
+ - name: project
+ in: path
+ description: The project id.
+ required: true
+ schema:
+ type: string
+ responses:
+ "200":
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/bytebase.v1.ListReleaseCategoriesResponse'
/v1/projects/{project}/rollouts:
get:
tags:
@@ -15519,6 +15565,28 @@ components:
If this field is omitted, there are no subsequent pages.
title: ListProjectsResponse
additionalProperties: false
+ bytebase.v1.ListReleaseCategoriesRequest:
+ type: object
+ properties:
+ parent:
+ type: string
+ title: parent
+ description: 'Format: projects/{project}'
+ title: ListReleaseCategoriesRequest
+ required:
+ - parent
+ additionalProperties: false
+ bytebase.v1.ListReleaseCategoriesResponse:
+ type: object
+ properties:
+ categories:
+ type: array
+ items:
+ type: string
+ title: categories
+ description: The unique category values in the project.
+ title: ListReleaseCategoriesResponse
+ additionalProperties: false
bytebase.v1.ListReleasesRequest:
type: object
properties:
@@ -15547,6 +15615,18 @@ components:
type: boolean
title: show_deleted
description: Show deleted releases if specified.
+ filter:
+ type: string
+ title: filter
+ description: |-
+ Filter is used to filter releases returned in the list.
+ The syntax and semantics of CEL are documented at https://github.com/google/cel-spec
+
+ Supported filters:
+ - category: release category, support "==" operator.
+
+ For example:
+ category == "webapp"
title: ListReleasesRequest
required:
- parent
@@ -17588,6 +17668,12 @@ components:
title: name
description: 'Format: projects/{project}/releases/{release}'
readOnly: true
+ category:
+ type: string
+ title: category
+ description: |-
+ Category extracted from release name (e.g., "webapp", "analytics").
+ Set by Bytebase action during release creation.
files:
type: array
items:
diff --git a/proto/gen/grpc-doc/v1/README.md b/proto/gen/grpc-doc/v1/README.md
index b8c58108dd..a450232609 100644
--- a/proto/gen/grpc-doc/v1/README.md
+++ b/proto/gen/grpc-doc/v1/README.md
@@ -460,6 +460,8 @@
- [CreateReleaseRequest](#bytebase-v1-CreateReleaseRequest)
- [DeleteReleaseRequest](#bytebase-v1-DeleteReleaseRequest)
- [GetReleaseRequest](#bytebase-v1-GetReleaseRequest)
+ - [ListReleaseCategoriesRequest](#bytebase-v1-ListReleaseCategoriesRequest)
+ - [ListReleaseCategoriesResponse](#bytebase-v1-ListReleaseCategoriesResponse)
- [ListReleasesRequest](#bytebase-v1-ListReleasesRequest)
- [ListReleasesResponse](#bytebase-v1-ListReleasesResponse)
- [Release](#bytebase-v1-Release)
@@ -7630,6 +7632,36 @@ Check result for a single release file on a target database.
+<a name="bytebase-v1-ListReleaseCategoriesRequest"></a>
+
+### ListReleaseCategoriesRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| parent | [string](#string) | | Format: projects/{project} |
+
+
+
+
+
+
+<a name="bytebase-v1-ListReleaseCategoriesResponse"></a>
+
+### ListReleaseCategoriesResponse
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| categories | [string](#string) | repeated | The unique category values in the project. |
+
+
+
+
+
+
<a name="bytebase-v1-ListReleasesRequest"></a>
### ListReleasesRequest
@@ -7644,6 +7676,11 @@ Check result for a single release file on a target database.
When paginating, all other parameters provided to `ListReleases` must match the call that provided the page token. |
| show_deleted | [bool](#bool) | | Show deleted releases if specified. |
+| filter | [string](#string) | | Filter is used to filter releases returned in the list. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec
+
+Supported filters: - category: release category, support &#34;==&#34; operator.
+
+For example: category == &#34;webapp&#34; |
@@ -7675,6 +7712,7 @@ When paginating, all other parameters provided to `ListReleases` must match the
| Field | Type | Label | Description |
| ----- | ---- | ----- | ----------- |
| name | [string](#string) | | Format: projects/{project}/releases/{release} |
+| category | [string](#string) | | Category extracted from release name (e.g., &#34;webapp&#34;, &#34;analytics&#34;). Set by Bytebase action during release creation. |
| files | [Release.File](#bytebase-v1-Release-File) | repeated | The SQL files included in the release. |
| vcs_source | [Release.VCSSource](#bytebase-v1-Release-VCSSource) | | The version control source of the release. |
| creator | [string](#string) | | Format: users/[email protected] |
@@ -7789,6 +7827,7 @@ ReleaseService manages releases for coordinating deployments.
| DeleteRelease | [DeleteReleaseRequest](#bytebase-v1-DeleteReleaseRequest) | [.google.protobuf.Empty](#google-protobuf-Empty) | Deletes a release. Permissions required: bb.releases.delete |
| UndeleteRelease | [UndeleteReleaseRequest](#bytebase-v1-UndeleteReleaseRequest) | [Release](#bytebase-v1-Release) | Restores a deleted release. Permissions required: bb.releases.undelete |
| CheckRelease | [CheckReleaseRequest](#bytebase-v1-CheckReleaseRequest) | [CheckReleaseResponse](#bytebase-v1-CheckReleaseResponse) | Validates a release by dry-running checks on target databases. Permissions required: bb.releases.check |
+| ListReleaseCategories | [ListReleaseCategoriesRequest](#bytebase-v1-ListReleaseCategoriesRequest) | [ListReleaseCategoriesResponse](#bytebase-v1-ListReleaseCategoriesResponse) | Lists all unique categories in a project. Permissions required: bb.releases.list |
diff --git a/proto/gen/grpc-doc/v1/index.html b/proto/gen/grpc-doc/v1/index.html
index 5aa784adc0..868ef34a34 100644
--- a/proto/gen/grpc-doc/v1/index.html
+++ b/proto/gen/grpc-doc/v1/index.html
@@ -1930,6 +1930,14 @@
<a href="#bytebase.v1.GetReleaseRequest"><span class="badge">M</span>GetReleaseRequest</a>
</li>
+ <li>
+ <a href="#bytebase.v1.ListReleaseCategoriesRequest"><span class="badge">M</span>ListReleaseCategoriesRequest</a>
+ </li>
+
+ <li>
+ <a href="#bytebase.v1.ListReleaseCategoriesResponse"><span class="badge">M</span>ListReleaseCategoriesResponse</a>
+ </li>
+
<li>
<a href="#bytebase.v1.ListReleasesRequest"><span class="badge">M</span>ListReleasesRequest</a>
</li>
@@ -21884,6 +21892,54 @@ Format: projects/{project}/releases/{release} </p></td>
+ <h3 id="bytebase.v1.ListReleaseCategoriesRequest">ListReleaseCategoriesRequest</h3>
+ <p></p>
+
+
+ <table class="field-table">
+ <thead>
+ <tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
+ </thead>
+ <tbody>
+
+ <tr>
+ <td>parent</td>
+ <td><a href="#string">string</a></td>
+ <td></td>
+ <td><p>Format: projects/{project} </p></td>
+ </tr>
+
+ </tbody>
+ </table>
+
+
+
+
+
+ <h3 id="bytebase.v1.ListReleaseCategoriesResponse">ListReleaseCategoriesResponse</h3>
+ <p></p>
+
+
+ <table class="field-table">
+ <thead>
+ <tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
+ </thead>
+ <tbody>
+
+ <tr>
+ <td>categories</td>
+ <td><a href="#string">string</a></td>
+ <td>repeated</td>
+ <td><p>The unique category values in the project. </p></td>
+ </tr>
+
+ </tbody>
+ </table>
+
+
+
+
+
<h3 id="bytebase.v1.ListReleasesRequest">ListReleasesRequest</h3>
<p></p>
@@ -21928,6 +21984,20 @@ the call that provided the page token. </p></td>
<td><p>Show deleted releases if specified. </p></td>
</tr>
+ <tr>
+ <td>filter</td>
+ <td><a href="#string">string</a></td>
+ <td></td>
+ <td><p>Filter is used to filter releases returned in the list.
+The syntax and semantics of CEL are documented at https://github.com/google/cel-spec
+
+Supported filters:
+- category: release category, support &#34;==&#34; operator.
+
+For example:
+category == &#34;webapp&#34; </p></td>
+ </tr>
+
</tbody>
</table>
@@ -21984,6 +22054,14 @@ If this field is omitted, there are no subsequent pages. </p></td>
<td><p>Format: projects/{project}/releases/{release} </p></td>
</tr>
+ <tr>
+ <td>category</td>
+ <td><a href="#string">string</a></td>
+ <td></td>
+ <td><p>Category extracted from release name (e.g., &#34;webapp&#34;, &#34;analytics&#34;).
+Set by Bytebase action during release creation. </p></td>
+ </tr>
+
<tr>
<td>files</td>
<td><a href="#bytebase.v1.Release.File">Release.File</a></td>
@@ -22283,6 +22361,14 @@ Permissions required: bb.releases.undelete</p></td>
Permissions required: bb.releases.check</p></td>
</tr>
+ <tr>
+ <td>ListReleaseCategories</td>
+ <td><a href="#bytebase.v1.ListReleaseCategoriesRequest">ListReleaseCategoriesRequest</a></td>
+ <td><a href="#bytebase.v1.ListReleaseCategoriesResponse">ListReleaseCategoriesResponse</a></td>
+ <td><p>Lists all unique categories in a project.
+Permissions required: bb.releases.list</p></td>
+ </tr>
+
</tbody>
</table>
@@ -22371,6 +22457,16 @@ Permissions required: bb.releases.check</p></td>
</tr>
+
+
+ <tr>
+ <td>ListReleaseCategories</td>
+ <td>GET</td>
+ <td>/v1/{parent=projects/*}/releases:listCategories</td>
+ <td></td>
+ </tr>
+
+
</tbody>
</table>
diff --git a/proto/v1/v1/release_service.proto b/proto/v1/v1/release_service.proto
index a3b3110790..fba66d4fcf 100644
--- a/proto/v1/v1/release_service.proto
+++ b/proto/v1/v1/release_service.proto
@@ -87,6 +87,15 @@ service ReleaseService {
option (bytebase.v1.permission) = "bb.releases.check";
option (bytebase.v1.auth_method) = IAM;
}
+
+ // Lists all unique categories in a project.
+ // Permissions required: bb.releases.list
+ rpc ListReleaseCategories(ListReleaseCategoriesRequest) returns (ListReleaseCategoriesResponse) {
+ option (google.api.http) = {get: "/v1/{parent=projects/*}/releases:listCategories"};
+ option (google.api.method_signature) = "parent";
+ option (bytebase.v1.permission) = "bb.releases.list";
+ option (bytebase.v1.auth_method) = IAM;
+ }
}
message GetReleaseRequest {
@@ -118,6 +127,16 @@ message ListReleasesRequest {
// Show deleted releases if specified.
bool show_deleted = 4;
+
+ // Filter is used to filter releases returned in the list.
+ // The syntax and semantics of CEL are documented at https://github.com/google/cel-spec
+ //
+ // Supported filters:
+ // - category: release category, support "==" operator.
+ //
+ // For example:
+ // category == "webapp"
+ string filter = 5;
}
message ListReleasesResponse {
@@ -224,6 +243,19 @@ message CheckReleaseResponse {
RiskLevel risk_level = 3;
}
+message ListReleaseCategoriesRequest {
+ // Format: projects/{project}
+ string parent = 1 [
+ (google.api.field_behavior) = REQUIRED,
+ (google.api.resource_reference) = {type: "bytebase.com/Project"}
+ ];
+}
+
+message ListReleaseCategoriesResponse {
+ // The unique category values in the project.
+ repeated string categories = 1;
+}
+
message Release {
option (google.api.resource) = {
type: "bytebase.com/Release"
@@ -233,6 +265,10 @@ message Release {
// Format: projects/{project}/releases/{release}
string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+ // Category extracted from release name (e.g., "webapp", "analytics").
+ // Set by Bytebase action during release creation.
+ string category = 2;
+
// The SQL files included in the release.
repeated File files = 3;