diff --git a/cmd/minikube/cmd/env.go b/cmd/minikube/cmd/env.go index fdef62e3949cc0b183b4ab5223c6e281c2e8bdc4..030aa410cb91661391414962379988c61eff2175 100644 --- a/cmd/minikube/cmd/env.go +++ b/cmd/minikube/cmd/env.go @@ -377,7 +377,7 @@ func dockerURL(ip string, port int) string { return fmt.Sprintf("tcp://%s", net.JoinHostPort(ip, strconv.Itoa(port))) } -// dockerEnvVars gets the necessary docker env variables to allow the use of docker through minikube's vm +// dockerEnvVars gets the necessary docker env variables to allow the use of minikube's docker daemon func dockerEnvVars(ec EnvConfig) (map[string]string, error) { env := map[string]string{ constants.DockerTLSVerifyEnv: "1", diff --git a/cmd/minikube/cmd/start.go b/cmd/minikube/cmd/start.go index 2ae17838be87d42e49fccbc468adb911450a9935..5c7a21c59f5be1dc506c010643d7e84fcdf06e87 100644 --- a/cmd/minikube/cmd/start.go +++ b/cmd/minikube/cmd/start.go @@ -316,7 +316,7 @@ func runStart(cmd *cobra.Command, args []string) { updateDriver(driverName) } - k8sVersion, isUpgrade := getKubernetesVersion(existing) + k8sVersion := getKubernetesVersion(existing) mc, n, err := generateCfgFromFlags(cmd, k8sVersion, driverName) if err != nil { exit.WithError("Failed to generate config", err) @@ -365,7 +365,7 @@ func runStart(cmd *cobra.Command, args []string) { bs := setupKubeAdm(machineAPI, mc, n) // pull images or restart cluster - bootstrapCluster(bs, cr, mRunner, mc, preExists, isUpgrade) + bootstrapCluster(bs, cr, mRunner, mc) configureMounts() // enable addons, both old and new! @@ -1187,9 +1187,8 @@ func tryRegistry(r command.Runner) { } // getKubernetesVersion ensures that the requested version is reasonable -func getKubernetesVersion(old *config.MachineConfig) (string, bool) { +func getKubernetesVersion(old *config.MachineConfig) string { paramVersion := viper.GetString(kubernetesVersion) - isUpgrade := false if paramVersion == "" { // if the user did not specify any version then ... if old != nil { // .. use the old version from config (if any) @@ -1207,7 +1206,7 @@ func getKubernetesVersion(old *config.MachineConfig) (string, bool) { nv := version.VersionPrefix + nvs.String() if old == nil || old.KubernetesConfig.KubernetesVersion == "" { - return nv, isUpgrade + return nv } oldestVersion, err := semver.Make(strings.TrimPrefix(constants.OldestKubernetesVersion, version.VersionPrefix)) @@ -1249,11 +1248,7 @@ func getKubernetesVersion(old *config.MachineConfig) (string, bool) { if defaultVersion.GT(nvs) { out.T(out.ThumbsUp, "Kubernetes {{.new}} is now available. If you would like to upgrade, specify: --kubernetes-version={{.new}}", out.V{"new": defaultVersion}) } - - if nvs.GT(ovs) { - isUpgrade = true - } - return nv, isUpgrade + return nv } // setupKubeAdm adds any requested files into the VM before Kubernetes is started @@ -1296,14 +1291,7 @@ func configureRuntimes(runner cruntime.CommandRunner, drvName string, k8s config } // bootstrapCluster starts Kubernetes using the chosen bootstrapper -func bootstrapCluster(bs bootstrapper.Bootstrapper, r cruntime.Manager, runner command.Runner, mc config.MachineConfig, preexisting bool, isUpgrade bool) { - if isUpgrade || !preexisting { - out.T(out.Pulling, "Pulling images ...") - if err := bs.PullImages(mc.KubernetesConfig); err != nil { - out.T(out.FailureType, "Unable to pull images, which may be OK: {{.error}}", out.V{"error": err}) - } - } - +func bootstrapCluster(bs bootstrapper.Bootstrapper, r cruntime.Manager, runner command.Runner, mc config.MachineConfig) { out.T(out.Launch, "Launching Kubernetes ... ") if err := bs.StartCluster(mc); err != nil { exit.WithLogEntries("Error starting cluster", err, logs.FindProblems(r, bs, runner)) diff --git a/cmd/minikube/cmd/start_test.go b/cmd/minikube/cmd/start_test.go index 32f130aba366d2541203277956845a3571a1d53c..1003292da2e3230cdacec13bd8912301b3505579 100644 --- a/cmd/minikube/cmd/start_test.go +++ b/cmd/minikube/cmd/start_test.go @@ -31,33 +31,28 @@ func TestGetKuberneterVersion(t *testing.T) { description string expectedVersion string paramVersion string - upgrade bool cfg *cfg.MachineConfig }{ { description: "kubernetes-version not given, no config", expectedVersion: constants.DefaultKubernetesVersion, paramVersion: "", - upgrade: false, }, { description: "kubernetes-version not given, config available", expectedVersion: "v1.15.0", paramVersion: "", - upgrade: false, cfg: &cfg.MachineConfig{KubernetesConfig: cfg.KubernetesConfig{KubernetesVersion: "v1.15.0"}}, }, { description: "kubernetes-version given, no config", expectedVersion: "v1.15.0", paramVersion: "v1.15.0", - upgrade: false, }, { description: "kubernetes-version given, config available", expectedVersion: "v1.16.0", paramVersion: "v1.16.0", - upgrade: true, cfg: &cfg.MachineConfig{KubernetesConfig: cfg.KubernetesConfig{KubernetesVersion: "v1.15.0"}}, }, } @@ -65,17 +60,12 @@ func TestGetKuberneterVersion(t *testing.T) { for _, test := range tests { t.Run(test.description, func(t *testing.T) { viper.SetDefault(kubernetesVersion, test.paramVersion) - version, upgrade := getKubernetesVersion(test.cfg) + version := getKubernetesVersion(test.cfg) // check whether we are getting the expected version if version != test.expectedVersion { t.Fatalf("test failed because the expected version %s is not returned", test.expectedVersion) } - - // check whether the upgrade flag is correct - if test.upgrade != upgrade { - t.Fatalf("test failed expected upgrade is %t", test.upgrade) - } }) } } diff --git a/deploy/minikube/releases.json b/deploy/minikube/releases.json index 4a53dcc373a949e52c85c3fff4b769004866d1e8..33c0ec3afe145d96827c1dc5a47a42ead840ca13 100644 --- a/deploy/minikube/releases.json +++ b/deploy/minikube/releases.json @@ -1,4 +1,12 @@ [ + { + "name": "v1.7.1", + "checksums": { + "darwin": "ac6b1eb8ff6a98f0f4a8f26fddd7a9fd8dbdd7a5029cf87a9315399d31e4f6ce", + "linux": "1313da4fce807f2d5cd4664d8a59422067a3377ddd37fa66df9aa0bb228e154b", + "windows": "640ad4ba69926be2ea64140a5d6d80122f030c8bf75ae4afeca11eeff865feac" + } + }, { "name": "v1.7.0", "checksums": { diff --git a/pkg/minikube/bootstrapper/bootstrapper.go b/pkg/minikube/bootstrapper/bootstrapper.go index f08876b6319dcd8825f517ad72020ab5e67fb3b4..669a38fd57e24964eed3126e27135d85fa28e4ce 100644 --- a/pkg/minikube/bootstrapper/bootstrapper.go +++ b/pkg/minikube/bootstrapper/bootstrapper.go @@ -35,8 +35,6 @@ type LogOptions struct { // Bootstrapper contains all the methods needed to bootstrap a kubernetes cluster type Bootstrapper interface { - // PullImages pulls images necessary for a cluster. Success should not be required. - PullImages(config.KubernetesConfig) error StartCluster(config.MachineConfig) error UpdateCluster(config.MachineConfig) error DeleteCluster(config.KubernetesConfig) error diff --git a/pkg/minikube/bootstrapper/bsutil/kubeadm_test.go b/pkg/minikube/bootstrapper/bsutil/kubeadm_test.go index 20481e489880863ffa1069ced4bc3f9dd790e57c..6bf8f2795161266e49fb0007198f1b5036d38d2b 100644 --- a/pkg/minikube/bootstrapper/bsutil/kubeadm_test.go +++ b/pkg/minikube/bootstrapper/bsutil/kubeadm_test.go @@ -70,7 +70,7 @@ func getExtraOptsPodCidr() []config.ExtraOption { func recentReleases() ([]string, error) { // test the 6 most recent releases - versions := []string{"v1.17", "v1.16", "v1.15", "v1.14", "v1.13", "v1.12", "v1.11"} + versions := []string{"v1.19", "v1.18", "v1.17", "v1.16", "v1.15", "v1.14", "v1.13", "v1.12", "v1.11"} foundNewest := false foundDefault := false diff --git a/pkg/minikube/bootstrapper/bsutil/testdata/v1.18/containerd.yaml b/pkg/minikube/bootstrapper/bsutil/testdata/v1.18/containerd.yaml index fa7a7e26991a1a74f84f27d29fd7a1a7a4783f22..a17d26a8d62d2ef6c09e175afb1261e7eacfa6bc 100644 --- a/pkg/minikube/bootstrapper/bsutil/testdata/v1.18/containerd.yaml +++ b/pkg/minikube/bootstrapper/bsutil/testdata/v1.18/containerd.yaml @@ -35,4 +35,4 @@ kubernetesVersion: v1.18.0 networking: dnsDomain: cluster.local podSubnet: "" - serviceSubnet: 10.96.0.0/12 \ No newline at end of file + serviceSubnet: 10.96.0.0/12 diff --git a/pkg/minikube/bootstrapper/bsutil/testdata/v1.18/default.yaml b/pkg/minikube/bootstrapper/bsutil/testdata/v1.18/default.yaml index 3935c237d947f222f08f96beedb48d55271b66ee..9076038c356b66a267a6a7571217c938a2bd3198 100644 --- a/pkg/minikube/bootstrapper/bsutil/testdata/v1.18/default.yaml +++ b/pkg/minikube/bootstrapper/bsutil/testdata/v1.18/default.yaml @@ -35,4 +35,4 @@ kubernetesVersion: v1.18.0 networking: dnsDomain: cluster.local podSubnet: "" - serviceSubnet: 10.96.0.0/12 \ No newline at end of file + serviceSubnet: 10.96.0.0/12 diff --git a/pkg/minikube/bootstrapper/bsutil/testdata/v1.18/image-repository.yaml b/pkg/minikube/bootstrapper/bsutil/testdata/v1.18/image-repository.yaml index b66d057851e16fa5b0f742d2a0f8b99b183eacf4..8c1c1ff6a91f90ca04dae9af2ab532895397d390 100644 --- a/pkg/minikube/bootstrapper/bsutil/testdata/v1.18/image-repository.yaml +++ b/pkg/minikube/bootstrapper/bsutil/testdata/v1.18/image-repository.yaml @@ -36,4 +36,4 @@ kubernetesVersion: v1.18.0 networking: dnsDomain: cluster.local podSubnet: "" - serviceSubnet: 10.96.0.0/12 \ No newline at end of file + serviceSubnet: 10.96.0.0/12 diff --git a/pkg/minikube/bootstrapper/bsutil/testdata/v1.18/options.yaml b/pkg/minikube/bootstrapper/bsutil/testdata/v1.18/options.yaml index 760b2fdc3ce0b9b847b38098ea915d24d603ff5d..c2d123f473c59fb95ed047408af5498be8cf11d3 100644 --- a/pkg/minikube/bootstrapper/bsutil/testdata/v1.18/options.yaml +++ b/pkg/minikube/bootstrapper/bsutil/testdata/v1.18/options.yaml @@ -42,4 +42,4 @@ kubernetesVersion: v1.18.0 networking: dnsDomain: cluster.local podSubnet: "" - serviceSubnet: 10.96.0.0/12 \ No newline at end of file + serviceSubnet: 10.96.0.0/12 diff --git a/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/containerd-api-port.yaml b/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/containerd-api-port.yaml index 4dbf17cfc977f7008779b6a48822fb8dac901641..0f76dc8dbbdc7f5a18d02901e5cd5b37c6d0965c 100644 --- a/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/containerd-api-port.yaml +++ b/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/containerd-api-port.yaml @@ -35,4 +35,4 @@ kubernetesVersion: v1.19.0 networking: dnsDomain: cluster.local podSubnet: "" - serviceSubnet: 10.96.0.0/12 \ No newline at end of file + serviceSubnet: 10.96.0.0/12 diff --git a/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/containerd-pod-network-cidr.yaml b/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/containerd-pod-network-cidr.yaml index 154422be3597f12b1b7b36fbc460ed6a9c25039d..bb1c5e4cc13b99fbca99693dc5f4c12bb9649468 100644 --- a/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/containerd-pod-network-cidr.yaml +++ b/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/containerd-pod-network-cidr.yaml @@ -35,4 +35,4 @@ kubernetesVersion: v1.19.0 networking: dnsDomain: cluster.local podSubnet: "192.168.32.0/20" - serviceSubnet: 10.96.0.0/12 \ No newline at end of file + serviceSubnet: 10.96.0.0/12 diff --git a/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/containerd.yaml b/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/containerd.yaml index 9e7e8855cae20ec16eb07a4b6d67b56fea00c5aa..77db4e13aa0733298cfeb1c6402e43d0bada808e 100644 --- a/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/containerd.yaml +++ b/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/containerd.yaml @@ -35,4 +35,4 @@ kubernetesVersion: v1.19.0 networking: dnsDomain: cluster.local podSubnet: "" - serviceSubnet: 10.96.0.0/12 \ No newline at end of file + serviceSubnet: 10.96.0.0/12 diff --git a/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/crio-options-gates.yaml b/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/crio-options-gates.yaml index 8c964ee684f9d86015f93e8463802176af6d5d2a..b137cc4f4045ecd525d9334b57f10858211da929 100644 --- a/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/crio-options-gates.yaml +++ b/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/crio-options-gates.yaml @@ -45,4 +45,4 @@ kubernetesVersion: v1.19.0 networking: dnsDomain: cluster.local podSubnet: "" - serviceSubnet: 10.96.0.0/12 \ No newline at end of file + serviceSubnet: 10.96.0.0/12 diff --git a/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/crio.yaml b/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/crio.yaml index bffa2f1a2c948c4531da629588be5463c202751a..3fd6b7923cdbda323a4ae799494b8bfbe01b31f9 100644 --- a/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/crio.yaml +++ b/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/crio.yaml @@ -35,4 +35,4 @@ kubernetesVersion: v1.19.0 networking: dnsDomain: cluster.local podSubnet: "" - serviceSubnet: 10.96.0.0/12 \ No newline at end of file + serviceSubnet: 10.96.0.0/12 diff --git a/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/default.yaml b/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/default.yaml index 6dd892536cd63c48a6c3e9262a4319b6f6ee832c..45cec67f36172ee06e60b19e2b9d335424f17134 100644 --- a/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/default.yaml +++ b/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/default.yaml @@ -35,4 +35,4 @@ kubernetesVersion: v1.19.0 networking: dnsDomain: cluster.local podSubnet: "" - serviceSubnet: 10.96.0.0/12 \ No newline at end of file + serviceSubnet: 10.96.0.0/12 diff --git a/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/image-repository.yaml b/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/image-repository.yaml index d4d491db343d15643b4f5ca79313f46b8469bf24..e766699a11d0d5e764d676505a51ad3d520183e1 100644 --- a/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/image-repository.yaml +++ b/pkg/minikube/bootstrapper/bsutil/testdata/v1.19/image-repository.yaml @@ -36,4 +36,4 @@ kubernetesVersion: v1.19.0 networking: dnsDomain: cluster.local podSubnet: "" - serviceSubnet: 10.96.0.0/12 \ No newline at end of file + serviceSubnet: 10.96.0.0/12 diff --git a/pkg/minikube/bootstrapper/kubeadm/kubeadm.go b/pkg/minikube/bootstrapper/kubeadm/kubeadm.go index 8688ed54de2db6e4e1a1b66720e6847e628de191..452287951b319f6547458a2c138988ca24d34d29 100644 --- a/pkg/minikube/bootstrapper/kubeadm/kubeadm.go +++ b/pkg/minikube/bootstrapper/kubeadm/kubeadm.go @@ -390,23 +390,6 @@ func (k *Bootstrapper) DeleteCluster(k8s config.KubernetesConfig) error { return nil } -// PullImages downloads images that will be used by Kubernetes -func (k *Bootstrapper) PullImages(k8s config.KubernetesConfig) error { - version, err := bsutil.ParseKubernetesVersion(k8s.KubernetesVersion) - if err != nil { - return errors.Wrap(err, "parsing kubernetes version") - } - if version.LT(semver.MustParse("1.11.0")) { - return fmt.Errorf("pull command is not supported by kubeadm v%s", version) - } - - rr, err := k.c.RunCmd(exec.Command("/bin/bash", "-c", fmt.Sprintf("%s config images pull --config %s", bsutil.InvokeKubeadm(k8s.KubernetesVersion), bsutil.KubeadmYamlPath))) - if err != nil { - return errors.Wrapf(err, "running cmd: %q", rr.Command()) - } - return nil -} - // SetupCerts sets up certificates within the cluster. func (k *Bootstrapper) SetupCerts(k8s config.KubernetesConfig, n config.Node) error { return bootstrapper.SetupCerts(k.c, k8s, n) diff --git a/site/config.toml b/site/config.toml index 190237e9d4799a2edc266c595197382e0bbc64c1..34c91698191113a9c14aef021ec15eec286f7410 100644 --- a/site/config.toml +++ b/site/config.toml @@ -95,7 +95,7 @@ weight = 1 [params] copyright = "The Kubernetes Authors -- " # The latest release of minikube -latest_release = "1.6.2" +latest_release = "1.7.1" privacy_policy = "" diff --git a/site/content/en/docs/Reference/Commands/addons.md b/site/content/en/docs/Reference/Commands/addons.md index 0434ac8eefb1d4992d0ce2d73d86a903f32c3162..e87deb92166cd039b14a422b2f13d5d33169d30d 100644 --- a/site/content/en/docs/Reference/Commands/addons.md +++ b/site/content/en/docs/Reference/Commands/addons.md @@ -52,6 +52,14 @@ Lists all available minikube addons as well as their current statuses (enabled/d ``` minikube addons list [flags] ``` + +### Options + +``` + -h, --help help for list + -o, --output string minikube addons list --output OUTPUT. json, list (default "list") +``` + ## minikube addons open Opens the addon w/ADDON_NAME within minikube (example: minikube addons open dashboard). For a list of available addons use: minikube addons list diff --git a/site/content/en/docs/Reference/Commands/cache.md b/site/content/en/docs/Reference/Commands/cache.md index cd4b335f6dadbd16a6c20ec86f3e37f6c938d36c..039eda99408b663d7dd109fbceb43d0a0e8af08d 100644 --- a/site/content/en/docs/Reference/Commands/cache.md +++ b/site/content/en/docs/Reference/Commands/cache.md @@ -39,3 +39,11 @@ minikube cache list [flags] For the list of accessible variables for the template, see the struct values here: https://godoc.org/k8s.io/minikube/cmd/minikube/cmd#CacheListTemplate (default "{{.CacheImage}}\n") -h, --help help for list ``` + +## minikube cache reload + +reloads images previously added using the 'cache add' subcommand + +``` +minikube cache reload [flags] +``` \ No newline at end of file diff --git a/site/content/en/docs/Reference/Commands/config.md b/site/content/en/docs/Reference/Commands/config.md index 12f70c52bf8d18beeeea702839deda73ca2fc430..5a284951a05816b3b18b20b25d527b3e482f9adf 100644 --- a/site/content/en/docs/Reference/Commands/config.md +++ b/site/content/en/docs/Reference/Commands/config.md @@ -14,6 +14,7 @@ config modifies minikube config files using subcommands like "minikube config se Configurable fields: * vm-driver + * container-runtime * feature-gates * v * cpus @@ -33,26 +34,13 @@ Configurable fields: * bootstrapper * ShowDriverDeprecationNotification * ShowBootstrapperDeprecationNotification - * dashboard - * addon-manager - * default-storageclass - * efk - * ingress - * registry - * registry-creds - * freshpod - * default-storageclass - * storage-provisioner - * storage-provisioner-gluster - * metrics-server - * nvidia-driver-installer - * nvidia-gpu-device-plugin - * logviewer - * gvisor + * insecure-registry * hyperv-virtual-switch * disable-driver-mounts * cache * embed-certs + * native-ssh + ### subcommands diff --git a/site/content/en/docs/Reference/Commands/logs.md b/site/content/en/docs/Reference/Commands/logs.md index 0466ff747f55c73a43d87a5840f81dde071b0685..595c7055e1963a31aded7f93d38c70a24f31d917 100644 --- a/site/content/en/docs/Reference/Commands/logs.md +++ b/site/content/en/docs/Reference/Commands/logs.md @@ -18,7 +18,7 @@ minikube logs [flags] ``` -f, --follow Show only the most recent journal entries, and continuously print new entries as they are appended to the journal. -h, --help help for logs - -n, --length int Number of lines back to go within the log (default 50) + -n, --length int Number of lines back to go within the log (default 60) --problems Show only log entries which point to known problems ``` diff --git a/site/content/en/docs/Reference/Commands/pause.md b/site/content/en/docs/Reference/Commands/pause.md new file mode 100644 index 0000000000000000000000000000000000000000..c35ab6bfdd12a7a30f1f0f42870575a54676fe3c --- /dev/null +++ b/site/content/en/docs/Reference/Commands/pause.md @@ -0,0 +1,46 @@ +--- +title: "pause" +linkTitle: "pause" +weight: 1 +date: 2020-02-05 +description: > + pause the Kubernetes control plane or other namespaces +--- + +### Overview + +The pause command allows you to freeze containers using the Linux [cgroup freezer](https://www.kernel.org/doc/Documentation/cgroup-v1/freezer-subsystem.txt). Once frozen, processes will no longer consume CPU cycles, but will remain in memory. + +By default, the pause command will pause the Kubernetes control plane (kube-system namespace), leaving your applications running. This reduces the background CPU usage of a minikube cluster to a negligable 2-3% of a CPU. + +### Usage + +``` +minikube pause [flags] +``` + +### Options + +``` + -n, ----namespaces strings namespaces to pause (default [kube-system,kubernetes-dashboard,storage-gluster,istio-operator]) + -A, --all-namespaces If set, pause all namespaces + -h, --help help for pause +``` + +### Options inherited from parent commands + +``` + --alsologtostderr log to standard error as well as files + --log_backtrace_at traceLocation when logging hits line file:N, emit a stack trace (default :0) + --log_dir string If non-empty, write log files in this directory + --logtostderr log to standard error instead of files + -p, --profile string The name of the minikube VM being used. This can be set to allow having multiple instances of minikube independently. (default "minikube") + --stderrthreshold severity logs at or above this threshold go to stderr (default 2) + -v, --v Level log level for V logs + --vmodule moduleSpec comma-separated list of pattern=N settings for file-filtered logging +``` + +### SEE ALSO + +* [unpause](unpause.md) + diff --git a/site/content/en/docs/Reference/Commands/profile.md b/site/content/en/docs/Reference/Commands/profile.md index 86fd88f796ab7884c3a64d26e9ee0a91238e57a9..88505fcf35ce4b647a6b4ba898c743543444f73f 100644 --- a/site/content/en/docs/Reference/Commands/profile.md +++ b/site/content/en/docs/Reference/Commands/profile.md @@ -49,3 +49,10 @@ Lists all valid minikube profiles and detects all possible invalid profiles. ``` minikube profile list [flags] ``` + +### Options + +``` + -h, --help help for list + -o, --output string The output format. One of 'json', 'table' (default "table") +``` diff --git a/site/content/en/docs/Reference/Commands/service.md b/site/content/en/docs/Reference/Commands/service.md index 67ed39d486d9f7f4564fe3945f971d54797cdbf0..8a7a8b164f1578aeb3666bde040abba9eeb21ae8 100644 --- a/site/content/en/docs/Reference/Commands/service.md +++ b/site/content/en/docs/Reference/Commands/service.md @@ -27,7 +27,7 @@ minikube service [flags] SERVICE --format string Format to output service URL in. This format will be applied to each url individually and they will be printed one at a time. (default "http://{{.IP}}:{{.Port}}") -h, --help help for service --https Open the service URL with https instead of http - --interval int The time interval for each check that wait performs in seconds (default 6) + --interval int The initial time interval for each check that wait performs in seconds (default 6) -n, --namespace string The service namespace (default "default") --url Display the kubernetes service URL in the CLI instead of opening it in the default browser --wait int Amount of time to wait for a service in seconds (default 20) diff --git a/site/content/en/docs/Reference/Commands/ssh.md b/site/content/en/docs/Reference/Commands/ssh.md index 6be1d3247c387fd79eb5ec4fc64feb533d112a7c..54d96492333fb36522a4a606e2fe5a1692d44d66 100644 --- a/site/content/en/docs/Reference/Commands/ssh.md +++ b/site/content/en/docs/Reference/Commands/ssh.md @@ -13,18 +13,10 @@ description: > ``` minikube ssh [flags] ``` -``` -### Options inherited from parent commands +### Options ``` - --alsologtostderr log to standard error as well as files - -b, --bootstrapper string The name of the cluster bootstrapper that will set up the kubernetes cluster. (default "kubeadm") - --log_backtrace_at traceLocation when logging hits line file:N, emit a stack trace (default :0) - --log_dir string If non-empty, write log files in this directory - --logtostderr log to standard error instead of files - -p, --profile string The name of the minikube VM being used. This can be set to allow having multiple instances of minikube independently. (default "minikube") - --stderrthreshold severity logs at or above this threshold go to stderr (default 2) - -v, --v Level log level for V logs - --vmodule moduleSpec comma-separated list of pattern=N settings for file-filtered logging + -h, --help help for ssh + --native-ssh Use native Golang SSH client (default true). Set to 'false' to use the command line 'ssh' command when accessing the docker machine. Useful for the machine drivers when they will not start with 'Waiting for SSH'. (default true) ``` diff --git a/site/content/en/docs/Reference/Commands/start.md b/site/content/en/docs/Reference/Commands/start.md index 6e1c1b13dfaef604d019ecc46da6d6c4ecb8a80c..8c9bc178f83ec0ff1297c3102f1bcbe7932613c2 100644 --- a/site/content/en/docs/Reference/Commands/start.md +++ b/site/content/en/docs/Reference/Commands/start.md @@ -16,60 +16,69 @@ minikube start [flags] ### Options ``` ---addons Enable addons. see `minikube addons list` for a list of valid addon names. ---apiserver-ips ipSlice A set of apiserver IP Addresses which are used in the generated certificate for kubernetes. This can be used if you want to make the apiserver available from outside the machine (default []) ---apiserver-name string The apiserver name which is used in the generated certificate for kubernetes. This can be used if you want to make the apiserver available from outside the machine (default "minikubeCA") ---apiserver-names stringArray A set of apiserver names which are used in the generated certificate for kubernetes. This can be used if you want to make the apiserver available from outside the machine ---apiserver-port int The apiserver listening port (default 8443) ---cache-images If true, cache docker images for the current bootstrapper and load them into the machine. Always false with --vm-driver=none. (default true) ---container-runtime string The container runtime to be used (docker, crio, containerd). (default "docker") ---cpus int Number of CPUs allocated to the minikube VM. (default 2) ---cri-socket string The cri socket path to be used. ---disable-driver-mounts Disables the filesystem mounts provided by the hypervisors ---disk-size string Disk size allocated to the minikube VM (format: [], where unit = b, k, m or g). (default "20000mb") ---dns-domain string The cluster dns domain name used in the kubernetes cluster (default "cluster.local") ---dns-proxy Enable proxy for NAT DNS requests (virtualbox) ---docker-env stringArray Environment variables to pass to the Docker daemon. (format: key=value) ---docker-opt stringArray Specify arbitrary flags to pass to the Docker daemon. (format: key=value) ---download-only If true, only download and cache files for later use - don't install or start anything. ---embed-certs if true, will embed the certs in kubeconfig. ---enable-default-cni Enable the default CNI plugin (/etc/cni/net.d/k8s.conf). Used in conjunction with "--network-plugin=cni". ---extra-config ExtraOption A set of key=value pairs that describe configuration that may be passed to different components. -The key should be '.' separated, and the first part before the dot is the component to apply the configuration to. -Valid components are: kubelet, kubeadm, apiserver, controller-manager, etcd, proxy, scheduler -Valid kubeadm parameters: ignore-preflight-errors, dry-run, kubeconfig, kubeconfig-dir, node-name, cri-socket, experimental-upload-certs, certificate-key, rootfs, pod-network-cidr ---feature-gates string A set of key=value pairs that describe feature gates for alpha/experimental features. ---force Force minikube to perform possibly dangerous operations --h, --help help for start ---host-dns-resolver Enable host resolver for NAT DNS requests (virtualbox) (default true) ---host-only-cidr string The CIDR to be used for the minikube VM (only supported with Virtualbox driver) (default "192.168.99.1/24") ---hyperkit-vpnkit-sock string Location of the VPNKit socket used for networking. If empty, disables Hyperkit VPNKitSock, if 'auto' uses Docker for Mac VPNKit connection, otherwise uses the specified VSock. ---hyperkit-vsock-ports strings List of guest VSock ports that should be exposed as sockets on the host (Only supported on with hyperkit now). ---hyperv-virtual-switch string The hyperv virtual switch name. Defaults to first found. (only supported with HyperV driver) ---image-mirror-country string Country code of the image mirror to be used. Leave empty to use the global one. For Chinese mainland users, set it to cn ---image-repository string Alternative image repository to pull docker images from. This can be used when you have limited access to gcr.io. Set it to "auto" to let minikube decide one for you. For Chinese mainland users, you may use local gcr.io mirrors such as registry.cn-hangzhou.aliyuncs.com/google_containers ---insecure-registry strings Insecure Docker registries to pass to the Docker daemon. The default service CIDR range will automatically be added. ---iso-url string Location of the minikube iso. (default "https://storage.googleapis.com/minikube/iso/minikube-v1.3.0.iso") ---keep-context This will keep the existing kubectl context and will create a minikube context. ---kubernetes-version string The kubernetes version that the minikube VM will use (ex: v1.2.3) (default "v1.15.2") ---kvm-gpu Enable experimental NVIDIA GPU support in minikube ---kvm-hidden Hide the hypervisor signature from the guest in minikube ---kvm-network string The KVM network name. (only supported with KVM driver) (default "default") ---kvm-qemu-uri string The KVM QEMU connection URI. (works only with kvm2 driver on linux) (default "qemu:///system") ---memory string Amount of RAM allocated to the minikube VM (format: [], where unit = b, k, m or g). (default "2000mb") ---mount This will start the mount daemon and automatically mount files into minikube. ---mount-string string The argument to pass the minikube mount command on start. (default "/Users:/minikube-host") ---network-plugin string The name of the network plugin. ---nfs-share strings Local folders to share with Guest via NFS mounts (Only supported on with hyperkit now) ---nfs-shares-root string Where to root the NFS Shares (defaults to /nfsshares, only supported with hyperkit now) (default "/nfsshares") ---no-vtx-check Disable checking for the availability of hardware virtualization before the vm is started (virtualbox) ---registry-mirror strings Registry mirrors to pass to the Docker daemon ---service-cluster-ip-range string The CIDR to be used for service cluster IPs. (default "10.96.0.0/12") ---uuid string Provide VM UUID to restore MAC address (only supported with Hyperkit driver). ---vm-driver string VM driver is one of: [virtualbox parallels vmwarefusion hyperkit vmware] (default "virtualbox") ---wait Wait until Kubernetes core services are healthy before exiting. (default true) ---wait-timeout duration max time to wait per Kubernetes core services to be healthy. (default 3m0s) -``` + --addons minikube addons list Enable addons. see minikube addons list for a list of valid addon names. + --apiserver-ips ipSlice A set of apiserver IP Addresses which are used in the generated certificate for kubernetes. This can be used if you want to make the apiserver available from outside the machine (default []) + --apiserver-name string The apiserver name which is used in the generated certificate for kubernetes. This can be used if you want to make the apiserver available from outside the machine (default "minikubeCA") + --apiserver-names stringArray A set of apiserver names which are used in the generated certificate for kubernetes. This can be used if you want to make the apiserver available from outside the machine + --apiserver-port int The apiserver listening port (default 8443) + --auto-update-drivers If set, automatically updates drivers to the latest version. Defaults to true. (default true) + --cache-images If true, cache docker images for the current bootstrapper and load them into the machine. Always false with --vm-driver=none. (default true) + --container-runtime string The container runtime to be used (docker, crio, containerd). (default "docker") + --cpus int Number of CPUs allocated to the minikube VM. (default 2) + --cri-socket string The cri socket path to be used. + --disable-driver-mounts Disables the filesystem mounts provided by the hypervisors + --disk-size string Disk size allocated to the minikube VM (format: [], where unit = b, k, m or g). (default "20000mb") + --dns-domain string The cluster dns domain name used in the kubernetes cluster (default "cluster.local") + --dns-proxy Enable proxy for NAT DNS requests (virtualbox driver only) + --docker-env stringArray Environment variables to pass to the Docker daemon. (format: key=value) + --docker-opt stringArray Specify arbitrary flags to pass to the Docker daemon. (format: key=value) + --download-only If true, only download and cache files for later use - don't install or start anything. + --dry-run dry-run mode. Validates configuration, but does not mutate system state + --embed-certs if true, will embed the certs in kubeconfig. + --enable-default-cni Enable the default CNI plugin (/etc/cni/net.d/k8s.conf). Used in conjunction with "--network-plugin=cni". + --extra-config ExtraOption A set of key=value pairs that describe configuration that may be passed to different components. + + The key should be '.' separated, and the first part before the dot is the component to apply the configuration to. + + Valid components are: kubelet, kubeadm, apiserver, controller-manager, etcd, proxy, scheduler + + Valid kubeadm parameters: ignore-preflight-errors, dry-run, kubeconfig, kubeconfig-dir, node-name, cri-socket, experimental-upload-certs, certificate-key, rootfs, pod-network-cidr + + --feature-gates string A set of key=value pairs that describe feature gates for alpha/experimental features. + --force Force minikube to perform possibly dangerous operations + -h, --help help for start + --host-dns-resolver Enable host resolver for NAT DNS requests (virtualbox driver only) (default true) + --host-only-cidr string The CIDR to be used for the minikube VM (virtualbox driver only) (default "192.168.99.1/24") + --host-only-nic-type string NIC Type used for host only network. One of Am79C970A, Am79C973, 82540EM, 82543GC, 82545EM, or virtio (virtualbox driver only) (default "virtio") + --hyperkit-vpnkit-sock string Location of the VPNKit socket used for networking. If empty, disables Hyperkit VPNKitSock, if 'auto' uses Docker for Mac VPNKit connection, otherwise uses the specified VSock (hyperkit driver only) + --hyperkit-vsock-ports strings List of guest VSock ports that should be exposed as sockets on the host (hyperkit driver only) + --hyperv-virtual-switch string The hyperv virtual switch name. Defaults to first found. (hyperv driver only) + --image-mirror-country string Country code of the image mirror to be used. Leave empty to use the global one. For Chinese mainland users, set it to cn. + --image-repository string Alternative image repository to pull docker images from. This can be used when you have limited access to gcr.io. Set it to "auto" to let minikube decide one for you. For Chinese mainland users, you may use local gcr.io mirrors such as registry.cn-hangzhou.aliyuncs.com/google_containers + --insecure-registry strings Insecure Docker registries to pass to the Docker daemon. The default service CIDR range will automatically be added. + --interactive Allow user prompts for more information (default true) + --iso-url string Location of the minikube iso. (default "https://storage.googleapis.com/minikube/iso/minikube-v1.7.0.iso") + --keep-context This will keep the existing kubectl context and will create a minikube context. + --kubernetes-version string The kubernetes version that the minikube VM will use (ex: v1.2.3) + --kvm-gpu Enable experimental NVIDIA GPU support in minikube + --kvm-hidden Hide the hypervisor signature from the guest in minikube (kvm2 driver only) + --kvm-network string The KVM network name. (kvm2 driver only) (default "default") + --kvm-qemu-uri string The KVM QEMU connection URI. (kvm2 driver only) (default "qemu:///system") + --memory string Amount of RAM allocated to the minikube VM (format: [], where unit = b, k, m or g). (default "2000mb") + --mount This will start the mount daemon and automatically mount files into minikube. + --mount-string string The argument to pass the minikube mount command on start. (default "/Users:/minikube-host") + --nat-nic-type string NIC Type used for host only network. One of Am79C970A, Am79C973, 82540EM, 82543GC, 82545EM, or virtio (virtualbox driver only) (default "virtio") + --native-ssh Use native Golang SSH client (default true). Set to 'false' to use the command line 'ssh' command when accessing the docker machine. Useful for the machine drivers when they will not start with 'Waiting for SSH'. (default true) + --network-plugin string The name of the network plugin. + --nfs-share strings Local folders to share with Guest via NFS mounts (hyperkit driver only) + --nfs-shares-root string Where to root the NFS Shares, defaults to /nfsshares (hyperkit driver only) (default "/nfsshares") + --no-vtx-check Disable checking for the availability of hardware virtualization before the vm is started (virtualbox driver only) + --registry-mirror strings Registry mirrors to pass to the Docker daemon + --service-cluster-ip-range string The CIDR to be used for service cluster IPs. (default "10.96.0.0/12") + --uuid string Provide VM UUID to restore MAC address (hyperkit driver only) + --vm-driver string Driver is one of: virtualbox, parallels, vmwarefusion, hyperkit, vmware, docker (experimental) (defaults to auto-detect) + --wait Block until the apiserver is servicing API requests (default true) + --wait-timeout duration max time to wait per Kubernetes core services to be healthy. (default 6m0s)``` ### Options inherited from parent commands diff --git a/site/content/en/docs/Reference/Commands/status.md b/site/content/en/docs/Reference/Commands/status.md index 90dd6e2bde9fd39b79bef357abbfcbcd9839caad..d8c636ccf7c70b884a8c7a11c771bc8e13fe6fdc 100644 --- a/site/content/en/docs/Reference/Commands/status.md +++ b/site/content/en/docs/Reference/Commands/status.md @@ -23,13 +23,30 @@ minikube status [flags] ### Options ``` - --format string Go template format string for the status output. The format for Go templates can be found here: https://golang.org/pkg/text/template/ - For the list accessible variables for the template, see the struct values here: https://godoc.org/k8s.io/minikube/cmd/minikube/cmd#Status (default "host: {{.Host}}\nkubelet: {{.Kubelet}}\napiserver: {{.APIServer}}\nkubectl: {{.Kubeconfig}}\n") + -f, --format string Go template format string for the status output. The format for Go templates can be found here: https://golang.org/pkg/text/template/ + + For the list accessible variables for the template, see the struct values here: https://godoc.org/k8s.io/minikube/cmd/minikube/cmd#Status (default "host: {{.Host}}\nkubelet: {{.Kubelet}}\napiserver: {{.APIServer}}\nkubeconfig: {{.Kubeconfig}}\n") + -h, --help help for status + -o, --output string minikube status --output OUTPUT. json, text (default "text") ``` ### Options inherited from parent commands +``` + --alsologtostderr log to standard error as well as files + -b, --bootstrapper string The name of the cluster bootstrapper that will set up the kubernetes cluster. (default "kubeadm") + --log_backtrace_at traceLocation when logging hits line file:N, emit a stack trace (default :0) + --log_dir string If non-empty, write log files in this directory + --logtostderr log to standard error instead of files + -p, --profile string The name of the minikube VM being used. This can be set to allow having multiple instances of minikube independently. (default "minikube") + --stderrthreshold severity logs at or above this threshold go to stderr (default 2) + -v, --v Level log level for V logs + --vmodule moduleSpec comma-separated list of pattern=N settings for file-filtered logging + ``` + +### Options inherited from parent commands + ``` --alsologtostderr log to standard error as well as files -b, --bootstrapper string The name of the cluster bootstrapper that will set up the kubernetes cluster. (default "kubeadm") diff --git a/site/content/en/docs/Reference/Commands/unpause.md b/site/content/en/docs/Reference/Commands/unpause.md new file mode 100644 index 0000000000000000000000000000000000000000..1b71bce9df5a8919e7814723dbf2cd64f35432b6 --- /dev/null +++ b/site/content/en/docs/Reference/Commands/unpause.md @@ -0,0 +1,42 @@ +--- +title: "unpause" +linkTitle: "unpause" +weight: 1 +date: 2020-02-05 +description: > + unpause the Kubernetes control plane or other namespaces + +--- + +### Usage + +``` +minikube unpause [flags] +``` + +### Options + +``` + -n, ----namespaces strings namespaces to unpause (default [kube-system,kubernetes-dashboard,storage-gluster,istio-operator]) + -A, --all-namespaces If set, unpause all namespaces + -h, --help help for unpause +``` + +### Options inherited from parent commands + +``` + --alsologtostderr log to standard error as well as files + -b, --bootstrapper string The name of the cluster bootstrapper that will set up the kubernetes cluster. (default "kubeadm") + --log_backtrace_at traceLocation when logging hits line file:N, emit a stack trace (default :0) + --log_dir string If non-empty, write log files in this directory + --logtostderr log to standard error instead of files + -p, --profile string The name of the minikube VM being used. This can be set to allow having multiple instances of minikube independently. (default "minikube") + --stderrthreshold severity logs at or above this threshold go to stderr (default 2) + -v, --v Level log level for V logs + --vmodule moduleSpec comma-separated list of pattern=N settings for file-filtered logging +``` + +### SEE ALSO + +* [pause](pause.md) + diff --git a/site/content/en/docs/Reference/Drivers/docker.md b/site/content/en/docs/Reference/Drivers/docker.md new file mode 100644 index 0000000000000000000000000000000000000000..164691d267a2ab441b46c1548a0dc780a9ff9999 --- /dev/null +++ b/site/content/en/docs/Reference/Drivers/docker.md @@ -0,0 +1,30 @@ +--- +title: "docker" +linkTitle: "docker" +weight: 3 +date: 2020-02-05 +description: > + Docker driver (EXPERIMENTAL) +--- + +## Overview + +The Docker driver is an experimental VM-free driver that ships with minikube v1.7. + +This driver was inspired by the [kind project](https://kind.sigs.k8s.io/), and uses a modified version of its base image. + +## Special features + +No hypervisor required when run on Linux. + +## Limitations + +As an experimental driver, not all commands are supported on all platforms. Notably: `mount,` `service`, `tunnel`, and others. Most of these limitations will be addressed by minikube v1.8 (March 2020) + +## Issues + +* [Full list of open 'kic-driver' issues](https://github.com/kubernetes/minikube/labels/co%2Fkic-driver) + +## Troubleshooting + +* Run `minikube start --alsologtostderr -v=1` to debug crashes diff --git a/site/content/en/docs/Start/linux.md b/site/content/en/docs/Start/linux.md index b657df3fb4839e1a0ec5076fb2836825f353f979..b52b1690d8e94dad7b22d2aeb7eca0847c24207e 100644 --- a/site/content/en/docs/Start/linux.md +++ b/site/content/en/docs/Start/linux.md @@ -21,8 +21,8 @@ Download and install minikube to /usr/local/bin: Download and install minikube: ```shell -curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube_{{< latest >}}.deb \ - && sudo dpkg -i minikube_{{< latest >}}.deb +curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube_{{< latest >}}-0_amd64.deb \ + && sudo dpkg -i minikube_{{< latest >}}-0_amd64.deb ``` {{% /tab %}} @@ -32,8 +32,8 @@ curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube_{{< la Download and install minikube: ```shell -curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-{{< latest >}}.rpm \ - && sudo rpm -ivh minikube-{{< latest >}}.rpm +curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-{{< latest >}}-0.x86_64.rpm \ + && sudo rpm -ivh minikube-{{< latest >}}-0.x86_64.rpm ``` {{% /tab %}}