commands

package
v1.10.0 Latest Latest
Warning

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

Go to latest
Published: Oct 1, 2018 License: Apache-2.0 Imports: 35 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source
var ApiURL string

ApiURL holds the API URL to use.

View Source
var Context string

Context holds the current auth context

View Source
var DoitCmd = &Command{
	Command: &cobra.Command{
		Use:   "doctl",
		Short: "doctl is a command line interface for the DigitalOcean API.",
	},
}

DoitCmd is the base command.

View Source
var ErrNoAccessToken = errors.New("no access token has been configured")

ErrNoAccessToken is an error for when there is no access token.

View Source
var ErrUnknownTerminal = errors.New("unknown terminal")

ErrUnknownTerminal signifies an unknown terminal. It is returned when doit can't ascertain the current terminal type with requesting an auth token.

View Source
var Output string

Output holds the global output format.

View Source
var Token string

Token holds the global authorization token.

View Source
var Trace bool

Trace toggles http tracing output.

View Source
var Verbose bool

Verbose toggles verbose output.

View Source
var Writer = os.Stdout

Writer is where output should be written to.

Functions

func AddBoolFlag added in v1.0.0

func AddBoolFlag(cmd *Command, name, shorthand string, def bool, desc string, opts ...flagOpt)

AddBoolFlag adds a boolean flag to a command.

func AddIntFlag added in v1.0.0

func AddIntFlag(cmd *Command, name, shorthand string, def int, desc string, opts ...flagOpt)

AddIntFlag adds an integr flag to a command.

func AddStringFlag added in v1.0.0

func AddStringFlag(cmd *Command, name, shorthand, dflt, desc string, opts ...flagOpt)

AddStringFlag adds a string flag to a command.

func AddStringSliceFlag added in v1.0.0

func AddStringSliceFlag(cmd *Command, name, shorthand string, def []string, desc string, opts ...flagOpt)

AddStringSliceFlag adds a string slice flag to a command.

func AskForConfirm added in v1.5.0

func AskForConfirm(message string) error

AskForConfirm parses and verifies user input for confirmation.

func Execute

func Execute()

Execute executes the current command using DoitCmd.

func RunAccountGet

func RunAccountGet(c *CmdConfig) error

RunAccountGet runs account get.

func RunAccountRateLimit added in v1.0.0

func RunAccountRateLimit(c *CmdConfig) error

RunAccountRateLimit retrieves API rate limits for the account.

func RunAuthInit added in v1.4.0

func RunAuthInit(retrieveUserTokenFunc func() (string, error)) func(c *CmdConfig) error

RunAuthInit initializes the doctl config. Configuration is stored in $XDG_CONFIG_HOME/doctl. On Unix, if XDG_CONFIG_HOME is not set, use $HOME/.config. On Windows use %APPDATA%/doctl/config.

func RunAuthSwitch added in v1.8.0

func RunAuthSwitch(c *CmdConfig) error

func RunCDNCreate added in v1.9.0

func RunCDNCreate(c *CmdConfig) error

RunCDNCreate creates a cdn.

func RunCDNDelete added in v1.9.0

func RunCDNDelete(c *CmdConfig) error

RunCDNDelete deletes a cdn.

func RunCDNFlushCache added in v1.9.0

func RunCDNFlushCache(c *CmdConfig) error

RunCDNFlushCache flushes the cache of an individual cdn

func RunCDNGet added in v1.9.0

func RunCDNGet(c *CmdConfig) error

RunCDNGet returns an individual CDN.

func RunCDNList added in v1.9.0

func RunCDNList(c *CmdConfig) error

RunCDNList returns a list of CDNs.

func RunCDNUpdateTTL added in v1.9.0

func RunCDNUpdateTTL(c *CmdConfig) error

RunCDNUpdateTTL updates an individual cdn ttl

func RunCertificateCreate added in v1.6.0

func RunCertificateCreate(c *CmdConfig) error

RunCertificateCreate creates a certificate.

func RunCertificateDelete added in v1.6.0

func RunCertificateDelete(c *CmdConfig) error

RunCertificateDelete deletes a certificate by its identifier.

func RunCertificateGet added in v1.6.0

