Am 03.05.2024 um 00:06 schrieb John W. Himpel
<john(a)jlhimpel.net>:
All,
I notice that most of our Fedora Server documentation describes using
cockpit and command-line and graphical apps.
While I have no objection to this and I believe it works well for
maintaining a small number of servers and/or services, it is my belief
this becomes quite cumbersome for more than a handful of servers and/or
services.
I have been asked to edit the NFS Server service installation and setup
documentation currently found in the Staging Environment. The docs
should cover both server side and client side procedures. I am more
that willing to edit the procedures prescribed in that document. But I
prefer using ansible to maintain my server environment. It becomes
permanent documentation (in case I am no longer available) and it
becomes repeatable by only modifying the "environment files" if a
server requires a rebuild.
I am looking for the opinion and experience of the community in
deciding whether or not we should document both types of procedures.
I strongly agree with adding Ansible procedures to our documentation. We have committed to
Ansible in our technical specifications
(
https://docs.fedoraproject.org/en-US/server-working-group/docs/server-tec...)
Our Server Roles are Ansible supported services. And it is the core of our project
"Using Ansible to install and configure Wildfly“ (issue #60,
https://pagure.io/fedora-server/issue/60) We chose Wildfly als our PoC project.
Unfortunately it turned out, that Wildfly itself provides so many quirks which we had to
master, that we didn’t came to Ansible until now.
Maybe it is a good idea to use the NFS case as an opportunity to use this as a PoC for our
Server Roles. NFS is obviously much easier to master and we can concentrate on the Ansible
part instead on the quirks of the software itself.
And a next good candidate would be our „Post-install Tasks“, I think (although this is of
course not a „Server Role“).
Regarding the current NFS article:
I think we should leave the first part as it is until "Preparation" and insert a
new part before Preparation: The NFS Server Role. And describe in this part to use Ansible
for setup. And than continue with a new sub-header like „Manual Setup“ and describe the
manual procedure.
Or we can split it into separate Sub-docs like
== The Fedora Server NFS Server Role
With some general information a
=== Setting up NFS Server Role via Ansible
=== Setting up NFS Server Role via CLI
=== Setting up a Fedora Linux NFS client (desktop an server)
We have to discard the Cockpit part about NFS server, because the module was never really
developed further and is now orphaned, if I remember correctly.
And then we have to discuss and decide how to maintain and distribute the Ansible files.
--
Peter Boy
https://fedoraproject.org/wiki/User:Pboy
PBoy(a)fedoraproject.org
Timezone: CET (UTC+1) / CEST (UTC+2)
Fedora Server Edition Working Group member
Fedora Docs team contributor and board member
Java developer and enthusiast