v2action

package
v6.36.0+incompatible Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Apr 2, 2018 License: Apache-2.0 Imports: 20 Imported by: 412

Documentation

Overview

Package v2action contains the business logic for the commands/v2 package

Index

Constants

View Source 
const (
	DefaultFolderPermissions      = 0755
	DefaultArchiveFilePermissions = 0744
	MaxResourceMatchChunkSize     = 1000
)
View Source 
const StagingLog = "STG"

Variables

View Source 
var DefaultIgnoreLines = []string{
	".cfignore",
	".DS_Store",
	".git",
	".gitignore",
	".hg",
	".svn",
	"_darcs",
	"manifest.yaml",
	"manifest.yml",
}

Functions

func ActorToCCRoute 

func ActorToCCRoute(route Route) ccv2.Route

Types

type Actor 

type Actor struct {
	CloudControllerClient CloudControllerClient
	Config                Config
	UAAClient             UAAClient
	// contains filtered or unexported fields
}

Actor handles all business logic for Cloud Controller v2 operations.

func NewActor 

func NewActor(ccClient CloudControllerClient, uaaClient UAAClient, config Config) *Actor

NewActor returns a new actor.

func (Actor) Authenticate 

func (actor Actor) Authenticate(ID string, secret string, grantType constant.GrantType) error

Authenticate authenticates the user in UAA and sets the returned tokens in the config.

It unsets the currently targeted org and space whether authentication succeeds or not.

func (Actor) BindSecurityGroupToSpace 

func (actor Actor) BindSecurityGroupToSpace(securityGroupGUID string, spaceGUID string, lifecycle constant.SecurityGroupLifecycle) (Warnings, error)

func (Actor) BindServiceByApplicationAndServiceInstance 

func (actor Actor) BindServiceByApplicationAndServiceInstance(appGUID string, serviceInstanceGUID string) (Warnings, error)

BindServiceByApplicationAndServiceInstance binds the service instance to an application.

func (Actor) BindServiceBySpace 

func (actor Actor) BindServiceBySpace(appName string, serviceInstanceName string, spaceGUID string, bindingName string, parameters map[string]interface{}) (Warnings, error)

BindServiceBySpace binds the service instance to an application for a given space.

func (Actor) CheckRoute 

func (actor Actor) CheckRoute(route Route) (bool, Warnings, error)

func (Actor) ClearTarget 

func (actor Actor) ClearTarget()

ClearTarget clears target information from the actor.

func (Actor) CloudControllerAPIVersion 

func (actor Actor) CloudControllerAPIVersion() string

CloudControllerAPIVersion returns the Cloud Controller API version.

func (Actor) CreateApplication 

func (actor Actor) CreateApplication(application Application) (Application, Warnings, error)

CreateApplication creates an application.

func (Actor) CreateApplicationManifestByNameAndSpace 

func (actor Actor) CreateApplicationManifestByNameAndSpace(appName string, spaceGUID string, pathToFile string) (Warnings, error)

func (Actor) CreateRoute 

func (actor Actor) CreateRoute(route Route, generatePort bool) (Route, Warnings, error)

func (Actor) CreateRouteWithExistenceCheck 

func (actor Actor) CreateRouteWithExistenceCheck(orgGUID string, spaceName string, route Route, generatePort bool) (Route, Warnings, error)

func (Actor) CreateUser 

func (actor Actor) CreateUser(username string, password string, origin string) (User, Warnings, error)

CreateUser creates a new user in UAA and registers it with cloud controller.

func (Actor) DeleteOrganization 

func (actor Actor) DeleteOrganization(orgName string) (Warnings, error)

DeleteOrganization deletes the Organization associated with the provided GUID. Once the deletion request is sent, it polls the deletion job until it's finished.

func (Actor) DeleteRoute 

func (actor Actor) DeleteRoute(routeGUID string) (Warnings, error)

DeleteRoute deletes the Route associated with the provided Route GUID.

func (Actor) DeleteSpaceByNameAndOrganizationName 

func (actor Actor) DeleteSpaceByNameAndOrganizationName(spaceName string, orgName string) (Warnings, error)

func (Actor) FindRouteBoundToSpaceWithSettings 

func (actor Actor) FindRouteBoundToSpaceWithSettings(route Route) (Route, Warnings, error)

FindRouteBoundToSpaceWithSettings finds the route with the given host, domain and space. If it is unable to find the route, it will check if it exists anywhere in the system. When the route exists in another space, RouteInDifferentSpaceError is returned. Use this when you know the space GUID.

func (Actor) GetApplication 

func (actor Actor) GetApplication(guid string) (Application, Warnings, error)

GetApplication returns the application.

func (Actor) GetApplicationByNameAndSpace 

