1790afd0ee
Adds AddIngressPath and RemoveIngressPath to the Deployer interface for managing per-component ingress rules in monorepo projects. - Implement conflict retry logic for concurrent ingress updates - Add K8s client interface for testability - Add comprehensive unit tests for ingress path operations - Add component deployment and teardown methods to ComponentService - Update service templates with OpenAPI spec improvements - Add evolving-app cookbook tree for reference - Split resources.go into resources_ingress.go for path-based routing - Split component.go into component_deploy.go for deployment helpers Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
74 lines
3.5 KiB
Go
74 lines
3.5 KiB
Go
// Package port defines interfaces (ports) for external dependencies.
|
|
package port
|
|
|
|
import (
|
|
"context"
|
|
|
|
"github.com/orchard9/rdev/internal/domain"
|
|
)
|
|
|
|
// Deployer manages application deployments to Kubernetes.
|
|
type Deployer interface {
|
|
// Deploy creates or updates a deployment for a project.
|
|
// This includes creating/updating Deployment, Service, and Ingress resources.
|
|
// For monorepo projects with ComponentPath set, creates component-specific resources.
|
|
Deploy(ctx context.Context, spec domain.DeploySpec) error
|
|
|
|
// Undeploy removes all deployment resources for a project.
|
|
Undeploy(ctx context.Context, projectName string) error
|
|
|
|
// UndeployComponent removes deployment resources for a specific component.
|
|
// The componentPath is the path within the monorepo (e.g., "services/auth-api").
|
|
UndeployComponent(ctx context.Context, projectName, componentPath string) error
|
|
|
|
// GetStatus returns the current deployment status for a project.
|
|
// Returns nil if no deployment exists.
|
|
GetStatus(ctx context.Context, projectName string) (*domain.DeployStatus, error)
|
|
|
|
// GetComponentStatus returns deployment status for a specific component.
|
|
// Returns nil if no deployment exists for the component.
|
|
GetComponentStatus(ctx context.Context, projectName, componentPath string) (*domain.DeployStatus, error)
|
|
|
|
// ListComponentStatuses returns deployment status for all components in a project.
|
|
ListComponentStatuses(ctx context.Context, projectName string) (*domain.ProjectDeployStatus, error)
|
|
|
|
// Restart triggers a rolling restart of the deployment.
|
|
// This is useful for picking up new images with the same tag.
|
|
Restart(ctx context.Context, projectName string) error
|
|
|
|
// RestartComponent triggers a rolling restart of a specific component.
|
|
RestartComponent(ctx context.Context, projectName, componentPath string) error
|
|
|
|
// Scale adjusts the replica count for a deployment.
|
|
Scale(ctx context.Context, projectName string, replicas int) error
|
|
|
|
// ScaleComponent adjusts the replica count for a component.
|
|
ScaleComponent(ctx context.Context, projectName, componentPath string, replicas int) error
|
|
|
|
// GetLogs returns recent logs from the deployment pods.
|
|
// tailLines specifies how many recent lines to return.
|
|
GetLogs(ctx context.Context, projectName string, tailLines int) (string, error)
|
|
|
|
// GetComponentLogs returns recent logs from a specific component's pods.
|
|
GetComponentLogs(ctx context.Context, projectName, componentPath string, tailLines int) (string, error)
|
|
|
|
// AddIngressHost adds a new host to an existing project's ingress.
|
|
// This is used when adding domain aliases to a project.
|
|
// The host is added to both the TLS configuration and the routing rules.
|
|
AddIngressHost(ctx context.Context, projectName, host string) error
|
|
|
|
// RemoveIngressHost removes a host from an existing project's ingress.
|
|
// This is used when removing domain aliases from a project.
|
|
RemoveIngressHost(ctx context.Context, projectName, host string) error
|
|
|
|
// AddIngressPath adds or updates a path rule in the project's unified Ingress.
|
|
// For monorepo projects, all components share a single Ingress with path-based routing.
|
|
// The path is the URL prefix (e.g., "/api/auth", "/").
|
|
AddIngressPath(ctx context.Context, projectName, host, path, serviceName string, servicePort int) error
|
|
|
|
// RemoveIngressPath removes a path rule from the project's unified Ingress.
|
|
// If no paths remain for a host, the host rule is removed.
|
|
// If no rules remain, the Ingress is deleted.
|
|
RemoveIngressPath(ctx context.Context, projectName, host, path string) error
|
|
}
|