Cleaned up repo after migration to forge.fedoraproject.org

README.md

@@ -1,31 +1,7 @@
-# Fedora-server repository
-
-This repository is used by [Server working group]( http://fedoraproject.org/wiki/Server).
-
-### It currently contains:
-
-* Docs directory for documentation.
-* Tickets (issues) for the Server group.
-
-### Basic instructions on how to contribute to this repository
-
-[Git for docs writers](https://docs.fedoraproject.org/en-US/fedora-docs/contributing-docs/contributions-quick-repo/) 
-
-Note: Replace master with main on all occations on above document: 
-
-* For example: instead of
-`git checkout master` use `git checkout main`
-
-### Previewing docs:
-
-To build and preview docs, run:
-
-```
-$ ./docsbuilder.sh
-```
-
-The result will be available at http://localhost:8080
-
+# Fedora Server Working Group Documentation
 
+This repository contains the sources for the Fedora [Server Working Group proceedings](https://docs.fedoraproject.org/en-US/fedora-docs/) project documentation.
 
+The approved members of the working group have full read/write access to the repository. They can directly enter changes or additions that do not require discussion.
 
+Otherwise, the repository follows the GIT Pull Request workflow. Contributors create a fork of the repository, enter all contributions there, and create a “pull request.” This will be processed by the approved members.

antora.yml

@@ -1,4 +1,4 @@
-# Name will be mostly visible in the URL. Treat it as an identifier.
+~~# Name will be mostly visible in the URL. Treat it as an identifier.
 # Tip: If you want to use the local preview scripts that come with this
 # repository, please change this value in the site.yml file as well. (under
 # site/start_page)
@@ -9,8 +9,8 @@ title: Fedora Server Working Group
 
 # If you don't plan to have multiple versions of the docs (for example, to
 # document multiple versions of some software), you can ignore this field.
-# Otherwise, change "master" to a specific version.
-version: master
+# Otherwise, change "~" to a specific version.
+version: ~
 
 # We encourage you to name the index page as "index.adoc". If you absolutely
 # have to use a different name, please reflect it here. You can ignore this

docs/README.md

@@ -1,140 +0,0 @@
-# Fedora Server Documentation
-
-This directory contains the sources for the Fedora Server Documentation.
-
-## Contributing to this documentation
-
-Steps to do to contribute to the documentation:
-
-Fork this repository, so you are not pushing updates directly into the main branch.
-
-Start adding the actual ASCIIDoc content. While writing, make sure your new source files are included in the nav.adoc configuration file of the module you are using (./modules/ROOT/ ). 
-Also make sure to use local preview often to check your markup.
-
-Once you finish, commit your changes and push them to your fork.
-
-Use Pagure to make a pull request from your fork to the repository’s main branch.
-
-Someone will see your pull request and either merge it, or provide feedback if there is something you should change. Work with the people commenting to make sure your contributions are up to standards.
-
-## This step needs to be done only once when first version of the site is finished.
-Your new content will need to be published for the first time, and at the moment this does not happen automatically. Send an e-mail to the docs mailing list asking for your content to be published.
-
-The information below is on contributing to this repository (Taken from https://pagure.io/fedora-docs/template)
-
-## Structure
-
-```
-|-- README.md
-|-- antora.yml ....................... 1.
-|-- build.sh ......................... 2.
-|-- preview.sh ....................... 3.
-|-- site.yml ......................... 4.
-`-- modules
-    `-- ROOT ......................... 5.
-        |-- assets
-        |   `-- images ............... 6.
-        |       `-- pizza.png
-        |-- nav.adoc ................. 7.
-        `-- pages .................... 8.
-            |-- architecture.adoc
-            |-- community.adoc
-            |-- faq.adoc
-            |-- index.adoc
-            |-- pizza-dough.adoc
-            `-- pizza-oven.adoc
-```
-
-1. Metadata definition.
-2. A script that does a local build. Uses podman/docker.
-3. A script that shows a preview of the site in a web browser by running a local web server. Uses podman/docker.
-4. A definition file for the build script.
-5. A "root module of this documentation component". Please read below for an explanation.
-6. **Images** to be used on any page.
-7. **Menu definition.** Also defines the hierarchy of all the pages.
-8. **Pages with the actual content.** They can be also organised into subdirectories if desired.
-
-## Components and Modules
-
-Antora introduces two new terms:
-
-* **Component** — Simply put, a component is a part of the documentation website with its own menu. Components can also be versioned. In the Fedora Docs, we use separate components for user documentation, the Fedora Project, Fedora council, Mindshare, FESCO, but also for subprojects such as CommOps or Modulartity.
-* **Module** — A component can be broken down into multiple modules. Modules still share a single menu on the site, but their sources can be stored in different git repositories, even owned by different groups. The default module is called "ROOT" (that's what is in this example). If you don't want to use multiple modules, only use "ROOT". But to define more modules, simply duplicate the "ROOT" directory and name it anything you want. You can store modules in one or more git repositories.
-
-## Local preview
-
-This repo includes scripts to build and preview the contents of this repository.
-
-**NOTE**: Please note that if you reference pages from other repositories, such links will be broken in this local preview as it only builds this repository. If you want to rebuild the whole Fedora Docs site, please see [the Fedora Docs build repository](https://pagure.io/fedora-docs/docs-fp-o/) for instructions.
-
-Both scripts work on Fedora (using Podman) and macOS (using Docker).
-
-To build and preview the site, run:
-
-```
-$ ./build.sh && ./preview.sh
-```
-
-The result will be available at http://localhost:8080
-
-### Installing Podman on Fedora
-
-Newer Fedora Workstations comes with Podman preinstalled by default — if you do not have it, you need to install it using the following command:
-
-```
-$ sudo dnf install podman
-```
-
-### Preview as a part of the whole Fedora Docs site
-
-You can also build the whole Fedora Docs site locally to see your changes in the whole context.
-This is especially useful for checking if your `xref` links work properly.
-
-To do this, you need to clone the main [Fedora Docs build repository](https://pagure.io/fedora-docs/docs-fp-o), modify the `site.yml` file to reference a repo with your changes, and build it.
-Steps:
-
-Clone the main repository and cd into it:
-
-```
-$ git clone https://pagure.io/fedora-docs/docs-fp-o.git
-$ cd docs-fp-o
-```
-
-Find a reference to the repository you're changing in the `site.yml` file, and change it so it points to your change.
-So for example, if I made a modification to the Modularity docs, I would find:
-
-```
-...
-   - url: https://pagure.io/fedora-docs/modularity.git
-     branches:
-       - master
-...
-```
-
-And replaced it with a pointer to my fork:
-```
-...
-   - url: https://pagure.io/forks/asamalik/fedora-docs/modularity.git
-     branches:
-       - master
-...
-```
-
-I could also point to a local repository, using `HEAD` as a branch to preview the what's changed without the need of making a commit.
-
-**Note:** I would need to move the repository under the `docs-fp-o` directory, because the builder won't see anything above.
-So I would need to create a `repositories` directory in `docs-fp-o` and copy my repository into it.
-
-```
-...
-   - url: ./repositories/modularity
-     branches:
-       - HEAD
-...
-```
-
-To build the whole site, I would run the following in the `docs-fp-o` directory.
-
-```
-$ ./build.sh && ./preview.sh
-```

docs/antora.yml

@@ -1,22 +0,0 @@
-# Name will be mostly visible in the URL. Treat it as an identifier.
-# Tip: If you want to use the local preview scripts that come with this
-# repository, please change this value in the site.yml file as well. (under
-# site/start_page)
-name: fedora-server
-
-# Title will be visible on the page.
-title: Fedora Server Documentation
-
-# If you don't plan to have multiple versions of the docs (for example, to
-# document multiple versions of some software), you can ignore this field.
-# Otherwise, change "master" to a specific version.
-version: master
-
-# We encourage you to name the index page as "index.adoc". If you absolutely
-# have to use a different name, please reflect it here. You can ignore this
-# field otherwise.
-start_page: ROOT:index.adoc
-
-# This lists all the menu definitions of your component.
-nav:
-- modules/ROOT/nav.adoc

docs/modules/ROOT/assets/attachments/services/httpd-basic-setup/zvhost-static-html.template

@@ -1,195 +0,0 @@
-# Apache vhost configuration for a static html server.
-# It manages SSL connections including certificates.
-# Initially, a self-signed certificate is active. 
-# Incoming http traffic is automatically redirected to https.
-# Version 2.1
-
-#==> To adjust in vi/vim copy and adjust to the vi command line:
-# : %s/SHORT_DESCR/real_short_descr/g	e.g. my-domain.org production production server
-# : %s/FQN_NAME/your_domain/g		e.g. my-domain.org
-# : %s/BASE_NAME/your_shortname/g	e.g. my-domain
-# : %s/OPTIONAL_ALIAS/your_alias/g	e.g. www.my-domain.org
-# afterwards delete these lines
-
-
-# Certificates are managed by Apache md module.
-#==> To activate, remove the leading '#' character and comment out 
-# the default distribution provided certificates further down. 
-#==> Adjust the mail address as appropriate!
-#MDContactEmail root@FQN_NAME
-#MDCertificateAgreement accepted
-#MDomain FQN_NAME 
-
-<VirtualHost *:443>
-	# Secure virtual WEB host configuration for 
-	# SHORT_DESCR
-
-	# The site can be accessed by https/ssl only. Without a valid certificate
-	# you have to use a self-signed certificate as a quick temporary fix.
-
-	ServerName      FQN_NAME
-	ServerAlias	OPTIONAL_ALIAS
-
-	#==> Adjust the mail address as appropriate!
-	ServerAdmin     root@localhost
-
-	# ##########################################################################
-	# NOTE: We re-route everything from the insecure site to this secure site!
-	# ##########################################################################
-
-	# Optional: Ensure that all registered domain names are rewritten to the
-	# official base name
-	#RewriteEngine   On
-	#RewriteCond     %{HTTP_HOST}    !^FQN_NAME [NC]
-	#RewriteCond     %{HTTP_HOST}    !^$
-	#RewriteRule     ^(.*)$          https://FQN_NAME$1  [R=301,L]
-
-	# ====================================================================
-	# Certificates configuration
-	# ====================================================================
-	SSLEngine on
-	# We rely on Fedora's systemwide configuration of SSL security.
-
-	# By default, certificates are managed by Apache md module (see above)
-	# In this case, no certificates needs bo be configured here.
-	# Otherwise, insert proper certificate configuration here.
-
-	# DEFAULT distribution provided, needed for initial startup.
-	#==> Comment OUT when module md created a certificate or you use custom
-	# certificates.
-	SSLCertificateFile	/etc/pki/tls/certs/localhost.crt
-	SSLCertificateKeyFile	/etc/pki/tls/private/localhost.key
-
-	# LetsEncrypt certificates managed by certbot (NOT by module md!)
-	#SSLCertificateFile      /etc/letsencrypt/live/DOMAIN_NAME/cert.pem
-	#SSLCertificateKeyFile   /etc/letsencrypt/live/DOMAIN_NAME/privkey.pem
-	#SSLCertificateChainFile /etc/letsencrypt/live/DOMAIN_NAME/chain.pem
-
-	# ===============================================================
-	# Directory Locations
-	# ===============================================================
-	DirectoryIndex	index.html
-	DocumentRoot	/srv/BASE_NAME/htdocs
-	# Specific to default 2.4 configuration:
-	# Enable access to server-specific base file location
-	<Directory "/srv/BASE_NAME">
-		AllowOverride None
-		# Allow open access:
-		Require all granted
-	</Directory>
-	# Further relax access to the default document root
-	<Directory "/srv/BASE_NAME/htdocs">
-		#
-		# Possible values for the Options directive are "None", "All",
-		# or any combination of:
-		#   Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews
-		#
-		# Note that "MultiViews" must be named *explicitly* --- "Options All"
-		# doesn't give it to you.
-		#
-		# The Options directive is both complicated and important.  Please see
-		# http://httpd.apache.org/docs/2.4/mod/core.html#options
-		# for more information.
-		#
-		Options Indexes FollowSymLinks
-
-		#
-		# AllowOverride controls what directives may be placed in .htaccess files.
-		# It can be "All", "None", or any combination of the keywords:
-		#   Options FileInfo AuthConfig Limit
-		#
-		AllowOverride None
-
-		#
-		# Controls who can get stuff from this server:
-		# Allow open access:
-		Require all granted
-
-	</Directory>
-
-
-	# ===============================================================
-	# Optional: Protect access to start page (and subsequent pages) 
-	# ==>       Ensure you created the additional auth.d directory 
-	#           including SELinux labels
-	# ===============================================================
-	#<Location />
-	#	AuthType Basic
-	#	AuthName "Access start page"
-	#	AuthUserFile /srv/BASE_NAME/auth.d/htuser
-	#	Require valid-user
-	#</Location>
-
-
-	# ===============================================================
-	# Optional: Configure webDAV access 
-	#==>        Ensure you created the additional davlock directory 
-	#           including SELinux labels
-	# ===============================================================
-	#DavLockDB /srv/SERVER_SHORT_NAME/davlock/dav_lock_db
-
-	#<Location /dav>
-	#	DAV On
-	#	ForceType text/plain
-
-	#	Order Allow,Deny
-	#	Allow from all
-	#	Options all
-	#	DirectoryIndex none
-
-		# Optional: Protect basic dav page (and all subsequent page)
-		#AuthType Basic
-		#AuthName "Application Server WebDAV access"
-		#AuthUserFile /srv/SERVER_SHORT_NAME/auth.d/htdavuser
-		#Require valid-user
-	#</Location>
-
-
-	# ===============================================================
-	# Logging configuration
-	# ===============================================================
-	# Use separate log files for the SSL virtual host; note that LogLevel
-	# is not inherited from httpd.conf.
-	# NOTE: fail2ban searches for ~/logs/*access_log and  ~/logs/*error_log
-	#       to access log files to watch and analyze!
-	ErrorLog        logs/BASE_NAME-ssl_error_log
-	CustomLog       logs/BASE_NAME-ssl_access_log combined
-	LogLevel warn
-
-</VirtualHost>
-
-<VirtualHost *:80>
-	# INSECURE virtual WEB host configuration for 
-	# SHORT_DESCR
-
-	# NOTE: Everything from the insecure port 80 is redirected to this instance'
-	#       SECURE site
-
-	ServerName      FQN_NAME
-	ServerAlias	OPTIONAL_ALIAS
-
-	ServerAdmin     root@FQN_NAME
-
-	# ##########################################################################
-	# NOTE: We re-route everything to the secure site! 
-	#       We retain all aliase names for now.
-	#       There is no need for an exception for Let's Encrypt anymore. 
-	#       Version 2.x can deal with self-signed certificates and https
-	# ##########################################################################
-	RewriteEngine   On
-	RewriteRule	(.*)	https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]
-
-
-	# ===============================================================
-	# Logging configuration
-	# ===============================================================
-	# Use separate log files for the SSL virtual host; note that LogLevel
-	# is not inherited from httpd.conf.
-	# NOTE: fail2ban searches for ~/logs/*access_log and  ~/logs/*error_log
-	#       to access log files to watch and analyze!
-	ErrorLog        logs/BASE_NAME-error_log
-	CustomLog       logs/BASE_NAME-access_log combined
-
-</VirtualHost>
-
-

docs/modules/ROOT/assets/attachments/tutorials/imagefactory/fedora-server-kvm-dev.ks

@@ -1,201 +0,0 @@
-# fedora-server-vm-full.ks (rel. 1.02)
-# Kickstart file to build a Fedora Server Edition VM disk image.
-# The image aims to resemble as close as technically possible the
-# full features of a Fedora Server Edition in a virtual machine.
-#
-# The image uses GPT partition type as of default in Fedora 39.
-#
-# At first boot it opens a text mode basic configuration screen.
-#
-# This kickstart file is designed to be used with ImageFactory (in Koji).
-#
-# To build the image locally, you need to install ImageFactory and
-# various additional helpers and configuration files.
-# See Fedora Server Edition user documentation tutorial.
-
-# Use text mode install
-text
-
-# Keyboard layouts
-keyboard 'us'
-
-# System language
-lang en_US.UTF-8
-
-# System timezone
-# set time zone to GMT (Etcetera/UTC)
-timezone Etc/UTC --utc
-
-
-# Root password
-rootpw --iscrypted --lock locked
-
-# SELinux configuration
-selinux --enforcing
-
-
-# System bootloader configuration
-bootloader --location=mbr --timeout=1 --append="console=tty1 console=ttyS0,115200n8"
-
-# Network information
-network  --bootproto=dhcp --device=link --activate --onboot=on
-
-# Firewall configuration
-firewall --enabled --service=mdns
-
-
-# System services
-services --enabled="sshd,NetworkManager,chronyd,initial-setup"
-
-# Run the Setup Agent on first boot
-firstboot --reconfig
-
-# Partition Information. Use GPT by default (since Fedora 37)
-# Resemble the Partitioning used for Fedora Server Install media
-clearpart --all --initlabel --disklabel=gpt
-reqpart --add-boot
-part pv.007     --size=4000  --grow
-volgroup  sysvg  pv.007
-logvol / --vgname=sysvg --size=4000 --grow --maxsize=16000 --fstype=xfs --name=root --label=sysroot
-
-
-# Include URLs for network installation dynamically, dependent on Fedora release
-# and imagefactory runtime environment
-%include fedora-repo.ks
-
-# Shutdown after installation
-shutdown
-
-
-
-##### begin package list #############################################
-%packages --inst-langs=en
-
-@server-product
-@core
-@headless-management
-@standard
-@networkmanager-submodules
-# container management is an optional install item on disk media.
-# Install options not available with VMs. So we don't include it
-# despite trying to resemble a DVD installation as close as possible.
-##@container-management
-@domain-client
-@guest-agents
-
-# All arm-tools packages install on aarch64/armhfp only
-# TODO: on a x86_64 devel environment are @arm-tools not available
-# and cause a build error.
-# @arm-tools
-
-# Standard Fedora Package Groups
-## dracut-config-generic  ## included in =core=
-glibc-all-langpacks
-initial-setup
-kernel-core
--dracut-config-rescue
--generic-release*
--initial-setup-gui
--kernel
--linux-firmware
--plymouth
-# pulled in by @standard
--smartmontools
--smartmontools-selinux
-
-%end
-##### end package list ###############################################
-
-
-##### begin kickstart post script ####################################
-%post --erroronfail  --log=/root/anaconda-post-1.log
-
-# Find the architecture we are on
-arch=$(uname -m)
-
-# Import RPM GPG key, during installation saved in /etc/pki
-echo "Import RPM GPG key"
-releasever=$(rpm --eval '%{fedora}')
-basearch=$(uname -i)
-rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-$basearch
-
-# See the systemd-random-seed.service man page that says:
-#   " It is recommended to remove the random seed from OS images intended
-#     for replication on multiple systems"
-# The newly installed instance should make it's own
-echo "Removing random-seed so it's not the same in every image."
-rm -f /var/lib/systemd/random-seed
-
-# When we build the image a networking config file gets left behind.
-# Let's clean it up.
-echo "Cleanup leftover networking configuration"
-rm -f /etc/NetworkManager/system-connections/*.nmconnection
-
-# Truncate the /etc/resolv.conf left over from NetworkManager during the
-# kickstart because the DNS server is environment specific.
-truncate -s 0 /etc/resolv.conf
-
-echo "Cleaning repodata to save space."
-dnf clean all
-
-# linux-firmware is installed by default and is quite large. As of mid 2020:
-#   Total download size: 97 M
-#   Installed size: 268 M
-# Not needed in virtual environment.
-echo "Removing linux-firmware package."
-rpm -e linux-firmware
-
-# Will ever anybody see this?
-echo "Packages within this disk image"
-rpm -qa --qf '%{size}\t%{name}-%{version}-%{release}.%{arch}\n' |sort -rn
-
-# Note that running rpm recreates the rpm db files which aren't needed or wanted
-rm -f /var/lib/rpm/__db*
-
-
-# Do we need a serial terminal with a VM?
-if [[ $arch == "aarch64" ]] || [[ $arch == "armv7l" ]]; then
- # Anaconda adds console=tty0 to the grub boot line on all images. this is problematic
- # when you are using fedora via serial console as you do not get any output post grub
- # linux does a good job of knowing what consoles need to be enabled.
- # https://bugzilla.redhat.com/show_bug.cgi?id=2022757
- sed -i -e 's|console=tty0||g' /boot/loader/entries/*conf
-fi
-
-
-# Remove machine-id on pre generated images
-rm -f /etc/machine-id
-touch /etc/machine-id
-
-%end
-##### end kickstart post script #####################################
-
-
-##### begin custom post script (after base) #########################
-%post
-
-# When we build the image /var/log gets populated.
-# Let's clean it up.
-echo "Cleanup leftover in /var/log"
-cd /var/log  && find . -name \* -type f -delete 
-
-echo "Zeroing out empty space."
-# Create zeros file with nodatacow and no compression
-touch /var/tmp/zeros
-chattr +C /var/tmp/zeros
-# This forces the filesystem to reclaim space from deleted files
-dd bs=1M if=/dev/zero of=/var/tmp/zeros || :
-echo "(Don't worry -- that out-of-space error was expected.)"
-# Force sync to disk
-sync /
-rm -f /var/tmp/zeros
-sync /
-
-# setup systemd to boot to the right runlevel
-echo -n "Setting default runlevel to multiuser text mode"
-rm -f /etc/systemd/system/default.target
-ln -s /lib/systemd/system/multi-user.target /etc/systemd/system/default.target
-echo .
-
-%end
-##### end custom post script ########################################

docs/modules/ROOT/assets/attachments/tutorials/imagefactory/fedora-server-kvm-dev.tdl

@@ -1,16 +0,0 @@
-<template>
-    <name>fedora-server-kvm-dev</name>
-    <os>
-        <name>Fedora</name>
-        <version>22</version>
-        <arch>x86_64</arch>
-        <install type='url'>
-          <url>https://kojipkgs.fedoraproject.org/compose/branched/Fedora-39-20231001.n.0/compose/Everything/x86_64/os</url>
-        </install>
-    </os>
-    <description>Fedora-server-kvm-dev</description>
-    <disk>
-      <size>7G</size>
-    </disk>
-</template>
-