6
0
mirror of https://github.com/ChristianLight/tutor.git synced 2024-11-19 19:45:25 +00:00
tutor/docs/tutorials
Régis Behmo 18ce1f2fe4 feat: persistent bind-mounts
This is an important change, where we get remove the previous `--mount`
option, and instead opt for persistent bind-mounts.

Persistent bind mounts have several advantages:
- They make it easier to remember which folders need to be bind-mounted.
- Code is *much* less clunky, as we no longer need to generate temporary
  docker-compose files.
- They allow us to bind-mount host directories *at build time* using the
  buildx `--build-context` option.
- The transition from development to production becomes much easier, as
  images will automatically be built using the host repo.

The only drawback is that persistent bind-mounts are slightly less
portable: when a config.yml file is moved to a different folder, many
things will break if the repo is not checked out in the same path.

For instance, this is how to start working on a local fork of
edx-platform:

    tutor config save --append MOUNTS=/path/to/edx-platform

And that's all there is to it. No, this fork will be used whenever we
run:

    tutor images build openedx
    tutor local start
    tutor dev start

This change is made possible by huge improvements in the build time
performance. These improvements make it convenient to re-build Docker
images often.

Related issues:
https://github.com/openedx/wg-developer-experience/issues/71
https://github.com/openedx/wg-developer-experience/issues/66
https://github.com/openedx/wg-developer-experience/issues/166
2023-06-14 21:08:49 +02:00
..
arm64.rst feat: persistent bind-mounts 2023-06-14 21:08:49 +02:00
datamigration.rst docs: specify root username in mysql dump instructions 2022-05-20 07:43:56 +02:00
edx-platform-settings.rst depr: drop the possibility of overriding edx-platform settings 2022-04-15 15:37:56 +02:00
google-smtp.rst feat: deprecate "quickstart" and rename to "launch" 2022-09-30 12:05:35 +02:00
index.rst docs: move forum to discuss.openedx.org 2022-05-23 09:48:19 +02:00
multiplatforms.rst minor typos fixed 2022-03-29 08:44:33 +02:00
nightly.rst Merge branch 'master' into nightly 2022-11-24 17:27:47 +01:00
oldreleases.rst feat: deprecate "quickstart" and rename to "launch" 2022-09-30 12:05:35 +02:00
plugin.rst docs: fix ENV_PATCHES example 2023-05-16 12:03:38 +02:00
podman.rst docs: update the Podman instructions 2023-01-06 17:46:33 +01:00
portainer.rst feat: upgrade to Maple 2021-12-20 21:21:36 +01:00
proxy.rst docs: adjust web proxy tutorial 2022-11-29 09:49:57 +01:00
scale.rst minor typos fixed 2022-03-29 08:44:33 +02:00
theming.rst feat: pluggable local/dev/k8s do <job> commands 2022-11-15 09:46:08 +01:00