Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Instructions to convert isle-dc to site template #2319

Merged
merged 8 commits into from
Aug 26, 2024
Next Next commit
updated layout of docker installion pages
  • Loading branch information
joshdentremont committed May 21, 2024
commit b913f82fed7abd1366cad6f155e7fbf2dcd34055
Original file line number Diff line number Diff line change
@@ -12,4 +12,4 @@ ISLE's architecture using [Docker](https://www.docker.com/) separates out the "s

ISLE is a suite of Docker containers that run the various components of Islandora: drupal, fedora, solr, alpaca, crayfish, matomo, etc. The individual containers are created (and automatically pushed to [Docker Hub](https://hub.docker.com/u/islandora)) by [ISLE BuildKit](https://github.com/Islandora-Devops/isle-buildkit).

In order to deploy the containers, however, you need to use a container orchestration tool. The ISLE project provides tools for running and maintaining the containers using docker-compose with [ISLE Docker Compose](https://github.com/Islandora-Devops/isle-dc).
In order to deploy the containers, however, you need to use a container orchestration tool. The ISLE project provides tools for running and maintaining the containers using docker-compose with [ISLE Docker Compose](https://github.com/Islandora-Devops/isle-dc) or [ISLE Site Template](https://github.com/Islandora-Devops/isle-site-template).
Original file line number Diff line number Diff line change
@@ -38,7 +38,7 @@ Docker Compose is a tool to simplify the process of running multiple Docker cont

### GNU Make

Make allows us to define commands that simplify installing and maintaining our Islandora site. For a complete list of available commands see the Makefile included with ISLE.
Make allows us to define commands that simplify installing and maintaining our Islandora site. For a complete list of available commands see the Makefile included with ISLE-DC.

### Composer

@@ -58,7 +58,6 @@ Drush is a command line tool for managing your Drupal site. It comes installed i
- Docker Compose version 2.x+
- GNU Make 4.0+
- Git 2.0+
- [ISLE Docker Compose](https://github.com/islandora-devops/isle-dc)
- At least 8GB of RAM (ideally 16GB)
- An administrator account your machine (a.k.a. the host machine)
- (Mac OS) Apple Developer Tools
@@ -89,11 +88,3 @@ If you need to install Docker, we recommend using the application [Docker Deskto
- Production or production-like development: 16GB

**Swap**: Swap space is space borrowed from your hard disk drive to serve as makeshift RAM as needed. If you cannot provide as much RAM as you would like, increase this as is reasonable given your free disk space.

## Installing ISLE Docker Compose

Use Git to install the ISLE Docker Compose tool:

`git clone https://github.com/islandora-devops/isle-dc`

Tagged versions are available [here](https://github.com/Islandora-Devops/isle-dc/tags).
File renamed without changes.
File renamed without changes.
Original file line number Diff line number Diff line change
@@ -4,6 +4,14 @@ When developing locally, your Drupal site resides in your `isle-dc/codebase` fol
Drupal container. This lets you update code using the IDE of your choice on your host machine, and the
changes are automatically reflected on the Drupal container.

## Installing ISLE Docker Compose

Use Git to install the ISLE Docker Compose tool:

`git clone https://github.com/islandora-devops/isle-dc`

Tagged versions are available [here](https://github.com/Islandora-Devops/isle-dc/tags).

## Getting Started

If you don't already have a Drupal site, you'll be given a basic setup using Drupal 9 and the
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
30 changes: 16 additions & 14 deletions mkdocs.yml
Original file line number Diff line number Diff line change
@@ -111,20 +111,22 @@ nav:
- '8.x-2.0 Release Notes': 'release-notes/8.x-2.0.md'
- 'Older Release Notes': 'https://github.com/Islandora/documentation/tree/main/docs/release_notes'
- 'Install a Demo': 'installation/install-a-demo.md'
- 'ISLE-DC':
- 'Introduction to ISLE': 'installation/docker-introduction.md'
- 'Prerequisites': 'installation/docker-prereq.md'
- Install Islandora:
- 'Installing a Development Server': 'installation/docker-local.md'
- 'Installing a Staging/Production Server': 'installation/docker-custom.md'
- Maintaining Islandora:
- 'Basic Usage': 'installation/docker-basic-usage.md'
- 'Maintaining Drupal': 'installation/docker-maintain-drupal.md'
- 'Maintaining ISLE': 'installation/docker-maintain-isle.md'
- 'Available Commands': 'installation/docker-available-commands.md'
- 'Available Configuration': 'installation/docker-available-configuration.md'
- 'Troubleshooting' : 'installation/docker-troubleshooting.md'
- 'ISLE Site Template': 'installation/site-template.md'
- 'Docker':
- 'Introduction to ISLE': 'installation/docker/docker-introduction.md'
- 'Prerequisites': 'installation/docker/docker-prereq.md'
- 'ISLE-DC':
- Installing:
- 'Installing a Development Server': 'installation/docker/isle-dc/docker-local.md'
- 'Installing a Staging/Production Server': 'installation/docker/isle-dc/docker-custom.md'
- Maintaining:
- 'Basic Usage': 'installation/docker/isle-dc/docker-basic-usage.md'
- 'Maintaining Drupal': 'installation/docker/isle-dc/docker-maintain-drupal.md'
- 'Maintaining ISLE': 'installation/docker/isle-dc/docker-maintain-isle.md'
- 'Available Commands': 'installation/docker/isle-dc/docker-available-commands.md'
- 'Available Configuration': 'installation/docker/isle-dc/docker-available-configuration.md'
- 'Troubleshooting' : 'installation/docker/isle-dc/docker-troubleshooting.md'
- 'ISLE Site Template':
- 'Introduction to Site Template': 'installation/docker/site-template/site-template.md'
- 'Ansible Playbook': 'installation/playbook.md'
- Manual Installation:
- 'Introduction': 'installation/manual/introduction.md'
Loading