ScyllaDB University Live | Free Virtual Training Event
Learn more
ScyllaDB Documentation Logo Documentation
  • Server
  • Cloud
  • Tools
    • ScyllaDB Manager
    • ScyllaDB Monitoring Stack
    • ScyllaDB Operator
  • Drivers
    • CQL Drivers
    • DynamoDB Drivers
  • Resources
    • ScyllaDB University
    • Community Forum
    • Tutorials
Download
ScyllaDB Docs ScyllaDB Sphinx Theme Deployment Pull requests previews

Caution

You're viewing documentation for a previous version of ScyllaDB Sphinx Theme. Switch to the latest stable version.

Pull requests previews¶

Warning

This feature is under beta testing and only available for a selected number of projects.

We use AWS Amplify to build a preview site for the docs every time someone sends a pull request that updates the docs folder.

Once the build completes, the pull request receives a message with a link to preview the docs.

../_images/amplify-message.png

On this page, you will learn how to enable pull request previews in a repository with the toolchain installed.

Installation¶

  1. Copy the file amplify.yml in the project root directory.

  2. Commit and push the changes to GitHub (default branch).

    Note

    To complete the installation, we must list the repository in the company’s AWS account. Contact us in Slack (#scylla-docs channel) to set this configuration for you.

Enable previews¶

Instructions to enable previews on AWS:

Step 1: Access AWS Amplify¶

  1. In the company’s AWS account, search for AWS Amplify in the search console.

    ../_images/amplify-search.png
  2. Do one of the following:

    • If you are at the AWS Amplify homepage, click on Get Started under AWS Amplify Hosting.

      ../_images/amplify-get-started.png
    • Otherwise, click on New App > Host Web App.

      ../_images/amplify-app.png
  3. Select Import from GitHub. You might be asked to grant permissions to AWS Amplify in your GitHub account.

    ../_images/amplify-github.png
  4. Choose Continue.

Step 2: Connect a repository¶

../_images/amplify-branch.png
  1. Find the repository you want to enable pull request previews.

  2. Set the default branch (e.g. master).

  3. Check Connecting to a monorepo? and pick the folder docs.

  4. Choose Next.

Step 3: Configure build settings¶

../_images/amplify-build.png

On this page, you should verify that the amplify.yml file was imported successfully.

Under Build and test settings, you should see the message “We detected amplify.yml in your repository and will use it to deploy your app.”. If it is not the case, review Installation.

Once the file is imported automatically, choose Next. On the Review page, choose Save and deploy.

Step 4: Enable pull request previews¶

  1. On the left sidebar, go to Previews page and choose Preview Settings.

    ../_images/amplify-preview-settings.png
  2. Select the default branch from the list and choose Manage.

    ../_images/amplify-preview-manage.png
  3. Turn on pull request previews.

    ../_images/amplify-preview-enable.png

The next time you submit a pull request for the branch, AWS Amplify will build the docs automatically and share a preview URL as a pull request comment.

Blocking a user from triggering previews¶

Code owners and third-party contributors can build pull request previews. To ban abusive users, see Blocking a user from your organization.

Limitations¶

  • Previews builds have a 15 min limit. Nevertheless, we recommend you make sure the command make dirhtml does not take more than 3 minutes to build on average.

  • If your repository is private, all the pull requests previews will be publicly available by default.

  • AWS Amplify only builds previews if the docs folder receives an update.

  • AWS deletes previews when the pull requets gets merged or closed.

Was this page helpful?

PREVIOUS
Production deployment
NEXT
Examples
  • Create an issue
  • Edit this page

On this page

  • Pull requests previews
    • Installation
    • Enable previews
      • Step 1: Access AWS Amplify
      • Step 2: Connect a repository
      • Step 3: Configure build settings
      • Step 4: Enable pull request previews
    • Blocking a user from triggering previews
    • Limitations
ScyllaDB Sphinx Theme
  • 1.2
    • 1.8
    • 1.7
    • 1.6
    • 1.5
    • 1.4
    • 1.3
    • 1.2
    • 1.1
  • Getting started
    • Toolchain
    • Installation
  • Configuration
    • Template options
    • Page options
    • Multiversion options
    • Markdown support
    • Redirections support
    • Search support
    • Troubleshooting
  • Commands
  • Deployment
    • Production deployment
    • Pull requests previews
  • Examples
    • Admonitions
    • Collapse
    • Code blocks
    • Glossary
    • Headings
    • Hero box
    • Includes
    • Images
    • Links
    • Lists
    • Panel box
    • Substitutions
    • Tables
    • Tabs
    • Text
    • TOC
    • Topic box
    • Versions
  • Upgrade guides
    • Migrating from 1.1 to 1.2
    • Migrating from 1.0 to 1.1
    • Migrating from 0.x to 1.0
    • Changelog
  • Contribute
    • Contribute to the documentation
    • Contribute to the theme
    • Source Code
Docs Tutorials University Contact Us About Us
© 2025 ScyllaDB | Terms of Service | Privacy Policy | ScyllaDB, and ScyllaDB Cloud, are registered trademarks of ScyllaDB, Inc.
Last updated on 09 May 2025.
Powered by Sphinx 7.4.7 & ScyllaDB Theme 1.8.6
Ask AI