gcp

package
v0.11.0 Latest Latest
Warning

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

 Go to latest Published: Sep 25, 2018 License: Apache-2.0 Imports: 14 Imported by: 0

Documentation

Overview

Package gcp allows interaction with Google Cloud Platform resources.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func AssertStorageBucketExists 

func AssertStorageBucketExists(t *testing.T, name string)

AssertStorageBucketExists checks if the given storage bucket exists and fails the test if it does not.

func AssertStorageBucketExistsE 

func AssertStorageBucketExistsE(t *testing.T, name string) error

AssertStorageBucketExistsE checks if the given storage bucket exists and returns an error if it does not.

func CreateStorageBucket 

func CreateStorageBucket(t *testing.T, projectID string, name string, attr *storage.BucketAttrs)

CreateStorageBucket creates a Google Cloud bucket with the given BucketAttrs. Note that Google Storage bucket names must be globally unique.

func CreateStorageBucketE 

func CreateStorageBucketE(t *testing.T, projectID string, name string, attr *storage.BucketAttrs) error

CreateStorageBucketE creates a Google Cloud bucket with the given BucketAttrs. Note that Google Storage bucket names must be globally unique.

func DeleteStorageBucket 

func DeleteStorageBucket(t *testing.T, name string)

DeleteStorageBucket destroys the Google Storage bucket.

func DeleteStorageBucketE 

func DeleteStorageBucketE(t *testing.T, name string) error

DeleteStorageBucketE destroys the S3 bucket in the given region with the given name.

func EmptyStorageBucket 

func EmptyStorageBucket(t *testing.T, name string)

EmptyStorageBucket removes the contents of a storage bucket with the given name.

func EmptyStorageBucketE 

func EmptyStorageBucketE(t *testing.T, name string) error

EmptyStorageBucketE removes the contents of a storage bucket with the given name.

func GetAllGcpRegions 

func GetAllGcpRegions(t *testing.T, projectID string) []string

GetAllGcpRegions gets the list of GCP regions available in this account.

func GetAllGcpRegionsE 

func GetAllGcpRegionsE(t *testing.T, projectID string) ([]string, error)

GetAllGcpRegionsE gets the list of GCP regions available in this account.

func GetAllGcpZones 

func GetAllGcpZones(t *testing.T, projectID string) []string

GetAllGcpZones gets the list of GCP Zones available in this account.

func GetAllGcpZonesE 

func GetAllGcpZonesE(t *testing.T, projectID string) ([]string, error)

GetAllGcpZonesE gets the list of GCP Zones available in this account.

func GetGoogleCredentialsFromEnvVar 

func GetGoogleCredentialsFromEnvVar(t *testing.T) string

GetGoogleCredentialsFromEnvVar returns the Credentials for use with testing.

func GetGoogleProjectIDFromEnvVar 

func GetGoogleProjectIDFromEnvVar(t *testing.T) string

GetGoogleProjectIDFromEnvVar returns the Project Id for use with testing.

func GetGoogleRegionFromEnvVar 

func GetGoogleRegionFromEnvVar(t *testing.T) string

GetGoogleRegionFromEnvVar returns the Region for use with testing.

func GetRandomRegion 

func GetRandomRegion(t *testing.T, projectID string, approvedRegions []string, forbiddenRegions []string) string

GetRandomRegion gets a randomly chosen GCP Region. If approvedRegions is not empty, this will be a Region from the approvedRegions list; otherwise, this method will fetch the latest list of regions from the GCP APIs and pick one of those. If forbiddenRegions is not empty, this method will make sure the returned Region is not in the forbiddenRegions list.

func GetRandomRegionE 

func GetRandomRegionE(t *testing.T, projectID string, approvedRegions []string, forbiddenRegions []string) (string, error)

GetRandomRegionE gets a randomly chosen GCP Region. If approvedRegions is not empty, this will be a Region from the approvedRegions list; otherwise, this method will fetch the latest list of regions from the GCP APIs and pick one of those. If forbiddenRegions is not empty, this method will make sure the returned Region is not in the forbiddenRegions list.

func GetRandomZone 

func GetRandomZone(t *testing.T, projectID string, approvedZones []string, forbiddenZones []string) string

GetRandomZone gets a randomly chosen GCP Zone. If approvedRegions is not empty, this will be a Zone from the approvedZones list; otherwise, this method will fetch the latest list of Zones from the GCP APIs and pick one of those. If forbiddenZones is not empty, this method will make sure the returned Region is not in the forbiddenZones list.

