Configuration on Solo

SOLO-1001

Mon, 01 Jan 0001 00:00:00 +0000

`LocalConfigNotFoundSoloError`


Code	`SOLO-1001`
Category	Configuration
Ownership	User
Retryable	No

Description

Thrown when solo reads its local configuration but no file exists at the resolved path (~/.solo/local-config.yaml, or $SOLO_HOME/local-config.yaml when SOLO_HOME is set). The local config records cluster references, deployments, and the active user context, so most commands load it before doing any work. The file is missing because solo init has not yet run on this machine, because SOLO_HOME points at a different directory than the one the file was created in, or because it was manually moved or deleted.

SOLO-1002

Mon, 01 Jan 0001 00:00:00 +0000

`WriteLocalConfigFileError`


Code	`SOLO-1002`
Category	Configuration
Ownership	Infrastructure
Retryable	No

Description

Thrown when solo cannot persist the local configuration to disk at ~/.solo/local-config.yaml (or $SOLO_HOME/local-config.yaml). The local config is rewritten whenever solo records a new cluster reference, deployment, or context, and this error wraps the underlying filesystem failure (cause). It means the data was prepared but could not be written: typical causes are missing write permissions on the ~/.solo directory, a read-only or full disk, or a parent directory that is missing or locked.

SOLO-1003

Mon, 01 Jan 0001 00:00:00 +0000

`RefreshLocalConfigSourceError`


Code	`SOLO-1003`
Category	Configuration
Ownership	Infrastructure
Retryable	No

Description

Thrown when solo fails to reload the local configuration from its on-disk source — that is, the re-read and re-parse of ~/.solo/local-config.yaml (or $SOLO_HOME/local-config.yaml) did not complete; the underlying failure is wrapped in cause. Unlike LocalConfigNotFoundSoloError, the file is present: it could not be read (insufficient permissions, an I/O error) or its contents could not be parsed into the expected configuration because the file is malformed or corrupt.

SOLO-1004

Mon, 01 Jan 0001 00:00:00 +0000

`RemoteConfigsMismatchSoloError`


Code	`SOLO-1004`
Category	Configuration
Ownership	Infrastructure
Retryable	No

Description

Thrown when a deployment spans multiple clusters and solo finds that the remote configuration stored in two of them does not agree; the message names the two clusters whose copies diverged. solo keeps the remote config as a ConfigMap that must be an identical replica in every cluster of the deployment, so it compares them and raises this when they differ. The usual cause is a prior write that was applied to one cluster but not the others (a partial or failed update), a ConfigMap that was edited manually, or clusters that have otherwise drifted out of sync.