func RunCertificateGet(c *CmdConfig) error

RunCertificateGet retrieves an existing certificate by its identifier.

func RunCertificateList added in v1.6.0

func RunCertificateList(c *CmdConfig) error

RunCertificateList lists certificates.

func RunCmdActionGet

func RunCmdActionGet(c *CmdConfig) error

RunCmdActionGet runs action get.

func RunCmdActionList

func RunCmdActionList(c *CmdConfig) error

RunCmdActionList run action list.

func RunCmdActionWait added in v1.0.0

func RunCmdActionWait(c *CmdConfig) error

RunCmdActionWait waits for an action to complete or error.

func RunCmdTagCreate added in v1.1.0

func RunCmdTagCreate(c *CmdConfig) error

RunCmdTagCreate runs tag create.

func RunCmdTagDelete added in v1.1.0

func RunCmdTagDelete(c *CmdConfig) error

RunCmdTagDelete runs tag delete.

func RunCmdTagGet added in v1.1.0

func RunCmdTagGet(c *CmdConfig) error

RunCmdTagGet runs tag get.

func RunCmdTagList added in v1.1.0

func RunCmdTagList(c *CmdConfig) error

RunCmdTagList runs tag list.

func RunCompletionBash added in v1.6.1

func RunCompletionBash(c *CmdConfig) error

RunCompletionBash outputs completion code for bash.

func RunCompletionZsh added in v1.6.1

func RunCompletionZsh(c *CmdConfig) error

RunCompletionZsh outputs completion code for zsh shell.

func RunDomainCreate

func RunDomainCreate(c *CmdConfig) error

RunDomainCreate runs domain create.

func RunDomainDelete

func RunDomainDelete(c *CmdConfig) error

RunDomainDelete deletes a domain by name.

func RunDomainGet

func RunDomainGet(c *CmdConfig) error

RunDomainGet retrieves a domain by name.

func RunDomainList

func RunDomainList(c *CmdConfig) error

RunDomainList runs domain create.

func RunDropletActionChangeKernel

func RunDropletActionChangeKernel(c *CmdConfig) error

RunDropletActionChangeKernel changes the kernel for a droplet.

func RunDropletActionDisableBackups

func RunDropletActionDisableBackups(c *CmdConfig) error

RunDropletActionDisableBackups disables backups for a droplet.

func RunDropletActionEnableBackups added in v1.8.2

func RunDropletActionEnableBackups(c *CmdConfig) error

RunDropletActionEnableBackups disables backups for a droplet.

func RunDropletActionEnableIPv6

func RunDropletActionEnableIPv6(c *CmdConfig) error

RunDropletActionEnableIPv6 enables IPv6 for a droplet.

func RunDropletActionEnablePrivateNetworking

func RunDropletActionEnablePrivateNetworking(c *CmdConfig) error

RunDropletActionEnablePrivateNetworking enables private networking for a droplet.

func RunDropletActionGet

func RunDropletActionGet(c *CmdConfig) error

RunDropletActionGet returns a droplet action by id.

func RunDropletActionPasswordReset

func RunDropletActionPasswordReset(c *CmdConfig) error

RunDropletActionPasswordReset resets the droplet root password.

func RunDropletActionPowerCycle

func RunDropletActionPowerCycle(c *CmdConfig) error

RunDropletActionPowerCycle power cycles a droplet.

func RunDropletActionPowerOff

func RunDropletActionPowerOff(c *CmdConfig) error

RunDropletActionPowerOff turns droplet power off.

func RunDropletActionPowerOn

func RunDropletActionPowerOn(c *CmdConfig) error

RunDropletActionPowerOn turns droplet power on.

func RunDropletActionReboot

func RunDropletActionReboot(c *CmdConfig) error

RunDropletActionReboot reboots a droplet.

func RunDropletActionRebuild

func RunDropletActionRebuild(c *CmdConfig) error

RunDropletActionRebuild rebuilds a droplet using an image id or slug.

func RunDropletActionRename

func RunDropletActionRename(c *CmdConfig) error

RunDropletActionRename renames a droplet.

func RunDropletActionResize

func RunDropletActionResize(c *CmdConfig) error

