Skip to content

jlebon/atomic-devmode

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Atomic Developer Mode

This package provides a developer-friendly way to use an Atomic Host locally without having to manually set up a cloud-init source. It's a great way to try out Atomic with the minimum amount of fuss.

The package provides a new GRUB 2 menu item which, if booted, sets up cloud-init to use a local datasource, creates a new root password, sets up autologin for root on tty1, and starts a new interactive tmux session in which the cockpit image is downloaded and started.

It is meant to be included in the initial tree installed by the %ostreesetup kickstart command. The kickstart should then (in its %post) call bootentry add in order to have the GRUB 2 menu item created.

Trying it out

Images built with this package can be found here. You can also build the package and compose your own tree on which to rebase. See HACKING.md for more details.

GRUB 2 timeout

To give users more time to make their selection, the GRUB 2 timeout is increased from 1s to 2s. However, the timeout will be restored to 1s the next time grub.cfg is regenerated (e.g. during an upgrade/rebase/rollback or from an explicit grub2-mkconfig -o /boot/loader/grub.cfg).

Root account

A systemd configuration override file is used to make the getty service on tty1 to autologin as root. A password is auto-generated using pwmake, making sure that it contains only friendly characters that are less prone to typos (see them here).

Tmux

To provide a more tailored experience, tmux is used to set up the Atomic Developer Mode environment. A custom configuration file is used which provide easy shortcuts for navigating the panes and terminals:

  • Ctrl-Space: activate next pane
  • Alt-1: activate window 1
  • Alt-2: activate window 2
  • Alt-3: activate window 3

Memoryless

Once booted in Developer Mode, rebooting into a normal tree should not leave any lasting effects.

About

The easiest way to try out Atomic Host!

Resources

License

LGPL-3.0, GPL-3.0 licenses found

Licenses found

LGPL-3.0
COPYING.LESSER
GPL-3.0
COPYING

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Shell 92.5%
  • Makefile 7.5%