juju: github.com/juju/juju/api/uniter Index | Files

package uniter

import "github.com/juju/juju/api/uniter"

Index

Package Files

action.go application.go charm.go endpoint.go leadership.go relation.go relationunit.go settings.go storage.go unit.go uniter.go

Variables

var ErrNoCharmURLSet = errors.New("unit has no charm url set")

func ErrIfNotVersionFn Uses

func ErrIfNotVersionFn(minVersion int, bestAPIVersion int) func(string) error

ErrIfNotVersionFn returns a function which can be used to check for the minimum supported version, and, if appropriate, generate an error.

type Action Uses

type Action struct {
    // contains filtered or unexported fields
}

Action represents a single instance of an Action call, by name and params.

func NewAction Uses

func NewAction(name string, params map[string]interface{}) (*Action, error)

NewAction makes a new Action with specified name and params map.

func (*Action) Name Uses

func (a *Action) Name() string

Name retrieves the name of the Action.

func (*Action) Params Uses

func (a *Action) Params() map[string]interface{}

Params retrieves the params map of the Action.

type Application Uses

type Application struct {
    // contains filtered or unexported fields
}

Application represents the state of an application.

func (*Application) CharmModifiedVersion Uses

func (s *Application) CharmModifiedVersion() (int, error)

CharmModifiedVersion increments every time the charm, or any part of it, is changed in some way.

func (*Application) CharmURL Uses

func (s *Application) CharmURL() (*charm.URL, bool, error)

CharmURL returns the application's charm URL, and whether units should upgrade to the charm with that URL even if they are in an error state (force flag).

NOTE: This differs from state.Application.CharmURL() by returning an error instead as well, because it needs to make an API call.

func (*Application) Life Uses

func (s *Application) Life() params.Life

Life returns the application's current life state.

func (*Application) Name Uses

func (s *Application) Name() string

Name returns the application name.

func (*Application) Refresh Uses

func (s *Application) Refresh() error

Refresh refreshes the contents of the application from the underlying state.

func (*Application) SetStatus Uses

func (s *Application) SetStatus(unitName string, appStatus status.Status, info string, data map[string]interface{}) error

SetStatus sets the status of the application if the passed unitName, corresponding to the calling unit, is of the leader.

func (*Application) Status Uses

func (s *Application) Status(unitName string) (params.ApplicationStatusResult, error)

Status returns the status of the application if the passed unitName, corresponding to the calling unit, is of the leader.

func (*Application) String Uses

func (s *Application) String() string

String returns the application as a string.

func (*Application) Tag Uses

func (s *Application) Tag() names.ApplicationTag

Tag returns the application's tag.

func (*Application) Watch Uses

func (s *Application) Watch() (watcher.NotifyWatcher, error)

Watch returns a watcher for observing changes to an application.

func (*Application) WatchLeadershipSettings Uses

func (s *Application) WatchLeadershipSettings() (watcher.NotifyWatcher, error)

WatchLeadershipSettings returns a watcher which can be used to wait for leadership settings changes to be made for the application.

type Charm Uses

type Charm struct {
    // contains filtered or unexported fields
}

Charm represents the state of a charm in the model.

func (*Charm) ArchiveSha256 Uses

func (c *Charm) ArchiveSha256() (string, error)

ArchiveSha256 returns the SHA256 digest of the charm archive (bundle) bytes.

NOTE: This differs from state.Charm.BundleSha256() by returning an error as well, because it needs to make an API call. It's also renamed to avoid confusion with juju deployment bundles.

TODO(dimitern): 2013-09-06 bug 1221834 Cache the result after getting it once for the same charm URL, because it's immutable.

func (*Charm) String Uses

func (c *Charm) String() string

String returns the charm URL as a string.

func (*Charm) URL Uses

func (c *Charm) URL() *charm.URL

URL returns the URL that identifies the charm.

type CheckAPIVersionFn Uses

type CheckAPIVersionFn func(functionName string) error

type Endpoint Uses

type Endpoint struct {
    charm.Relation
}

