summaryrefslogtreecommitdiff
path: root/contributors
diff options
context:
space:
mode:
authorKubernetes Prow Robot <k8s-ci-robot@users.noreply.github.com>2023-02-10 15:39:30 -0800
committerGitHub <noreply@github.com>2023-02-10 15:39:30 -0800
commitc48ace2338644e2db3ad25b15a70f87f97d74b73 (patch)
treeeb73368f46b09abf1efcb7f9f33c240ac3e3c4f3 /contributors
parentcf74cf0a8bbd1e14f57190ac9f048c0140227c97 (diff)
parent538c027e6ac4a9b50f83aca9edf8a1927fd054ea (diff)
Merge pull request #7133 from tzneal/update-running-locally
update running locally instructions
Diffstat (limited to 'contributors')
-rw-r--r--contributors/devel/running-locally.md25
1 files changed, 20 insertions, 5 deletions
diff --git a/contributors/devel/running-locally.md b/contributors/devel/running-locally.md
index ef2d4d54..c3a556cd 100644
--- a/contributors/devel/running-locally.md
+++ b/contributors/devel/running-locally.md
@@ -71,6 +71,8 @@ Set the endpoint for container runtime e.g. containerd
export CONTAINER_RUNTIME_ENDPOINT="unix:///run/containerd/containerd.sock"
```
+Optionally set any other environment variables as needed to change the cluster configuration. The possible options are listed at the top of the `./hack/local-up-cluster.sh` script.
+
In a separate tab of your terminal, run the following:
```sh
@@ -100,7 +102,11 @@ print the commands to run to point kubectl at the local cluster.
Your cluster is running, and you want to start running containers!
-You can now use any of the cluster/kubectl.sh commands to interact with your local setup.
+You can now use any of the cluster/kubectl.sh commands to interact with your local setup after setting your KUBECONFIG
+
+```sh
+export KUBECONFIG=/var/run/kubernetes/admin.kubeconfig
+```
```sh
./cluster/kubectl.sh get pods
@@ -112,10 +118,11 @@ You can now use any of the cluster/kubectl.sh commands to interact with your loc
While waiting for the provisioning to complete, you can monitor progress in another terminal with these commands.
```sh
-docker images
-# To watch the process pull the nginx image
-docker ps
-# To watch all Docker processes.
+# containerd
+# To list images
+ctr --namespace k8s.io image ls
+# To list containers
+ctr --namespace k8s.io containers ls
```
Once provisioning is complete, you can use the following commands for Kubernetes introspection.
@@ -181,3 +188,11 @@ KUBE_DNS_NAME="cluster.local"
```
To know more on DNS service you can check out the [docs](http://kubernetes.io/docs/admin/dns/).
+
+### All pod fail to start with a cgroups error of `expected cgroupsPath to be of format "slice:prefix:name" for systemd cgroups`
+
+Your container runtime is using the systemd cgroup driver, but by default `./hack/local-up-cluster.sh` uses cgroupfs. To correct the mismatch, set the `CGROUP_DRIVER` environment variable to systemd as well.
+
+```sh
+export CGROUP_DRIVER=systemd
+``` \ No newline at end of file