deploy

Documentation

Overview

Package deploy holds the structures to deploy infrastructure resources. This file defines application deployment resources.

Package deploy holds the structures to deploy infrastructure resources.

Package deploy holds the structures to deploy infrastructure resources. This file defines environment deployment resources.

Package deploy holds the structures to deploy infrastructure resources. This file defines pipeline deployment resources.

Package deploy holds the structures to deploy infrastructure resources. This file defines service deployment resources.

Package deploy holds the structures to deploy infrastructure resources. This file defines service deployment resources.

Index

• Constants
• type AdjustVPCConfig
• type ArtifactBucket
  • func (a *ArtifactBucket) Region() (string, error)
• type AssociatedEnvironment
• type ConfigStoreClient
• type CreateAppInput
• type CreateEnvironmentInput
  • func (e CreateEnvironmentInput) AdjustVPCOpts() *template.AdjustVPCOpts
  • func (e CreateEnvironmentInput) ImportVPCOpts() *template.ImportVPCOpts
• type CreateEnvironmentResponse
• type CreatePipelineInput
• type CreateTaskResourcesInput
• type DeleteServiceInput
• type ImportVPCConfig
• type PipelineStage
  • func (s *PipelineStage) ServiceTemplateConfigurationPath(svcName string) string
  • func (s *PipelineStage) ServiceTemplatePath(svcName string) string
• type Resource
• type ResourceEvent
• type Source
  • func (s *Source) GitHubPersonalAccessTokenSecretID() (string, error)
  • func (s *Source) Owner() (string, error)
  • func (s *Source) Repository() (string, error)
• type Store
  • func NewStore(store ConfigStoreClient) (*Store, error)
  • func (s *Store) IsServiceDeployed(appName string, envName string, svcName string) (bool, error)
  • func (s *Store) ListDeployedServices(appName string, envName string) ([]string, error)
  • func (s *Store) ListEnvironmentsDeployedTo(appName string, svcName string) ([]string, error)

Constants

const (
	// AppTagKey is tag key for Copilot app.
	AppTagKey = "copilot-application"
	// EnvTagKey is tag key for Copilot env.
	EnvTagKey = "copilot-environment"
	// ServiceTagKey is tag key for Copilot svc.
	ServiceTagKey = "copilot-service"
	// TaskTagKey is tag key for Copilot task.
	TaskTagKey = "copilot-task"
)

Types

type AdjustVPCConfig

type AdjustVPCConfig struct {
	CIDR               string // CIDR range for the VPC.
	PublicSubnetCIDRs  []string
	PrivateSubnetCIDRs []string
}

AdjustVPCConfig holds the fields to adjust default VPC resources.

type ArtifactBucket

type ArtifactBucket struct {
	// The name of the S3 bucket.
	BucketName string

	// The ARN of the KMS key used to en/decrypt artifacts stored in this bucket.
	KeyArn string
}

ArtifactBucket represents an S3 bucket used by the CodePipeline to store intermediate artifacts produced by the pipeline.

func (*ArtifactBucket) Region

func (a *ArtifactBucket) Region() (string, error)

Region parses out the region from the ARN of the KMS key associated with the artifact bucket.

type AssociatedEnvironment

type AssociatedEnvironment struct {
	// Name of the environment, must be unique within an application.
	// This is also the name of the pipeline stage.
	Name string

	// The region this environment is stored in.
	Region string

	// AccountID of the account this environment is stored in.
	AccountID string
}

AssociatedEnvironment defines the necessary information a pipeline stage needs for an Config Environment.

type ConfigStoreClient

type ConfigStoreClient interface {
	GetEnvironment(appName string, environmentName string) (*config.Environment, error)
	ListEnvironments(appName string) ([]*config.Environment, error)
	GetService(appName, svcName string) (*config.Service, error)
}

ConfigStoreClient wraps config store methods utilized by deploy store.

type CreateAppInput

type CreateAppInput struct {
	Name                  string            // Name of the application that needs to be created.
	AccountID             string            // AWS account ID to administrate the application.
	DNSDelegationAccounts []string          // Accounts to grant DNS access to for this application.
	DomainName            string            // DNS Name used for this application.
	AdditionalTags        map[string]string // AdditionalTags are labels applied to resources under the application.
}

CreateAppInput holds the fields required to create an application stack set.

type CreateEnvironmentInput

type CreateEnvironmentInput struct {
	AppName                  string            // Name of the application this environment belongs to.
	Name                     string            // Name of the environment, must be unique within an application.
	Prod                     bool              // Whether or not this environment is a production environment.
	ToolsAccountPrincipalARN string            // The Principal ARN of the tools account.
	AppDNSName               string            // The DNS name of this application, if it exists
	AdditionalTags           map[string]string // AdditionalTags are labels applied to resources under the application.
	ImportVPCConfig          *ImportVPCConfig  // Optional configuration if users have an existing VPC.
	AdjustVPCConfig          *AdjustVPCConfig  // Optional configuration if users want to override default VPC configuration.

	// The version of the environment template to creat the stack. If empty, creates the legacy stack.
	Version string
}

CreateEnvironmentInput holds the fields required to deploy an environment.