Endpoint represents one endpoint of a relation. It is just a wrapper around charm.Relation. No API calls to the server-side are needed to support the interface needed by the uniter worker.

type FacadeCallFn Uses

type FacadeCallFn func(request string, params, response interface{}) error

type LeadershipSettingsAccessor Uses

type LeadershipSettingsAccessor struct {
    // contains filtered or unexported fields
}

LeadershipSettingsAccessor provides a type that can make RPC calls to a service which can read, write, and watch leadership settings.

func NewLeadershipSettingsAccessor Uses

func NewLeadershipSettingsAccessor(
    caller FacadeCallFn,
    newWatcher NewNotifyWatcherFn,
    checkAPIVersion CheckAPIVersionFn,
) *LeadershipSettingsAccessor

NewLeadershipSettingsAccessor returns a new LeadershipSettingsAccessor.

func (*LeadershipSettingsAccessor) Merge Uses

func (lsa *LeadershipSettingsAccessor) Merge(appId, unitId string, settings map[string]string) error

Merge merges the provided settings into the leadership settings for the given application and unit. Only leaders of a given application may perform this operation.

func (*LeadershipSettingsAccessor) Read Uses

func (lsa *LeadershipSettingsAccessor) Read(appId string) (map[string]string, error)

Read retrieves the leadership settings for the given application ID. Anyone may perform this operation.

func (*LeadershipSettingsAccessor) WatchLeadershipSettings Uses

func (lsa *LeadershipSettingsAccessor) WatchLeadershipSettings(appId string) (watcher.NotifyWatcher, error)

WatchLeadershipSettings returns a watcher which can be used to wait for leadership settings changes to be made for a given application ID.

type NewNotifyWatcherFn Uses

type NewNotifyWatcherFn func(params.NotifyWatchResult) watcher.NotifyWatcher

type Relation Uses

type Relation struct {
    // contains filtered or unexported fields
}

Relation represents a relation between one or two application endpoints.

func (*Relation) Endpoint Uses

func (r *Relation) Endpoint() (*Endpoint, error)

Endpoint returns the endpoint of the relation for the application the uniter's managed unit belongs to.

func (*Relation) Id Uses

func (r *Relation) Id() int

Id returns the integer internal relation key. This is exposed because the unit agent needs to expose a value derived from this (as JUJU_RELATION_ID) to allow relation hooks to differentiate between relations with different applications.

func (*Relation) Life Uses

func (r *Relation) Life() params.Life

Life returns the relation's current life state.

func (*Relation) OtherApplication Uses

func (r *Relation) OtherApplication() string

