Skip to content

Commit 178d25d

Browse files
docs: DOC-2374 Edit Docker customization step for Edgeforge (#9728) (#9747)
* Add Docker customization warning to EdgeForge * ci: auto-formatting prettier issues * Update palette-canvos.md * ci: auto-formatting prettier issues * Update palette-canvos.md * Update palette-canvos.md * ci: auto-formatting prettier issues * Update palette-canvos.md * ci: auto-formatting prettier issues * Update palette-canvos.md * ci: auto-formatting prettier issues * Empty commit to trigger security checks --------- Co-authored-by: svetlana-efimova <205686560+svetlana-efimova@users.noreply.github.com>
1 parent d8414a3 commit 178d25d

File tree

1 file changed

+19
-16
lines changed

1 file changed

+19
-16
lines changed

docs/docs-content/clusters/edge/edgeforge-workflow/palette-canvos/palette-canvos.md

Lines changed: 19 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -676,30 +676,33 @@ git checkout v4.4.12
676676
677677
:::
678678
679-
12. Use the following command to append the [WireGuard](https://www.wireguard.com/install/) installation instructions to
680-
the `Dockerfile`. You can install more tools and dependencies and configure the image to meet your needs. Add your
681-
customizations below the line tagged with the `Add any other image customizations here` comment in the `Dockerfile`.
682-
Do not edit or add any lines before this tagged comment.
679+
12. Customize the `Dockerfile` as needed. You can install tools and dependencies and make other image modifications. Add your customizations below the line tagged with the `Add any other image customizations here` comment in the `Dockerfile`. Do not edit or add any lines before this tagged comment.
683680
684-
```bash
685-
echo 'RUN sudo zypper refresh && sudo zypper install --non-interactive wireguard-tools' >> Dockerfile
681+
:::warning
682+
683+
When customizing the `Dockerfile` to add custom binaries, install them into `/usr/bin`. Do not use `/usr/local`, as this directory is mounted from the persistent partition at boot and makes files added during image build unavailable at runtime.
684+
685+
:::
686+
687+
For example, you can add the following line to the `Dockerfile` to install [WireGuard](https://www.wireguard.com/install/).
688+
689+
```dockerfile
690+
...
691+
###########################Add any other image customizations here #######################
692+
693+
RUN sudo zypper refresh && sudo zypper install --non-interactive wireguard-tools
686694
```
695+
Package installation commands in the `Dockerfile` must be non-interactive. Ensure you use the appropriate
696+
non-interactive flag for your package manager, for example, `--non-interactive` for Zypper or `--yes` for Advanced
697+
Package Tool (APT). Interactive prompts cause the image build to fail. This guidance applies to all dependencies you
698+
add through the `Dockerfile`.
687699
688-
View the newly created file to ensure the instruction to install WireGuard is appended correctly.
700+
View the `Dockerfile` to ensure the instruction to install WireGuard is appended correctly.
689701
690702
```bash
691703
cat Dockerfile
692704
```
693705
694-
:::warning
695-
696-
Using the `-y` option with the `sudo zypper install` command is critical to successfully build the images. The
697-
default behavior for package installations is to prompt the user for permission to install the package. A user
698-
prompt will cause the image creation process to fail. This guidance applies to all dependencies you add through the
699-
`Dockerfile`.
700-
701-
:::
702-
703706
13. Issue the command below to save your tenant registration token to a local variable. Replace `[your_token_here]` with
704707
your actual registration token.
705708

0 commit comments

Comments
 (0)