Document how to update

[rosiel]

Docker makes updating easy, right? Is it so easy that we can provide instructions in the islandora "throw up the simplest isle sandbox with docker" documentation so that someone who's started working on their Islandora sandbox (we're talking the real basic one here) can successfully:

• update their drupal, modules, and themes (related: 403 error when installing updates or themes #108)
• update other non-islandora-provided containers (traefik, watchtower)
• update other islandora-provided containers (from the namespaces in the docker desktop, this includes drupal, matomo, fcrepo, crayfits, cantaloupe, gemini, houdini, recast, solr, mariadb, alpaca, homarus, hypercube, blazegraph, fits, milliner, activemq)

without destroying their added content?

[rosiel]

Here are some rough comments regarding updating "the whole dang thing at the isle-dc" level, from a conversation with @dannylamb. I'm taking it out of the initial "docker documentation" pr because it's too incomplete.

If you're not doing "anything special" and want new stuff, type docker-compose pull, docker-compose up -dyou don't even have to take things down. (Does this apply regardless of whether you didmakeormake dev`?

If you have your own stuff, do that but also 'make a new drupal container' - that's what isle-dc will turn into... when you have a site and you export "the tree" i.e. all the files starting where your composer file is, e.g. /var/www/html/drupal - put that in a folder in your codebase, then when you type make it uses that exported drupal site as your container. There are some subtleties if you have to change crayfish or alpaca.

To add a new module, go into your codebase folder, use composer to require the module, then "make a new container out of all of this". (This requires composer installed on your host, right? is there a specific version we need?)

[rosiel]

(notes to whoever documents this ticket) I found that if I had already done make dev and wanted to completely re-install islandora, i.e. i'd done some weird stuff in my Drupal and I wanted a "clean reset to stock isle", then I had to

docker-compose down -v
git pull # or checkout a different branch
sudo rm -rf codebase
make dev
# say [yes] to replacing the .yml files in my export directory sites/default/files/config_LTXMp_pilLcNsr--Umu2l4pmNFJHOD4rWMYdO39mqz9SrOQWKemKBrXRTWusz75l4MMBSX32og/sync
# Enter my root password when removing volume isle-dc_solr-data
# wait a bunch...

TBC when/if this completes.

[rosiel]

to this, I'm adding that when @dannylamb and I went through "setting up a site from a composer.json file", we:

• make dev (this failed)
• checked that the codebase folder included composer.json
• went into the codebase folder and deleted everything except composer.json. required sudo.
• docker-compose down -v just to make sure
• vim the .env file and set ENVIRONMENT=local
• from within the codebase folder, composer install
• cd .. into the main folder then make set-codebase-owner
• this takes a while.
• docker-compose up -d
• make install
  then there's a thing at islandora.traefik.me