Use docker compose and not docker-compose.

Author: geerlingguy

.github/workflows/ci.yml

@@ -29,14 +29,14 @@ jobs:
       - name: Bring up the environment.
         run: |
           cp tests/docker-compose.yml ./docker-compose.yml
-          docker-compose up -d
+          docker compose up -d
           while ! mysqladmin ping -h127.0.0.1 -u drupal -pdrupal --silent; do
             sleep 1
           done
 
       - name: Install Drupal.
         run: >
-          docker-compose exec -T drupal bash -c
+          docker compose exec -T drupal bash -c
           'drush site:install minimal
           --db-url="mysql://drupal:$DRUPAL_DATABASE_PASSWORD@$DRUPAL_DATABASE_HOST/drupal"
           --site-name="Drupal Example Site for Kubernetes"

README.md

@@ -21,19 +21,19 @@ Please read through the [project documentation](docs/README.md) for details abou
   1. Run the local development environment:
 
      ```
-     docker-compose up -d
+     docker compose up -d
      ```
 
-     (Wait for the environment to come up—you can monitor the logs with `docker-compose logs -f`).
+     (Wait for the environment to come up—you can monitor the logs with `docker compose logs -f`).
 
   1. Once the container is running, install Dependencies and install Drupal. You can either access http://localhost/ and install using the UI, or install via Drush:
 
      ```
      # Install dependencies.
-     docker-compose exec drupal composer install
+     docker compose exec drupal composer install
 
      # Install Drupal.
-     docker-compose exec drupal bash -c 'drush site:install minimal --db-url="mysql://drupal:$DRUPAL_DATABASE_PASSWORD@$DRUPAL_DATABASE_HOST/drupal" --site-name="Drupal Example Site for Kubernetes" --existing-config -y'
+     docker compose exec drupal bash -c 'drush site:install minimal --db-url="mysql://drupal:$DRUPAL_DATABASE_PASSWORD@$DRUPAL_DATABASE_HOST/drupal" --site-name="Drupal Example Site for Kubernetes" --existing-config -y'
      ```
 
   1. Visit http://localhost/ in your browser, and login as `admin` using the password Drush printed in the 'Installation complete' message.
@@ -44,24 +44,24 @@ Please read through the [project documentation](docs/README.md) for details abou
 
 After making any configuration changes on the website, you can export the configuration to disk so it can be preserved in the codebase and deployed to the production site:
 
-    docker-compose exec drupal bash -c 'drush config:export -y'
+    docker compose exec drupal bash -c 'drush config:export -y'
 
 For more on the way this project's configuration changes are handled, and the general site development process, see the [project documentation](docs/README.md).
 
 ### Exporting Content
 
 After making any content changes on the website, you can export the changes to disk so it is preserved in the codebase and installable on the production site:
 
-    docker-compose exec drupal bash -c 'drush dcer --folder=modules/custom/pidramble_default_content/content/ node 1'
+    docker compose exec drupal bash -c 'drush dcer --folder=modules/custom/pidramble_default_content/content/ node 1'
 
 For more on the way this project's content changes are handled, see the [pidramble_default_content README](web/modules/custom/pidramble_default_content/README.md).
 
 ### Upgrading Core (and Contrib)
 
   1. Set up the site like normal, make sure it's installed.
-  2. Run `docker-compose exec drupal composer update` (to update everything).
-  3. Run `docker-compose exec drupal bash -c 'drush updb -y'`
-  4. Run `docker-compose exec drupal bash -c 'drush config:export -y'`
+  2. Run `docker compose exec drupal composer update` (to update everything).
+  3. Run `docker compose exec drupal bash -c 'drush updb -y'`
+  4. Run `docker compose exec drupal bash -c 'drush config:export -y'`
   5. Commit any changes and push them.
 
 ## License

docs/add-custom-theme.md

@@ -22,7 +22,7 @@ However, you need to remember to _export the site's configuration_ now, so the t
   1. Run the command:
 
      ```
-     docker-compose exec drupal bash -c 'drush config:export -y'
+     docker compose exec drupal bash -c 'drush config:export -y'
      ```
 
   1. Commit the changed configuration to Git:

docs/configure-and-reproduce.md

@@ -6,11 +6,11 @@ For Drupal 8+, that means using _configuration_ to synchronize changes between a
 
 Before we can start doing this work, we need to make sure we have our local environment set up to allow us to work in the Docker environment, but also have our codebase changes reflected locally (outside of the running Docker container), so we can commit any changes to our Git codebase.
 