RunDropletActionResize resizesx a droplet giving a size slug and optionally expands the disk.

func RunDropletActionRestore

func RunDropletActionRestore(c *CmdConfig) error

RunDropletActionRestore restores a droplet using an image id.

func RunDropletActionShutdown

func RunDropletActionShutdown(c *CmdConfig) error

RunDropletActionShutdown shuts a droplet down.

func RunDropletActionSnapshot

func RunDropletActionSnapshot(c *CmdConfig) error

RunDropletActionSnapshot creates a snapshot for a droplet.

func RunDropletActions

func RunDropletActions(c *CmdConfig) error

RunDropletActions returns a list of actions for a droplet.

func RunDropletBackups

func RunDropletBackups(c *CmdConfig) error

RunDropletBackups returns a list of backup images for a droplet.

func RunDropletCreate

func RunDropletCreate(c *CmdConfig) error

RunDropletCreate creates a droplet.

func RunDropletDelete

func RunDropletDelete(c *CmdConfig) error

RunDropletDelete destroy a droplet by id.

func RunDropletGet

func RunDropletGet(c *CmdConfig) error

RunDropletGet returns a droplet.

func RunDropletKernels

func RunDropletKernels(c *CmdConfig) error

RunDropletKernels returns a list of available kernels for a droplet.

func RunDropletList

func RunDropletList(c *CmdConfig) error

RunDropletList returns a list of droplets.

func RunDropletNeighbors

func RunDropletNeighbors(c *CmdConfig) error

RunDropletNeighbors returns a list of droplet neighbors.

func RunDropletSnapshots

func RunDropletSnapshots(c *CmdConfig) error

RunDropletSnapshots returns a list of available kernels for a droplet.

func RunDropletTag added in v1.1.0

func RunDropletTag(c *CmdConfig) error

RunDropletTag adds a tag to a droplet.

func RunDropletUntag added in v1.1.0

func RunDropletUntag(c *CmdConfig) error

RunDropletUntag untags a droplet.

func RunFirewallAddDroplets added in v1.7.0

func RunFirewallAddDroplets(c *CmdConfig) error

RunFirewallAddDroplets adds droplets to a Firewall.

func RunFirewallAddRules added in v1.7.0

func RunFirewallAddRules(c *CmdConfig) error

RunFirewallAddRules adds rules to a Firewall.

func RunFirewallAddTags added in v1.7.0

func RunFirewallAddTags(c *CmdConfig) error

RunFirewallAddTags adds tags to a Firewall.

func RunFirewallCreate added in v1.7.0

func RunFirewallCreate(c *CmdConfig) error

RunFirewallCreate creates a new Firewall with a given configuration.

func RunFirewallDelete added in v1.7.0

func RunFirewallDelete(c *CmdConfig) error

RunFirewallDelete deletes a Firewall by its identifier.

func RunFirewallGet added in v1.7.0

func RunFirewallGet(c *CmdConfig) error

RunFirewallGet retrieves an existing Firewall by its identifier.

func RunFirewallList added in v1.7.0

func RunFirewallList(c *CmdConfig) error

RunFirewallList lists Firewalls.

func RunFirewallListByDroplet added in v1.7.0

func RunFirewallListByDroplet(c *CmdConfig) error

RunFirewallListByDroplet lists Firewalls for a given Droplet.

func RunFirewallRemoveDroplets added in v1.7.0

func RunFirewallRemoveDroplets(c *CmdConfig) error

RunFirewallRemoveDroplets removes droplets from a Firewall.

func RunFirewallRemoveRules added in v1.7.0

func RunFirewallRemoveRules(c *CmdConfig) error

RunFirewallRemoveRules removes rules from a Firewall.

func RunFirewallRemoveTags added in v1.7.0

func RunFirewallRemoveTags(c *CmdConfig) error

RunFirewallRemoveTags removes tags from a Firewall.

func RunFirewallUpdate added in v1.7.0

func RunFirewallUpdate(c *CmdConfig) error

RunFirewallUpdate updates an existing Firewall with new configuration.

func RunFloatingIPActionsAssign

func RunFloatingIPActionsAssign(c *CmdConfig) error

