Skip to main content

Onboarding Guide

This guide walks you through getting a Drupal project running on Skpr.

Work through the baseline steps first. They're required for a working deployment. The bonus step adds deeper insight once you're up and running.

Baseline

Complete these four steps to get your project deploying on Skpr.

1. Add Skpr project configuration

Add a .skpr directory to your project root. This holds the baseline configuration Skpr needs to build and run your site, including:

  • Routing rules
  • Cron tasks
  • Daemons

For a working reference, see the example Drupal project.

2. Make the code changes

Integrate your Drupal codebase with the Skpr runtime. You'll need to:

  • Wire the site up to the Skpr configuration system
  • Configure filesystem mount paths
  • Set Drupal's trusted host patterns
  • Configure the Drupal's reverse proxy detection
  • Add Drush aliases for the Skpr command line interface (CLI)

Full details are in the Drupal configuration guide.

3. Set up CI/CD

Skpr works with any continuous integration and continuous delivery (CI/CD) pipeline. We provide ready-to-use examples you can adapt:

4. Configure logging

Skpr collects logs from standard output (stdout). Install the Skpr Logs module so Drupal prints its logs to stdout for collection.

Bonus points

Application metrics

Expose your application's custom metrics for deeper insight into how it's running. See the metrics guide.

Next steps

When you're ready to launch, follow the go-live guide.