-## Local Development with `docker-compose`
+## Local Development with `docker compose`
 
 The first step is to modify the `docker-compose.yml` file so it has a `volume` which shares the local codebase into the Drupal container:
 
-  1. If you already have the Docker environment running from the previous guide, make sure it is completely removed using `docker-compose down -v`.
+  1. If you already have the Docker environment running from the previous guide, make sure it is completely removed using `docker compose down -v`.
   1. Since we'll be using the local codebase to drive the Drupal site (instead of the Drupal codebase only available inside the Drupal container), we need to install Composer dependencies locally:
 
      ```
@@ -22,7 +22,7 @@ The first step is to modify the `docker-compose.yml` file so it has a `volume` w
   1. Start the local development environment:
 
      ```
-     docker-compose up -d
+     docker compose up -d
      ```
 
   1. Install Drupal using the same Drush command used in the previous guide, [Starting a new Drupal Project](starting-new-project.md).
@@ -52,15 +52,15 @@ So let's do something I do for all my Drupal sites: install the [Admin Toolbar](
   1. Now run the following command to tell Drupal to dump its current configuration into the 'config sync' directory:
 
      ```
-     docker-compose exec drupal bash -c 'drush config:export -y'
+     docker compose exec drupal bash -c 'drush config:export -y'
      ```
 
   1. If you look inside the `config/sync` folder you should now see lots of YAML files (ending with `.yml`), containing all the details of your Drupal site's configuration.
   1. Now is where this gets interesting; let's say you then make some other changes to your site configuration, but you want to ditch them because you weren't happy with them. For example, go to the Basic site settings page (`/admin/config/system/site-information`) and change the Slogan to "The best website ever" and save it.
   1. You can now _reinstall_ the site from scratch, but using the configuration you previously exported (so it will have the Admin Toolbar module and everything else, but not this silly slogan you don't like), by adding the flag `--existing-config` to the install command:
 
      ```
-     docker-compose exec drupal bash -c 'drush site:install minimal --db-url="mysql://drupal:$DRUPAL_DATABASE_PASSWORD@$DRUPAL_DATABASE_HOST/drupal" --site-name="My Drupal Site" --existing-config -y'
+     docker compose exec drupal bash -c 'drush site:install minimal --db-url="mysql://drupal:$DRUPAL_DATABASE_PASSWORD@$DRUPAL_DATABASE_HOST/drupal" --site-name="My Drupal Site" --existing-config -y'
      ```
 
   1. A minute or so later, if you log into the site using the `admin` user and the new password Drush prints to the command line, you'll see that the Slogan was reverted to being blank, as it was before you changed it.

docs/create-default-content.md

@@ -49,7 +49,7 @@ Anyways, let's get started with Default Content:
   1. Once you're satisfied things worked correctly, go ahead and export the site configuration so the Default Content module and your site's default content module are enabled:
 
      ```
-     docker-compose exec drupal bash -c 'drush config:export -y'
+     docker compose exec drupal bash -c 'drush config:export -y'
      ```
 
   1. Reinstall Drupal from scratch, and you _should_ see that not only is the Drupal site back the same way you had configured it, there are also entities that are recreated after an install which should be helpful for local development and theming.

docs/starting-new-project.md

@@ -37,15 +37,15 @@ Part of the purpose of this project is to outline the exact steps required to bu
   1. Verify you can run the site in the container image locally:
 
      ```
-     docker-compose up -d
+     docker compose up -d
      ```
 
-     (Wait for the environment to come up—you can monitor the logs with `docker-compose logs -f`).
+     (Wait for the environment to come up—you can monitor the logs with `docker compose logs -f`).
 
   1. Once the container is running, you need to install Drupal. You can either access http://localhost/ and install using the UI, or install via Drush:
 
      ```
-     docker-compose exec drupal bash -c 'drush site:install minimal --db-url="mysql://drupal:$DRUPAL_DATABASE_PASSWORD@$DRUPAL_DATABASE_HOST/drupal" --site-name="My Drupal Site" -y'
+     docker compose exec drupal bash -c 'drush site:install minimal --db-url="mysql://drupal:$DRUPAL_DATABASE_PASSWORD@$DRUPAL_DATABASE_HOST/drupal" --site-name="My Drupal Site" -y'
      ```
 
   1. Visit http://localhost/ in your browser, and login as `admin` using the password Drush printed in the 'Installation complete' message.