RunFloatingIPActionsAssign assigns a floating IP to a droplet.

func RunFloatingIPActionsGet

func RunFloatingIPActionsGet(c *CmdConfig) error

RunFloatingIPActionsGet retrieves an action for a floating IP.

func RunFloatingIPActionsUnassign

func RunFloatingIPActionsUnassign(c *CmdConfig) error

RunFloatingIPActionsUnassign unassigns a floating IP to a droplet.

func RunFloatingIPCreate

func RunFloatingIPCreate(c *CmdConfig) error

RunFloatingIPCreate runs floating IP create.

func RunFloatingIPDelete

func RunFloatingIPDelete(c *CmdConfig) error

RunFloatingIPDelete runs floating IP delete.

func RunFloatingIPGet

func RunFloatingIPGet(c *CmdConfig) error

RunFloatingIPGet retrieves a floating IP's details.

func RunFloatingIPList

func RunFloatingIPList(c *CmdConfig) error

RunFloatingIPList runs floating IP create.

func RunImageActionsGet

func RunImageActionsGet(c *CmdConfig) error

RunImageActionsGet retrieves an action for an image.

func RunImageActionsTransfer

func RunImageActionsTransfer(c *CmdConfig) error

RunImageActionsTransfer an image.

func RunImagesDelete

func RunImagesDelete(c *CmdConfig) error

RunImagesDelete deletes an image.

func RunImagesGet

func RunImagesGet(c *CmdConfig) error

RunImagesGet retrieves an image by id or slug.

func RunImagesList

func RunImagesList(c *CmdConfig) error

RunImagesList images.

func RunImagesListApplication

func RunImagesListApplication(c *CmdConfig) error

RunImagesListApplication lists application iamges.

func RunImagesListDistribution

func RunImagesListDistribution(c *CmdConfig) error

RunImagesListDistribution lists distributions that are available.

func RunImagesListUser

func RunImagesListUser(c *CmdConfig) error

RunImagesListUser lists user images.

func RunImagesUpdate

func RunImagesUpdate(c *CmdConfig) error

RunImagesUpdate updates an image.

func RunKeyCreate

func RunKeyCreate(c *CmdConfig) error

RunKeyCreate uploads a SSH key.

func RunKeyDelete

func RunKeyDelete(c *CmdConfig) error

RunKeyDelete deletes a key.

func RunKeyGet

func RunKeyGet(c *CmdConfig) error

RunKeyGet retrieves a key.

func RunKeyImport

func RunKeyImport(c *CmdConfig) error

RunKeyImport imports a key from a file

func RunKeyList

func RunKeyList(c *CmdConfig) error

RunKeyList lists keys.

func RunKeyUpdate

func RunKeyUpdate(c *CmdConfig) error

RunKeyUpdate updates a key.

func RunLoadBalancerAddDroplets added in v1.6.0

func RunLoadBalancerAddDroplets(c *CmdConfig) error

RunLoadBalancerAddDroplets adds droplets to a load balancer.

func RunLoadBalancerAddForwardingRules added in v1.6.0

func RunLoadBalancerAddForwardingRules(c *CmdConfig) error

RunLoadBalancerAddForwardingRules adds forwarding rules to a load balancer.

func RunLoadBalancerCreate added in v1.6.0

func RunLoadBalancerCreate(c *CmdConfig) error

RunLoadBalancerCreate creates a new load balancer with a given configuration.

func RunLoadBalancerDelete added in v1.6.0

func RunLoadBalancerDelete(c *CmdConfig) error

RunLoadBalancerDelete deletes a load balancer by its identifier.

func RunLoadBalancerGet added in v1.6.0

func RunLoadBalancerGet(c *CmdConfig) error

RunLoadBalancerGet retrieves an existing load balancer by its identifier.

func RunLoadBalancerList added in v1.6.0

func RunLoadBalancerList(c *CmdConfig) error

RunLoadBalancerList lists load balancers.

func RunLoadBalancerRemoveDroplets added in v1.6.0

func RunLoadBalancerRemoveDroplets(c *CmdConfig) error

RunLoadBalancerRemoveDroplets removes droplets from a load balancer.

