How-to guides

• Run workloads with a machine charm
• Run workloads with a Kubernetes charm
  • Set up the workload container
  • Control and monitor services in the workload container
  • Perform health checks on the workload container
  • Manage files in the workload container
  • Run commands on the workload container
  • Use custom notices from the workload container
• Manage logs
• Manage storage
  • Implement the feature
• Manage resources
  • Implement the feature
• Manage actions
  • Implement the feature
• Manage configurations
  • Implement the feature
• Manage relations
  • Implement the feature
  • Test the feature
• Manage leadership changes
  • Implement response to leadership changes
  • Write integration tests
• Manage libraries
  • Use a library
  • Write a library
  • Write tests
• Manage interfaces
  • Register an interface
  • Write tests for an interface
• Manage secrets
  • Secret owner charm
  • Secret observer charm
• Manage stored state
  • Storing state for the lifetime of the charm container or machine
  • Storing state for the lifetime of the application
• Manage opened ports
  • Implement the feature
  • Test the feature
• Manage the charm version
  • Implement the feature
  • Test the feature
• Manage the workload version
  • Implement the feature
• Write unit tests for a charm
  • Setting up your environment
  • Creating the charm and test files
  • Writing a test
  • Mocking beyond the State
• Write integration tests for a charm
  • Prepare your environment
  • Prepare the tox.ini configuration file
  • Create a test file
  • Build your tests
  • Run your tests
  • Generate crash dumps
• Legacy how-to guides
  • Write legacy unit tests for a charm
  • Turn a hooks-based charm into an ops charm