OtherApplication returns the name of the application on the other end of the relation (from this unit's perspective).

func (*Relation) Refresh Uses

func (r *Relation) Refresh() error

Refresh refreshes the contents of the relation from the underlying state. It returns an error that satisfies errors.IsNotFound if the relation has been removed.

func (*Relation) SetStatus Uses

func (r *Relation) SetStatus(status relation.Status) error

SetStatus updates the status of the relation.

func (*Relation) String Uses

func (r *Relation) String() string

String returns the relation as a string.

func (*Relation) Suspended Uses

func (r *Relation) Suspended() bool

Suspended returns the relation's current suspended status.

func (*Relation) Tag Uses

func (r *Relation) Tag() names.RelationTag

Tag returns the relation tag.

func (*Relation) Unit Uses

func (r *Relation) Unit(u *Unit) (*RelationUnit, error)

Unit returns a RelationUnit for the supplied unit.

func (*Relation) UpdateSuspended Uses

func (r *Relation) UpdateSuspended(suspended bool)

UpdateSuspended updates the in memory value of the relation's suspended attribute.

type RelationStatus Uses

type RelationStatus struct {
    // Tag is the relation tag.
    Tag names.RelationTag

    // Suspended is true if the relation is suspended.
    Suspended bool

    // InScope is true if the relation unit is in scope.
    InScope bool
}

RelationStatus holds information about a relation's scope and status.

type RelationUnit Uses

type RelationUnit struct {
    // contains filtered or unexported fields
}

RelationUnit holds information about a single unit in a relation, and allows clients to conveniently access unit-specific functionality.

func (*RelationUnit) ApplicationSettings Uses

func (ru *RelationUnit) ApplicationSettings() (*Settings, error)

ApplicationSettings returns a Settings which allows access to this unit's application settings within the relation. This can only be used from the leader unit. Calling it from a non-Leader generates a NotLeader error.

func (*RelationUnit) Endpoint Uses

func (ru *RelationUnit) Endpoint() Endpoint

Endpoint returns the relation endpoint that defines the unit's participation in the relation.

func (*RelationUnit) EnterScope Uses

func (ru *RelationUnit) EnterScope() error

EnterScope ensures that the unit has entered its scope in the relation. When the unit has already entered its relation scope, EnterScope will report success but make no changes to state.

Otherwise, assuming both the relation and the unit are alive, it will enter scope.

If the unit is a principal and the relation has container scope, EnterScope will also create the required subordinate unit, if it does not already exist; this is because there's no point having a principal in scope if there is no corresponding subordinate to join it.

Once a unit has entered a scope, it stays in scope without further intervention; the relation will not be able to become Dead until all units have departed its scopes.

NOTE: Unlike state.RelatioUnit.EnterScope(), this method does not take settings, because uniter only uses this to supply the unit's private address, but this is not done at the server-side by the API.

func (*RelationUnit) LeaveScope Uses

func (ru *RelationUnit) LeaveScope() error

LeaveScope signals that the unit has left its scope in the relation. After the unit has left its relation scope, it is no longer a member of the relation; if the relation is dying when its last member unit leaves, it is removed immediately. It is not an error to leave a scope that the unit is not, or never was, a member of.

func (*RelationUnit) ReadSettings Uses

func (ru *RelationUnit) ReadSettings(name string) (params.Settings, error)

ReadSettings returns a map holding the settings of the unit with the supplied name within this relation. An error will be returned if the relation no longer exists, or if the unit's application is not part of the relation, or the settings are invalid; but mere non-existence of the unit is not grounds for an error, because the unit settings are guaranteed to persist for the lifetime of the relation, regardless of the lifetime of the unit.

func (*RelationUnit) Relation Uses

func (ru *RelationUnit) Relation() *Relation

Relation returns the relation associated with the unit.

func (*RelationUnit) Settings Uses

func (ru *RelationUnit) Settings() (*Settings, error)

Settings returns a Settings which allows access to the unit's settings within the relation.

func (*RelationUnit) UpdateRelationSettings Uses

func (ru *RelationUnit) UpdateRelationSettings(unit, application params.Settings) error

UpdateRelationSettings is used to record any changes to settings for this unit and application. It is only valid to update application settings if this unit is the leader, otherwise it is a NotLeader error. Note that either unit or application is allowed to be nil.

func (*RelationUnit) Watch Uses

func (ru *RelationUnit) Watch() (watcher.RelationUnitsWatcher, error)

Watch returns a watcher that notifies of changes to counterpart units in the relation.

type Settings Uses

type Settings struct {
    // contains filtered or unexported fields
}

Settings manages changes to unit settings in a relation.

func (*Settings) Delete Uses

func (s *Settings) Delete(key string)

Delete removes key.

func (*Settings) FinalResult Uses

func (s *Settings) FinalResult() params.Settings

FinalResult returns a params.Settings with the final updates applied. This includes entries that were deleted.

func (*Settings) Map Uses

func (s *Settings) Map() params.Settings

Map returns all keys and values of the node.

func (*Settings) Set Uses

func (s *Settings) Set(key, value string)

Set sets key to value.

type State Uses

type State struct {
    *common.ModelWatcher
    *common.APIAddresser
    *common.UpgradeSeriesAPI
    *StorageAccessor

    LeadershipSettings *LeadershipSettingsAccessor
    // contains filtered or unexported fields
}

State provides access to the Uniter API facade.

func NewState Uses

func NewState(
    caller base.APICaller,
    authTag names.UnitTag,
) *State

NewState creates a new client-side Uniter facade.

func (*State) Action Uses

func (st *State) Action(tag names.ActionTag) (*Action, error)

Action returns the Action with the given tag.

func (*State) ActionBegin Uses

func (st *State) ActionBegin(tag names.ActionTag) error

ActionBegin marks an action as running.

func (*State) ActionFinish Uses

func (st *State) ActionFinish(tag names.ActionTag, status string, results map[string]interface{}, message string) error

ActionFinish captures the structured output of an action.

func (*State) AllMachinePorts Uses

func (st *State) AllMachinePorts(machineTag names.MachineTag) (map[network.PortRange]params.RelationUnit, error)

AllMachinePorts returns all port ranges currently open on the given machine, mapped to the tags of the unit that opened them and the relation that applies.

func (*State) Application Uses

func (st *State) Application(tag names.ApplicationTag) (*Application, error)

Application returns an application state by tag.

func (*State) BestAPIVersion Uses

func (st *State) BestAPIVersion() int

BestAPIVersion returns the API version that we were able to determine is supported by both the client and the API Server.

func (*State) Charm Uses

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

Charm returns the charm with the given URL.

func (*State) CloudAPIVersion Uses

func (st *State) CloudAPIVersion() (string, error)

CloudAPIVersion returns the API version of the cloud, if known.

func (*State) CloudSpec Uses

func (st *State) CloudSpec() (*params.CloudSpec, error)

CloudSpec returns the cloud spec for the model that calling unit or application resides in. If the application has not been authorised to access its cloud spec, then an authorisation error will be returned.

func (*State) Facade Uses

func (st *State) Facade() base.FacadeCaller

Facade returns the current facade.

func (*State) GoalState Uses

func (st *State) GoalState() (application.GoalState, error)

GoalState returns a GoalState struct with the charm's peers and related units information.

func (*State) Model Uses

func (st *State) Model() (*model.Model, error)

Model returns the model entity.

func (*State) ProviderType Uses

func (st *State) ProviderType() (string, error)

ProviderType returns a provider type used by the current juju model.

TODO(dimitern): We might be able to drop this, once we have machine addresses implemented fully. See also LP bug 1221798.

func (*State) Relation Uses

func (st *State) Relation(relationTag names.RelationTag) (*Relation, error)

Relation returns the existing relation with the given tag.

func (*State) RelationById Uses

func (st *State) RelationById(id int) (*Relation, error)

RelationById returns the existing relation with the given id.

func (*State) SLALevel Uses

func (st *State) SLALevel() (string, error)

SLALevel returns the SLA level set on the model.

func (*State) SetPodSpec Uses

func (st *State) SetPodSpec(appName string, spec string) error

SetPodSpec sets the pod spec of the specified application.

func (*State) Unit Uses

func (st *State) Unit(tag names.UnitTag) (*Unit, error)

Unit provides access to methods of a state.Unit through the facade.

func (*State) WatchRelationUnits Uses

func (st *State) WatchRelationUnits(
    relationTag names.RelationTag,
    unitTag names.UnitTag,
) (watcher.RelationUnitsWatcher, error)

WatchRelationUnits returns a watcher that notifies of changes to the counterpart units in the relation for the given unit.

type StorageAccessor Uses

type StorageAccessor struct {
    // contains filtered or unexported fields
}

func NewStorageAccessor Uses

func NewStorageAccessor(facade base.FacadeCaller) *StorageAccessor

NewStorageAccessor creates a StorageAccessor on the specified facade, and uses this name when calling through the caller.

func (*StorageAccessor) DestroyUnitStorageAttachments Uses

func (sa *StorageAccessor) DestroyUnitStorageAttachments(unitTag names.UnitTag) error

DestroyUnitStorageAttachments ensures that the specified unit's storage attachments will be removed at some point in the future.

func (*StorageAccessor) RemoveStorageAttachment Uses

func (sa *StorageAccessor) RemoveStorageAttachment(storageTag names.StorageTag, unitTag names.UnitTag) error

RemoveStorageAttachment removes the storage attachment with the specified unit and storage tags from state. This method is only expected to succeed if the storage attachment is Dead.

func (*StorageAccessor) StorageAttachment Uses

func (sa *StorageAccessor) StorageAttachment(storageTag names.StorageTag, unitTag names.UnitTag) (params.StorageAttachment, error)

StorageAttachment returns the storage attachment with the specified unit and storage tags.

func (*StorageAccessor) StorageAttachmentLife Uses

func (sa *StorageAccessor) StorageAttachmentLife(ids []params.StorageAttachmentId) ([]params.LifeResult, error)

StorageAttachmentLife returns the lifecycle state of the storage attachments with the specified IDs.

func (*StorageAccessor) UnitStorageAttachments Uses

func (sa *StorageAccessor) UnitStorageAttachments(unitTag names.UnitTag) ([]params.StorageAttachmentId, error)

UnitStorageAttachments returns the IDs of a unit's storage attachments.

func (*StorageAccessor) WatchStorageAttachment Uses

func (sa *StorageAccessor) WatchStorageAttachment(storageTag names.StorageTag, unitTag names.UnitTag) (watcher.NotifyWatcher, error)

WatchStorageAttachments starts a watcher for changes to the info of the storage attachment with the specified unit and storage tags.

func (*StorageAccessor) WatchUnitStorageAttachments Uses

func (sa *StorageAccessor) WatchUnitStorageAttachments(unitTag names.UnitTag) (watcher.StringsWatcher, error)

WatchUnitStorageAttachments starts a watcher for changes to storage attachments related to the unit. The watcher will return the IDs of the corresponding storage instances.

type Unit Uses

type Unit struct {
    // contains filtered or unexported fields
}

Unit represents a juju unit as seen by a uniter worker.

func (*Unit) AddMetricBatches Uses

func (u *Unit) AddMetricBatches(batches []params.MetricBatch) (map[string]error, error)

AddMetricsBatches makes an api call to the uniter requesting it to store metrics batches in state.

func (*Unit) AddMetrics Uses

func (u *Unit) AddMetrics(metrics []params.Metric) error

AddMetrics adds the metrics for the unit.

func (*Unit) AddStorage Uses

func (u *Unit) AddStorage(constraints map[string][]params.StorageConstraints) error

AddStorage adds desired storage instances to a unit.

func (*Unit) Application Uses

func (u *Unit) Application() (*Application, error)

Application returns the unit's application.

func (*Unit) ApplicationName Uses

func (u *Unit) ApplicationName() string

ApplicationName returns the application name.

func (*Unit) ApplicationTag Uses

func (u *Unit) ApplicationTag() names.ApplicationTag

ApplicationTag returns the application tag.

func (*Unit) AssignedMachine Uses

func (u *Unit) AssignedMachine() (names.MachineTag, error)

AssignedMachine returns the unit's assigned machine tag or an error satisfying params.IsCodeNotAssigned when the unit has no assigned machine..

func (*Unit) AvailabilityZone Uses

func (u *Unit) AvailabilityZone() (string, error)

AvailabilityZone returns the availability zone of the unit.

func (*Unit) CharmURL Uses

func (u *Unit) CharmURL() (*charm.URL, error)

CharmURL returns the charm URL this unit is currently using.

NOTE: This differs from state.Unit.CharmURL() by returning an error instead of a bool, because it needs to make an API call.

func (*Unit) ClearResolved Uses

func (u *Unit) ClearResolved() error

ClearResolved removes any resolved setting on the unit.

func (*Unit) ClosePorts Uses

func (u *Unit) ClosePorts(protocol string, fromPort, toPort int) error

ClosePorts sets the policy of the port range with protocol to be closed.

func (*Unit) ConfigSettings Uses

func (u *Unit) ConfigSettings() (charm.Settings, error)

ConfigSettings returns the complete set of application charm config settings available to the unit. Unset values will be replaced with the default value for the associated option, and may thus be nil when no default is specified.

func (*Unit) Destroy Uses

func (u *Unit) Destroy() error

Destroy, when called on a Alive unit, advances its lifecycle as far as possible; it otherwise has no effect. In most situations, the unit's life is just set to Dying; but if a principal unit that is not assigned to a provisioned machine is Destroyed, it will be removed from state directly.

func (*Unit) DestroyAllSubordinates Uses

func (u *Unit) DestroyAllSubordinates() error

DestroyAllSubordinates destroys all subordinates of the unit.

func (*Unit) EnsureDead Uses

func (u *Unit) EnsureDead() error

EnsureDead sets the unit lifecycle to Dead if it is Alive or Dying. It does nothing otherwise.

func (*Unit) HasSubordinates Uses

func (u *Unit) HasSubordinates() (bool, error)

HasSubordinates returns the tags of any subordinate units.

func (*Unit) Life Uses

func (u *Unit) Life() params.Life

Life returns the unit's lifecycle value.

func (*Unit) LogActionMessage Uses

func (u *Unit) LogActionMessage(tag names.ActionTag, message string) error

LogActionMessage logs a progress message for the specified action.

func (*Unit) MeterStatus Uses

func (u *Unit) MeterStatus() (statusCode, statusInfo string, rErr error)

MeterStatus returns the meter status of the unit.

func (*Unit) Name Uses

func (u *Unit) Name() string

Name returns the name of the unit.

func (*Unit) NetworkInfo Uses

func (u *Unit) NetworkInfo(bindings []string, relationId *int) (map[string]params.NetworkInfoResult, error)

NetworkInfo returns network interfaces/addresses for specified bindings.

func (*Unit) OpenPorts Uses

func (u *Unit) OpenPorts(protocol string, fromPort, toPort int) error

OpenPorts sets the policy of the port range with protocol to be opened.

func (*Unit) PrincipalName Uses

func (u *Unit) PrincipalName() (string, bool, error)

PrincipalName returns the principal unit name and true for subordinates. For principal units the function returns "" and false.

NOTE: This differs from state.Unit.PrincipalName() by returning an error as well, because it needs to make an API call.

func (*Unit) PrivateAddress Uses

func (u *Unit) PrivateAddress() (string, error)

PrivateAddress returns the private address of the unit and whether it is valid.

NOTE: This differs from state.Unit.PrivateAddress() by returning an error instead of a bool, because it needs to make an API call.

TODO(dimitern): We might be able to drop this, once we have machine addresses implemented fully. See also LP bug 1221798.

func (*Unit) ProviderID Uses

func (u *Unit) ProviderID() string

ProviderID returns the provider Id of the unit.

func (*Unit) PublicAddress Uses

func (u *Unit) PublicAddress() (string, error)

PublicAddress returns the public address of the unit and whether it is valid.

NOTE: This differs from state.Unit.PublicAddres() by returning an error instead of a bool, because it needs to make an API call.

TODO(dimitern): We might be able to drop this, once we have machine addresses implemented fully. See also LP bug 1221798.

func (*Unit) Refresh Uses

func (u *Unit) Refresh() error

Refresh updates the cached local copy of the unit's data.

func (*Unit) RelationsStatus Uses

func (u *Unit) RelationsStatus() ([]RelationStatus, error)

RelationsInScope returns the tags of the relations the unit has joined and entered scope, or the relation is suspended.

func (*Unit) RequestReboot Uses

func (u *Unit) RequestReboot() error

RequestReboot sets the reboot flag for its machine agent

func (*Unit) Resolved Uses

func (u *Unit) Resolved() params.ResolvedMode

Resolved returns the unit's resolved mode value.

func (*Unit) SetAgentStatus Uses

func (u *Unit) SetAgentStatus(agentStatus status.Status, info string, data map[string]interface{}) error

SetAgentStatus sets the status of the unit agent.

func (*Unit) SetCharmURL Uses

func (u *Unit) SetCharmURL(curl *charm.URL) error

SetCharmURL marks the unit as currently using the supplied charm URL. An error will be returned if the unit is dead, or the charm URL not known.

func (*Unit) SetUnitStatus Uses

func (u *Unit) SetUnitStatus(unitStatus status.Status, info string, data map[string]interface{}) error

SetUnitStatus sets the status of the unit.

func (*Unit) SetUpgradeSeriesStatus Uses

func (u *Unit) SetUpgradeSeriesStatus(status model.UpgradeSeriesStatus, reason string) error

SetUpgradeSeriesStatus sets the upgrade series status of the unit in the remote state

func (*Unit) String Uses

func (u *Unit) String() string

String returns the unit as a string.

func (*Unit) Tag Uses

func (u *Unit) Tag() names.UnitTag

Tag returns the unit's tag.

func (*Unit) UnitStatus Uses

func (u *Unit) UnitStatus() (params.StatusResult, error)

UnitStatus gets the status details of the unit.

func (*Unit) UpdateNetworkInfo Uses

func (u *Unit) UpdateNetworkInfo() error

UpdateNetworkInfo updates the network settings for the unit's bound endpoints.

func (*Unit) UpgradeSeriesStatus Uses

func (u *Unit) UpgradeSeriesStatus() (model.UpgradeSeriesStatus, error)

UpgradeSeriesStatus returns the upgrade series status of a unit from remote state

func (*Unit) Watch Uses

func (u *Unit) Watch() (watcher.NotifyWatcher, error)

Watch returns a watcher for observing changes to the unit.

func (*Unit) WatchActionNotifications Uses

func (u *Unit) WatchActionNotifications() (watcher.StringsWatcher, error)

WatchActionNotifications returns a StringsWatcher for observing the ids of Actions added to the Unit. The initial event will contain the ids of any Actions pending at the time the Watcher is made.

func (*Unit) WatchAddressesHash Uses

func (u *Unit) WatchAddressesHash() (watcher.StringsWatcher, error)

WatchAddressesHash returns a watcher for observing changes to the hash of the unit's addresses. For IAAS models, the unit must be assigned to a machine before this method is called, and the returned watcher will be valid only while the unit's assigned machine is not changed. For CAAS models, the watcher observes changes to the address of the pod associated with the unit.

func (*Unit) WatchConfigSettingsHash Uses

func (u *Unit) WatchConfigSettingsHash() (watcher.StringsWatcher, error)

WatchConfigSettingsHash returns a watcher for observing changes to the unit's charm configuration settings (with a hash of the settings content so we can determine whether it has changed since it was last seen by the uniter). The unit must have a charm URL set before this method is called, and the returned watcher will be valid only while the unit's charm URL is not changed.

func (*Unit) WatchMeterStatus Uses

func (u *Unit) WatchMeterStatus() (watcher.NotifyWatcher, error)

WatchMeterStatus returns a watcher for observing changes to the unit's meter status.

func (*Unit) WatchRelations Uses

func (u *Unit) WatchRelations() (watcher.StringsWatcher, error)

WatchRelations returns a StringsWatcher that notifies of changes to the lifecycles of relations involving u.

func (*Unit) WatchStorage Uses

func (u *Unit) WatchStorage() (watcher.StringsWatcher, error)

WatchStorage returns a watcher for observing changes to the unit's storage attachments.

func (*Unit) WatchTrustConfigSettingsHash Uses

func (u *Unit) WatchTrustConfigSettingsHash() (watcher.StringsWatcher, error)

WatchTrustConfigSettingsHash returns a watcher for observing changes to the unit's application configuration settings (with a hash of the settings content so we can determine whether it has changed since it was last seen by the uniter).

func (*Unit) WatchUpgradeSeriesNotifications Uses

func (u *Unit) WatchUpgradeSeriesNotifications() (watcher.NotifyWatcher, error)

WatchUpgradeSeriesNotifications returns a NotifyWatcher for observing the state of a series upgrade.

Package uniter imports 15 packages (graph) and is imported by 244 packages. Updated 2019-10-18. Refresh now. Tools for package owners.