func RunLoadBalancerRemoveForwardingRules added in v1.6.0

func RunLoadBalancerRemoveForwardingRules(c *CmdConfig) error

RunLoadBalancerRemoveForwardingRules removes forwarding rules from a load balancer.

func RunLoadBalancerUpdate added in v1.6.0

func RunLoadBalancerUpdate(c *CmdConfig) error

RunLoadBalancerUpdate updates an existing load balancer with new configuration.

func RunPluginList added in v1.0.0

func RunPluginList(c *CmdConfig) error

RunPluginList is a command for listing available plugins.

func RunPluginRun added in v1.0.0

func RunPluginRun(c *CmdConfig) error

RunPluginRun is a command for running a plugin.

func RunRecordCreate

func RunRecordCreate(c *CmdConfig) error

RunRecordCreate creates a domain record.

func RunRecordDelete

func RunRecordDelete(c *CmdConfig) error

RunRecordDelete deletes a domain record.

func RunRecordList

func RunRecordList(c *CmdConfig) error

RunRecordList list records for a domain.

func RunRecordUpdate

func RunRecordUpdate(c *CmdConfig) error

RunRecordUpdate updates a domain record.

func RunRegionList

func RunRegionList(c *CmdConfig) error

RunRegionList all regions.

func RunSSH

func RunSSH(c *CmdConfig) error

RunSSH finds a droplet to ssh to given input parameters (name or id).

func RunSizeList

func RunSizeList(c *CmdConfig) error

RunSizeList all sizes.

func RunSnapshotDelete added in v1.6.0

func RunSnapshotDelete(c *CmdConfig) error

RunSnapshotDelete destroys snapshot(s) by id

func RunSnapshotGet added in v1.6.0

func RunSnapshotGet(c *CmdConfig) error

RunSnapshotGet returns a snapshot

func RunSnapshotList added in v1.6.0

func RunSnapshotList(c *CmdConfig) error

RunSnapshotList returns a list of snapshots

func RunVolumeAttach added in v1.3.0

func RunVolumeAttach(c *CmdConfig) error

RunVolumeAttach attaches a volume to a droplet.

func RunVolumeCreate added in v1.3.0

func RunVolumeCreate(c *CmdConfig) error

RunVolumeCreate creates a volume.

func RunVolumeDelete added in v1.3.0

func RunVolumeDelete(c *CmdConfig) error

RunVolumeDelete deletes a volume.

func RunVolumeDetach added in v1.3.0

func RunVolumeDetach(c *CmdConfig) error

RunVolumeDetachByDropletID detaches a volume by droplet ID

func RunVolumeGet added in v1.3.0

func RunVolumeGet(c *CmdConfig) error

RunVolumeGet gets a volume.

func RunVolumeList added in v1.3.0

func RunVolumeList(c *CmdConfig) error

RunVolumeList returns a list of volumes.

func RunVolumeResize added in v1.6.0

func RunVolumeResize(c *CmdConfig) error

RunVolumeResize resizes a volume

func RunVolumeSnapshot added in v1.6.0

func RunVolumeSnapshot(c *CmdConfig) error

RunVolumeSnapshot creates a snapshot of a volume

Types

type CmdConfig added in v1.0.0

type CmdConfig struct {
	NS   string
	Doit doctl.Config
	Out  io.Writer
	Args []string

	// services
	Keys              func() do.KeysService
	Sizes             func() do.SizesService
	Regions           func() do.RegionsService
	Images            func() do.ImagesService
	ImageActions      func() do.ImageActionsService
	LoadBalancers     func() do.LoadBalancersService
	FloatingIPs       func() do.FloatingIPsService
	FloatingIPActions func() do.FloatingIPActionsService
	Droplets          func() do.DropletsService
	DropletActions    func() do.DropletActionsService
	Domains           func() do.DomainsService
	Actions           func() do.ActionsService
	Account           func() do.AccountService
	Tags              func() do.TagsService
	Volumes           func() do.VolumesService
	VolumeActions     func() do.VolumeActionsService
	Snapshots         func() do.SnapshotsService
	Certificates      func() do.CertificatesService
	Firewalls         func() do.FirewallsService
	CDNs              func() do.CDNsService
	// contains filtered or unexported fields
}

