https://github.com/openshift/pivot
Pivots from on ostree OS/Deployment to another via containers
https://github.com/openshift/pivot
ostree pivot update
Last synced: about 1 year ago
JSON representation
Pivots from on ostree OS/Deployment to another via containers
- Host: GitHub
- URL: https://github.com/openshift/pivot
- Owner: openshift
- License: apache-2.0
- Created: 2018-06-11T19:29:41.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2019-12-18T21:57:10.000Z (over 6 years ago)
- Last Synced: 2024-06-20T10:08:21.855Z (almost 2 years ago)
- Topics: ostree, pivot, update
- Language: Go
- Homepage:
- Size: 279 KB
- Stars: 12
- Watchers: 17
- Forks: 13
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
pivot ➰
========
**Deprecated**: Please see [machine-config-operator](https://github.com/openshift/machine-config-operator/tree/master/pkg/daemon/pivot).
[](https://travis-ci.org/openshift/pivot/)
`pivot` provides a simple command allowing you to upgrade an
OSTree-based system from an OSTree repo embedded within a container
image. Such container images are generated by the
`coreos-assembler oscontainer` command.
It works by (1) downloading the oscontainer, (2) mounting it using
`podman mount`, (3) looking for the OSTree commit stored inside the
container, and (4) invoking rpm-ostree to rebase the OS to that commit.
It's not intended to be run manually, but rather as part of the
installation and upgrade process of a cluster. Though one can certainly
test it today by provisioning an RHCOS node and running it directly (see
[the internal guide](https://url.corp.redhat.com/redhat-coreos) and
[release page](https://url.corp.redhat.com/redhat-coreos-releases)) for
more information).
Building
--------
```
make build
```
OR
```
make static
```
Example Usage
-------------
```
pivot -r $REGISTRY/os:latest
```
Though normally, one wants to use digests rather than tags, e.g.:
```
pivot -r $REGISTRY/os@sha256:fdf70521df4ed1dc135d81fd3c4608574aeca45dc22d1b4e38d16630e9d6f1a7
```
It also comes with a systemd unit to provide a "host API". For example:
```
mkdir -p /etc/pivot
echo $REGISTRY/os:latest > /etc/pivot/image-pullspec
touch /run/pivot/reboot-needed
systemctl start pivot
```
This will start `pivot`, which will read the file and execute the pivot.
If the pivot is completed, the file will be deleted. The expected way to
make use of this is to create the necessary files from Ignition.
See
---
- [openshift/os](https://github.com/openshift/os/)
- [openshift/installer](https://github.com/openshift/installer)
- [openshift/machine-config-operator](https://github.com/openshift/machine-config-operator)
- [coreos/coreos-assembler](https://github.com/coreos/coreos-assembler)