func (actor Actor) GetApplicationByNameAndSpace(name string, spaceGUID string) (Application, Warnings, error)

GetApplicationByNameAndSpace returns an application with matching name in the space.

func (Actor) GetApplicationInstancesByApplication 

func (actor Actor) GetApplicationInstancesByApplication(guid string) (map[int]ApplicationInstance, Warnings, error)

func (Actor) GetApplicationInstancesWithStatsByApplication 

func (actor Actor) GetApplicationInstancesWithStatsByApplication(guid string) ([]ApplicationInstanceWithStats, Warnings, error)

func (Actor) GetApplicationRoutes 

func (actor Actor) GetApplicationRoutes(applicationGUID string) (Routes, Warnings, error)

GetApplicationRoutes returns a list of routes associated with the provided Application GUID.

func (Actor) GetApplicationSummaryByNameAndSpace 

func (actor Actor) GetApplicationSummaryByNameAndSpace(name string, spaceGUID string) (ApplicationSummary, Warnings, error)

func (Actor) GetApplicationsBySpace 

func (actor Actor) GetApplicationsBySpace(spaceGUID string) ([]Application, Warnings, error)

GetApplicationsBySpace returns all applications in a space.

func (Actor) GetDomain 

func (actor Actor) GetDomain(domainGUID string) (Domain, Warnings, error)

GetDomain returns the shared or private domain associated with the provided Domain GUID.

func (Actor) GetDomainsByNameAndOrganization 

func (actor Actor) GetDomainsByNameAndOrganization(domainNames []string, orgGUID string) ([]Domain, Warnings, error)

GetDomainsByNameAndOrganization returns back a list of domains given a list of domains names and the organization GUID. If no domains are given, than this command will not lookup any domains.

func (Actor) GetFeatureFlags 

func (actor Actor) GetFeatureFlags() ([]FeatureFlag, Warnings, error)

func (Actor) GetOrganization 

func (actor Actor) GetOrganization(guid string) (Organization, Warnings, error)

GetOrganization returns an Organization based on the provided guid.

func (Actor) GetOrganizationByName 

func (actor Actor) GetOrganizationByName(orgName string) (Organization, Warnings, error)

GetOrganizationByName returns an Organization based off of the name given.

func (Actor) GetOrganizationDomains 

func (actor Actor) GetOrganizationDomains(orgGUID string) ([]Domain, Warnings, error)

GetOrganizationDomains returns the shared and private domains associated with an organization.

func (Actor) GetOrganizationQuota 

func (actor Actor) GetOrganizationQuota(guid string) (OrganizationQuota, Warnings, error)

func (Actor) GetOrganizationSpaces 

func (actor Actor) GetOrganizationSpaces(orgGUID string) ([]Space, Warnings, error)

GetOrganizationSpaces returns a list of spaces in the specified org

func (Actor) GetOrganizationSummaryByName 

func (actor Actor) GetOrganizationSummaryByName(orgName string) (OrganizationSummary, Warnings, error)

func (Actor) GetOrganizations 

func (actor Actor) GetOrganizations() ([]Organization, Warnings, error)

func (Actor) GetOrphanedRoutesBySpace 

func (actor Actor) GetOrphanedRoutesBySpace(spaceGUID string) ([]Route, Warnings, error)

GetOrphanedRoutesBySpace returns a list of orphaned routes associated with the provided Space GUID.

func (Actor) GetPrivateDomain 

func (actor Actor) GetPrivateDomain(domainGUID string) (Domain, Warnings, error)

GetPrivateDomain returns the private domain associated with the provided Domain GUID.

func (Actor) GetRecentLogsForApplicationByNameAndSpace 

func (actor Actor) GetRecentLogsForApplicationByNameAndSpace(appName string, spaceGUID string, client NOAAClient) ([]LogMessage, Warnings, error)

func (Actor) GetRouteApplications 

func (actor Actor) GetRouteApplications(routeGUID string) ([]Application, Warnings, error)

GetRouteApplications returns a list of apps associated with the provided Route GUID.

func (Actor) GetRouteByComponents 

func (actor Actor) GetRouteByComponents(route Route) (Route, Warnings, error)

GetRouteByComponents returns the route with the matching host, domain, path, and port. Use this when you don't know the space GUID. TCP routes require a port to be uniquely identified HTTP routes using shared domains require a hostname or path to be uniquely identified

func (Actor) GetSSHPasscode 

func (actor Actor) GetSSHPasscode() (string, error)

func (Actor) GetSecurityGroupByName 

func (actor Actor) GetSecurityGroupByName(securityGroupName string) (SecurityGroup, Warnings, error)

func (Actor) GetSecurityGroupsWithOrganizationSpaceAndLifecycle 

