[Feature] [License] Master Management (#1975)

Author: ajanikow

CHANGELOG.md

@@ -9,6 +9,7 @@
 - (Feature) (Platform) EventsV1 Integration
 - (Feature) (Platform) Allows to opt out in the Inventory Telemetry 
 - (Feature) Simplify Operator ID Process
+- (Feature) (License) Activation API Integration
 
 ## [1.3.1](https://github.com/arangodb/kube-arangodb/tree/1.3.1) (2025-10-07)
 - (Documentation) Add ArangoPlatformStorage Docs & Examples

docs/api/ArangoDeployment.V1.md

@@ -4791,16 +4791,69 @@ Possible Values:
 
 ***
 
+### .spec.license.expirationGracePeriod
+
+Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.3.1/pkg/apis/deployment/v1/license_spec.go#L68)</sup>
+
+ExpirationGracePeriod defines the expiration grace period for the license
+
+Default Value: `72h`
+
+***
+
+### .spec.license.inventory
+
+Type: `boolean` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.3.1/pkg/apis/deployment/v1/license_spec.go#L76)</sup>
+
+Inventory defines if inventory is collected
+
+Default Value: `true`
+
+***
+
+### .spec.license.mode
+
+Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.3.1/pkg/apis/deployment/v1/license_spec.go#L60)</sup>
+
+Mode Defines the mode of license
+
+Possible Values: 
+* `"discover"` (default) - Discovers the LicenseMode based on the keys
+* `"key"` - Use License Key mechanism
+* `"master"` - Use License Master Key mechanism
+
+***
+
 ### .spec.license.secretName
 
-Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.3.1/pkg/apis/deployment/v1/license_spec.go#L33)</sup>
+Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.3.1/pkg/apis/deployment/v1/license_spec.go#L53)</sup>
 
 SecretName setting specifies the name of a kubernetes `Secret` that contains
-the license key token used for enterprise images. This value is not used for
+the license key token or master key used for enterprise images. This value is not used for
 the Community Edition.
 
 ***
 
+### .spec.license.telemetry
+
+Type: `boolean` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.3.1/pkg/apis/deployment/v1/license_spec.go#L72)</sup>
+
+Telemetry defines if telemetry is collected
+
+Default Value: `true`
+
+***
+
+### .spec.license.ttl
+
+Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.3.1/pkg/apis/deployment/v1/license_spec.go#L64)</sup>
+
+TTL Sets the requested License TTL
+
+Default Value: `336h`
+
+***
+
 ### .spec.lifecycle.resources
 
 Type: `core.ResourceRequirements` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.3.1/pkg/apis/deployment/v1/lifecycle_spec.go#L31)</sup>

docs/generated/actions.md

@@ -47,6 +47,8 @@ nav_order: 11
 | JWTSetActive | no | 10m0s | no | Enterprise Only | Change active JWT key on the cluster |
 | JWTStatusUpdate | no | 10m0s | no | Enterprise Only | Update status of JWT propagation |
 | KillMemberPod | no | 10m0s | no | Community & Enterprise | Execute Delete on Pod (put pod in Terminating state) |
+| LicenseClean | no | 10m0s | no | Community & Enterprise | Removes the License reference from the status |
+| LicenseGenerate | no | 10m0s | no | Community & Enterprise | Generates License using ArangoDB LicenseManager Endpoint |
 | LicenseSet | no | 10m0s | no | Community & Enterprise | Update Cluster license (3.9+) |
 | MarkToRemoveMember | no | 10m0s | no | Community & Enterprise | Marks member to be removed. Used when member Pod is annotated with replace annotation |
 | MemberPhaseUpdate | no | 10m0s | no | Community & Enterprise | Change member phase |
@@ -78,6 +80,7 @@ nav_order: 11
 | RuntimeContainerArgsLogLevelUpdate | no | 10m0s | no | Community & Enterprise | Change ArangoDB Member log levels in runtime |
 | RuntimeContainerImageUpdate | no | 10m0s | no | Community & Enterprise | Update Container Image in runtime |
 | RuntimeContainerSyncTolerations | no | 10m0s | no | Community & Enterprise | Update Pod Tolerations in runtime |
+| SetAnnotation | yes | 10m0s | no | Community & Enterprise | Set ArangoDeployment annotation |
 | ~~SetCondition~~ | no | 10m0s | no | Community & Enterprise | Set deployment condition |
 | SetConditionV2 | yes | 10m0s | no | Community & Enterprise | Set deployment condition |
 | SetCurrentImage | no | 6h0m0s | no | Community & Enterprise | Update deployment current image after image discovery |
@@ -146,6 +149,8 @@ spec:
       JWTSetActive: 10m0s
       JWTStatusUpdate: 10m0s
       KillMemberPod: 10m0s
+      LicenseClean: 10m0s
+      LicenseGenerate: 10m0s
       LicenseSet: 10m0s
       MarkToRemoveMember: 10m0s
       MemberPhaseUpdate: 10m0s
@@ -177,6 +182,7 @@ spec:
       RuntimeContainerArgsLogLevelUpdate: 10m0s
       RuntimeContainerImageUpdate: 10m0s
       RuntimeContainerSyncTolerations: 10m0s
+      SetAnnotation: 10m0s
       SetCondition: 10m0s
       SetConditionV2: 10m0s
       SetCurrentImage: 6h0m0s

internal/actions.yaml

@@ -232,6 +232,11 @@ actions:
     scopes:
       - High
     isInternal: true
+  SetAnnotation:
+    description: Set ArangoDeployment annotation
+    scopes:
+      - High
+    isInternal: true
   MemberRIDUpdate:
     description: Update Run ID of member
     scopes:
@@ -247,6 +252,10 @@ actions:
       - High
   LicenseSet:
     description: Update Cluster license (3.9+)
+  LicenseGenerate:
+    description: Generates License using ArangoDB LicenseManager Endpoint
+  LicenseClean:
+    description: Removes the License reference from the status
   RuntimeContainerImageUpdate:
     description: Update Container Image in runtime
   RuntimeContainerSyncTolerations:

pkg/apis/deployment/v1/actions.generated.go

@@ -1,7 +1,7 @@
 //
 // DISCLAIMER
 //
-// Copyright 2016-2024 ArangoDB GmbH, Cologne, Germany
+// Copyright 2016-2025 ArangoDB GmbH, Cologne, Germany
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -53,6 +53,7 @@ type DeploymentStatus struct {
 
 	// Images holds a list of ArangoDB images with their ID and ArangoDB version.
 	Images ImageInfoList `json:"arangodb-images,omitempty"`
+
 	// Image that is currently being used when new pods are created
 	CurrentImage *ImageInfo `json:"current-image,omitempty"`
 
@@ -97,6 +98,8 @@ type DeploymentStatus struct {
 
 	Timezone *string `json:"timezone,omitempty"`
 
+	License *DeploymentStatusLicense `json:"license,omitempty"`
+
 	Single       *ServerGroupStatus `json:"single,omitempty"`
 	Agents       *ServerGroupStatus `json:"agents,omitempty"`
 	DBServers    *ServerGroupStatus `json:"dbservers,omitempty"`
@@ -135,7 +138,8 @@ func (ds *DeploymentStatus) Equal(other DeploymentStatus) bool {
 		ds.Coordinators.Equal(other.Coordinators) &&
 		ds.SyncMasters.Equal(other.SyncMasters) &&
 		ds.SyncWorkers.Equal(other.SyncWorkers) &&
-		strings.CompareStringPointers(ds.Timezone, other.Timezone)
+		strings.CompareStringPointers(ds.Timezone, other.Timezone) &&
+		ds.License.Equal(other.License)
 }
 
 // IsForceReload returns true if ForceStatusReload is set to true
@@ -147,6 +151,14 @@ func (ds *DeploymentStatus) IsPlanEmpty() bool {
 	return ds.Plan.IsEmpty() && ds.HighPriorityPlan.IsEmpty()
 }
 
+func (ds *DeploymentStatus) IsEnterprise() bool {
+	if ds == nil {
+		return false
+	}
+
+	return ds.CurrentImage.IsEnterprise()
+}
+
 func (ds *DeploymentStatus) NonInternalActions() int {
 	return ds.Plan.NonInternalActions() + ds.HighPriorityPlan.NonInternalActions()
 }

pkg/apis/deployment/v1/deployment_status.go

@@ -0,0 +1,54 @@
+//
+// DISCLAIMER
+//
+// Copyright 2025 ArangoDB GmbH, Cologne, Germany
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// Copyright holder is ArangoDB GmbH, Cologne, Germany
+//
+
+package v1
+
+import meta "k8s.io/apimachinery/pkg/apis/meta/v1"
+
+// DeploymentStatusLicense contains the status part of a Cluster resource.
+type DeploymentStatusLicense struct {
+	// ID Defines the License ID
+	ID string `json:"id,omitempty"`
+
+	// Hash Defines the License Hash
+	Hash string `json:"hash,omitempty"`
+
+	// Expires Defines the expiration time of the License
+	Expires meta.Time `json:"expires,omitempty"`
+
+	// Regenerate Defines the time when license will be regenerated
+	Regenerate meta.Time `json:"regenerate,omitempty"`
+
+	// Mode defines the license mode
+	Mode LicenseMode `json:"mode,omitempty"`
+}
+
+// Equal checks for equality
+func (ds *DeploymentStatusLicense) Equal(other *DeploymentStatusLicense) bool {
+	if ds == nil && other == nil {
+		return true
+	}
+
+	if ds == nil || other == nil {
+		return false
+	}
+
+	return ds.ID == other.ID && ds.Hash == other.Hash
+}

pkg/apis/deployment/v1/deployment_status_license.go

@@ -1,7 +1,7 @@
 //
 // DISCLAIMER
 //
-// Copyright 2016-2022 ArangoDB GmbH, Cologne, Germany
+// Copyright 2016-2025 ArangoDB GmbH, Cologne, Germany
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -48,6 +48,15 @@ func (i *ImageInfo) String() string {
 	return fmt.Sprintf("ArangoDB %s %s (%s)", e, string(i.ArangoDBVersion), i.Image)
 }
 
+// IsEnterprise returns true if image is enterprise
+func (i *ImageInfo) IsEnterprise() bool {
+	if i == nil {
+		return false
+	}
+
+	return i.Enterprise
+}
+
 // ImageInfoList is a list of image infos
 type ImageInfoList []ImageInfo