func GetRandomZoneE 

func GetRandomZoneE(t *testing.T, projectID string, approvedZones []string, forbiddenZones []string) (string, error)

GetRandomZoneE gets a randomly chosen GCP Zone. If approvedRegions is not empty, this will be a Zone from the approvedZones list; otherwise, this method will fetch the latest list of Zones from the GCP APIs and pick one of those. If forbiddenZones is not empty, this method will make sure the returned Region is not in the forbiddenZones list.

func GetRandomZoneForRegion 

func GetRandomZoneForRegion(t *testing.T, projectID string, region string) string

GetRandomZoneForRegion gets a randomly chosen GCP Zone in the given Region.

func GetRandomZoneForRegionE 

func GetRandomZoneForRegionE(t *testing.T, projectID string, region string) (string, error)

GetRandomZoneForRegionE gets a randomly chosen GCP Zone in the given Region.

func NewComputeService 

func NewComputeService(t *testing.T) *compute.Service

NewComputeService creates a new Compute service, which is used to make GCP API calls.

func NewComputeServiceE 

func NewComputeServiceE(t *testing.T) (*compute.Service, error)

NewComputeServiceE creates a new Compute service, which is used to make GCP API calls.

func ReadBucketObject 

func ReadBucketObject(t *testing.T, bucketName string, filePath string) io.Reader

ReadBucketObject reads an object from the given Storage Bucket and returns its contents.

func ReadBucketObjectE 

func ReadBucketObjectE(t *testing.T, bucketName string, filePath string) (io.Reader, error)

ReadBucketObjectE reads an object from the given Storage Bucket and returns its contents.

func RegionUrlToRegion 

func RegionUrlToRegion(zoneUrl string) string

Given a GCP Zone URL formatted like https://www.googleapis.com/compute/v1/projects/project-123456/regions/southamerica-east1, return "southamerica-east1". Todo: Improve sanity checking on this function by using a RegEx with capture groups

func WriteBucketObject 

func WriteBucketObject(t *testing.T, bucketName string, filePath string, body io.Reader, contentType string) string

WriteBucketObject writes an object to the given Storage Bucket and returns its URL.

func WriteBucketObjectE 

func WriteBucketObjectE(t *testing.T, bucketName string, filePath string, body io.Reader, contentType string) (string, error)

WriteBucketObjectE writes an object to the given Storage Bucket and returns its URL.

func ZoneUrlToZone 

func ZoneUrlToZone(zoneUrl string) string

Given a GCP Zone URL formatted like https://www.googleapis.com/compute/v1/projects/project-123456/zones/asia-east1-b, return "asia-east1-b". Todo: Improve sanity checking on this function by using a RegEx with capture groups

Types

type Image 

type Image struct {
	*compute.Image
	// contains filtered or unexported fields
}