func (actor Actor) GetSecurityGroupsWithOrganizationSpaceAndLifecycle(includeStaging bool) ([]SecurityGroupWithOrganizationSpaceAndLifecycle, Warnings, error)

GetSecurityGroupsWithOrganizationSpaceAndLifecycle returns a list of security groups with org and space information, optionally including staging spaces.

func (Actor) GetService 

func (actor Actor) GetService(serviceGUID string) (Service, Warnings, error)

func (Actor) GetServiceBindingByApplicationAndServiceInstance 

func (actor Actor) GetServiceBindingByApplicationAndServiceInstance(appGUID string, serviceInstanceGUID string) (ServiceBinding, Warnings, error)

GetServiceBindingByApplicationAndServiceInstance returns a service binding given an application GUID and and service instance GUID.

func (Actor) GetServiceBindingsByServiceInstance 

func (actor Actor) GetServiceBindingsByServiceInstance(serviceInstanceGUID string) ([]ServiceBinding, Warnings, error)

func (Actor) GetServiceBindingsByUserProvidedServiceInstance 

func (actor Actor) GetServiceBindingsByUserProvidedServiceInstance(userProvidedServiceInstanceGUID string) ([]ServiceBinding, Warnings, error)

func (Actor) GetServiceInstance 

func (actor Actor) GetServiceInstance(guid string) (ServiceInstance, Warnings, error)

func (Actor) GetServiceInstanceByNameAndSpace 

func (actor Actor) GetServiceInstanceByNameAndSpace(name string, spaceGUID string) (ServiceInstance, Warnings, error)

func (Actor) GetServiceInstanceSharedFromByServiceInstance 

func (actor Actor) GetServiceInstanceSharedFromByServiceInstance(serviceInstanceGUID string) (ServiceInstanceSharedFrom, Warnings, error)

func (Actor) GetServiceInstanceSharedTosByServiceInstance 

func (actor Actor) GetServiceInstanceSharedTosByServiceInstance(serviceInstanceGUID string) ([]ServiceInstanceSharedTo, Warnings, error)

func (Actor) GetServiceInstanceSummaryByNameAndSpace 

func (actor Actor) GetServiceInstanceSummaryByNameAndSpace(name string, spaceGUID string) (ServiceInstanceSummary, Warnings, error)

func (Actor) GetServiceInstancesByApplication 

func (actor Actor) GetServiceInstancesByApplication(appGUID string) ([]ServiceInstance, Warnings, error)

func (Actor) GetServiceInstancesBySpace 

func (actor Actor) GetServiceInstancesBySpace(spaceGUID string) ([]ServiceInstance, Warnings, error)

func (Actor) GetServiceInstancesSummaryBySpace 

func (actor Actor) GetServiceInstancesSummaryBySpace(spaceGUID string) ([]ServiceInstanceSummary, Warnings, error)

func (Actor) GetServicePlan 

func (actor Actor) GetServicePlan(servicePlanGUID string) (ServicePlan, Warnings, error)

func (Actor) GetSharedDomain 

func (actor Actor) GetSharedDomain(domainGUID string) (Domain, Warnings, error)

GetSharedDomain returns the shared domain associated with the provided Domain GUID.

func (Actor) GetSpaceByOrganizationAndName 

func (actor Actor) GetSpaceByOrganizationAndName(orgGUID string, spaceName string) (Space, Warnings, error)

GetSpaceByOrganizationAndName returns an Space based on the org and name.

func (Actor) GetSpaceQuota 

func (actor Actor) GetSpaceQuota(guid string) (SpaceQuota, Warnings, error)

func (Actor) GetSpaceRoutes 

func (actor Actor) GetSpaceRoutes(spaceGUID string) ([]Route, Warnings, error)

GetSpaceRoutes returns a list of routes associated with the provided Space GUID.

func (Actor) GetSpaceRunningSecurityGroupsBySpace 

func (actor Actor) GetSpaceRunningSecurityGroupsBySpace(spaceGUID string) ([]SecurityGroup, Warnings, error)

GetSpaceRunningSecurityGroupsBySpace returns a list of all security groups bound to this space in the 'running' lifecycle phase.

func (Actor) GetSpaceStagingSecurityGroupsBySpace 

func (actor Actor) GetSpaceStagingSecurityGroupsBySpace(spaceGUID string) ([]SecurityGroup, Warnings, error)

GetSpaceStagingSecurityGroupsBySpace returns a list of all security groups bound to this space in the 'staging' lifecycle phase. with an optional

func (Actor) GetSpaceSummaryByOrganizationAndName 

func (actor Actor) GetSpaceSummaryByOrganizationAndName(orgGUID string, name string, includeStagingSecurityGroupsRules bool) (SpaceSummary, Warnings, error)

func (Actor) GetStack 

func (actor Actor) GetStack(guid string) (Stack, Warnings, error)

