Skip to content

Commit d89ef20

Browse files
kashyapcrwmjones
authored andcommitted
virt-builder.pod: Update Fedora versions
It's that time again. Update the Fedora versions in examples. For the index file example, I used Fedora 41 and 42 (which will come out in April 2025). Signed-off-by: Kashyap Chamarthy <[email protected]>
1 parent 5520f1c commit d89ef20

File tree

1 file changed

+36
-36
lines changed

1 file changed

+36
-36
lines changed

builder/virt-builder.pod

+36-36
Original file line numberDiff line numberDiff line change
@@ -59,13 +59,13 @@ your own too (see below).
5959
After choosing a guest from the list, you may want to see if there
6060
are any installation notes:
6161

62-
virt-builder --notes fedora-27
62+
virt-builder --notes fedora-41
6363

6464
=head2 Build a virtual machine
6565

66-
virt-builder fedora-27
66+
virt-builder fedora-41
6767

68-
will build a Fedora 25 image for the same architecture as virt-builder
68+
will build a Fedora 41 image for the same architecture as virt-builder
6969
(so running it from an i686 installation will try to build an i686
7070
image, if available). This will have all default
7171
configuration (minimal size, no user accounts, random root password,
@@ -77,33 +77,33 @@ The first time this runs it has to download the template over the
7777
network, but this gets cached (see L</CACHING>).
7878

7979
The name of the output file is derived from the template name, so
80-
above it will be F<fedora-27.img>. You can change the output filename
80+
above it will be F<fedora-41.img>. You can change the output filename
8181
using the I<-o> option:
8282

83-
virt-builder fedora-27 -o mydisk.img
83+
virt-builder fedora-41 -o mydisk.img
8484

8585
You can also use the I<-o> option to write to existing devices or
8686
logical volumes.
8787

88-
virt-builder fedora-27 --format qcow2
88+
virt-builder fedora-41 --format qcow2
8989

90-
As above, but write the output in qcow2 format to F<fedora-27.qcow2>.
90+
As above, but write the output in qcow2 format to F<fedora-41.qcow2>.
9191

92-
virt-builder fedora-27 --size 20G
92+
virt-builder fedora-41 --size 20G
9393

9494
As above, but the output size will be 20 GB. The guest OS is resized
9595
as it is copied to the output (automatically, using
9696
L<virt-resize(1)>).
9797

98-
virt-builder fedora-27 --arch i686
98+
virt-builder fedora-41 --arch i686
9999

100100
As above, but using an i686 template, if available.
101101

102102
=head2 Setting the root password
103103

104-
virt-builder fedora-27 --root-password file:/tmp/rootpw
104+
virt-builder fedora-41 --root-password file:/tmp/rootpw
105105

106-
Create a Fedora 25 image. The root password is taken from the file
106+
Create a Fedora 41 image. The root password is taken from the file
107107
F</tmp/rootpw>.
108108

109109
Note if you I<don’t> set I<--root-password> then the guest is given
@@ -113,7 +113,7 @@ You can also create user accounts. See L</USERS AND PASSWORDS> below.
113113

114114
=head2 Set the hostname
115115

116-
virt-builder fedora-27 --hostname virt.example.com
116+
virt-builder fedora-41 --hostname virt.example.com
117117

118118
Set the hostname to C<virt.example.com>.
119119

@@ -122,7 +122,7 @@ Set the hostname to C<virt.example.com>.
122122
To install packages from the ordinary (guest) software repository
123123
(eg. dnf or apt):
124124

125-
virt-builder fedora-27 --install "inkscape,@Xfce Desktop"
125+
virt-builder fedora-41 --install "inkscape,@Xfce Desktop"
126126

127127
(In Fedora, C<@> is used to install groups of packages. On Debian
128128
you would install a meta-package instead.)
@@ -147,18 +147,18 @@ For example:
147147
dnf -y --best update
148148
EOF
149149

150-
virt-builder fedora-27 --firstboot /tmp/dnf-update.sh
150+
virt-builder fedora-41 --firstboot /tmp/dnf-update.sh
151151

152152
or simply:
153153

154-
virt-builder fedora-27 --firstboot-command 'dnf -y --best update'
154+
virt-builder fedora-41 --firstboot-command 'dnf -y --best update'
155155

156156
which makes the L<dnf(8)> C<update> command run once the first time
157157
the guest boots.
158158

159159
Or:
160160

161-
virt-builder fedora-27 \
161+
virt-builder fedora-41 \
162162
--edit '/etc/dnf/dnf.conf:
163163
s/gpgcheck=1/gpgcheck=0/'
164164

@@ -559,7 +559,7 @@ If the guest OS you are installing is similar to the host OS (eg.
559559
both are Linux), and if libguestfs supports network connections, then
560560
you can use I<--install> to install packages like this:
561561

562-
virt-builder fedora-27 --install inkscape
562+
virt-builder fedora-41 --install inkscape
563563

564564
This uses the guest’s package manager and the host’s network
565565
connection.
@@ -568,7 +568,7 @@ connection.
568568

569569
To update the installed packages in the template at build time:
570570

571-
virt-builder fedora-27 --update
571+
virt-builder fedora-41 --update
572572

573573
Most of the templates that ship with virt-builder come with a very
574574
minimal selection of packages (known as a "JEOS" or "Just Enough
@@ -580,7 +580,7 @@ OS from the template. This option updates those template packages.
580580

581581
Another option is to install the packages when the guest first boots:
582582

583-
virt-builder fedora-27 --firstboot-install inkscape
583+
virt-builder fedora-41 --firstboot-install inkscape
584584

585585
This uses the guest’s package manager and the guest’s network
586586
connection.
@@ -628,7 +628,7 @@ For apt, create /tmp/install.sh containing:
628628
Use the I<--attach> option to attach the CD / disk image and the
629629
I<--run> option to run the script:
630630

631-
virt-builder fedora-27 \
631+
virt-builder fedora-41 \
632632
--attach extra-packages.iso \
633633
--run /tmp/install.sh
634634

@@ -707,7 +707,7 @@ keyboard for some common Linux distributions.
707707

708708
For distros that use systemd C<localectl>, use a command like this:
709709

710-
virt-builder fedora-27 \
710+
virt-builder fedora-41 \
711711
--firstboot-command 'localectl set-keymap uk'
712712

713713
See L<localectl(1)> and
@@ -749,9 +749,9 @@ of virt-builder to do this.
749749

750750
This section contains examples for some common Linux distributions.
751751

752-
=head3 Setting Japanese in Fedora 25
752+
=head3 Setting Japanese in Fedora 41
753753

754-
virt-builder fedora-27 \
754+
virt-builder fedora-41 \
755755
--size 20G \
756756
--update \
757757
--install @japanese-support \
@@ -1014,7 +1014,7 @@ tools probably work differently as well.
10141014

10151015
Import the image into Glance (the OpenStack image store) by doing:
10161016

1017-
glance image-create --name fedora-27-image --file fedora-27.img \
1017+
glance image-create --name fedora-41-image --file fedora-41.img \
10181018
--disk-format raw --container-format bare \
10191019
--is-public True
10201020

@@ -1024,12 +1024,12 @@ parameter should match virt-builder’s I<--format> option (or C<raw> if
10241024
you didn't use that option). The I<--container-format> should always
10251025
be C<bare> since virt-builder doesn't put images into containers.
10261026

1027-
You can use the S<C<glance image-show I<fedora-27-image>>> command to
1027+
You can use the S<C<glance image-show I<fedora-41-image>>> command to
10281028
display the properties of the image.
10291029

10301030
To boot up an instance of your image on a Nova compute node, do:
10311031

1032-
nova boot fedora-27-server --image fedora-27-image \
1032+
nova boot fedora-41-server --image fedora-41-image \
10331033
--flavor m1.medium
10341034

10351035
Use S<C<nova flavor-list>> to list possible machine flavors. Use
@@ -1060,7 +1060,7 @@ at boot.
10601060

10611061
A typical virt-builder command would be:
10621062

1063-
virt-builder fedora-27 \
1063+
virt-builder fedora-41 \
10641064
--hostname client.example.com \
10651065
--update \
10661066
--install puppet \
@@ -1294,22 +1294,22 @@ options (see L<nbdkit-xz-plugin(1)> for further explanation):
12941294
The index file has a simple text format (shown here without the
12951295
digital signature):
12961296

1297-
[fedora-18]
1298-
name=Fedora® 18
1299-
osinfo=fedora18
1297+
[fedora-41]
1298+
name=Fedora® 41
1299+
osinfo=fedora41
13001300
arch=x86_64
1301-
file=fedora-18.xz
1301+
file=fedora-41.xz
13021302
checksum[sha512]=...
13031303
format=raw
13041304
size=6442450944
13051305
compressed_size=148947524
13061306
expand=/dev/sda3
13071307

1308-
[fedora-19]
1309-
name=Fedora® 19
1310-
osinfo=fedora19
1308+
[fedora-42]
1309+
name=Fedora® 42
1310+
osinfo=fedora42
13111311
arch=x86_64
1312-
file=fedora-19.xz
1312+
file=fedora-42.xz
13131313
checksum[sha512]=...
13141314
revision=3
13151315
format=raw
@@ -1584,7 +1584,7 @@ package manager at that.
15841584

15851585
To install a Fedora guest using a local mirror:
15861586

1587-
virt-builder fedora-27 \
1587+
virt-builder fedora-41 \
15881588
--edit '/etc/yum.repos.d/fedora.repo:
15891589
s{.*baseurl=.*}{baseurl=http://example.com/mirror/};
15901590
s{.*metalink=.*}{};

0 commit comments

Comments
 (0)