Point $HOME to /tekton/home

/builder/home is still mounted, backed by the same volume, to allow
users some time to move over before we move /builder/home in v0.10 and
beta.

cmd/creds-init/README.md

@@ -36,13 +36,13 @@ data:
 ```
 
 The flag `-ssh-git=ssh-key=github.com` (with the environment variable
-`HOME=/builder/home`) would result with the following files:
+`HOME=/tekton/home`) would result with the following files:
 
 - `~/.ssh/config`
 
 	```
 	HostName github.com
-	IdentityFile /builder/home/.ssh/id_foo
+	IdentityFile /tekton/home/.ssh/id_foo
 	Port 22
 	```
 - `~/.ssh/id_rsa` with the content of `ssh-privatekey` decoded
@@ -71,9 +71,9 @@ stringData:
 ```
 
 The flag `-basic-git=foo=github.com` (with the environment variable
-`HOME=/builder/home`) would result of the following files:
+`HOME=/tekton/home`) would result of the following files:
 
-- `/builder/home/.gitconfig`
+- `/tekton/home/.gitconfig`
 
   ```
   [credential]
@@ -82,7 +82,7 @@ The flag `-basic-git=foo=github.com` (with the environment variable
 	  username = <username>
   ```
 
-- `/builder/home/.git-credentials`
+- `/tekton/home/.git-credentials`
 
   ```
   https://<username>:<password>@github.com

docs/auth.md

@@ -431,7 +431,7 @@ Note: Because `known_hosts` is a non-standard extension of
 ### Least privilege
 
 The secrets as outlined here will be stored into `$HOME` (by convention the
-volume: `/builder/home`), and will be available to `Source` and all `Steps`.
+volume: `/tekton/home`), and will be available to `Source` and all `Steps`.
 
 For sensitive credentials that should not be made available to some steps, do
 not use the mechanisms outlined here. Instead, the user should declare an

docs/developers/README.md

@@ -147,7 +147,7 @@ If the image is a private registry, the service account should include an
 The `/builder/` namespace is reserved on containers for various system tools,
 such as the following:
 
-- The environment variable HOME is set to `/builder/home`, used by the builder
+- The environment variable HOME is set to `/tekton/home`, used by the builder
   tools and injected on into all of the step containers
 - Default location for output-images `/builder/output-images`
 

docs/taskruns.md

@@ -90,7 +90,7 @@ spec:
         # specifying DOCKER_CONFIG is required to allow kaniko to detect docker credential
         env:
           - name: "DOCKER_CONFIG"
-            value: "/builder/home/.docker/"
+            value: "/tekton/home/.docker/"
         command:
           - /kaniko/executor
         args:
@@ -377,7 +377,7 @@ spec:
         # specifying DOCKER_CONFIG is required to allow kaniko to detect docker credential
         env:
           - name: "DOCKER_CONFIG"
-            value: "/builder/home/.docker/"
+            value: "/tekton/home/.docker/"
         command:
           - /kaniko/executor
         args:

docs/tutorial.md

@@ -182,7 +182,7 @@ spec:
       # specifying DOCKER_CONFIG is required to allow kaniko to detect docker credential
       env:
         - name: "DOCKER_CONFIG"
-          value: "/builder/home/.docker/"
+          value: "/tekton/home/.docker/"
       command:
         - /kaniko/executor
       args:

examples/pipelineruns/pipelinerun.yaml

@@ -96,7 +96,7 @@ spec:
     # specifying DOCKER_CONFIG is required to allow kaniko to detect docker credential
     env:
     - name: "DOCKER_CONFIG"
-      value: "/builder/home/.docker/"
+      value: "/tekton/home/.docker/"
     command:
     - /kaniko/executor
     args:

examples/taskruns/build-push-kaniko.yaml

@@ -47,7 +47,7 @@ spec:
     # specifying DOCKER_CONFIG is required to allow kaniko to detect docker credential
     env:
     - name: "DOCKER_CONFIG"
-      value: "/builder/home/.docker/"
+      value: "/tekton/home/.docker/"
     command:
     - /kaniko/executor
     args:

examples/taskruns/home-is-set.yaml

@@ -10,4 +10,4 @@ spec:
       command: ['bash']
       args:
       - '-c'
-      - '[[ $HOME == /builder/home ]]'
+      - '[[ $HOME == /tekton/home ]]'

examples/taskruns/home-volume.yaml

@@ -8,19 +8,20 @@ spec:
     - name: write
       image: ubuntu
       command: ['bash']
-      args: ['-c', 'echo some stuff > /builder/home/stuff']
+      args: ['-c', 'echo some stuff > /tekton/home/stuff']
     - name: read
       image: ubuntu
       command: ['cat']
-      args: ['/builder/home/stuff']
+      args: ['/tekton/home/stuff']
     - name: override-homevol
       image: ubuntu
       command: ['bash']
-      # /builder/home/stuff *doesn't* exist.
-      args: ['-c', '[[ ! -f /builder/home/stuff ]]']
+      # /tekton/home/stuff *doesn't* exist, because the specified volumeMount
+      # conflicts with it, and the user's explicit declaration wins the tie.
+      args: ['-c', '[[ ! -f /tekton/home/stuff ]]']
       volumeMounts:
       - name: empty
-        mountPath: /builder/home
+        mountPath: /tekton/home
     volumes:
     - name: empty
       emptyDir: {}

examples/taskruns/old-home-volume.yaml

@@ -0,0 +1,27 @@
+apiVersion: tekton.dev/v1alpha1
+kind: TaskRun
+metadata:
+  generateName: old-home-volume-
+spec:
+  taskSpec:
+    steps:
+    - name: write
+      image: ubuntu
+      command: ['bash']
+      args: ['-c', 'echo some stuff > /builder/home/stuff']
+    - name: read
+      image: ubuntu
+      command: ['cat']
+      args: ['/builder/home/stuff']
+    - name: override-homevol
+      image: ubuntu
+      command: ['bash']
+      # /tekton/home/stuff *doesn't* exist, because the specified volumeMount
+      # conflicts with it, and the user's explicit declaration wins the tie.
+      args: ['-c', '[[ ! -f /builder/home/stuff ]]']
+      volumeMounts:
+      - name: empty
+        mountPath: /builder/home
+    volumes:
+    - name: empty
+      emptyDir: {}

examples/taskruns/task-multiple-output-image.yaml

@@ -73,8 +73,8 @@ spec:
     - -ce
     - |
       set -ex
-      mkdir -p /builder/home/image-outputs/builtImage1
-      cat <<EOF > /builder/home/image-outputs/builtImage1/index.json
+      mkdir -p /tekton/home/image-outputs/builtImage1
+      cat <<EOF > /tekton/home/image-outputs/builtImage1/index.json
       {
         "schemaVersion": 2,
         "manifests": [
@@ -94,8 +94,8 @@ spec:
     - -ce
     - |
       set -e
-      mkdir -p /builder/home/image-outputs/builtImage2
-      cat <<EOF > /builder/home/image-outputs/builtImage2/index.json
+      mkdir -p /tekton/home/image-outputs/builtImage2
+      cat <<EOF > /tekton/home/image-outputs/builtImage2/index.json
       {
         "schemaVersion": 2,
         "manifests": [

pkg/pod/pod.go

@@ -36,7 +36,8 @@ import (
 
 const (
 	workspaceDir = "/workspace"
-	homeDir      = "/builder/home"
+	homeDir      = "/tekton/home"
+	oldHomeDir   = "/builder/home"
 
 	taskRunLabelKey     = pipeline.GroupName + pipeline.TaskRunLabelKey
 	ManagedByLabelKey   = "app.kubernetes.io/managed-by"
@@ -59,14 +60,20 @@ var (
 		Name:      "workspace",
 		MountPath: workspaceDir,
 	}, {
-		Name:      "home",
+		Name:      "tekton-home",
 		MountPath: homeDir,
+	}, {
+		// Mount the home Volume to both /tekton/home and (old,
+		// deprecated) /builder/home.
+		// TODO(#1633): After v0.10, we can remove this old path.
+		Name:      "tekton-home",
+		MountPath: oldHomeDir,
 	}}
 	implicitVolumes = []corev1.Volume{{
 		Name:         "workspace",
 		VolumeSource: corev1.VolumeSource{EmptyDir: &corev1.EmptyDirVolumeSource{}},
 	}, {
-		Name:         "home",
+		Name:         "tekton-home",
 		VolumeSource: corev1.VolumeSource{EmptyDir: &corev1.EmptyDirVolumeSource{}},
 	}}
 

pkg/pod/workingdir_init_test.go

@@ -27,11 +27,8 @@ import (
 
 func TestWorkingDirInit(t *testing.T) {
 	volumeMounts := []corev1.VolumeMount{{
-		Name:      "workspace",
-		MountPath: "/workspace",
-	}, {
-		Name:      "home",
-		MountPath: "/builder/home",
+		Name:      "my-volume-mount",
+		MountPath: "/blah",
 	}}
 
 	names.TestingSeed()