GetStack returns the stack information associated with the provided stack GUID.

func (Actor) GetStackByName 

func (actor Actor) GetStackByName(stackName string) (Stack, Warnings, error)

GetStackByName returns the provided stack

func (Actor) GetStreamingLogs 

func (Actor) GetStreamingLogs(appGUID string, client NOAAClient) (<-chan *LogMessage, <-chan error)

func (Actor) GetStreamingLogsForApplicationByNameAndSpace 

func (actor Actor) GetStreamingLogsForApplicationByNameAndSpace(appName string, spaceGUID string, client NOAAClient) (<-chan *LogMessage, <-chan error, Warnings, error)

func (Actor) MapRouteToApplication 

func (actor Actor) MapRouteToApplication(routeGUID string, appGUID string) (Warnings, error)

func (Actor) PollJob 

func (actor Actor) PollJob(job Job) (Warnings, error)

func (Actor) RefreshAccessToken 

func (actor Actor) RefreshAccessToken(refreshToken string) (string, error)

func (Actor) ResourceMatch 

func (actor Actor) ResourceMatch(allResources []Resource) ([]Resource, []Resource, Warnings, error)

ResourceMatch returns a set of matched resources and unmatched resources in the order they were given in allResources.

func (Actor) RestageApplication 

func (actor Actor) RestageApplication(app Application, client NOAAClient) (<-chan *LogMessage, <-chan error, <-chan ApplicationStateChange, <-chan string, <-chan error)

RestageApplication restarts a given application. If already stopped, no stop call will be sent.

func (Actor) RestartApplication 

func (actor Actor) RestartApplication(app Application, client NOAAClient) (<-chan *LogMessage, <-chan error, <-chan ApplicationStateChange, <-chan string, <-chan error)

RestartApplication restarts a given application. If already stopped, no stop call will be sent.

func (Actor) SetApplicationHealthCheckTypeByNameAndSpace 

func (actor Actor) SetApplicationHealthCheckTypeByNameAndSpace(name string, spaceGUID string, healthCheckType constant.ApplicationHealthCheckType, httpEndpoint string) (Application, Warnings, error)

SetApplicationHealthCheckTypeByNameAndSpace updates an application's health check type if it is not already the desired type.

func (Actor) SetTarget 

func (actor Actor) SetTarget(settings TargetSettings) (Warnings, error)

SetTarget targets the Cloud Controller using the client and sets target information in the actor based on the response.

func (Actor) StartApplication 

func (actor Actor) StartApplication(app Application, client NOAAClient) (<-chan *LogMessage, <-chan error, <-chan ApplicationStateChange, <-chan string, <-chan error)

StartApplication restarts a given application. If already stopped, no stop call will be sent.

func (Actor) UnbindSecurityGroupByNameAndSpace 

func (actor Actor) UnbindSecurityGroupByNameAndSpace(securityGroupName string, spaceGUID string, lifecycle constant.SecurityGroupLifecycle) (Warnings, error)

func (Actor) UnbindSecurityGroupByNameOrganizationNameAndSpaceName 

func (actor Actor) UnbindSecurityGroupByNameOrganizationNameAndSpaceName(securityGroupName string, orgName string, spaceName string, lifecycle constant.SecurityGroupLifecycle) (Warnings, error)

func (Actor) UnbindServiceBySpace 

func (actor Actor) UnbindServiceBySpace(appName string, serviceInstanceName string, spaceGUID string) (Warnings, error)

UnbindServiceBySpace deletes the service binding between an application and service instance for a given space.

func (Actor) UnmapRouteFromApplication 

func (actor Actor) UnmapRouteFromApplication(routeGUID string, appGUID string) (Warnings, error)

func (Actor) UpdateApplication 

func (actor Actor) UpdateApplication(application Application) (Application, Warnings, error)

UpdateApplication updates an application.

func (Actor) UploadApplicationPackage 

func (actor Actor) UploadApplicationPackage(appGUID string, existingResources []Resource, newResources io.Reader, newResourcesLength int64) (Job, Warnings, error)

func (Actor) UploadDroplet 

func (actor Actor) UploadDroplet(appGUID string, droplet io.Reader, dropletLength int64) (Job, Warnings, error)

type Application 

type Application ccv2.Application

Application represents an application.

func (Application) CalculatedBuildpack 

func (application Application) CalculatedBuildpack() string

CalculatedBuildpack returns the buildpack that will be used.

func (Application) CalculatedCommand 

func (application Application) CalculatedCommand() string

CalculatedCommand returns the command that will be used.

func (Application) CalculatedHealthCheckEndpoint 

func (application Application) CalculatedHealthCheckEndpoint() string

CalculatedHealthCheckEndpoint returns the health check endpoint. If the health check type is not http it will return the empty string.

