This change adds a new "agent mode" to GARM. The agent enables GARM to set up a persistent websocket connection between the garm server and the runners it spawns. The goal is to be able to easier keep track of state, even without subsequent webhooks from the forge. The Agent will report via websockets when the runner is actually online, when it started a job and when it finished a job. Additionally, the agent allows us to enable optional remote shell between the user and any runner that is spun up using agent mode. The remote shell is multiplexed over the same persistent websocket connection the agent sets up with the server (the agent never listens on a port). Enablement has also been done in the web UI for this functionality. Signed-off-by: Gabriel Adrian Samfira <gsamfira@cloudbasesolutions.com>
469 lines
13 KiB
Go
469 lines
13 KiB
Go
// Copyright 2025 Cloudbase Solutions SRL
|
|
//
|
|
// 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.
|
|
|
|
package sql
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
"fmt"
|
|
|
|
"github.com/google/uuid"
|
|
"gorm.io/datatypes"
|
|
"gorm.io/gorm"
|
|
|
|
runnerErrors "github.com/cloudbase/garm-provider-common/errors"
|
|
"github.com/cloudbase/garm/database/common"
|
|
"github.com/cloudbase/garm/params"
|
|
)
|
|
|
|
func (s *sqlDatabase) ListAllScaleSets(_ context.Context) ([]params.ScaleSet, error) {
|
|
var scaleSets []ScaleSet
|
|
|
|
q := s.conn.Model(&ScaleSet{}).
|
|
Preload("Organization").
|
|
Preload("Organization.Endpoint").
|
|
Preload("Repository").
|
|
Preload("Repository.Endpoint").
|
|
Preload("Enterprise").
|
|
Preload("Enterprise.Endpoint").
|
|
Omit("extra_specs").
|
|
Omit("status_messages").
|
|
Find(&scaleSets)
|
|
if q.Error != nil {
|
|
return nil, fmt.Errorf("error fetching all scale sets: %w", q.Error)
|
|
}
|
|
|
|
ret := make([]params.ScaleSet, len(scaleSets))
|
|
var err error
|
|
for idx, val := range scaleSets {
|
|
ret[idx], err = s.sqlToCommonScaleSet(val)
|
|
if err != nil {
|
|
return nil, fmt.Errorf("error converting scale sets: %w", err)
|
|
}
|
|
}
|
|
return ret, nil
|
|
}
|
|
|
|
func (s *sqlDatabase) CreateEntityScaleSet(ctx context.Context, entity params.ForgeEntity, param params.CreateScaleSetParams) (scaleSet params.ScaleSet, err error) {
|
|
if err := param.Validate(); err != nil {
|
|
return params.ScaleSet{}, fmt.Errorf("failed to validate create params: %w", err)
|
|
}
|
|
|
|
defer func() {
|
|
if err == nil {
|
|
s.sendNotify(common.ScaleSetEntityType, common.CreateOperation, scaleSet)
|
|
}
|
|
}()
|
|
|
|
newScaleSet := ScaleSet{
|
|
Name: param.Name,
|
|
ScaleSetID: param.ScaleSetID,
|
|
DisableUpdate: param.DisableUpdate,
|
|
ProviderName: param.ProviderName,
|
|
RunnerPrefix: param.GetRunnerPrefix(),
|
|
MaxRunners: param.MaxRunners,
|
|
MinIdleRunners: param.MinIdleRunners,
|
|
RunnerBootstrapTimeout: param.RunnerBootstrapTimeout,
|
|
Image: param.Image,
|
|
Flavor: param.Flavor,
|
|
OSType: param.OSType,
|
|
OSArch: param.OSArch,
|
|
Enabled: param.Enabled,
|
|
GitHubRunnerGroup: param.GitHubRunnerGroup,
|
|
State: params.ScaleSetPendingCreate,
|
|
TemplateID: param.TemplateID,
|
|
EnableShell: param.EnableShell,
|
|
}
|
|
|
|
if len(param.ExtraSpecs) > 0 {
|
|
newScaleSet.ExtraSpecs = datatypes.JSON(param.ExtraSpecs)
|
|
}
|
|
|
|
entityID, err := uuid.Parse(entity.ID)
|
|
if err != nil {
|
|
return params.ScaleSet{}, fmt.Errorf("error parsing id: %w", runnerErrors.ErrBadRequest)
|
|
}
|
|
|
|
switch entity.EntityType {
|
|
case params.ForgeEntityTypeRepository:
|
|
newScaleSet.RepoID = &entityID
|
|
case params.ForgeEntityTypeOrganization:
|
|
newScaleSet.OrgID = &entityID
|
|
case params.ForgeEntityTypeEnterprise:
|
|
newScaleSet.EnterpriseID = &entityID
|
|
}
|
|
err = s.conn.Transaction(func(tx *gorm.DB) error {
|
|
if err := s.hasGithubEntity(tx, entity.EntityType, entity.ID); err != nil {
|
|
return fmt.Errorf("error checking entity existence: %w", err)
|
|
}
|
|
|
|
q := tx.Create(&newScaleSet)
|
|
if q.Error != nil {
|
|
return fmt.Errorf("error creating scale set: %w", q.Error)
|
|
}
|
|
|
|
return nil
|
|
})
|
|
if err != nil {
|
|
return params.ScaleSet{}, err
|
|
}
|
|
|
|
dbScaleSet, err := s.GetScaleSetByID(ctx, newScaleSet.ID)
|
|
if err != nil {
|
|
return params.ScaleSet{}, fmt.Errorf("error fetching scale set: %w", err)
|
|
}
|
|
|
|
return dbScaleSet, nil
|
|
}
|
|
|
|
func (s *sqlDatabase) listEntityScaleSets(tx *gorm.DB, entityType params.ForgeEntityType, entityID string, preload ...string) ([]ScaleSet, error) {
|
|
if _, err := uuid.Parse(entityID); err != nil {
|
|
return nil, fmt.Errorf("error parsing id: %w", runnerErrors.ErrBadRequest)
|
|
}
|
|
|
|
if err := s.hasGithubEntity(tx, entityType, entityID); err != nil {
|
|
return nil, fmt.Errorf("error checking entity existence: %w", err)
|
|
}
|
|
|
|
var preloadEntity string
|
|
var fieldName string
|
|
switch entityType {
|
|
case params.ForgeEntityTypeRepository:
|
|
fieldName = entityTypeRepoName
|
|
preloadEntity = repositoryFieldName
|
|
case params.ForgeEntityTypeOrganization:
|
|
fieldName = entityTypeOrgName
|
|
preloadEntity = organizationFieldName
|
|
case params.ForgeEntityTypeEnterprise:
|
|
fieldName = entityTypeEnterpriseName
|
|
preloadEntity = enterpriseFieldName
|
|
default:
|
|
return nil, fmt.Errorf("invalid entityType: %v", entityType)
|
|
}
|
|
|
|
q := tx
|
|
q = q.Preload(preloadEntity)
|
|
if len(preload) > 0 {
|
|
for _, item := range preload {
|
|
q = q.Preload(item)
|
|
}
|
|
}
|
|
|
|
var scaleSets []ScaleSet
|
|
condition := fmt.Sprintf("%s = ?", fieldName)
|
|
err := q.Model(&ScaleSet{}).
|
|
Where(condition, entityID).
|
|
Omit("extra_specs").
|
|
Omit("status_messages").
|
|
Find(&scaleSets).Error
|
|
if err != nil {
|
|
if errors.Is(err, gorm.ErrRecordNotFound) {
|
|
return []ScaleSet{}, nil
|
|
}
|
|
return nil, fmt.Errorf("error fetching scale sets: %w", err)
|
|
}
|
|
|
|
return scaleSets, nil
|
|
}
|
|
|
|
func (s *sqlDatabase) ListEntityScaleSets(_ context.Context, entity params.ForgeEntity) ([]params.ScaleSet, error) {
|
|
scaleSets, err := s.listEntityScaleSets(s.conn, entity.EntityType, entity.ID)
|
|
if err != nil {
|
|
return nil, fmt.Errorf("error fetching scale sets: %w", err)
|
|
}
|
|
|
|
ret := make([]params.ScaleSet, len(scaleSets))
|
|
for idx, set := range scaleSets {
|
|
ret[idx], err = s.sqlToCommonScaleSet(set)
|
|
if err != nil {
|
|
return nil, fmt.Errorf("error conbverting scale set: %w", err)
|
|
}
|
|
}
|
|
|
|
return ret, nil
|
|
}
|
|
|
|
func (s *sqlDatabase) UpdateEntityScaleSet(ctx context.Context, entity params.ForgeEntity, scaleSetID uint, param params.UpdateScaleSetParams, callback func(old, newSet params.ScaleSet) error) (updatedScaleSet params.ScaleSet, err error) {
|
|
defer func() {
|
|
if err == nil {
|
|
s.sendNotify(common.ScaleSetEntityType, common.UpdateOperation, updatedScaleSet)
|
|
}
|
|
}()
|
|
err = s.conn.Transaction(func(tx *gorm.DB) error {
|
|
scaleSet, err := s.getEntityScaleSet(tx, entity.EntityType, entity.ID, scaleSetID, "Instances")
|
|
if err != nil {
|
|
return fmt.Errorf("error fetching scale set: %w", err)
|
|
}
|
|
|
|
old, err := s.sqlToCommonScaleSet(scaleSet)
|
|
if err != nil {
|
|
return fmt.Errorf("error converting scale set: %w", err)
|
|
}
|
|
|
|
updatedScaleSet, err = s.updateScaleSet(tx, scaleSet, param)
|
|
if err != nil {
|
|
return fmt.Errorf("error updating scale set: %w", err)
|
|
}
|
|
|
|
if callback != nil {
|
|
if err := callback(old, updatedScaleSet); err != nil {
|
|
return fmt.Errorf("error executing update callback: %w", err)
|
|
}
|
|
}
|
|
return nil
|
|
})
|
|
if err != nil {
|
|
return params.ScaleSet{}, err
|
|
}
|
|
|
|
updatedScaleSet, err = s.GetScaleSetByID(ctx, scaleSetID)
|
|
if err != nil {
|
|
return params.ScaleSet{}, err
|
|
}
|
|
return updatedScaleSet, nil
|
|
}
|
|
|
|
func (s *sqlDatabase) getEntityScaleSet(tx *gorm.DB, entityType params.ForgeEntityType, entityID string, scaleSetID uint, preload ...string) (ScaleSet, error) {
|
|
if entityID == "" {
|
|
return ScaleSet{}, fmt.Errorf("error missing entity id: %w", runnerErrors.ErrBadRequest)
|
|
}
|
|
|
|
if scaleSetID == 0 {
|
|
return ScaleSet{}, fmt.Errorf("error missing scaleset id: %w", runnerErrors.ErrBadRequest)
|
|
}
|
|
|
|
var fieldName string
|
|
var entityField string
|
|
switch entityType {
|
|
case params.ForgeEntityTypeRepository:
|
|
fieldName = entityTypeRepoName
|
|
entityField = "Repository"
|
|
case params.ForgeEntityTypeOrganization:
|
|
fieldName = entityTypeOrgName
|
|
entityField = "Organization"
|
|
case params.ForgeEntityTypeEnterprise:
|
|
fieldName = entityTypeEnterpriseName
|
|
entityField = "Enterprise"
|
|
default:
|
|
return ScaleSet{}, fmt.Errorf("invalid entityType: %v", entityType)
|
|
}
|
|
|
|
q := tx
|
|
q = q.Preload(entityField)
|
|
if len(preload) > 0 {
|
|
for _, item := range preload {
|
|
q = q.Preload(item)
|
|
}
|
|
}
|
|
|
|
var scaleSet ScaleSet
|
|
condition := fmt.Sprintf("id = ? and %s = ?", fieldName)
|
|
err := q.Model(&ScaleSet{}).
|
|
Where(condition, scaleSetID, entityID).
|
|
First(&scaleSet).Error
|
|
if err != nil {
|
|
if errors.Is(err, gorm.ErrRecordNotFound) {
|
|
return ScaleSet{}, fmt.Errorf("error finding scale set: %w", runnerErrors.ErrNotFound)
|
|
}
|
|
return ScaleSet{}, fmt.Errorf("error fetching scale set: %w", err)
|
|
}
|
|
|
|
return scaleSet, nil
|
|
}
|
|
|
|
func (s *sqlDatabase) updateScaleSet(tx *gorm.DB, scaleSet ScaleSet, param params.UpdateScaleSetParams) (params.ScaleSet, error) {
|
|
if param.Enabled != nil && scaleSet.Enabled != *param.Enabled {
|
|
scaleSet.Enabled = *param.Enabled
|
|
}
|
|
|
|
if param.State != nil && *param.State != scaleSet.State {
|
|
scaleSet.State = *param.State
|
|
}
|
|
|
|
if param.ExtendedState != nil && *param.ExtendedState != scaleSet.ExtendedState {
|
|
scaleSet.ExtendedState = *param.ExtendedState
|
|
}
|
|
|
|
if param.ScaleSetID != 0 {
|
|
scaleSet.ScaleSetID = param.ScaleSetID
|
|
}
|
|
|
|
if param.TemplateID != nil {
|
|
scaleSet.TemplateID = param.TemplateID
|
|
}
|
|
|
|
if param.EnableShell != nil {
|
|
scaleSet.EnableShell = *param.EnableShell
|
|
}
|
|
|
|
if param.Name != "" {
|
|
scaleSet.Name = param.Name
|
|
}
|
|
|
|
if param.GitHubRunnerGroup != nil && *param.GitHubRunnerGroup != "" {
|
|
scaleSet.GitHubRunnerGroup = *param.GitHubRunnerGroup
|
|
}
|
|
|
|
if param.Flavor != "" {
|
|
scaleSet.Flavor = param.Flavor
|
|
}
|
|
|
|
if param.Image != "" {
|
|
scaleSet.Image = param.Image
|
|
}
|
|
|
|
if param.Prefix != "" {
|
|
scaleSet.RunnerPrefix = param.Prefix
|
|
}
|
|
|
|
if param.MaxRunners != nil {
|
|
scaleSet.MaxRunners = *param.MaxRunners
|
|
}
|
|
|
|
if param.MinIdleRunners != nil {
|
|
scaleSet.MinIdleRunners = *param.MinIdleRunners
|
|
}
|
|
|
|
if param.OSArch != "" {
|
|
scaleSet.OSArch = param.OSArch
|
|
}
|
|
|
|
if param.OSType != "" {
|
|
scaleSet.OSType = param.OSType
|
|
}
|
|
|
|
if param.ExtraSpecs != nil {
|
|
scaleSet.ExtraSpecs = datatypes.JSON(param.ExtraSpecs)
|
|
}
|
|
|
|
if param.RunnerBootstrapTimeout != nil && *param.RunnerBootstrapTimeout > 0 {
|
|
scaleSet.RunnerBootstrapTimeout = *param.RunnerBootstrapTimeout
|
|
}
|
|
|
|
if param.GitHubRunnerGroup != nil {
|
|
scaleSet.GitHubRunnerGroup = *param.GitHubRunnerGroup
|
|
}
|
|
|
|
if q := tx.Save(&scaleSet); q.Error != nil {
|
|
return params.ScaleSet{}, fmt.Errorf("error saving database entry: %w", q.Error)
|
|
}
|
|
|
|
return s.sqlToCommonScaleSet(scaleSet)
|
|
}
|
|
|
|
func (s *sqlDatabase) GetScaleSetByID(_ context.Context, scaleSet uint) (params.ScaleSet, error) {
|
|
set, err := s.getScaleSetByID(
|
|
s.conn,
|
|
scaleSet,
|
|
"Instances",
|
|
"Enterprise",
|
|
"Enterprise.Endpoint",
|
|
"Organization",
|
|
"Organization.Endpoint",
|
|
"Repository",
|
|
"Repository.Endpoint",
|
|
"Template",
|
|
)
|
|
if err != nil {
|
|
return params.ScaleSet{}, fmt.Errorf("error fetching scale set by ID: %w", err)
|
|
}
|
|
return s.sqlToCommonScaleSet(set)
|
|
}
|
|
|
|
func (s *sqlDatabase) DeleteScaleSetByID(_ context.Context, scaleSetID uint) (err error) {
|
|
var scaleSet params.ScaleSet
|
|
defer func() {
|
|
if err == nil && scaleSet.ID != 0 {
|
|
s.sendNotify(common.ScaleSetEntityType, common.DeleteOperation, scaleSet)
|
|
}
|
|
}()
|
|
err = s.conn.Transaction(func(tx *gorm.DB) error {
|
|
dbSet, err := s.getScaleSetByID(tx, scaleSetID, "Instances", "Enterprise", "Organization", "Repository")
|
|
if err != nil {
|
|
return fmt.Errorf("error fetching scale set: %w", err)
|
|
}
|
|
|
|
if len(dbSet.Instances) > 0 {
|
|
return runnerErrors.NewBadRequestError("cannot delete scaleset with runners")
|
|
}
|
|
scaleSet, err = s.sqlToCommonScaleSet(dbSet)
|
|
if err != nil {
|
|
return fmt.Errorf("error converting scale set: %w", err)
|
|
}
|
|
|
|
if q := tx.Unscoped().Delete(&dbSet); q.Error != nil {
|
|
return fmt.Errorf("error deleting scale set: %w", q.Error)
|
|
}
|
|
return nil
|
|
})
|
|
if err != nil {
|
|
return fmt.Errorf("error removing scale set: %w", err)
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func (s *sqlDatabase) SetScaleSetLastMessageID(_ context.Context, scaleSetID uint, lastMessageID int64) (err error) {
|
|
var scaleSet params.ScaleSet
|
|
defer func() {
|
|
if err == nil && scaleSet.ID != 0 {
|
|
s.sendNotify(common.ScaleSetEntityType, common.UpdateOperation, scaleSet)
|
|
}
|
|
}()
|
|
if err := s.conn.Transaction(func(tx *gorm.DB) error {
|
|
dbSet, err := s.getScaleSetByID(tx, scaleSetID, "Instances", "Enterprise", "Organization", "Repository")
|
|
if err != nil {
|
|
return fmt.Errorf("error fetching scale set: %w", err)
|
|
}
|
|
dbSet.LastMessageID = lastMessageID
|
|
if err := tx.Save(&dbSet).Error; err != nil {
|
|
return fmt.Errorf("error saving database entry: %w", err)
|
|
}
|
|
scaleSet, err = s.sqlToCommonScaleSet(dbSet)
|
|
if err != nil {
|
|
return fmt.Errorf("error converting scale set: %w", err)
|
|
}
|
|
return nil
|
|
}); err != nil {
|
|
return fmt.Errorf("error setting last message ID: %w", err)
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func (s *sqlDatabase) SetScaleSetDesiredRunnerCount(_ context.Context, scaleSetID uint, desiredRunnerCount int) (err error) {
|
|
var scaleSet params.ScaleSet
|
|
defer func() {
|
|
if err == nil && scaleSet.ID != 0 {
|
|
s.sendNotify(common.ScaleSetEntityType, common.UpdateOperation, scaleSet)
|
|
}
|
|
}()
|
|
if err := s.conn.Transaction(func(tx *gorm.DB) error {
|
|
dbSet, err := s.getScaleSetByID(tx, scaleSetID, "Instances", "Enterprise", "Organization", "Repository")
|
|
if err != nil {
|
|
return fmt.Errorf("error fetching scale set: %w", err)
|
|
}
|
|
dbSet.DesiredRunnerCount = desiredRunnerCount
|
|
if err := tx.Save(&dbSet).Error; err != nil {
|
|
return fmt.Errorf("error saving database entry: %w", err)
|
|
}
|
|
scaleSet, err = s.sqlToCommonScaleSet(dbSet)
|
|
if err != nil {
|
|
return fmt.Errorf("error converting scale set: %w", err)
|
|
}
|
|
return nil
|
|
}); err != nil {
|
|
return fmt.Errorf("error setting desired runner count: %w", err)
|
|
}
|
|
return nil
|
|
}
|