Skip to main content

Deploy with an agent

Copy agent prompt

Before you start

Connect your AWS account using the Spring Winter quickstart. You need mySQL 8 and durable content storage. Check the upstream deployment instructions and pin a release before you deploy. Source repository.

Create and connect the database

  1. Create a private SQL database with MySQL 8. If you already have a database for this deployment, verify that the engine and version match the pinned app release. Wait for the database to be ready.
  2. Open Connect on the database. Use the writer endpoint, port, database name and application credentials. Create the application database and role if needed. Confirm that the application and migration process can reach the private writer.
  3. Set database__client=mysql and the database__connection__host, database__connection__port, database__connection__user, database__connection__password and database__connection__database values. Configure durable content storage before startup. Put secret values in runtime configuration or the migration process’s secret store.
  4. Start Ghost and let it initialize its database. Open the admin setup once it is healthy.

Configure the deployment

  1. Select a Spring Winter project in the AWS Region you want to use. Confirm where persistent or non-HTTP components will run before creating resources.
  2. Use the upstream Ghost image on port 2368 with the url runtime setting and the production MySQL connection settings from the release.
  3. Plan durable content storage for media and themes.
  4. On Spring Winter task compute, use a validated storage adapter and a strategy for the remaining content files or choose a persistent host.
  5. Configure email separately if you enable memberships or newsletters.
When you run the HTTP app on Spring Winter, set a health path that returns HTTP 200 without signing in. Use Runtime variables for runtime configuration. Task storage is temporary. Verify that every file you need after replacement goes to durable storage.

Verify the deployment

Check the deployment in History if you created Spring Winter compute. Wait for the workflow to succeed, then test the application over HTTPS. Publish a test post with an image and load both from the canonical HTTPS URL after replacement.