How-to guides

The following guides provide comprehensive, step-by-step instructions for the common tasks related to the 12-factor tooling, from working with the relevant products to contributing.

Manage a 12-factor app rock

The Rockcraft documentation contains a set of how-to guides for managing a 12-factor app container image.

• Manage a 12-Factor app rock

  • Set up a 12-Factor app rock: Initialize and configure a rock using the 12-factor extensions.

  • Use a 12-Factor app rock: Learn about the various ways you can use and update your rock.

Manage a 12-factor app charm

The Charmcraft documentation contains a set of how-to guides for initializing, configuring, integrating, and using a 12-factor app charm.

• Manage a 12-factor app charm:

  • Initialization

  • Configuration: The 12-factor tooling includes different ways you can customize to fit your use case. These guides provide instructions on tasks like adding configurations, actions, and managing secrets.

  • Relations: The tooling provides you the ability to integrate with preexisting charms in the Juju ecosystem. These guides get you started with three commonly used relations: databases, ingress, and observability.

  • Usage: Learn more about tasks such as migrations and troubleshooting.

Contribute to the project

Below are step-by-step instructions for developing and contributing to the 12-factor app project.

• Add a new framework: A guide that details the process for contributing to the 12-factor project, Rockcraft, and Charmcraft.

• Contribute: Recommended processes and practices for contributing enhancements to the 12-factor project

• Upgrade: Information for upgrading your 12-factor app rock, deployed charm, or paas-charm version.