testing

func AddCharm ¶

func AddCharm(st *state.State, curl *charm.URL, ch charm.Charm) (*state.Charm, error)

AddCharm adds the charm to state and storage.

func AddControllerMachine ¶

func AddControllerMachine(c *gc.C, st *state.State) *state.Machine

AddControllerMachine adds a "controller" machine to the state so that State.Addresses and State.APIAddresses will work. It returns the added machine. The addresses that those methods will return bear no relation to the addresses actually used by the state and API servers. It returns the addresses that will be returned by the State.Addresses and State.APIAddresses methods, which will not bear any relation to the be the addresses used by the controllers.

func AddSubnetsWithTemplate ¶

func AddSubnetsWithTemplate(c *gc.C, st *state.State, numSubnets uint, infoTemplate state.SubnetInfo)

AddSubnetsWithTemplate adds numSubnets subnets, using the given infoTemplate. Any string field in the infoTemplate can be specified as a text/template string containing {{.}}, which is the current index of the subnet-to-add (between 0 and numSubnets-1).

Example:

AddSubnetsWithTemplate(c, st, 2, state.SubnetInfo{
    CIDR: "10.10.{{.}}.0/24",
    ProviderId: "subnet-{{.}}",
    SpaceName: "space1",
    AvailabilityZone: "zone-{{.}}",
    VLANTag: 42,
})

This is equivalent to the following calls:

_, err := st.AddSubnet(state.SubnetInfo{
    CIDR: "10.10.0.0/24",
    ProviderId: "subnet-0",
    SpaceName: "space1",
    AvailabilityZone: "zone-0",
    VLANTag: 42,
})

c.Assert(err, jc.ErrorIsNil)

_, err = st.AddSubnet(state.SubnetInfo{
    CIDR: "10.10.1.0/24",
    ProviderId: "subnet-1",
    SpaceName: "space1",
    AvailabilityZone: "zone-1",
    VLANTag: 42,
})

func AssertStartControllerInstance ¶

func AssertStartControllerInstance(
	c *gc.C, env environs.Environ, controllerUUID, machineId string,
) (
	instance.Instance, *instance.HardwareCharacteristics,
)

AssertStartControllerInstance is a test helper function that starts a controller instance with a plausible but invalid configuration, and checks that it succeeds.

func AssertStartInstance ¶

func AssertStartInstance(
	c *gc.C, env environs.Environ, controllerUUID, machineId string,
) (
	instance.Instance, *instance.HardwareCharacteristics,
)

AssertStartInstance is a test helper function that starts an instance with a plausible but invalid configuration, and checks that it succeeds.

func AssertStartInstanceWithConstraints ¶

func AssertStartInstanceWithConstraints(
	c *gc.C, env environs.Environ, controllerUUID, machineId string, cons constraints.Value,
) (
	instance.Instance, *instance.HardwareCharacteristics,
)

AssertStartInstanceWithConstraints is a test helper function that starts an instance with the given constraints, and a plausible but invalid configuration, and returns the result of Environ.StartInstance.

func DefaultVersions ¶

func DefaultVersions(conf *config.Config) []version.Binary

DefaultVersions returns a slice of unique 'versions' for the current environment's preferred series and host architecture, as well supported LTS series for the host architecture. Additionally, it ensures that 'versions' for amd64 are returned if that is not the current host's architecture.

func FakeAPIInfo ¶

func FakeAPIInfo(machineId string) *api.Info

FakeAPIInfo holds information about no state - it will always give an error when connected to. The machine id gives the machine id of the machine to be started.

func FakeStateInfo ¶

func FakeStateInfo(machineId string) *mongo.MongoInfo

FakeStateInfo holds information about no state - it will always give an error when connected to. The machine id gives the machine id of the machine to be started.

func PutCharm ¶

func PutCharm(st *state.State, curl *charm.URL, repo charmrepo.Interface, bumpRevision bool) (*state.Charm, error)

PutCharm uploads the given charm to provider storage, and adds a state.Charm to the state. The charm is not uploaded if a charm with the same URL already exists in the state. If bumpRevision is true, the charm must be a local directory, and the revision number will be incremented before pushing.

func SetImageMetadata ¶

func SetImageMetadata(env environs.Environ, series, arches []string, out *[]*imagemetadata.ImageMetadata) error

func StartInstance ¶

func StartInstance(
	env environs.Environ, controllerUUID, machineId string,
) (
	instance.Instance, *instance.HardwareCharacteristics, []network.InterfaceInfo, error,
)

StartInstance is a test helper function that starts an instance with a plausible but invalid configuration, and returns the result of Environ.StartInstance.

func StartInstanceWithConstraints ¶

func StartInstanceWithConstraints(
	env environs.Environ, controllerUUID, machineId string, cons constraints.Value,
) (
	instance.Instance, *instance.HardwareCharacteristics, []network.InterfaceInfo, error,
)

StartInstanceWithConstraints is a test helper function that starts an instance with the given constraints, and a plausible but invalid configuration, and returns the result of Environ.StartInstance.

func StartInstanceWithParams ¶

func StartInstanceWithParams(
	env environs.Environ, machineId string,
	params environs.StartInstanceParams,
) (
	*environs.StartInstanceResult, error,
)

StartInstanceWithParams is a test helper function that starts an instance with the given parameters, and a plausible but invalid configuration, and returns the result of Environ.StartInstance. The provided params's InstanceConfig and Tools field values will be ignored.

func WaitInstanceAddresses ¶

func WaitInstanceAddresses(env environs.Environ, instId instance.Id) ([]network.Address, error)

WaitAddresses waits until the specified instance has addresses, and returns them.