Corresponds to a GCP Image (https://cloud.google.com/compute/docs/images)

func FetchImage 

func FetchImage(t *testing.T, projectID string, name string) *Image

FetchImage queries GCP to return a new instance of the (GCP Compute) Image type

func FetchImageE 

func FetchImageE(t *testing.T, projectID string, name string) (*Image, error)

FetchImage queries GCP to return a new instance of the (GCP Compute) Image type

func (*Image) DeleteImage 

func (i *Image) DeleteImage(t *testing.T)

DeleteImage deletes the given Compute Image.

func (*Image) DeleteImageE 

func (i *Image) DeleteImageE(t *testing.T) error

DeleteImageE deletes the given Compute Image.

type Instance 

type Instance struct {
	*compute.Instance
	// contains filtered or unexported fields
}

Corresponds to a GCP Compute Instance (https://cloud.google.com/compute/docs/instances/)

func FetchInstance 

func FetchInstance(t *testing.T, projectID string, name string) *Instance

FetchInstance queries GCP to return an instance of the (GCP Compute) Instance type

func FetchInstanceE 

func FetchInstanceE(t *testing.T, projectID string, name string) (*Instance, error)

FetchInstance queries GCP to return an instance of the (GCP Compute) Instance type

func (*Instance) GetLabels 

func (i *Instance) GetLabels(t *testing.T) map[string]string

GetLabels returns all the tags for the given Compute Instance.

func (*Instance) GetPublicIp 

func (i *Instance) GetPublicIp(t *testing.T) string

GetPublicIP gets the public IP address of the given Compute Instance.

func (*Instance) GetPublicIpE 

func (i *Instance) GetPublicIpE(t *testing.T) (string, error)

GetPublicIpE gets the public IP address of the given Compute Instance.

func (*Instance) GetZone 

func (i *Instance) GetZone(t *testing.T) string

GetZone returns the Zone in which the Compute Instance is located.

func (*Instance) SetLabels 

func (i *Instance) SetLabels(t *testing.T, labels map[string]string)

SetLabels adds the tags to the given Compute Instance.

func (*Instance) SetLabelsE 

func (i *Instance) SetLabelsE(t *testing.T, labels map[string]string) error

SetLabelsE adds the tags to the given Compute Instance.

type InstanceGroup 

type InstanceGroup interface {
	GetInstanceIds(t *testing.T) []string
	GetInstanceIdsE(t *testing.T) ([]string, error)
}

type RegionalInstanceGroup 

type RegionalInstanceGroup struct {
	*compute.InstanceGroup
	// contains filtered or unexported fields
}

Corresponds to a GCP Regional Instance Group (https://cloud.google.com/compute/docs/instance-groups/)

func FetchRegionalInstanceGroup 

func FetchRegionalInstanceGroup(t *testing.T, projectID string, region string, name string) *RegionalInstanceGroup

FetchRegionalInstanceGroup queries GCP to return a new instance of the Regional Instance Group type

func FetchRegionalInstanceGroupE 

func FetchRegionalInstanceGroupE(t *testing.T, projectID string, region string, name string) (*RegionalInstanceGroup, error)

FetchRegionalInstanceGroup queries GCP to return a new instance of the Regional Instance Group type

func (*RegionalInstanceGroup) GetInstanceIds 

func (ig *RegionalInstanceGroup) GetInstanceIds(t *testing.T) []string

GetInstanceIds gets the IDs of Instances in the given Regional Instance Group.

func (*RegionalInstanceGroup) GetInstanceIdsE 

func (ig *RegionalInstanceGroup) GetInstanceIdsE(t *testing.T) ([]string, error)

GetInstanceIdsE gets the IDs of Instances in the given Regional Instance Group.

func (*RegionalInstanceGroup) GetRandomInstance 

func (ig *RegionalInstanceGroup) GetRandomInstance(t *testing.T) *Instance

getRandomInstance returns a randomly selected Instance from the Regional Instance Group

func (*RegionalInstanceGroup) GetRandomInstanceE 

func (ig *RegionalInstanceGroup) GetRandomInstanceE(t *testing.T) (*Instance, error)

getRandomInstanceE returns a randomly selected Instance from the Regional Instance Group

type ZonalInstanceGroup 

type ZonalInstanceGroup struct {
	*compute.InstanceGroup
	// contains filtered or unexported fields
}

Corresponds to a GCP Zonal Instance Group (https://cloud.google.com/compute/docs/instance-groups/)

func FetchZonalInstanceGroup 

func FetchZonalInstanceGroup(t *testing.T, projectID string, zone string, name string) *ZonalInstanceGroup

FetchZonalInstanceGroup queries GCP to return a new instance of the Regional Instance Group type

func FetchZonalInstanceGroupE 

func FetchZonalInstanceGroupE(t *testing.T, projectID string, zone string, name string) (*ZonalInstanceGroup, error)

FetchZonalInstanceGroup queries GCP to return a new instance of the Regional Instance Group type

func (*ZonalInstanceGroup) GetInstanceIds 

func (ig *ZonalInstanceGroup) GetInstanceIds(t *testing.T) []string

GetInstanceIds gets the IDs of Instances in the given Instance Group.

func (*ZonalInstanceGroup) GetInstanceIdsE 

func (ig *ZonalInstanceGroup) GetInstanceIdsE(t *testing.T) ([]string, error)

GetInstanceIdsE gets the IDs of Instances in the given Zonal Instance Group.

func (*ZonalInstanceGroup) GetRandomInstance 

func (ig *ZonalInstanceGroup) GetRandomInstance(t *testing.T) *Instance

getRandomInstance returns a randomly selected Instance from the Regional Instance Group

func (*ZonalInstanceGroup) GetRandomInstanceE 

func (ig *ZonalInstanceGroup) GetRandomInstanceE(t *testing.T) (*Instance, error)

getRandomInstanceE returns a randomly selected Instance from the Regional Instance Group

Source Files

View all Source files

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.