CmdConfig is a command configuration.

func NewCmdConfig added in v1.0.0

func NewCmdConfig(ns string, dc doctl.Config, out io.Writer, args []string, initGodo bool) (*CmdConfig, error)

NewCmdConfig creates an instance of a CmdConfig.

func (*CmdConfig) Display added in v1.0.0

func (c *CmdConfig) Display(d Displayable) error

Display displayes the output from a command.

type CmdRunner added in v1.0.0

type CmdRunner func(*CmdConfig) error

CmdRunner runs a command and passes in a cmdConfig.

type Command added in v1.0.0

type Command struct {
	*cobra.Command

	// DocCategories are the documentation categories this command belongs to.
	DocCategories []string

	IsIndex bool
	// contains filtered or unexported fields
}

Command is a wrapper around cobra.Command that adds doctl specific functionality.

func Account

func Account() *Command

Account creates the account commands heirarchy.

func Actions

func Actions() *Command

Actions creates the action commands heirarchy.

func Auth added in v0.6.0

func Auth() *Command

Auth creates auth commands for doctl.

func CDN added in v1.9.0

func CDN() *Command

CDN creates the CDN command

func Certificate added in v1.6.0

func Certificate() *Command

Certificate creates the certificate command.

func CmdBuilder added in v1.0.0

func CmdBuilder(parent *Command, cr CmdRunner, cliText, desc string, out io.Writer, options ...cmdOption) *Command

CmdBuilder builds a new command.

func Completion added in v1.6.1

func Completion() *Command

Completion creates the completion command

func Domain

func Domain() *Command

Domain creates the domain commands heirarchy.

func Droplet

func Droplet() *Command

Droplet creates the droplet command.

func DropletAction

func DropletAction() *Command

DropletAction creates the droplet-action command.

func Firewall added in v1.7.0

func Firewall() *Command

Firewall creates the firewall command.

func FloatingIP

func FloatingIP() *Command

FloatingIP creates the command heirarchy for floating ips.

func FloatingIPAction

func FloatingIPAction() *Command

FloatingIPAction creates the floating IP action commmand.

func ImageAction

func ImageAction() *Command

ImageAction creates the image action commmand.

func Images

func Images() *Command

Images creates an image command.

func LoadBalancer added in v1.6.0

func LoadBalancer() *Command

LoadBalancer creates the load balancer command.

func Plugin added in v1.0.0

func Plugin() *Command

Plugin creates the plugin commands heirarchy.

func Region

func Region() *Command

Region creates the region commands heirarchy.

func SSH

func SSH(parent *Command) *Command

SSH creates the ssh commands heirarchy

func SSHKeys

func SSHKeys() *Command

SSHKeys creates the ssh key commands heirarchy.

func Size

func Size() *Command

Size creates the size commands heirarchy.

func Snapshot added in v1.6.0

func Snapshot() *Command

Snapshot creates the snapshot command

func Tags added in v1.1.0

func Tags() *Command

Tags creates the tag commands heirarchy.

func Version added in v1.0.0

func Version() *Command

Version creates a version command.

func Volume added in v1.3.0

func Volume() *Command

Volume creates the Volume command

func VolumeAction added in v1.3.0

func VolumeAction() *Command

VolumeAction creates the volume command

func (*Command) AddCommand added in v1.0.0

func (c *Command) AddCommand(commands ...*Command)

AddCommand adds child commands and adds child commands for cobra as well.

func (*Command) ChildCommands added in v1.0.0

func (c *Command) ChildCommands() []*Command

ChildCommands returns the child commands.

type Displayable added in v1.0.0

type Displayable interface {
	Cols() []string
	ColMap() map[string]string
	KV() []map[string]interface{}
	JSON(io.Writer) error
}

Displayable is a displable entity. These are used for printing results.

type UnknownSchemeError added in v0.6.0

type UnknownSchemeError struct {
	Scheme string
}

UnknownSchemeError signifies an unknown HTTP scheme.

func (*UnknownSchemeError) Error added in v0.6.0

func (use *UnknownSchemeError) Error() string

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL