types

package
v1.15.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Feb 15, 2026 License: BSD-3-Clause Imports: 1 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var Endpoints = ArcaneApiEndpoints{}/* 111 elements not displayed */

Endpoints contains the defined API endpoints

Functions

This section is empty.

Types

type ArcaneApiEndpoints 

type ArcaneApiEndpoints struct {
	// Version & Health
	AppVersionEndpoint string
	VersionEndpoint    string
	HealthEndpoint     string

	// Authentication
	AuthLoginEndpoint    string
	AuthLogoutEndpoint   string
	AuthMeEndpoint       string
	AuthPasswordEndpoint string
	AuthRefreshEndpoint  string

	// OIDC
	OIDCStatusEndpoint      string
	OIDCConfigEndpoint      string
	OIDCUrlEndpoint         string
	OIDCCallbackEndpoint    string
	OIDCDeviceCodeEndpoint  string
	OIDCDeviceTokenEndpoint string

	// API Keys
	ApiKeysEndpoint string
	ApiKeyEndpoint  string

	// Users
	UsersEndpoint string
	UserEndpoint  string

	// Environments
	EnvironmentsEndpoint     string
	EnvironmentEndpoint      string
	EnvironmentPairEndpoint  string
	EnvironmentAgentEndpoint string
	EnvironmentTestEndpoint  string

	// Containers
	ContainersEndpoint       string
	ContainerEndpoint        string
	ContainerStartEndpoint   string
	ContainerStopEndpoint    string
	ContainerRestartEndpoint string
	ContainerUpdateEndpoint  string
	ContainersCountsEndpoint string

	// Images
	ImagesEndpoint       string
	ImageEndpoint        string
	ImagesPullEndpoint   string
	ImagesPruneEndpoint  string
	ImagesCountsEndpoint string
	ImagesUploadEndpoint string

	// Image Updates
	ImageUpdatesCheckEndpoint      string
	ImageUpdatesCheckAllEndpoint   string
	ImageUpdatesCheckBatchEndpoint string
	ImageUpdatesCheckByIdEndpoint  string
	ImageUpdatesSummaryEndpoint    string

	// Networks
	NetworksEndpoint       string
	NetworkEndpoint        string
	NetworksCountsEndpoint string
	NetworksPruneEndpoint  string

	// Volumes
	VolumesEndpoint       string
	VolumeEndpoint        string
	VolumesCountsEndpoint string
	VolumesPruneEndpoint  string
	VolumesSizesEndpoint  string
	VolumeUsageEndpoint   string

	// Projects (Stacks)
	ProjectsEndpoint        string
	ProjectEndpoint         string
	ProjectsCountsEndpoint  string
	ProjectDestroyEndpoint  string
	ProjectUpEndpoint       string
	ProjectDownEndpoint     string
	ProjectRestartEndpoint  string
	ProjectRedeployEndpoint string
	ProjectPullEndpoint     string
	ProjectIncludesEndpoint string

	// System
	SystemPruneEndpoint                  string
	SystemHealthEndpoint                 string
	SystemDockerInfoEndpoint             string
	SystemConvertEndpoint                string
	SystemContainersStartAllEndpoint     string
	SystemContainersStopAllEndpoint      string
	SystemContainersStartStoppedEndpoint string
	SystemUpgradeCheckEndpoint           string
	SystemUpgradeEndpoint                string

	// Updater
	UpdaterStatusEndpoint  string
	UpdaterRunEndpoint     string
	UpdaterHistoryEndpoint string

	// Job Schedules
	JobSchedulesEndpoint string

	// Settings
	SettingsEndpoint           string
	SettingsPublicEndpoint     string
	SettingsCategoriesEndpoint string
	SettingsSearchEndpoint     string

	// Notifications
	NotificationsAppriseEndpoint     string
	NotificationsAppriseTestEndpoint string
	NotificationsSettingsEndpoint    string
	NotificationSettingEndpoint      string
	NotificationTestEndpoint         string

	// Container Registries
	ContainerRegistriesEndpoint       string
	ContainerRegistryEndpoint         string
	ContainerRegistrySyncEndpoint     string
	ContainerRegistryTestEndpoint     string
	EnvironmentSyncRegistriesEndpoint string

	// Events
	EventsEndpoint            string
	EventEndpoint             string
	EventsEnvironmentEndpoint string

	// Templates
	TemplatesEndpoint           string
	TemplateEndpoint            string
	TemplatesAllEndpoint        string
	TemplatesDefaultEndpoint    string
	TemplatesFetchEndpoint      string
	TemplatesRegistriesEndpoint string
	TemplateRegistryEndpoint    string
	TemplatesVariablesEndpoint  string
	TemplateContentEndpoint     string
	TemplateDownloadEndpoint    string

	// Deployment
	DeploymentEndpoint string
	HeartbeatEndpoint  string

	// Assets
	AppImagesFaviconEndpoint string
	AppImagesLogoEndpoint    string
	AppImagesProfileEndpoint string
	FontsMonoEndpoint        string
	FontsSansEndpoint        string
	FontsSerifEndpoint       string

	// Customization
	CustomizeCategoriesEndpoint string
	CustomizeSearchEndpoint     string
}

