gcloud

Documentation

Index

• func InstanceIPs(inst *compute.Instance) (intIP, extIP string)
• func ParseDisk(spec string, zone string) (*compute.AttachedDisk, error)
• type API
  • func New(opts *Options) (*API, error)
  • func (a *API) Client() *http.Client
  • func (a *API) CreateImage(spec *ImageSpec, overwrite bool) (*compute.Operation, *Pending, error)
  • func (a *API) CreateInstance(userdata string, keys []*agent.Key, opts platform.MachineOptions, ...) (*compute.Instance, error)
  • func (a *API) DeleteImage(name string) (*Pending, error)
  • func (a *API) DeprecateImage(name string, state DeprecationState, replacement string) (*Pending, error)
  • func (a *API) GC(gracePeriod time.Duration) error
  • func (a *API) GetConsoleOutput(name string) (string, error)
  • func (a *API) GetPendingForImage(image *compute.Image) (*Pending, error)
  • func (a *API) ListImages(ctx context.Context, prefix string, family string) ([]*compute.Image, error)
  • func (a *API) ListInstances(prefix string) ([]*compute.Instance, error)
  • func (a *API) NewPending(desc string, do doable) *Pending
  • func (a *API) SetImagePublic(name string) error
  • func (a *API) TerminateInstance(name string) error
  • func (a *API) UpdateImage(name string, family string, description string) (*Pending, error)
• type DeprecationState
• type ImageSpec
• type Options
• type Pending
  • func (p *Pending) Wait() error

Functions

func InstanceIPs

func InstanceIPs(inst *compute.Instance) (intIP, extIP string)

Taken from: https://github.com/golang/build/blob/master/buildlet/gce.go

func ParseDisk

func ParseDisk(spec string, zone string) (*compute.AttachedDisk, error)

["5G:channel=nvme"], by default the disk type is local-ssd

Types

type API

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

func New

func New(opts *Options) (*API, error)

func (*API) Client

func (a *API) Client() *http.Client

func (*API) CreateImage

func (a *API) CreateImage(spec *ImageSpec, overwrite bool) (*compute.Operation, *Pending, error)

CreateImage creates an image on GCP and returns operation details and a Pending. If overwrite is true, an existing image will be overwritten if it exists.

func (*API) CreateInstance

func (a *API) CreateInstance(userdata string, keys []*agent.Key, opts platform.MachineOptions, useServiceAcct bool) (*compute.Instance, error)

CreateInstance creates a Google Compute Engine instance.

func (*API) DeleteImage

func (a *API) DeleteImage(name string) (*Pending, error)

func (*API) DeprecateImage

func (a *API) DeprecateImage(name string, state DeprecationState, replacement string) (*Pending, error)

func (*API) GC

func (a *API) GC(gracePeriod time.Duration) error

func (*API) GetConsoleOutput

func (a *API) GetConsoleOutput(name string) (string, error)

func (*API) GetPendingForImage

func (a *API) GetPendingForImage(image *compute.Image) (*Pending, error)

func (*API) ListImages

func (a *API) ListImages(ctx context.Context, prefix string, family string) ([]*compute.Image, error)

func (*API) ListInstances

func (a *API) ListInstances(prefix string) ([]*compute.Instance, error)

func (*API) NewPending

func (a *API) NewPending(desc string, do doable) *Pending

func (*API) SetImagePublic

func (a *API) SetImagePublic(name string) error

https://cloud.google.com/compute/docs/images/managing-access-custom-images#share-images-publicly

func (*API) TerminateInstance

func (a *API) TerminateInstance(name string) error

func (*API) UpdateImage

func (a *API) UpdateImage(name string, family string, description string) (*Pending, error)

type DeprecationState

type DeprecationState string

const (
	DeprecationStateActive     DeprecationState = "ACTIVE"
	DeprecationStateDeprecated DeprecationState = "DEPRECATED"
	DeprecationStateObsolete   DeprecationState = "OBSOLETE"
	DeprecationStateDeleted    DeprecationState = "DELETED"
)

type ImageSpec

type ImageSpec struct {
	Architecture string
	SourceImage  string
	Family       string
	Name         string
	Description  string
	Licenses     []string // short names
}

type Options

type Options struct {
	Image        string
	Project      string
	Zone         string
	MachineType  string
	DiskType     string
	Network      string
	ServiceAcct  string
	JSONKeyFile  string
	ServiceAuth  bool
	Confidential bool
	*platform.Options
}

type Pending

type Pending struct {
	Interval time.Duration
	Timeout  time.Duration // for default progress function
	Progress func(desc string, elapsed time.Duration, op *compute.Operation) error
	// contains filtered or unexported fields
}

func (*Pending) Wait

func (p *Pending) Wait() error