func (Application) StagingCompleted 

func (application Application) StagingCompleted() bool

StagingCompleted returns true if the application has been staged.

func (Application) StagingFailed 

func (application Application) StagingFailed() bool

StagingFailed returns true if staging the application failed.

func (Application) StagingFailedMessage 

func (application Application) StagingFailedMessage() string

StagingFailedMessage returns the verbose description of the failure or the reason if the verbose description is empty.

func (Application) StagingFailedNoAppDetected 

func (application Application) StagingFailedNoAppDetected() bool

StagingFailedNoAppDetected returns true when the staging failed due to a NoAppDetectedError.

func (Application) Started 

func (application Application) Started() bool

Started returns true when the application is started.

func (Application) Stopped 

func (application Application) Stopped() bool

Stopped returns true when the application is stopped.

func (Application) String 

func (application Application) String() string

type ApplicationInstance 

type ApplicationInstance ccv2.ApplicationInstance

func (ApplicationInstance) Crashed 

func (instance ApplicationInstance) Crashed() bool

func (ApplicationInstance) Flapping 

func (instance ApplicationInstance) Flapping() bool

func (ApplicationInstance) Running 

func (instance ApplicationInstance) Running() bool

type ApplicationInstanceState 

type ApplicationInstanceState constant.ApplicationInstanceState

type ApplicationInstanceWithStats 

type ApplicationInstanceWithStats struct {
	// CPU is the instance's CPU utilization percentage.
	CPU float64

	// Details are arbitrary information about the instance.
	Details string

	// Disk is the instance's disk usage in bytes.
	Disk int

	// DiskQuota is the instance's allowed disk usage in bytes.
	DiskQuota int

	// ID is the instance ID.
	ID int

	// IsolationSegment that the app instance is currently running on.
	IsolationSegment string

	// Memory is the instance's memory usage in bytes.
	Memory int

	// MemoryQuota is the instance's allowed memory usage in bytes.
	MemoryQuota int

	// Since is the Unix time stamp that represents the time the instance was
	// created.
	Since float64

	// State is the instance's state.
	State ApplicationInstanceState
}

func (ApplicationInstanceWithStats) TimeSinceCreation 

func (instance ApplicationInstanceWithStats) TimeSinceCreation() time.Time

type ApplicationStateChange 

type ApplicationStateChange string
const (
	ApplicationStateStopping ApplicationStateChange = "stopping"
	ApplicationStateStaging  ApplicationStateChange = "staging"
	ApplicationStateStarting ApplicationStateChange = "starting"
)

type ApplicationSummary 

type ApplicationSummary struct {
	Application
	Stack            Stack
	IsolationSegment string
	RunningInstances []ApplicationInstanceWithStats
	Routes           []Route
}

func (ApplicationSummary) StartingOrRunningInstanceCount 

func (app ApplicationSummary) StartingOrRunningInstanceCount() int

type BoundApplication 

type BoundApplication struct {
	AppName            string
	ServiceBindingName string
}

type CloudControllerClient 