ArcaneApiEndpoints holds the API endpoint path templates for the Arcane API. Endpoint paths may contain format specifiers (e.g., %s) for environment IDs or resource IDs.

func (ArcaneApiEndpoints) ApiKey 

func (e ArcaneApiEndpoints) ApiKey(id string) string

func (ArcaneApiEndpoints) ApiKeys 

func (e ArcaneApiEndpoints) ApiKeys() string

API Key endpoints

func (ArcaneApiEndpoints) AppVersion 

func (e ArcaneApiEndpoints) AppVersion() string

Version & Health endpoints

func (ArcaneApiEndpoints) AuthLogin 

func (e ArcaneApiEndpoints) AuthLogin() string

Auth endpoints

func (ArcaneApiEndpoints) AuthLogout 

func (e ArcaneApiEndpoints) AuthLogout() string

func (ArcaneApiEndpoints) AuthMe 

func (e ArcaneApiEndpoints) AuthMe() string

func (ArcaneApiEndpoints) AuthPassword 

func (e ArcaneApiEndpoints) AuthPassword() string

func (ArcaneApiEndpoints) AuthRefresh 

func (e ArcaneApiEndpoints) AuthRefresh() string

func (ArcaneApiEndpoints) Container 

func (e ArcaneApiEndpoints) Container(envID, containerID string) string

func (ArcaneApiEndpoints) ContainerRegistries 

func (e ArcaneApiEndpoints) ContainerRegistries() string

Container Registry endpoints

func (ArcaneApiEndpoints) ContainerRegistry 

func (e ArcaneApiEndpoints) ContainerRegistry(id string) string

func (ArcaneApiEndpoints) ContainerRegistrySync 

func (e ArcaneApiEndpoints) ContainerRegistrySync() string

func (ArcaneApiEndpoints) ContainerRegistryTest 

func (e ArcaneApiEndpoints) ContainerRegistryTest(id string) string

func (ArcaneApiEndpoints) ContainerRestart 

func (e ArcaneApiEndpoints) ContainerRestart(envID, containerID string) string

func (ArcaneApiEndpoints) ContainerStart 

func (e ArcaneApiEndpoints) ContainerStart(envID, containerID string) string

func (ArcaneApiEndpoints) ContainerStop 

func (e ArcaneApiEndpoints) ContainerStop(envID, containerID string) string

func (ArcaneApiEndpoints) ContainerUpdate 

func (e ArcaneApiEndpoints) ContainerUpdate(envID, containerID string) string

func (ArcaneApiEndpoints) Containers 

func (e ArcaneApiEndpoints) Containers(envID string) string

Container endpoints

func (ArcaneApiEndpoints) ContainersCounts 

func (e ArcaneApiEndpoints) ContainersCounts(envID string) string

func (ArcaneApiEndpoints) Deployment 

func (e ArcaneApiEndpoints) Deployment(envID string) string

Deployment & Heartbeat endpoints

func (ArcaneApiEndpoints) Environment 

func (e ArcaneApiEndpoints) Environment(id string) string

func (ArcaneApiEndpoints) EnvironmentAgent 

func (e ArcaneApiEndpoints) EnvironmentAgent(envID string) string

func (ArcaneApiEndpoints) EnvironmentPair 

func (e ArcaneApiEndpoints) EnvironmentPair() string

func (ArcaneApiEndpoints) EnvironmentSyncRegistries 

