Anyone can install this website locally even without being involved in DrupalCampNYC, but the website will have no content and the frontpage will point to a nonexistent page node until you create content and change the frontpage configuration.
drupalcamp.nyc is hosted on Amazee. You need to be a member of the DrupalCampNYC site's "Team" to be able to:
- Make a manual backup of the site
- Download a copy of the site's database and/or files (sites/default/files)
Our canonical git repository is on GitHub. You need to be a member of the GitHub Drupal-NYC organization's DrupalCamp team (link only works if you are a member) in order to:
- Push changes to the master branch
- Approve pull requests
Our .gitignore file is constructed to prevent "built" files such as those managed by Composer (e.g. Drupal core, contrib modules, and the vendor directory) or other package managers and build tools (e.g. theme dependencies and theme assets) from being added to the repository.
When changes are pushed to or merged into the master branch on GitHub, a build should be triggered on Amazee's Lagoon system. You need to be a member of the DrupalCampNYC site's "Team" to: view the status of builds, but status messages about builds are also posted in the #hosting channel of DrupalNYC Slack.
Note that the git repo already has a .ddev
directory so you only need DDEV installed locally to get started.
-
Follow the instructions for your operating system to setup DDEV on your local machine
-
Create a directory to contain the site (e.g.
mkdir ~/Sites/drupalcampnyc
). To avoid file permission issues, it is strongly recommended that this directory be located within your home folder. -
Change to that directory (e.g.
cd ~/Sites/drupalcampnyc
) -
If you have your local SSH public key added to your GitHub account (recommended), clone the repository using:
git clone [email protected]:Drupal-NYC/drupalcampnyc.git .
Otherwise, clone using HTTPS:
git clone https://github.com/Drupal-NYC/drupalcampnyc.git .
-
Start the project by first starting up your docker system, if needed for your OS, and then
ddev start
. -
Get dependencies by running
ddev rebuild
Note the following commands are run inside the container:composer install
for the projectnpm install
in web/themes/drupalnycnpm run build
in web/themes/drupalnyc to compile the theme
ddev rebuild
is defined in .ddev/commands/web/rebuild
-
For a fresh Drupal installation that takes advantage of all the configuration that has already been done, install from config:
ddev drush si minimal --existing-config
Note: installing from config can easily take 10 minutes to complete.
If you are a member of DrupalCampNYC site's "Team", you probably instead want to "Refresh from Amazee Lagoon" per the next section.
If you haven't already, forward your ssh keys into the container using ddev auth ssh
.
To replace your local environment's database and files with that of our Live environment: ddev update
ddev update
is defined in .ddev/commands/host/update and runs the following commands so that you don't have to run them individually.
drush rsync @lagoon.main:%files @self:%files
drush sql-sync @lagoon.main @self
drush deploy
Note that this will overwrite your local database and files without prompt. The drush deploy
ensures that your local environment uses the development-specific configuration.
You now have a fully functional local environment, accessible at https://drupalcampnyc.lndo.site/
If you find that you can see the site, but the theme was not applied, check out your error/warning messages in the console. You may be asked to install a module called optipng. Use this command to install it: npm install --save optipng-bin
This is the production environment. The main
branch is deployed here.
A staging environment that deploys the test
branch.
A PR to either of main
or test
will spin up a temporary environment with the result of
the PR deployed as the code. We are allowed up to 3 of these temporary environments.
git push
as normal.
The following commands must be run with their ddev prefix so that they are run inside the Lando container.
Composer: ddev composer <command>
Drush: ddev drush <command>
XDebug debugging is disabled for performance reasons. ddev xdebug on
will enable Xdebug.
You should run composer inside the DDEV container by using ddev composer
instead of composer
.
If you prefer to run composer on the host (and use composer
) rather than have to use ddev composer
, you must
have the same version of PHP as that used in the container.
Lando's Performance documentation explains further.
We use Drupal's core-composer-scaffold to place and manage files provided by Drupal core or Pantheon.
This guide will describe how you can use traditional Drupal hosting, Tome Static, and Netlify to have a normal content editing experience while still running static html on your public-facing site.
First, you'll need to create a local development environment. For this demo, I'll use Lando since it's the local dev environment for the DrupalCampNYC site.
(Run lando start
on WSL2.)
Assuming you have your local Drupal 8 up and running, run this command from where your site's "composer.json" file lives: "composer require drupal/tome drupal/tome_netlify".
Edit your site "settings.php" file and set the "tome_static_directory" setting to a writeable directory on your hosting provider.
Tome documentation recommends adding the following block of code for sites hosted on Pantheon:
if (isset($_ENV['PANTHEON_ENVIRONMENT'])) {
$settings['tome_static_directory'] = 'sites/default/files/private/tome_static';
}
However, we want the ability to export directly from Lando, so we won't even check the Pantheon environment variable:
// Configure Tome Static directory for Tome Netlify.
$settings['tome_static_directory'] = 'sites/default/files/private/tome_static';
The rest of the instructions are quoted verbatim from Tome documentation:
Commit the changes and push to your remote repository if you're using version control.
Create a Netlify account at https://app.netlify.com/signup
Login to your Drupal site as an administrator. Ensure you are using the HTTPS URL of your Drupal site, as Netlify pushes will fail when using HTTP.
Enable Tome Static and Tome Netlify at /admin/modules. You're enabling Tome Static and not Tome since you don't need any of the "store your content in Git" features that Tome Sync provides.
Visit
/admin/config/tome/static/generate
and generate your first static site.Visit
/admin/config/tome/static/download
and download the static build. Extract the generated .tar.gz file.Visit https://app.netlify.com/account/sites and drag+drop your static build folder to the dropzone at the bottom of the screen. This will create a new Netlify site that isn't tracked in Git.
Click into your new site in the Netlify UI, then click "Settings". Copy your site-specific "API ID" from there.
Visit https://app.netlify.com/account/applications and generate a new personal access token. Copy your token as it can not be retrieved after viewing it the first time.
Visit
/admin/config/services/tome_netlify/settings
and enter your token and site ID, then save the form.Visit
/admin/config/tome/netlify/send
and click Deploy.Wait a few minutes after a deploy is complete for Netlify to pick up the new build, then preview it using the link provided. Builds sent to Netlify only include files that have changed since the last build, which should make them super-duper fast.
When satisfied with the deploy, publish the draft on Netlify at "Deploys" when viewing your site in the UI.
You're done!
While this guide may seem daunting, I think this hosting setup is the most reasonable for Drupal users who don't want to change the way content editors use Drupal, but still want to run a static site on the frontend.
We are grateful to Drupal Europe 2018 for providing their codebase, which we adopted and improved upon.
To collaborate in real-time, please join us in the #camp-website channel of DrupalNYC Slack.
To collaborate with us and other camps on a shared codebase for future camps, please join us in the #event-website-starterkit channel of the Drupal Event Organizers Slack.
We encourage merge requests.