Help us shape the future of Go! Take the 2026 Go Developer Survey

docker

package
v1.5.1 Latest Latest
Warning

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

 Go to latest Published: Apr 28, 2017 License: Apache-2.0 Imports: 37 Imported by: 0

Documentation

Index

Constants

View Source 
const CmdDownRecommendedName = "down"
View Source 
const CmdJoinRecommendedName = "join"

CmdJoinRecommendedName is the recommended command name

View Source 
const CmdStatusRecommendedName = "status"

CmdStatusRecommendedName is the recommended command name

View Source 
const (
	// CmdUpRecommendedName is the recommended command name
	CmdUpRecommendedName = "up"
)

Variables

This section is empty.

Functions

func NewCmdDown 

func NewCmdDown(name, fullName string, f *osclientcmd.Factory, out io.Writer) *cobra.Command

NewCmdDown creates a command that stops OpenShift

func NewCmdJoin added in v1.5.0 

func NewCmdJoin(name, fullName string, f *osclientcmd.Factory, in io.Reader, out io.Writer) *cobra.Command

NewCmdJoin creates a command that joins an existing OpenShift cluster.

func NewCmdStatus added in v1.4.0 

func NewCmdStatus(name, fullName string, f *clientcmd.Factory, out io.Writer) *cobra.Command

NewCmdStatus implements the OpenShift cluster status command.

func NewCmdUp 

func NewCmdUp(name, fullName string, f *osclientcmd.Factory, out, errout io.Writer) *cobra.Command

NewCmdUp creates a command that starts openshift on Docker with reasonable defaults

func PrintError added in v1.4.0 

func PrintError(err error, out io.Writer)

Types

type ClientJoinConfig added in v1.5.0 

type ClientJoinConfig struct {
	CommonStartConfig

	In     io.Reader
	Secret string
}

ClientJoinConfig is the configuration for the client join command

func (*ClientJoinConfig) Bind added in v1.5.0 

func (config *ClientJoinConfig) Bind(flags *pflag.FlagSet)

func (*ClientJoinConfig) Complete added in v1.5.0 

func (c *ClientJoinConfig) Complete(f *osclientcmd.Factory, cmd *cobra.Command) error

Complete initializes fields based on command parameters and execution environment

func (*ClientJoinConfig) StartOpenShiftNode added in v1.5.0 

func (c *ClientJoinConfig) StartOpenShiftNode(out io.Writer) error

StartOpenShiftNode starts the OpenShift container as a node

type ClientStartConfig 

type ClientStartConfig struct {
	CommonStartConfig
}

ClientStartConfig is the configuration for the client start command

func (*ClientStartConfig) Bind added in v1.5.0 

func (config *ClientStartConfig) Bind(flags *pflag.FlagSet)

func (*ClientStartConfig) CheckContainerNetworking added in v1.5.0 

func (c *ClientStartConfig) CheckContainerNetworking(out io.Writer) error

func (*ClientStartConfig) Clients 

func (c *ClientStartConfig) Clients() (*client.Client, kclientset.Interface, error)

Clients returns clients for OpenShift and Kube

func (*ClientStartConfig) Complete 

func (c *ClientStartConfig) Complete(f *osclientcmd.Factory, cmd *cobra.Command) error

Complete initializes fields based on command parameters and execution environment

func (*ClientStartConfig) CreateProject 

func (c *ClientStartConfig) CreateProject(out io.Writer) error

CreateProject creates a new project for the current user

func (*ClientStartConfig) EnsureDefaultRedirectURIs added in v1.4.0 

func (c *ClientStartConfig) EnsureDefaultRedirectURIs(out io.Writer) error

EnsureDefaultRedirectURIs merges a default URL to an auth client's RedirectURIs array

func (*ClientStartConfig) Factory 

func (c *ClientStartConfig) Factory() (*clientcmd.Factory, error)

Factory returns a command factory that works with OpenShift server's admin credentials

func (*ClientStartConfig) ImportImageStreams 

func (c *ClientStartConfig) ImportImageStreams(out io.Writer) error

ImportImageStreams imports default image streams into the server TODO: Use streams compiled into oc

func (*ClientStartConfig) ImportTemplates 

func (c *ClientStartConfig) ImportTemplates(out io.Writer) error

ImportTemplates imports default templates into the server TODO: Use templates compiled into oc

func (*ClientStartConfig) InstallLogging added in v1.4.0 

func (c *ClientStartConfig) InstallLogging(out io.Writer) error

InstallLogging will start the installation of logging components

func (*ClientStartConfig) InstallMetrics 

func (c *ClientStartConfig) InstallMetrics(out io.Writer) error

