canonical / cloud-init

Official upstream for the cloud-init: cloud instance initialization
https://cloud-init.io/
Other
3.01k stars 887 forks source link

[docs]: your documentation is totally incomprehensible gibberish #5882

Closed jua74470 closed 1 week ago

jua74470 commented 1 week ago

your documentation is totally incomprehensible gibberish

this one only includes parts of the dispatcher file and we don't even understand how to assemble them

nor even where to find this or that part

what we need is examples of cloud-init config files that are complete and integral with detailed explanations of each line

as it was and still is the case with the kickstart files

personally I even understand why you changed this system

except to annoy people and force people to use boot iso files of more than 2 giga while before we could use a file of less than 100 MB and that the kickstart files were compatible with all current operating systems Ubuntu Debian CentOS Fedora etc

not to mention that these files are still used on the base distribution RHEL and it is fork

so already at my level I see no interest in changing the system and in addition it is incomprehensible

there are people who want automated installations who are not developers at all and who understand nothing at all about your documentation, not to mention that it is only in English

you could translate them into the most common languages

Spanish French Italian Portuguese Mandarin Arabic

what we need is documentation on a single page

which contains all the details of the cloud init config file

and also detailed explanations on how to integrate the file into the installation iso

all we find is how to integrate a second iso file

except computers have only one cd drive

so everything must be in a single file

in my case I need an equivalent following from kickstart to cloud init config

#for ubuntu 20.04 22.04 and 24.04 this example for 24.04 noble
# Firewall required disabled
firewall --disabled
# Install OS instead of upgrade
install
# Use network installation
url --url="http://fr.archive.ubuntu/ubuntu"
repo --name="Base" --baseurl=http://fr.archive.ubuntu/ubuntu --cost=100
# Root password
rootpw --disabled
user test --fullname "" --iscrypted --password $1$us6C7Q/3$asXQAUrZA89Ky.xGINj9K0
# System authorization information
auth  --useshadow  --passalgo=sha512
# Use graphical install
graphical
# Run the Setup Agent on first boot
firstboot --enable
# System keyboard require france french keyboard
keyboard fr-latin9
# System language french
lang fr_FR
# SELinux configuration not required for ubuntu apport disable please indicate parameter manual in chroot
#selinux --disabled
# Installation logging level
logging --level=info

# System timezone
timezone --isUtc Europe/Paris
# Network information ethernet dhcp config
network  --bootproto=dhcp --device=eth0 --onboot=on
# System bootloader configuration remove all partition on sda and install on full disk
bootloader --location=mbr --driveorder="sda"
# Clear the Master Boot Record
zerombr
# Partition clearing information
clearpart --all --initlabel