func (CreateEnvironmentInput) AdjustVPCOpts

func (e CreateEnvironmentInput) AdjustVPCOpts() *template.AdjustVPCOpts

AdjustVPCOpts converts the environment's vpc adjusting configuration into a format parsable by the templates pkg.

func (CreateEnvironmentInput) ImportVPCOpts

func (e CreateEnvironmentInput) ImportVPCOpts() *template.ImportVPCOpts

ImportVPCOpts converts the environment's vpc importing configuration into a format parsable by the templates pkg.

type CreateEnvironmentResponse

type CreateEnvironmentResponse struct {
	Env *config.Environment
	Err error
}

CreateEnvironmentResponse holds the created environment on successful deployment. Otherwise, the environment is set to nil and a descriptive error is returned.

type CreatePipelineInput

type CreatePipelineInput struct {
	// Name of the application this pipeline belongs to
	AppName string

	// Name of the pipeline
	Name string

	// The source code provider for this pipeline
	Source *Source

	// The stages of the pipeline. The order of stages in this list
	// will be the order we deploy to.
	Stages []PipelineStage

	// A list of artifact buckets and corresponding KMS keys that will
	// be used in this pipeline.
	ArtifactBuckets []ArtifactBucket

	// AdditionalTags are labels applied to resources under the application.
	AdditionalTags map[string]string
}

CreatePipelineInput represents the fields required to deploy a pipeline.

type CreateTaskResourcesInput

type CreateTaskResourcesInput struct {
	Name   string
	CPU    int
	Memory int

	Image         string
	TaskRole      string
	ExecutionRole string
	Command       string
	EnvVars       map[string]string

	App string
	Env string

	AdditionalTags map[string]string
}

CreateTaskResourcesInput holds the fields required to create a task stack.

type DeleteServiceInput

type DeleteServiceInput struct {
	Name    string // Name of the service that needs to be deleted.
	EnvName string // Name of the environment the service is deployed in.
	AppName string // Name of the application the service belongs to.
}

DeleteServiceInput holds the fields required to delete a service.

type ImportVPCConfig

type ImportVPCConfig struct {
	ID               string // ID for the VPC.
	PublicSubnetIDs  []string
	PrivateSubnetIDs []string
}

ImportVPCConfig holds the fields to import VPC resources.

type PipelineStage

type PipelineStage struct {
	*AssociatedEnvironment
	LocalServices    []string
	RequiresApproval bool
	TestCommands     []string
}

PipelineStage represents configuration for each deployment stage of a workspace. A stage consists of the Config Environment the pipeline is deploying to, the containerized services that will be deployed, and test commands, if the user has opted to add any.

func (*PipelineStage) ServiceTemplateConfigurationPath

func (s *PipelineStage) ServiceTemplateConfigurationPath(svcName string) string

ServiceTemplateConfigurationPath returns the full path to the service CFN template configuration file built during the build stage.

func (*PipelineStage) ServiceTemplatePath

func (s *PipelineStage) ServiceTemplatePath(svcName string) string

ServiceTemplatePath returns the full path to the service CFN template built during the build stage.

type Resource

type Resource struct {
	LogicalName string
	Type        string
}

Resource represents an AWS resource.

type ResourceEvent

type ResourceEvent struct {
	Resource
	Status       string
	StatusReason string
}

ResourceEvent represents a status update for an AWS resource during a deployment.

type Source

type Source struct {
	// The name of the source code provider. For example, "GitHub"
	ProviderName string

	// Contains provider-specific configurations, such as:
	// "repository": "aws/amazon-ecs-cli-v2"
	// "githubPersonalAccessTokenSecretId": "heyyo"
	Properties map[string]interface{}
}

Source defines the source of the artifacts to be built and deployed.

func (*Source) GitHubPersonalAccessTokenSecretID

func (s *Source) GitHubPersonalAccessTokenSecretID() (string, error)

GitHubPersonalAccessTokenSecretID returns the ID of the secret in the Secrets manager, which stores the GitHub Personal Access token if the provider is "GitHub". Otherwise, it returns an error.

func (*Source) Owner

func (s *Source) Owner() (string, error)

Owner returns the repository owner portion. For example, given "aws/amazon-ecs-cli-v2", this function returns "aws".

func (*Source) Repository

func (s *Source) Repository() (string, error)

Repository returns the repository portion. For example, given "aws/amazon-ecs-cli-v2", this function returns "amazon-ecs-cli-v2".

type Store

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

Store fetches information on deployed services.

func NewStore

func NewStore(store ConfigStoreClient) (*Store, error)

NewStore returns a new store.

func (*Store) IsServiceDeployed

func (s *Store) IsServiceDeployed(appName string, envName string, svcName string) (bool, error)

IsServiceDeployed returns whether a service is deployed in an environment or not.

func (*Store) ListDeployedServices

func (s *Store) ListDeployedServices(appName string, envName string) ([]string, error)

ListDeployedServices returns the names of deployed services in an environment part of an application.

func (*Store) ListEnvironmentsDeployedTo

func (s *Store) ListEnvironmentsDeployedTo(appName string, svcName string) ([]string, error)

ListEnvironmentsDeployedTo returns all the environment that a service is deployed in.