Manage a 12-factor app charm

These guides walk you through all ways you can manage 12-factor app charms, from initialization to usage.

Extensions add customized elements to a charm for specific web app frameworks. While the overall basic logic is the same as managing a charm, the following guides are about the 12-factor app charm workflow.

Initialization

You will need a rock for your 12-factor app charm. Prepare a 12-factor app rock with Rockcraft.

Once you have a rock, use charmcraft init and specify the relevant profile:

DjangoExpressFastAPIFlaskGo

charmcraft init --profile django-framework

Charmcraft automatically creates a charmcraft.yaml project file, a requirements.txt file and source code for the charm in your current directory. You will need to check the project file and README.md to verify that the charm’s name and description are correct.

Configuration

Once your 12-factor app charm has been set up, you can customize many aspects of it using Juju.

• Configure your 12-factor app charm
  • Add a new configuration
  • Add a custom action
  • Manage secrets
  • Write a Kubernetes charm for an async Flask app

Integration

Once deployed, your 12-factor app can be integrated into nearly anything in the Juju ecosystem.

• Integrate your 12-factor app charm
  • Integrate with a database
  • Integrate with ingress
  • Integrate with observability

Usage

Now that you’ve initialized and configured your 12-factor app charm, you’re ready to use it.

• Use your 12-factor app charm
  • Create an admin user for a Django app charm
  • Migrate the workload database
  • Troubleshoot the charm
  • Use observability