func (e ArcaneApiEndpoints) EnvironmentSyncRegistries(envID string) string

func (ArcaneApiEndpoints) EnvironmentTest 

func (e ArcaneApiEndpoints) EnvironmentTest(envID string) string

func (ArcaneApiEndpoints) Environments 

func (e ArcaneApiEndpoints) Environments() string

Environment endpoints

func (ArcaneApiEndpoints) Event 

func (e ArcaneApiEndpoints) Event(id string) string

func (ArcaneApiEndpoints) Events 

func (e ArcaneApiEndpoints) Events() string

Event endpoints

func (ArcaneApiEndpoints) EventsEnvironment 

func (e ArcaneApiEndpoints) EventsEnvironment(envID string) string

func (ArcaneApiEndpoints) FormatContainers 

func (e ArcaneApiEndpoints) FormatContainers(envID string) string

Legacy methods for backwards compatibility

func (ArcaneApiEndpoints) Health 

func (e ArcaneApiEndpoints) Health() string

func (ArcaneApiEndpoints) Heartbeat 

func (e ArcaneApiEndpoints) Heartbeat(envID string) string

func (ArcaneApiEndpoints) Image 

func (e ArcaneApiEndpoints) Image(envID, imageID string) string

func (ArcaneApiEndpoints) ImageUpdatesCheck 

func (e ArcaneApiEndpoints) ImageUpdatesCheck(envID string) string

Image Update endpoints

func (ArcaneApiEndpoints) ImageUpdatesCheckAll 

func (e ArcaneApiEndpoints) ImageUpdatesCheckAll(envID string) string

func (ArcaneApiEndpoints) ImageUpdatesCheckBatch 

func (e ArcaneApiEndpoints) ImageUpdatesCheckBatch(envID string) string

func (ArcaneApiEndpoints) ImageUpdatesCheckById 

func (e ArcaneApiEndpoints) ImageUpdatesCheckById(envID, imageID string) string

func (ArcaneApiEndpoints) ImageUpdatesSummary 

func (e ArcaneApiEndpoints) ImageUpdatesSummary(envID string) string

func (ArcaneApiEndpoints) Images 

func (e ArcaneApiEndpoints) Images(envID string) string

Image endpoints

func (ArcaneApiEndpoints) ImagesCounts 

func (e ArcaneApiEndpoints) ImagesCounts(envID string) string

func (ArcaneApiEndpoints) ImagesPrune 

func (e ArcaneApiEndpoints) ImagesPrune(envID string) string

func (ArcaneApiEndpoints) ImagesPull 

func (e ArcaneApiEndpoints) ImagesPull(envID string) string

func (ArcaneApiEndpoints) ImagesUpload 

func (e ArcaneApiEndpoints) ImagesUpload(envID string) string

func (ArcaneApiEndpoints) JobSchedules 

func (e ArcaneApiEndpoints) JobSchedules() string

Job schedule endpoints

func (ArcaneApiEndpoints) Network 

func (e ArcaneApiEndpoints) Network(envID, networkID string) string

func (ArcaneApiEndpoints) Networks 

func (e ArcaneApiEndpoints) Networks(envID string) string

Network endpoints

func (ArcaneApiEndpoints) NetworksCounts 

func (e ArcaneApiEndpoints) NetworksCounts(envID string) string

func (ArcaneApiEndpoints) NetworksPrune 

func (e ArcaneApiEndpoints) NetworksPrune(envID string) string

func (ArcaneApiEndpoints) NotificationSetting 

func (e ArcaneApiEndpoints) NotificationSetting(envID, provider string) string

func (ArcaneApiEndpoints) NotificationTest 

func (e ArcaneApiEndpoints) NotificationTest(envID, provider string) string

func (ArcaneApiEndpoints) NotificationsApprise 

func (e ArcaneApiEndpoints) NotificationsApprise(envID string) string

Notification endpoints

func (ArcaneApiEndpoints) NotificationsAppriseTest 

func (e ArcaneApiEndpoints) NotificationsAppriseTest(envID string) string

func (ArcaneApiEndpoints) NotificationsSettings 

func (e ArcaneApiEndpoints) NotificationsSettings(envID string) string

func (ArcaneApiEndpoints) OIDCCallback 

func (e ArcaneApiEndpoints) OIDCCallback() string

func (ArcaneApiEndpoints) OIDCConfig 