InstallMetrics will start the installation of Metrics components

func (*ClientStartConfig) InstallRegistry 

func (c *ClientStartConfig) InstallRegistry(out io.Writer) error

InstallRegistry installs the OpenShift registry on the server

func (*ClientStartConfig) InstallRouter 

func (c *ClientStartConfig) InstallRouter(out io.Writer) error

InstallRouter installs a default router on the server

func (*ClientStartConfig) Login 

func (c *ClientStartConfig) Login(out io.Writer) error

Login logs into the new server and sets up a default user and project

func (*ClientStartConfig) RemoveTemporaryDirectory added in v1.4.0 

func (c *ClientStartConfig) RemoveTemporaryDirectory(out io.Writer) error

RemoveTemporaryDirectory removes the local configuration directory

func (*ClientStartConfig) ServerInfo 

func (c *ClientStartConfig) ServerInfo(out io.Writer) error

ServerInfo displays server information after a successful start

func (*ClientStartConfig) ShouldCreateUser added in v1.4.0 

func (c *ClientStartConfig) ShouldCreateUser() bool

ShouldCreateUser determines whether a user and project should be created. If the user provider has been modified in the config, then it should not attempt to create a user. Also, even if the user provider has not been modified, but data has been initialized, then we should also not create user.

func (*ClientStartConfig) ShouldInitializeData added in v1.4.0 

func (c *ClientStartConfig) ShouldInitializeData() bool

ShouldInitializeData tries to determine whether we're dealing with an existing OpenShift data and config. It determines that data exists by checking for the existence of a docker-registry service.

func (*ClientStartConfig) Start 

func (c *ClientStartConfig) Start(out io.Writer) error

Start runs the start tasks ensuring that they are executed in sequence

func (*ClientStartConfig) StartOpenShift 

func (c *ClientStartConfig) StartOpenShift(out io.Writer) error

StartOpenShift starts the OpenShift container

func (*ClientStartConfig) Validate 

func (c *ClientStartConfig) Validate(out, errout io.Writer) error

Validate validates that required fields in StartConfig have been populated

type ClientStatusConfig added in v1.4.0 

type ClientStatusConfig struct {
	DockerMachine string
}

ClientStatusConfig is the configuration for the client status command

func (*ClientStatusConfig) Status added in v1.4.0 

func (c *ClientStatusConfig) Status(f *clientcmd.Factory, out io.Writer) error

Status prints the OpenShift cluster status

type ClientStopConfig 

type ClientStopConfig struct {
	DockerMachine string
}

func (*ClientStopConfig) Stop 

func (c *ClientStopConfig) Stop(out io.Writer) error

Stop stops the currently running origin container and any containers started by the node.

type CommonStartConfig added in v1.5.0 

type CommonStartConfig struct {
	ImageVersion              string
	Image                     string
	ImageStreams              string
	DockerMachine             string
	ShouldCreateDockerMachine bool
	SkipRegistryCheck         bool
	ShouldInstallMetrics      bool
	ShouldInstallLogging      bool
	PortForwarding            bool

	Out         io.Writer
	TaskPrinter *TaskPrinter
	Tasks       []task

	HostName                 string
	LocalConfigDir           string
	UseExistingConfig        bool
	Environment              []string
	ServerLogLevel           int
	HostVolumesDir           string
	HostConfigDir            string
	HostDataDir              string
	UsePorts                 []int
	DNSPort                  int
	ServerIP                 string
	UseNsenterMount          bool
	PublicHostname           string
	RoutingSuffix            string
	HostPersistentVolumesDir string
	HTTPProxy                string
	HTTPSProxy               string
	NoProxy                  []string
	SetPropagationMode       bool
	RouterIP                 string
	CACert                   string
	// contains filtered or unexported fields
}

func (*CommonStartConfig) Bind added in v1.5.0 

func (config *CommonStartConfig) Bind(flags *pflag.FlagSet)

func (*CommonStartConfig) CheckAvailablePorts added in v1.5.0 

func (c *CommonStartConfig) CheckAvailablePorts(out io.Writer) error

CheckAvailablePorts ensures that ports used by OpenShift are available on the Docker host

func (*CommonStartConfig) CheckDockerInsecureRegistry added in v1.5.0 

func (c *CommonStartConfig) CheckDockerInsecureRegistry(out io.Writer) error

CheckDockerInsecureRegistry checks whether the Docker daemon is using the right --insecure-registry argument

func (*CommonStartConfig) CheckDockerVersion added in v1.5.0 

func (c *CommonStartConfig) CheckDockerVersion(out io.Writer) error

CheckDockerVersion checks that the appropriate Docker version is installed based on whether we are using the nsenter mounter or shared volumes for OpenShift

