service

Documentation

Overview

Package service provides access to the service api facade. This facade contains api calls that are specific to services. As a rule of thumb, if the argument for an api requries a service name and affects only that service then the call belongs here.

Index

• type Client
  • func NewClient(st *api.State) *Client
  • func (c *Client) ServiceDeploy(charmURL string, serviceName string, numUnits int, configYAML string, ...) error
  • func (c *Client) SetMetricCredentials(service string, credentials []byte) error

Types

type Client

type Client struct {
	base.ClientFacade
	// contains filtered or unexported fields
}

Client allows access to the service API end point.

func NewClient

func NewClient(st *api.State) *Client

NewClient creates a new client for accessing the service api.

func (*Client) ServiceDeploy

func (c *Client) ServiceDeploy(
	charmURL string,
	serviceName string,
	numUnits int,
	configYAML string,
	cons constraints.Value,
	toMachineSpec string,
	networks []string,
	storage map[string]storage.Constraints,
) error

ServiceDeploy obtains the charm, either locally or from the charm store, and deploys it. It allows the specification of requested networks that must be present on the machines where the service is deployed. Another way to specify networks to include/exclude is using constraints.

func (*Client) SetMetricCredentials

func (c *Client) SetMetricCredentials(service string, credentials []byte) error

SetMetricCredentials sets the metric credentials for the service specified.