func (e ArcaneApiEndpoints) OIDCConfig() string

func (ArcaneApiEndpoints) OIDCDeviceCode 

func (e ArcaneApiEndpoints) OIDCDeviceCode() string

func (ArcaneApiEndpoints) OIDCDeviceToken 

func (e ArcaneApiEndpoints) OIDCDeviceToken() string

func (ArcaneApiEndpoints) OIDCStatus 

func (e ArcaneApiEndpoints) OIDCStatus() string

OIDC endpoints

func (ArcaneApiEndpoints) OIDCUrl 

func (e ArcaneApiEndpoints) OIDCUrl() string

func (ArcaneApiEndpoints) Project 

func (e ArcaneApiEndpoints) Project(envID, projectID string) string

func (ArcaneApiEndpoints) ProjectDestroy 

func (e ArcaneApiEndpoints) ProjectDestroy(envID, projectID string) string

func (ArcaneApiEndpoints) ProjectDown 

func (e ArcaneApiEndpoints) ProjectDown(envID, projectID string) string

func (ArcaneApiEndpoints) ProjectIncludes 

func (e ArcaneApiEndpoints) ProjectIncludes(envID, projectID string) string

func (ArcaneApiEndpoints) ProjectPull 

func (e ArcaneApiEndpoints) ProjectPull(envID, projectID string) string

func (ArcaneApiEndpoints) ProjectRedeploy 

func (e ArcaneApiEndpoints) ProjectRedeploy(envID, projectID string) string

func (ArcaneApiEndpoints) ProjectRestart 

func (e ArcaneApiEndpoints) ProjectRestart(envID, projectID string) string

func (ArcaneApiEndpoints) ProjectUp 

func (e ArcaneApiEndpoints) ProjectUp(envID, projectID string) string

func (ArcaneApiEndpoints) Projects 

func (e ArcaneApiEndpoints) Projects(envID string) string

Project endpoints

func (ArcaneApiEndpoints) ProjectsCounts 

func (e ArcaneApiEndpoints) ProjectsCounts(envID string) string

func (ArcaneApiEndpoints) Settings 

func (e ArcaneApiEndpoints) Settings(envID string) string

Settings endpoints

func (ArcaneApiEndpoints) SettingsCategories 

func (e ArcaneApiEndpoints) SettingsCategories() string

func (ArcaneApiEndpoints) SettingsPublic 

func (e ArcaneApiEndpoints) SettingsPublic(envID string) string

func (ArcaneApiEndpoints) SettingsSearch 

func (e ArcaneApiEndpoints) SettingsSearch() string

func (ArcaneApiEndpoints) SystemContainersStartAll 

func (e ArcaneApiEndpoints) SystemContainersStartAll(envID string) string

func (ArcaneApiEndpoints) SystemContainersStartStopped 

func (e ArcaneApiEndpoints) SystemContainersStartStopped(envID string) string

func (ArcaneApiEndpoints) SystemContainersStopAll 

func (e ArcaneApiEndpoints) SystemContainersStopAll(envID string) string

func (ArcaneApiEndpoints) SystemConvert 

func (e ArcaneApiEndpoints) SystemConvert(envID string) string

func (ArcaneApiEndpoints) SystemDockerInfo 

func (e ArcaneApiEndpoints) SystemDockerInfo(envID string) string

func (ArcaneApiEndpoints) SystemHealth 

func (e ArcaneApiEndpoints) SystemHealth(envID string) string

func (ArcaneApiEndpoints) SystemPrune 

func (e ArcaneApiEndpoints) SystemPrune(envID string) string

System endpoints

func (ArcaneApiEndpoints) SystemUpgrade 

func (e ArcaneApiEndpoints) SystemUpgrade(envID string) string

func (ArcaneApiEndpoints) SystemUpgradeCheck 

func (e ArcaneApiEndpoints) SystemUpgradeCheck(envID string) string

func (ArcaneApiEndpoints) Template 

func (e ArcaneApiEndpoints) Template(id string) string

func (ArcaneApiEndpoints) TemplateContent 

func (e ArcaneApiEndpoints) TemplateContent(id string) string

func (ArcaneApiEndpoints) TemplateDownload 

func (e ArcaneApiEndpoints) TemplateDownload(id string) string

func (ArcaneApiEndpoints) TemplateRegistry 

