blob: f89dc39e7435b8c70ab1bbd745cade21cece0a25 [file] [log] [blame]
// Copyright 2015 The Vanadium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.
// This file was auto-generated via go generate.
// DO NOT UPDATE MANUALLY
/*
Manages Vanadium applications on kubernetes
Usage:
vkube [flags] <command>
The vkube commands are:
start Starts an application.
update Updates an application.
stop Stops an application.
start-cluster-agent Starts the cluster agent.
stop-cluster-agent Stops the cluster agent.
update-cluster-agent Updates the cluster agent.
update-config Updates vkube.cfg.
claim-cluster-agent Claims the cluster agent.
build-docker-images Builds the docker images for the cluster and pod agents.
create-secrets Creates secrets
upgrade-cluster Upgrade the cluster defined in vkube.cfg.
kubectl Runs kubectl on the cluster defined in vkube.cfg.
help Display help for commands or topics
The vkube flags are:
-config=vkube.cfg
The 'vkube.cfg' file to use.
-gcloud=gcloud
The 'gcloud' binary to use.
-get-credentials=true
When true, use gcloud to get the cluster credentials. Otherwise, assume
kubectl already has the correct credentials, and 'vkube kubectl' is
equivalent to 'kubectl'.
-kubectl=kubectl
The 'kubectl' binary to use.
-no-headers=false
When true, suppress the 'Project: ... Zone: ... Cluster: ...' headers.
The global flags are:
-alsologtostderr=true
log to standard error as well as files
-log_backtrace_at=:0
when logging hits line file:N, emit a stack trace
-log_dir=
if non-empty, write log files to this directory
-logtostderr=false
log to standard error instead of files
-max_stack_buf_size=4292608
max size in bytes of the buffer to use for logging stack traces
-metadata=<just specify -metadata to activate>
Displays metadata for the program and exits.
-stderrthreshold=2
logs at or above this threshold go to stderr
-time=false
Dump timing information to stderr before exiting the program.
-v=0
log level for V logs
-v23.credentials=
directory to use for storing security credentials
-v23.i18n-catalogue=
18n catalogue files to load, comma separated
-v23.namespace.root=[/(dev.v.io:r:vprod:service:mounttabled)@ns.dev.v.io:8101]
local namespace root; can be repeated to provided multiple roots
-v23.proxy=
object name of proxy service to use to export services across network
boundaries
-v23.tcp.address=
address to listen on
-v23.tcp.protocol=wsh
protocol to listen with
-v23.vtrace.cache-size=1024
The number of vtrace traces to store in memory.
-v23.vtrace.collect-regexp=
Spans and annotations that match this regular expression will trigger trace
collection.
-v23.vtrace.dump-on-shutdown=true
If true, dump all stored traces on runtime shutdown.
-v23.vtrace.sample-rate=0
Rate (from 0.0 to 1.0) to sample vtrace traces.
-v23.vtrace.v=0
The verbosity level of the log messages to be captured in traces
-vmodule=
comma-separated list of globpattern=N settings for filename-filtered logging
(without the .go suffix). E.g. foo/bar/baz.go is matched by patterns baz or
*az or b* but not by bar/baz or baz.go or az or b.*
-vpath=
comma-separated list of regexppattern=N settings for file pathname-filtered
logging (without the .go suffix). E.g. foo/bar/baz.go is matched by patterns
foo/bar/baz or fo.*az or oo/ba or b.z but not by foo/bar/baz.go or fo*az
Vkube start
Starts an application.
Usage:
vkube start [flags] <extension>
<extension> The blessing name extension to give to the application.
If --noblessings is set, this argument is not needed.
The vkube start flags are:
-base-blessings=
Base blessings to extend, base64url-vom-encoded. If empty, the default
blessings are used.
-f=
Filename to use to create the kubernetes resource.
-noblessings=false
Do not pass blessings to the application.
-wait=false
Wait for all the replicas to be ready.
-wait-timeout=5m0s
How long to wait for the start to make progress.
-config=vkube.cfg
The 'vkube.cfg' file to use.
-gcloud=gcloud
The 'gcloud' binary to use.
-get-credentials=true
When true, use gcloud to get the cluster credentials. Otherwise, assume
kubectl already has the correct credentials, and 'vkube kubectl' is
equivalent to 'kubectl'.
-kubectl=kubectl
The 'kubectl' binary to use.
-no-headers=false
When true, suppress the 'Project: ... Zone: ... Cluster: ...' headers.
Vkube update
Updates an application to a new version with a rolling update.
Usage:
vkube update [flags] [<extension>]
<extension> The new blessing name extension to give to the application. If
omitted, the existing blessings are preserved.
The vkube update flags are:
-base-blessings=
Base blessings to extend, base64url-vom-encoded. If empty, the default
blessings are used.
-f=
Filename to use to update the kubernetes resource.
-wait=false
Wait for the update to finish.
-wait-timeout=5m0s
How long to wait for the update to make progress.
-config=vkube.cfg
The 'vkube.cfg' file to use.
-gcloud=gcloud
The 'gcloud' binary to use.
-get-credentials=true
When true, use gcloud to get the cluster credentials. Otherwise, assume
kubectl already has the correct credentials, and 'vkube kubectl' is
equivalent to 'kubectl'.
-kubectl=kubectl
The 'kubectl' binary to use.
-no-headers=false
When true, suppress the 'Project: ... Zone: ... Cluster: ...' headers.
Vkube stop
Stops an application.
Usage:
vkube stop [flags]
The vkube stop flags are:
-f=
Filename to use to stop the kubernetes resource.
-config=vkube.cfg
The 'vkube.cfg' file to use.
-gcloud=gcloud
The 'gcloud' binary to use.
-get-credentials=true
When true, use gcloud to get the cluster credentials. Otherwise, assume
kubectl already has the correct credentials, and 'vkube kubectl' is
equivalent to 'kubectl'.
-kubectl=kubectl
The 'kubectl' binary to use.
-no-headers=false
When true, suppress the 'Project: ... Zone: ... Cluster: ...' headers.
Vkube start-cluster-agent
Starts the cluster agent.
Usage:
vkube start-cluster-agent [flags]
The vkube start-cluster-agent flags are:
-wait=false
Wait for the cluster agent to be ready.
-wait-timeout=5m0s
How long to wait for the cluster agent to be ready.
-config=vkube.cfg
The 'vkube.cfg' file to use.
-gcloud=gcloud
The 'gcloud' binary to use.
-get-credentials=true
When true, use gcloud to get the cluster credentials. Otherwise, assume
kubectl already has the correct credentials, and 'vkube kubectl' is
equivalent to 'kubectl'.
-kubectl=kubectl
The 'kubectl' binary to use.
-no-headers=false
When true, suppress the 'Project: ... Zone: ... Cluster: ...' headers.
Vkube stop-cluster-agent
Stops the cluster agent.
Usage:
vkube stop-cluster-agent [flags]
The vkube stop-cluster-agent flags are:
-config=vkube.cfg
The 'vkube.cfg' file to use.
-gcloud=gcloud
The 'gcloud' binary to use.
-get-credentials=true
When true, use gcloud to get the cluster credentials. Otherwise, assume
kubectl already has the correct credentials, and 'vkube kubectl' is
equivalent to 'kubectl'.
-kubectl=kubectl
The 'kubectl' binary to use.
-no-headers=false
When true, suppress the 'Project: ... Zone: ... Cluster: ...' headers.
Vkube update-cluster-agent
Updates the cluster agent.
Usage:
vkube update-cluster-agent [flags]
The vkube update-cluster-agent flags are:
-wait=false
Wait for the cluster agent to be ready.
-wait-timeout=5m0s
How long to wait for the cluster agent to be ready.
-config=vkube.cfg
The 'vkube.cfg' file to use.
-gcloud=gcloud
The 'gcloud' binary to use.
-get-credentials=true
When true, use gcloud to get the cluster credentials. Otherwise, assume
kubectl already has the correct credentials, and 'vkube kubectl' is
equivalent to 'kubectl'.
-kubectl=kubectl
The 'kubectl' binary to use.
-no-headers=false
When true, suppress the 'Project: ... Zone: ... Cluster: ...' headers.
Vkube update-config
Updates the vkube.cfg file with new cluster-agent and/or pod-agent images.
Usage:
vkube update-config [flags]
The vkube update-config flags are:
-cluster-agent-image=
The new cluster agent image. If the name starts with ':', only the image tag
is updated.
-pod-agent-image=
The new pod agent image. If the name starts with ':', only the image tag is
updated.
-config=vkube.cfg
The 'vkube.cfg' file to use.
-gcloud=gcloud
The 'gcloud' binary to use.
-get-credentials=true
When true, use gcloud to get the cluster credentials. Otherwise, assume
kubectl already has the correct credentials, and 'vkube kubectl' is
equivalent to 'kubectl'.
-kubectl=kubectl
The 'kubectl' binary to use.
-no-headers=false
When true, suppress the 'Project: ... Zone: ... Cluster: ...' headers.
Vkube claim-cluster-agent
Claims the cluster agent.
Usage:
vkube claim-cluster-agent [flags]
The vkube claim-cluster-agent flags are:
-config=vkube.cfg
The 'vkube.cfg' file to use.
-gcloud=gcloud
The 'gcloud' binary to use.
-get-credentials=true
When true, use gcloud to get the cluster credentials. Otherwise, assume
kubectl already has the correct credentials, and 'vkube kubectl' is
equivalent to 'kubectl'.
-kubectl=kubectl
The 'kubectl' binary to use.
-no-headers=false
When true, suppress the 'Project: ... Zone: ... Cluster: ...' headers.
Vkube build-docker-images
Builds the docker images for the cluster and pod agents.
Usage:
vkube build-docker-images [flags]
The vkube build-docker-images flags are:
-tag=
The tag to add to the docker images. If empty, the current timestamp is used.
-v=false
When true, the output is more verbose.
-config=vkube.cfg
The 'vkube.cfg' file to use.
-gcloud=gcloud
The 'gcloud' binary to use.
-get-credentials=true
When true, use gcloud to get the cluster credentials. Otherwise, assume
kubectl already has the correct credentials, and 'vkube kubectl' is
equivalent to 'kubectl'.
-kubectl=kubectl
The 'kubectl' binary to use.
-no-headers=false
When true, suppress the 'Project: ... Zone: ... Cluster: ...' headers.
Vkube create-secrets - Creates secrets
Creates kubernetes secrets from the template files passed as arguments.
The --secrets flag points to an encrypted TAR file that contains the actual
secrets.
Each template file represents a kubernetes Secret object to be created by
substituting the template fields with the content of the files from the
encrypted TAR file.
Templates look like:
{
"apiVersion": "v1",
"kind": "Secret",
"metadata": {
"name": "secret-name"
},
"type": "Opaque",
"data": {
"file1": "{{base64 "path/file1"}}",
"file2": "{{base64 "path/file2"}}"
}
}
where path/file1 and path/file2 are files from the TAR file.
Usage:
vkube create-secrets [flags] <template> ...
<template> A file containing the template for the secret object.
The vkube create-secrets flags are:
-gpg=gpg
The gpg binary to use.
-secrets=
The file containing the encrypted secrets.
-config=vkube.cfg
The 'vkube.cfg' file to use.
-gcloud=gcloud
The 'gcloud' binary to use.
-get-credentials=true
When true, use gcloud to get the cluster credentials. Otherwise, assume
kubectl already has the correct credentials, and 'vkube kubectl' is
equivalent to 'kubectl'.
-kubectl=kubectl
The 'kubectl' binary to use.
-no-headers=false
When true, suppress the 'Project: ... Zone: ... Cluster: ...' headers.
Vkube upgrade-cluster
Upgrade the cluster defined in vkube.cfg to the default latest version.
This command is only meaningful with Kubernetes clusters on the Google Container
Engine.
Usage:
vkube upgrade-cluster [flags]
The vkube upgrade-cluster flags are:
-prompt=true
When true, prompt for confirmation before upgrading the cluster.
-config=vkube.cfg
The 'vkube.cfg' file to use.
-gcloud=gcloud
The 'gcloud' binary to use.
-get-credentials=true
When true, use gcloud to get the cluster credentials. Otherwise, assume
kubectl already has the correct credentials, and 'vkube kubectl' is
equivalent to 'kubectl'.
-kubectl=kubectl
The 'kubectl' binary to use.
-no-headers=false
When true, suppress the 'Project: ... Zone: ... Cluster: ...' headers.
Vkube kubectl
Runs kubectl on the cluster defined in vkube.cfg.
Usage:
vkube kubectl [flags] -- <kubectl args>
<kubectl args> are passed directly to the kubectl command.
The vkube kubectl flags are:
-config=vkube.cfg
The 'vkube.cfg' file to use.
-gcloud=gcloud
The 'gcloud' binary to use.
-get-credentials=true
When true, use gcloud to get the cluster credentials. Otherwise, assume
kubectl already has the correct credentials, and 'vkube kubectl' is
equivalent to 'kubectl'.
-kubectl=kubectl
The 'kubectl' binary to use.
-no-headers=false
When true, suppress the 'Project: ... Zone: ... Cluster: ...' headers.
Vkube help - Display help for commands or topics
Help with no args displays the usage of the parent command.
Help with args displays the usage of the specified sub-command or help topic.
"help ..." recursively displays help for all commands and topics.
Usage:
vkube help [flags] [command/topic ...]
[command/topic ...] optionally identifies a specific sub-command or help topic.
The vkube help flags are:
-style=compact
The formatting style for help output:
compact - Good for compact cmdline output.
full - Good for cmdline output, shows all global flags.
godoc - Good for godoc processing.
shortonly - Only output short description.
Override the default by setting the CMDLINE_STYLE environment variable.
-width=<terminal width>
Format output to this target width in runes, or unlimited if width < 0.
Defaults to the terminal width if available. Override the default by setting
the CMDLINE_WIDTH environment variable.
*/
package main