03-files

03 - Files

Score workloads can bind-mount files into running containers. Files using content support ${..} placeholder interpolation just like the container variables section. Files using a source path do not.

This is invaluable when configuring containers whose images you don't control or cannot modify further.

In the Score file below, two files are mounted, one with inline content, the other sourced from the local directory relative to the input Score file.

apiVersion: score.dev/v1b1

metadata:
  name: hello-world

containers:
  hello:
    image: busybox
    command: ["/bin/sh"]
    args: ["-c", "while true; do cat /fileA.txt; cat /fileB.txt; sleep 5; done"]
    files:
      - target: /fileA.txt
        source: fileA.txt
      - target: /fileB.txt
        content: |
          I am ${metadata.name}

As usual, we run this with init and generate score.yaml. After generate, you may notice that the files have been written to disk at .score-compose/mounts/files.

$ ls .score-compose/mounts/files/
hello-world-files-0-fileA.txt  hello-world-files-1-fileB.txt

And when we run it:

$ docker compose up
[+] Running 2/2
 ✔ Network 03-files_default                Created                                         0.1s
 ✔ Container 03-files-hello-world-hello-1  Cre...                                          0.1s
Attaching to hello-world-hello-1
hello-world-hello-1  | This is fileA.
hello-world-hello-1  | I am hello-world
hello-world-hello-1  | This is fileA.
hello-world-hello-1  | I am hello-world

files[*].noExpand is supported to disable placeholder interpolation in inline content. files[*].mode is not yet supported, see #88.