type CloudControllerClient interface {
	CreateApplication(app ccv2.Application) (ccv2.Application, ccv2.Warnings, error)
	CreateRoute(route ccv2.Route, generatePort bool) (ccv2.Route, ccv2.Warnings, error)
	CreateServiceBinding(appGUID string, serviceBindingGUID string, bindingName string, parameters map[string]interface{}) (ccv2.ServiceBinding, ccv2.Warnings, error)
	CreateUser(uaaUserID string) (ccv2.User, ccv2.Warnings, error)
	DeleteOrganizationJob(orgGUID string) (ccv2.Job, ccv2.Warnings, error)
	DeleteRoute(routeGUID string) (ccv2.Warnings, error)
	DeleteRouteApplication(routeGUID string, appGUID string) (ccv2.Warnings, error)
	DeleteSecurityGroupSpace(securityGroupGUID string, spaceGUID string) (ccv2.Warnings, error)
	DeleteSecurityGroupStagingSpace(securityGroupGUID string, spaceGUID string) (ccv2.Warnings, error)
	DeleteServiceBinding(serviceBindingGUID string) (ccv2.Warnings, error)
	DeleteSpaceJob(spaceGUID string) (ccv2.Job, ccv2.Warnings, error)
	DoesRouteExist(route ccv2.Route) (bool, ccv2.Warnings, error)
	GetApplication(guid string) (ccv2.Application, ccv2.Warnings, error)
	GetApplicationApplicationInstanceStatuses(guid string) (map[int]ccv2.ApplicationInstanceStatus, ccv2.Warnings, error)
	GetApplicationApplicationInstances(guid string) (map[int]ccv2.ApplicationInstance, ccv2.Warnings, error)
	GetApplicationRoutes(appGUID string, filters ...ccv2.Filter) ([]ccv2.Route, ccv2.Warnings, error)
	GetApplications(filters ...ccv2.Filter) ([]ccv2.Application, ccv2.Warnings, error)
	GetConfigFeatureFlags() ([]ccv2.FeatureFlag, ccv2.Warnings, error)
	GetJob(jobGUID string) (ccv2.Job, ccv2.Warnings, error)
	GetOrganization(guid string) (ccv2.Organization, ccv2.Warnings, error)
	GetOrganizationPrivateDomains(orgGUID string, filters ...ccv2.Filter) ([]ccv2.Domain, ccv2.Warnings, error)
	GetOrganizationQuota(guid string) (ccv2.OrganizationQuota, ccv2.Warnings, error)
	GetOrganizations(filters ...ccv2.Filter) ([]ccv2.Organization, ccv2.Warnings, error)
	GetPrivateDomain(domainGUID string) (ccv2.Domain, ccv2.Warnings, error)
	GetRouteApplications(routeGUID string, filters ...ccv2.Filter) ([]ccv2.Application, ccv2.Warnings, error)
	GetRoutes(filters ...ccv2.Filter) ([]ccv2.Route, ccv2.Warnings, error)
	GetSecurityGroupSpaces(securityGroupGUID string) ([]ccv2.Space, ccv2.Warnings, error)
	GetSecurityGroupStagingSpaces(securityGroupGUID string) ([]ccv2.Space, ccv2.Warnings, error)
	GetSecurityGroups(filters ...ccv2.Filter) ([]ccv2.SecurityGroup, ccv2.Warnings, error)
	GetService(serviceGUID string) (ccv2.Service, ccv2.Warnings, error)
	GetServiceBindings(filters ...ccv2.Filter) ([]ccv2.ServiceBinding, ccv2.Warnings, error)
	GetServiceInstance(serviceInstanceGUID string) (ccv2.ServiceInstance, ccv2.Warnings, error)
	GetServiceInstanceServiceBindings(serviceInstanceGUID string) ([]ccv2.ServiceBinding, ccv2.Warnings, error)
	GetServiceInstanceSharedFrom(serviceInstanceGUID string) (ccv2.ServiceInstanceSharedFrom, ccv2.Warnings, error)
	GetServiceInstanceSharedTos(serviceInstanceGUID string) ([]ccv2.ServiceInstanceSharedTo, ccv2.Warnings, error)
	GetServiceInstances(filters ...ccv2.Filter) ([]ccv2.ServiceInstance, ccv2.Warnings, error)
	GetServicePlan(servicePlanGUID string) (ccv2.ServicePlan, ccv2.Warnings, error)
	GetSharedDomain(domainGUID string) (ccv2.Domain, ccv2.Warnings, error)
	GetSharedDomains(filters ...ccv2.Filter) ([]ccv2.Domain, ccv2.Warnings, error)
	GetSpaceQuotaDefinition(guid string) (ccv2.SpaceQuota, ccv2.Warnings, error)
	GetSpaceRoutes(spaceGUID string, filters ...ccv2.Filter) ([]ccv2.Route, ccv2.Warnings, error)
	GetSpaceSecurityGroups(spaceGUID string, filters ...ccv2.Filter) ([]ccv2.SecurityGroup, ccv2.Warnings, error)
	GetSpaceServiceInstances(spaceGUID string, includeUserProvidedServices bool, filters ...ccv2.Filter) ([]ccv2.ServiceInstance, ccv2.Warnings, error)
	GetSpaceStagingSecurityGroups(spaceGUID string, filters ...ccv2.Filter) ([]ccv2.SecurityGroup, ccv2.Warnings, error)
	GetSpaces(filters ...ccv2.Filter) ([]ccv2.Space, ccv2.Warnings, error)
	GetStack(guid string) (ccv2.Stack, ccv2.Warnings, error)
	GetStacks(filters ...ccv2.Filter) ([]ccv2.Stack, ccv2.Warnings, error)
	GetUserProvidedServiceInstanceServiceBindings(userProvidedServiceInstanceGUID string) ([]ccv2.ServiceBinding, ccv2.Warnings, error)
	PollJob(job ccv2.Job) (ccv2.Warnings, error)
	RestageApplication(app ccv2.Application) (ccv2.Application, ccv2.Warnings, error)
	TargetCF(settings ccv2.TargetSettings) (ccv2.Warnings, error)
	UpdateApplication(app ccv2.Application) (ccv2.Application, ccv2.Warnings, error)
	UpdateResourceMatch(resourcesToMatch []ccv2.Resource) ([]ccv2.Resource, ccv2.Warnings, error)
	UpdateRouteApplication(routeGUID string, appGUID string) (ccv2.Route, ccv2.Warnings, error)
	UpdateSecurityGroupSpace(securityGroupGUID string, spaceGUID string) (ccv2.Warnings, error)
	UpdateSecurityGroupStagingSpace(securityGroupGUID string, spaceGUID string) (ccv2.Warnings, error)
	UploadApplicationPackage(appGUID string, existingResources []ccv2.Resource, newResources ccv2.Reader, newResourcesLength int64) (ccv2.Job, ccv2.Warnings, error)
	UploadDroplet(appGUID string, droplet io.Reader, dropletLength int64) (ccv2.Job, ccv2.Warnings, error)

	API() string
	APIVersion() string
	AuthorizationEndpoint() string
	DopplerEndpoint() string
	MinCLIVersion() string
	RoutingEndpoint() string
	TokenEndpoint() string
}