%post --nochroot
#copy host and resolv.conf file for internet work in chroot
cp /target/etc/resolv.conf /target/etc/resolv.conf.orig
cp /target/etc/hosts /target/etc/hosts.orig
cp /etc/resolv.conf /target/etc/
cp /etc/hosts /target/etc/
#configure repo sources.list with deb mirror
echo "deb mirror://mirrors.ubuntu.com/mirrors.txt noble main restricted universe multiverse" > /target/etc/apt/sources.list
echo "deb mirror://mirrors.ubuntu.com/mirrors.txt noble-security main restricted universe multiverse" >> /target/etc/apt/sources.list
echo "deb mirror://mirrors.ubuntu.com/mirrors.txt noble-updates main restricted universe multiverse" >> /target/etc/apt/sources.list
echo "deb-src mirror://mirrors.ubuntu.com/mirrors.txt noble main restricted universe multiverse" >> /target/etc/apt/sources.list
echo "deb-src mirror://mirrors.ubuntu.com/mirrors.txt noble-security main restricted universe multiverse" >> /target/etc/apt/sources.list
echo "deb-src mirror://mirrors.ubuntu.com/mirrors.txt noble-updates main restricted universe multiverse" >> /target/etc/apt/sources.list
echo "deb http://archive.canonical.com/ubuntu noble partner" >> /target/etc/apt/sources.list
echo "deb-src http://archive.canonical.com/ubuntu noble partner" >> /target/etc/apt/sources.list
#create apt keyrings folder
mkdir -pm755 /target/etc/apt/keyrings
# add apt key, repo and config for use mozilla firefox in deb no snap
wget https://packages.mozilla.org/apt/repo-signing-key.gpg -O   /target/etc/apt/keyrings/packages.mozilla.org.asc
echo "deb [signed-by=/etc/apt/keyrings/packages.mozilla.org.asc] https://packages.mozilla.org/apt mozilla main" > /target/etc/apt/sources.list.d/mozilla.list
echo "Package: firefox*" > /target/etc/apt/preferences.d/firefox-deb-nosnap
echo "Pin: release o=Ubuntu*" > /target/etc/apt/preferences.d/firefox-deb-nosnap
echo "Pin-Priority: -1" > /target/etc/apt/preferences.d/firefox-deb-nosnap
echo "Package: *" > /target/etc/apt/preferences.d/firefox-deb-nosnap
echo "Pin: origin packages.mozilla.org" > /target/etc/apt/preferences.d/firefox-deb-nosnap
echo "Pin-Priority: 1000" > /target/etc/apt/preferences.d/firefox-deb-nosnap
# add libreoffice ppa for use libreoffice in deb no snap
chroot /target add-apt-repository ppa:libreoffice/ppa -y
# add apt key and repo for use chromium browser in deb no snap
wget 'https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x869689FE09306074'  -O '/target/etc/apt/trusted.gpg.d/phd-chromium.asc'
echo "deb https://freeshell.de/phd/chromium/$(lsb_release -sc) /" > /target/etc/apt/sources.list.d/phd-chromium.list
# add apt key and repo for playonlinux latest version
wget 'http://deb.playonlinux.com/public.gpg'  -O '/target/etc/apt/trusted.gpg.d/playonlinux.gpg
wget http://deb.playonlinux.com/playonlinux_cosmic.list -O /target/etc/apt/sources.list.d/playonlinux.list
# add apt key and repo for use winehq version
chroot /target dpkg --add-architecture i386
wget -O /target/etc/apt/keyrings/winehq-archive.key https://dl.winehq.org/wine-builds/winehq.key
wget -NP /target/etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/noble/winehq-noble.sources
#enable xfce4 on default interface not use xubuntu interface
chroot /target /usr/lib/lightdm/lightdm-set-defaults --session xfce4-session
#enable ssh service
chroot /target systemctl enable ssh
#disable apport service
chroot /target systemctl enable apport
# remove firefox snap package
# I don't know if this is correct to run snapd in a chroot
echo '/usr/lib/snapd/snapd &' > /target/root/snapd.sh
echo 'snap remove firefox' >> /target/root/snapd.sh
echo 'snap remove libreoffice' >> /target/root/snapd.sh
echo 'killall -9 snapd' >> /target/root/snapd.sh
chroot /target bash /root/snapd.sh
rm -f /target/root/snapd.sh
#remove old package and install my personal package
chroot /target apt-get update
chroot /target apt-get -y remove firefox chromium-browser chromium-browser-* libreoffice libreoffice-*
chroot /target apt-get -y autoremove
chroot /target apt-get -y install firefox chromium libreoffice libreoffice-* vlc ffmpeg debhelper cdbs lintian build-essential fakeroot devscripts dh-make dput
chroot /target apt-get install --install-recommends winehq-stable playonlinux
chroot /target apt-get -y dist-upgrade
#restore host and resolv.conf file
rm -f /target/etc/resolv.conf /target/etc/hosts
mv /target/etc/resolv.conf.orig /target/etc/resolv.conf
mv /target/etc/hosts.orig /target/etc/hosts
%end

%packages
xubuntu-desktop
xfce4
xfce4-goodies
ssh
%end

reboot

everything is in a single file that is very easy to understand, which is not the case with your cloud init system

instead of creating a single page with the necessary

you make 50 thousand incomprehensible pages with parts of the file everywhere

and you don't even explain how to integrate this cloud init config file into the installation iso

and even in the language communities there is no translated document which clearly shows that no one can understand how your cloud init system works

create a new installation system why not

but only on condition that it is simpler and correctly documented in all languages

it's been more than 2 years since you created your system we still don't understand how it works and still no translation

holmanb commented 1 week ago

@jua74470 your understanding of cloud-init is misguided. Cloud-init is not an installer. Perhaps this page will redirect your confusion in the right direction.

It is not productive to include multiple different feature requests in the same report. Bug reports should be focused and specific. The issue that you filed looks much more like a rant than a proper bug report or feature request. If you want to be taken seriously when you file future bug reports, I would recommend individual reports for individual issues - not a single report containing every complaint that you have about the project.