"no address provided for private VCS instance" error

Issue: Private VCS Instance Not Configured on Worker

Error Message: no address provided for private VCS instance

This error indicates that the worker is not receiving the correct address for a private VCS instance. Even if your VCS agent configuration is correctly set up, Spacelift also requires this information to be provided directly on each private worker.

Solution

To ensure your workers are correctly informed of the VCS agent pool addresses, confirm that you have configured the following environment variables on the worker itself:

• SPACELIFT_PRIVATEVCS_MAPPING_NAME_<NUMBER>:
  This variable specifies the name of the VCS Agent Pool.

• SPACELIFT_PRIVATEVCS_MAPPING_BASE_ENDPOINT_<NUMBER>:
  This variable specifies the IP address or hostname (with protocol) for the VCS system.

For example:

SPACELIFT_PRIVATEVCS_MAPPING_NAME_1="MyPrivateVCS" 
SPACELIFT_PRIVATEVCS_MAPPING_BASE_ENDPOINT_1="https://your-vcs-address.com"

Each VCS Agent Pool needs to be specified separately using unique <NUMBER> values. These variables enable the worker to connect to your VCS instance within your private network.

Additional Information

For more details on configuring private VCS connections and VCS Agent Pools, refer to the Spacelift documentation on worker pools and VCS agents.