Photon RPM OSTree: a simple guide

Contents

---

Preface

1. Introduction
   1.1 What is OSTree? How about RPM-OSTree?
   1.2 Why use RPM-OSTree in Photon?
   1.3 Photon with RPM-OSTree installation profiles
   1.4 Terminology
   1.5 Sample code
   1.6 How to read this book
   1.7 RPM-OSTree in Photon OS 2.0
2. Installing a Photon RPM-OSTree host against default server repository
   2.1 Who is this for?
   2.2 Installing the ISO, step by step
3. Concepts in action
   3.1 Querying the deployed filetrees
   3.2 Bootable filetree version
   3.3 Commit ID
   3.4 OSname
   3.5 Refspec
   3.6 Deployments
4. Querying for commit, file and package metadata
   4.1 Commit history
   4.2 Listing file mappings
   4.3 Listing configuration changes
   4.4 Listing packages
   4.5 Querying for package details
   4.6 Why am I unable to install, update or delete packages?
5. Host updating operations
   5.1 Is it an update or an upgrade?
   5.2 Incremental upgrade
   5.3 Listing file differences
   5.4 Listing package differences
   5.5 Rollback
   5.6 Deleting a deployed filetree
   5.7 Version skipping upgrade
   5.8 Tracking parent commits
   5.9 Resetting a branch to a previous commit
6. Installing a Photon RPM-OSTree server
7. Installing a Photon RPM-OStree host against a custom server repository
   7.1 Manual install of a custom host
   7.2 Automated install of a custom host via kickstart
8. File oriented server operations
   8.1 Starting a fresh OSTree repo
   8.2 Checking out a filetree
   8.3 Committing changes to a filetree
   8.4 Downloading the changes at the host
   8.5 Creating summary metadata
9. Package oriented server operations
   9.1 JSON configuration file
   9.2 Package addition, removal, upgrade
   9.3 RPMS repository
   9.4 Composing a tree
   9.5 Automatic version prefix
   9.6 Installing package updates
   9.7 Creating server metadata
   9.8 Starting a fresh OSTree repo
10. Remotes
    10.1 Listing remotes
    10.2 GPG signature verification
    10.3 Switching repositories
    10.4 Adding and removing remotes
    10.5 List available branches
11. Running container applications between bootable images
    11.1 Downloading a docker container appliance
    11.2 Rebooting into an existing image
    11.3 Reboot into a newly created image
12. Install or rebase to Photon OS 2.0
    12.1 Installing an RPM-OSTree server
    12.2 Installing an RPM-OSTree host
    12.3 Rebasing a host from Photon 1.0 to 2.0
    12.4 Creating a host raw image

Appendix A: Known issues

---

About the author
Danut Moraru is a Senior Software Design Engineer in the Photon OS Development team.

Next page >