CloudControllerClient is a Cloud Controller V2 client.

type Config 

type Config interface {
	AccessToken() string
	PollingInterval() time.Duration
	RefreshToken() string
	SetAccessToken(accessToken string)
	SetRefreshToken(refreshToken string)
	SetTargetInformation(api string, apiVersion string, auth string, minCLIVersion string, doppler string, routing string, skipSSLValidation bool)
	SetTokenInformation(accessToken string, refreshToken string, sshOAuthClient string)
	SetUAAClientCredentials(client string, clientSecret string)
	SetUAAGrantType(uaaGrantType string)
	SkipSSLValidation() bool
	SSHOAuthClient() string
	StagingTimeout() time.Duration
	StartupTimeout() time.Duration
	Target() string
	UAAGrantType() string
	UnsetOrganizationAndSpaceInformation()
	UnsetSpaceInformation()
	Verbose() (bool, []string)
}

type Domain 

type Domain ccv2.Domain

Domain represents a CLI Domain.

func (Domain) IsHTTP 

func (domain Domain) IsHTTP() bool

IsHTTP returns true for any router group type that is not 'tcp'.

func (Domain) IsPrivate 

func (domain Domain) IsPrivate() bool

IsPrivate returns true when the domain is a private domain.

func (Domain) IsShared 

func (domain Domain) IsShared() bool

IsShared returns true when the domain is a shared domain.

func (Domain) IsTCP 

func (domain Domain) IsTCP() bool

IsTCP returns true only when the router group type equals 'tcp'.

type FeatureFlag 

type FeatureFlag ccv2.FeatureFlag

func (FeatureFlag) State 

func (f FeatureFlag) State() FeatureFlagState

type FeatureFlagState 

type FeatureFlagState string
const (
	FeatureFlagEnabled  FeatureFlagState = "enabled"
	FeatureFlagDisabled FeatureFlagState = "disabled"
)

type Job 

type Job ccv2.Job

type LogMessage 

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

func NewLogMessage 

func NewLogMessage(message string, messageType int, timestamp time.Time, sourceType string, sourceInstance string) *LogMessage

func (LogMessage) Message 

func (log LogMessage) Message() string

func (LogMessage) SourceInstance 

func (log LogMessage) SourceInstance() string

func (LogMessage) SourceType 

func (log LogMessage) SourceType() string

func (LogMessage) Staging 

func (log LogMessage) Staging() bool

func (LogMessage) Timestamp 

func (log LogMessage) Timestamp() time.Time

func (LogMessage) Type 

func (log LogMessage) Type() string

type LogMessages 

type LogMessages []*LogMessage

func (LogMessages) Len 

func (lm LogMessages) Len() int

func (LogMessages) Less 

func (lm LogMessages) Less(i, j int) bool

func (LogMessages) Swap 

func (lm LogMessages) Swap(i, j int)

type NOAAClient 

type NOAAClient interface {
	Close() error
	RecentLogs(appGuid string, authToken string) ([]*events.LogMessage, error)
	TailingLogs(appGuid, authToken string) (<-chan *events.LogMessage, <-chan error)
}

NOAAClient is a client for getting logs.

type Organization 

type Organization ccv2.Organization

Organization represents a CLI Organization.

type OrganizationQuota 

type OrganizationQuota ccv2.OrganizationQuota

type OrganizationSummary 

type OrganizationSummary struct {
	Organization
	QuotaName   string
	DomainNames []string
	SpaceNames  []string
}

type Resource 

type Resource ccv2.Resource

type Route 

type Route struct {
	Domain    Domain
	GUID      string
	Host      string
	Path      string
	Port      types.NullInt
	SpaceGUID string
}

Route represents a CLI Route.

func CCToActorRoute 

func CCToActorRoute(ccv2Route ccv2.Route, domain Domain) Route

func (Route) RandomTCPPort 

func (r Route) RandomTCPPort() bool

func (Route) String 

func (r Route) String() string

String formats the route in a human readable format.

func (Route) Validate 

