Skip to main content

InstanceDependencySource

Where a dependency wire-in comes from.

  • Connection — the wire was drawn from a blueprint Link between two components in this project.
  • RemoteReference — the wire is a per-instance override pointing at a resource from another project (or an imported resource).
  • EnvironmentDefault — no explicit wire was set, so the slot is filled from the environment's default for this resource type.

Per-instance RemoteReference overrides take priority over blueprint Connections, which take priority over EnvironmentDefaults.

union InstanceDependencySource = Connection | RemoteReference | EnvironmentDefault

Possible types​

InstanceDependencySource.Connection object​

A runtime wiring between two instances in an environment.

A connection is the runtime realization of a blueprint link. Where a link says "the database component's authentication output goes to the app component's database input," the connection in each environment carries the actual resource data (e.g., a connection string) from the source instance to the destination instance.

Connections are created automatically when instances are deployed and a matching blueprint link exists.

InstanceDependencySource.RemoteReference object​

A per-instance override of a single connection slot. The blueprint Link wires a slot from a sibling package's output; a remote reference overrides that wiring on one instance, pointing the slot at a resource from another project (or an imported resource) instead.

Remote references enable cross-project infrastructure sharing. For example, a networking team provisions a VPC in one project, and application teams override the vpc connection slot on their database/cache/etc. instances to point at that shared VPC.

Each remote reference binds a specific field on the instance — a key in the instance's bundle's connectionsSchema — to the target resource. The override takes priority over any blueprint-level Link on the same slot, and reverts to the Link (or environment default) when removed.

InstanceDependencySource.EnvironmentDefault object​

An environment default that automatically provides a resource to instances.

When an instance in the environment requires a resource type that matches this default, the resource is automatically connected without manual configuration. Only one default per resource type is allowed per environment -- remove the existing default before setting a new one.

Member Of​

InstanceDependency object