1. Copyright © SUSE
OPENS US E CONFERENCE 2 0 2 3 , NÜRNBERG
Iguana
Using containers to install your system

2. Copyright © SUSE
Who am I
●
SW engineer at SUSE
– Uyuni/SUSE Manager
– Iguana
●
Contact
– Ondrej Holecek ( oholecek@suse.com )
– aaannz ( https://github.com/aaannz )

3. Copyright © SUSE
Why Iguana

4. Copyright © SUSE 5
— Universal base OS
Installer conundrum
Why Iguana

5. Copyright © SUSE 6
— Universal base OS
— Hardware types and limitations
Installer conundrum
Why Iguana

6. Copyright © SUSE 7
— Universal base OS
— Hardware types and limitations
— Deployment methods
Installer conundrum
Why Iguana

7. Copyright © SUSE 8
— Universal base OS
— Hardware types and limitations
— Deployment methods
— Installer security and bug fixes
Installer conundrum
Why Iguana

8. Copyright © SUSE
What is Iguana

9. Copyright © SUSE 10
— Minimal initramfs image
What is Iguana

10. Copyright © SUSE 11
— Minimal initramfs image
— Container execution environment
What is Iguana

11. Copyright © SUSE 12
— Minimal initramfs image
— Container execution environment
— Installation and system rescue containers interface
What is Iguana

12. Copyright © SUSE
How is Iguana

13. Copyright © SUSE 15
— Dracut module
— Workflow parser and executor
— Installation container bundles
Components
Iguana

14. Copyright © SUSE 16
— Installing container runtime to the initramfs
— Preparing container environment
— Pass execution to Iguana workflow
— Mount sysroot and continue booting
Dracut module
Iguana

15. Copyright © SUSE 17
— Dracut module
— Workflow parser and executor
— Installation container bundles
Components
Iguana

16. Copyright © SUSE 18
— Pulls (and validates) images
— Runs service and job containers
— Controlled by Iguana workflow file
— Cleanup after individual jobs
Workflow
Iguana

17. Copyright © SUSE 19
Workflow file
Iguana

18. Copyright © SUSE 20
— Dracut module
— Workflow parser and executor
— Installation container bundles
Components
Iguana

19. Copyright © SUSE 21
— Iguana workflow file
— Installation container
Installation container bundle
Iguana

20. Copyright © SUSE 22
— Iguana workflow file
— Installation container
– OCI or docker container with some application
– Privileged with host networking
– Volumes and mounts from workflow file
– /iguana shared volume across all jobs and services
Installation container bundle
Iguana

21. Copyright © SUSE 23
— Iguana workflow file
— Installation container
– Job container run is monitored
– /iguana/mountlist expected after last job is finished
Installation container bundle
Iguana

22. Copyright © SUSE
How do I use Iguana?

23. Copyright © SUSE 25
Where to get it
Usage
— Source
https://github.com/openSUSE/iguana
— Packages
obs://YaST:Head:Iguana

24. Copyright © SUSE 26
— Install iguana package
– /usr/share/iguana
— Prepare PXE or VM direct kernel boot with iguana files
— rd.iguana.control_url=<URL to workflow file>
rd.iguana.control_url=https://raw.githubusercontent.com/openSUSE/iguana/main/examples/
agama.yaml
— Boot the machine
Standalone Iguana usage
Usage

25. Copyright © SUSE 27
— Install iguana-dracut and iguana-workflow packages
— Generate your initramfs with dracut ... --add iguana command
— Prepare PXE or VM direct kernel boot with iguana files
— rd.iguana.control_url=<URL to workflow file>
— Boot the machine
Enhance custom initramfs with Iguana
Usage

26. Copyright © SUSE 28
— rd.iguana.debug
— rd.debug
— rd.iguana.containers
Debugging
Usage

27. Copyright © SUSE
Questions?
Project: https://github.com/openSUSE/iguana
OBS: https://build.opensuse.org/repositories/YaST:Head:Iguana

28. Copyright © SUSE
© SUSE LLC. All Rights Reserved. SUSE and the
SUSE logo are registered trademarks of SUSE
LLC in the United States and other countries.
All third-party trademarks are the property of
their respective owners.
For more information, contact SUSE at:
+1 800 796 3700 (U.S./Canada)
Frankenstrasse 146
90461 Nürnberg
www.suse.com
Thank you