func (e ArcaneApiEndpoints) TemplateRegistry(id string) string

func (ArcaneApiEndpoints) Templates 

func (e ArcaneApiEndpoints) Templates() string

Template endpoints

func (ArcaneApiEndpoints) TemplatesAll 

func (e ArcaneApiEndpoints) TemplatesAll() string

func (ArcaneApiEndpoints) TemplatesDefault 

func (e ArcaneApiEndpoints) TemplatesDefault() string

func (ArcaneApiEndpoints) TemplatesFetch 

func (e ArcaneApiEndpoints) TemplatesFetch() string

func (ArcaneApiEndpoints) TemplatesRegistries 

func (e ArcaneApiEndpoints) TemplatesRegistries() string

func (ArcaneApiEndpoints) TemplatesVariables 

func (e ArcaneApiEndpoints) TemplatesVariables() string

func (ArcaneApiEndpoints) UpdaterHistory 

func (e ArcaneApiEndpoints) UpdaterHistory(envID string) string

func (ArcaneApiEndpoints) UpdaterRun 

func (e ArcaneApiEndpoints) UpdaterRun(envID string) string

func (ArcaneApiEndpoints) UpdaterStatus 

func (e ArcaneApiEndpoints) UpdaterStatus(envID string) string

Updater endpoints

func (ArcaneApiEndpoints) UseImageEndpoint 

func (e ArcaneApiEndpoints) UseImageEndpoint(action string, envID string) string

func (ArcaneApiEndpoints) User 

func (e ArcaneApiEndpoints) User(id string) string

func (ArcaneApiEndpoints) Users 

func (e ArcaneApiEndpoints) Users() string

User endpoints

func (ArcaneApiEndpoints) Version 

func (e ArcaneApiEndpoints) Version() string

func (ArcaneApiEndpoints) Volume 

func (e ArcaneApiEndpoints) Volume(envID, volumeName string) string

func (ArcaneApiEndpoints) VolumeUsage 

func (e ArcaneApiEndpoints) VolumeUsage(envID, volumeName string) string

func (ArcaneApiEndpoints) Volumes 

func (e ArcaneApiEndpoints) Volumes(envID string) string

Volume endpoints

func (ArcaneApiEndpoints) VolumesCounts 

func (e ArcaneApiEndpoints) VolumesCounts(envID string) string

func (ArcaneApiEndpoints) VolumesPrune 

func (e ArcaneApiEndpoints) VolumesPrune(envID string) string

func (ArcaneApiEndpoints) VolumesSizes 

func (e ArcaneApiEndpoints) VolumesSizes(envID string) string

type Config 

type Config struct {
	// ServerURL is the base URL of the Arcane server (e.g., http://localhost:3552)
	ServerURL string `yaml:"server_url"`
	// APIKey is the API key for authentication (sent as X-API-KEY)
	APIKey string `yaml:"api_key,omitempty"`
	// JWTToken is the JWT access token for authentication (sent as Authorization: Bearer)
	JWTToken string `yaml:"jwt_token,omitempty"`
	// RefreshToken is the refresh token for obtaining new access tokens
	RefreshToken string `yaml:"refresh_token,omitempty"`
	// DefaultEnvironment is the default environment ID to use
	DefaultEnvironment string `yaml:"default_environment,omitempty"`
	// LogLevel is the logging level (debug, info, warn, error, fatal, panic)
	LogLevel string `yaml:"log_level,omitempty"`
}

Config holds the CLI configuration for connecting to an Arcane server. It is persisted to disk as YAML and loaded on each CLI invocation.

func (*Config) HasAuth 

func (c *Config) HasAuth() bool

HasAuth returns true if either an API key or JWT token is configured.

func (*Config) IsConfigured 

func (c *Config) IsConfigured() bool

IsConfigured returns true if both ServerURL and APIKey are set. This is a quick check to determine if the CLI has been configured without triggering validation errors.

func (*Config) Validate 

func (c *Config) Validate() error

Validate checks if the configuration has all required fields set. It returns an error with instructions if ServerURL or APIKey is missing. This should be called before using the config to make API requests.

func (*Config) ValidateServerURL 

func (c *Config) ValidateServerURL() error

ValidateServerURL checks if the configuration has the server URL set. This is useful for commands like `auth login` that do not require prior authentication.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.