func (r Route) Validate() error

Validate will return an error if there are invalid HTTP or TCP settings for it's given domain.

func (Route) ValidateWithRandomPort 

func (r Route) ValidateWithRandomPort(randomPort bool) error

TODO: rename to ValidateWithPortOptions

type Routes 

type Routes []Route

func (Routes) Summary 

func (rs Routes) Summary() string

Summary converts routes into a comma separated string.

type SecurityGroup 

type SecurityGroup ccv2.SecurityGroup

SecurityGroup represents a CF SecurityGroup.

type SecurityGroupRule 

type SecurityGroupRule struct {
	Name        string
	Description string
	Destination string
	Lifecycle   constant.SecurityGroupLifecycle
	Ports       string
	Protocol    string
}

type SecurityGroupWithOrganizationSpaceAndLifecycle 

type SecurityGroupWithOrganizationSpaceAndLifecycle struct {
	SecurityGroup *SecurityGroup
	Organization  *Organization
	Space         *Space
	Lifecycle     constant.SecurityGroupLifecycle
}

SecurityGroupWithOrganizationSpaceAndLifecycle represents a security group with organization and space information.

type Service 

type Service ccv2.Service

type ServiceBinding 

type ServiceBinding ccv2.ServiceBinding

ServiceBinding represents the link between a service instance and an application.

type ServiceInstance 

type ServiceInstance ccv2.ServiceInstance

ServiceInstance represents an instance of a service.

func (ServiceInstance) IsManaged 

func (instance ServiceInstance) IsManaged() bool

func (ServiceInstance) IsUserProvided 

func (instance ServiceInstance) IsUserProvided() bool

type ServiceInstanceShareType 

type ServiceInstanceShareType string
const (
	ServiceInstanceIsSharedFrom ServiceInstanceShareType = "SharedFrom"
	ServiceInstanceIsSharedTo   ServiceInstanceShareType = "SharedTo"
	ServiceInstanceIsNotShared  ServiceInstanceShareType = "NotShared"
)

type ServiceInstanceSharedFrom 

type ServiceInstanceSharedFrom ccv2.ServiceInstanceSharedFrom

type ServiceInstanceSharedTo 

type ServiceInstanceSharedTo ccv2.ServiceInstanceSharedTo

type ServiceInstanceSummary 

type ServiceInstanceSummary struct {
	ServiceInstance

	ServicePlan                       ServicePlan
	Service                           Service
	ServiceInstanceSharingFeatureFlag bool
	ServiceInstanceShareType          ServiceInstanceShareType
	ServiceInstanceSharedFrom         ServiceInstanceSharedFrom
	ServiceInstanceSharedTos          []ServiceInstanceSharedTo
	BoundApplications                 []BoundApplication
}

func (ServiceInstanceSummary) IsNotShared 

func (s ServiceInstanceSummary) IsNotShared() bool

func (ServiceInstanceSummary) IsShareable 

func (s ServiceInstanceSummary) IsShareable() bool

func (ServiceInstanceSummary) IsSharedFrom 

func (s ServiceInstanceSummary) IsSharedFrom() bool

func (ServiceInstanceSummary) IsSharedTo 

func (s ServiceInstanceSummary) IsSharedTo() bool

type ServicePlan 

type ServicePlan ccv2.ServicePlan

type Space 

type Space ccv2.Space

Space represents a CLI Space

type SpaceQuota 

type SpaceQuota ccv2.SpaceQuota

type SpaceSummary 

type SpaceSummary struct {
	Space
	OrgName                        string
	OrgDefaultIsolationSegmentGUID string
	AppNames                       []string
	ServiceInstanceNames           []string
	SpaceQuotaName                 string
	RunningSecurityGroupNames      []string
	StagingSecurityGroupNames      []string
	SecurityGroupRules             []SecurityGroupRule
}

type SpaceWithLifecycle 

type SpaceWithLifecycle struct {
	ccv2.Space
	Lifecycle constant.SecurityGroupLifecycle
}

type Stack 

type Stack ccv2.Stack

type TargetSettings 

type TargetSettings ccv2.TargetSettings

type UAAClient 

type UAAClient interface {
	Authenticate(ID string, secret string, grantType constant.GrantType) (string, string, error)
	CreateUser(username string, password string, origin string) (uaa.User, error)
	GetSSHPasscode(accessToken string, sshOAuthClient string) (string, error)
	RefreshAccessToken(refreshToken string) (uaa.RefreshedTokens, error)
}

type User 

type User ccv2.User

User represents a CLI user.

type Warnings 

type Warnings []string

Warnings is a list of warnings returned back from the cloud controller

Source Files

View all Source files

Directories

Path Synopsis
Code generated by counterfeiter.
 Code generated by counterfeiter.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.