func (*CommonStartConfig) CheckExistingOpenShiftContainer added in v1.5.0 

func (c *CommonStartConfig) CheckExistingOpenShiftContainer(out io.Writer) error

CheckExistingOpenShiftContainer checks the state of an OpenShift container. If one is already running, it throws an error. If one exists, it removes it so a new one can be created.

func (*CommonStartConfig) CheckNsenterMounter added in v1.5.0 

func (c *CommonStartConfig) CheckNsenterMounter(out io.Writer) error

CheckNsenterMounter checks whether the Docker host can use the nsenter mounter from Kubernetes. Otherwise, a shared volume is needed in Docker

func (*CommonStartConfig) CheckOpenShiftClient added in v1.5.0 

func (c *CommonStartConfig) CheckOpenShiftClient(out io.Writer) error

CheckOpenShiftClient ensures that the client can be configured for the new server

func (*CommonStartConfig) CheckOpenShiftImage added in v1.5.0 

func (c *CommonStartConfig) CheckOpenShiftImage(out io.Writer) error

CheckOpenShiftImage checks whether the OpenShift image exists. If not it tells the Docker daemon to pull it.

func (*CommonStartConfig) Complete added in v1.5.0 

func (c *CommonStartConfig) Complete(f *osclientcmd.Factory, cmd *cobra.Command) error

func (*CommonStartConfig) CreateDockerMachine added in v1.5.0 

func (c *CommonStartConfig) CreateDockerMachine(out io.Writer) error

CreateDockerMachine will create a new Docker machine to run OpenShift

func (*CommonStartConfig) DetermineServerIP added in v1.5.0 

func (c *CommonStartConfig) DetermineServerIP(out io.Writer) error

DetermineServerIP gets an appropriate IP address to communicate with the OpenShift server

func (*CommonStartConfig) DockerHelper added in v1.5.0 

func (c *CommonStartConfig) DockerHelper() *dockerhelper.Helper

DockerHelper returns a helper object to work with the Docker client

func (*CommonStartConfig) EnsureHostDirectories added in v1.5.0 

func (c *CommonStartConfig) EnsureHostDirectories(io.Writer) error

func (*CommonStartConfig) GetDockerClient added in v1.5.0 

func (c *CommonStartConfig) GetDockerClient(out io.Writer) error

GetDockerClient obtains a new Docker client from the environment or from a Docker machine, starting it if necessary

func (*CommonStartConfig) HostHelper added in v1.5.0 

func (c *CommonStartConfig) HostHelper() *host.HostHelper

HostHelper returns a helper object to check Host configuration

func (*CommonStartConfig) OpenShiftHelper added in v1.5.0 

func (c *CommonStartConfig) OpenShiftHelper() *openshift.Helper

OpenShiftHelper returns a helper object to work with OpenShift on the server

func (*CommonStartConfig) Start added in v1.5.0 

func (c *CommonStartConfig) Start(out io.Writer) error

Start runs the start tasks ensuring that they are executed in sequence

func (*CommonStartConfig) Validate added in v1.5.0 

func (c *CommonStartConfig) Validate(out io.Writer) error

Validate validates that required fields in StartConfig have been populated

type TaskPrinter 

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

TaskPrinter is a helper for start task output

func NewTaskPrinter 

func NewTaskPrinter(out io.Writer) *TaskPrinter

NewTaskPrinter creates a new TaskPrinter

func (*TaskPrinter) Failure 

func (p *TaskPrinter) Failure(err error)

Failure writes out a failure marker for a task and outputs the error that caused the failure

func (*TaskPrinter) StartTask 

func (p *TaskPrinter) StartTask(name string)

StartTask writes out the header for a task

func (*TaskPrinter) Success 

func (p *TaskPrinter) Success()

Success writes out a success marker for a task

func (*TaskPrinter) TaskWriter 

func (p *TaskPrinter) TaskWriter() io.Writer

TaskWriter is a writer that can be used to write task output

Source Files

View all Source files

Directories

Path Synopsis
Package exec contains a utility to Docker exec into a running a container Create an ExecHelper with NewExecHelper and then create new exec commands with Command()
 Package exec contains a utility to Docker exec into a running a container Create an ExecHelper with NewExecHelper and then create new exec commands with Command()
Package host contains a utility to run commands on the Docker host by using an image in privileged mode.
 Package host contains a utility to run commands on the Docker host by using an image in privileged mode.
Package runner contains a utility to run Docker containers Create a RunHelper with NewRunHelper and then create new run instances with New()
 Package runner contains a utility to run Docker containers Create a RunHelper with NewRunHelper and then create new run instances with New()

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.