Tutorials

Tutorials here are focused on In-Place Upgrades with leapp repositories covered by the leapp-repository project. Therefore the main focus of these tutorials is to provide information how to write leapp actors for In-Place Upgrades (IPU) with the leapp framework.

Note

These tutorials are under reconstruction and we will be glad for a feedback. Feel free to contact us via GH discussion in our upstream project.

Contents:

• How to setup the development environment
  • Clone official leapp repositories for IPU
  • Install snactor
  • Register IPU repositories in snactor
• How to write an Actor for Leapp Upgrade
  • Create the first actor for IPU
    • Most common phases for actors
  • Formulate Your Requirements
  • Scout the Environment
  • Determine Implementation Details
  • Where to Place Your Actors
• Running a single Actor
  • Running a single actor with minimal context
    • Initial configuration
    • Resolving actor’s message dependencies
    • Limitations
  • Run single actor with existing database
    • Limitations
• How to create custom content for IPU
  • Create custom repository
  • Create custom actor
  • Naming convention
• Creating configurable actors
  • Declaring your configuration
  • Accessing configuration values
  • Providing actors with configuration
• Templates
  • Install a kernel driver during the upgrade
  • Execute custom script during the upgrade
• Troubleshooting and Debugging
  • Debug logs
  • Troubleshooting with leapp-inspector
    • Usage
      • Inspect Specific Execution
  • Debugging Code
  • Inspecting the Target Userspace Container During an Upgrade
  • Debugging Inside Initramfs
• Dealing with dependencies
  • Packaging and dependencies in leapp-repository
    • Deps packages replacement
  • What to do in leapp-repository when dependencies of leapp change?
  • What to do when leapp-repository dependencies need to change?