Website content and code for rexify.org
Home Page: https://www.rexify.org
The rexify website is powered by Statocles, and deployed to GitHub Pages.
Please see our Contributing Guide about how to contribute or work with it locally.
If you need help or have questions, please contact us on our various support channels.
In the file content/docs/faq/index.md, the question "How can I run a block of code with one command?" has this example code:
$ rexify --use Rex::Misc::ShellBlock
That command no longer works. There's a ticket for it at RexOps/Rex#1201. I would submit a pull request to fix this answer, but I'm not sure what the example code should be changed to.
Judging by the Rex codebase there are feature flags that are not yet documented on the according page of the website yet and/or not activated like it is described to the existing documentation.
So we can use that to port over the old news to Statocles
I think it would make sense to use markdown in more places to ease authoring of new content, especially for the book :)
It might also be an option to reuse some existing content management system for it, but I think we can also just convert markdown into HTML internally.
As reported by @stephan48 via IRC:
when clicking on the "docs" breadcrumb i get a empty page
Is there an existing vagrant box/ Vagrantfile that can be used with rex? I couldn't find anything about that on rexify.org (besides rex-box).
If not I could try to add Rex support to https://github.com/bechtoldt/vagrant-devenv / https://github.com/bechtoldt/iac-vagrant.
on this page http://www.rexify.org/howtos/start.html and maybe elsewhere where more than one servers are added to it.
Especially for @ferki ;)
html show rexify --create-module=Service::NTP
but the real command is rexify Service::NTP --create-module
The whole installation page could use a major overhaul. Just by skimming through it:
curl | perl - --sudo method should be discouraged (ref comment on #73)I believe should really publish the recommended/preferred installation methods before some of those options go away.
The navigation menu is showing submenus upon hover, which makes it weird to use them on e.g. a mobile phone (or I just don't know the proper gesture on touch screen :).
Probably it would be nice to see if can activate the submenu on a click instead of hover.
Sometimes rex users get a sudo: sorry, you must have a tty to run sudo error, e.g. as described here. It might worth adding this case to the FAQ.
apt-get install apt-transport-https
echo 'deb https://rex.linux-files.org/ubuntu/ trusty rex' >> /etc/apt/sources.list.d/rex.list
wget -O - https://rex.linux-files.org/DPKG-GPG-KEY-REXIFY-REPO | apt-key add -
apt-get update
apt-get install rex
Instructions will include:
cpanfile for dependency componentsReplacing reduces the number of assets to be loaded and reduces the complexity of the pages.
http://www.rexify.org/support.html under 'Community Support' tells us to join the 'user group' , but I don't know what does that mean. Could the 'user group' be turned into a link to https://groups.google.com/forum/#!forum/rex-users if that's what you mean. (just as I later found on the left hand side of the page)
IMHO it would be also nice to link to http://stackoverflow.com/questions/tagged/rex from both the 'Community Support' entry and from the bottom left side and then monitor that tag on StackOverflow.
(Though I am not sure if it would not be better to have it on http://serverfault.com/ )
better page classification using tagging or page hierarchies would allow for better "breadcrumbing" too.
There are some questiong at serverfault.
If someone with sufficient reputation (I think >300) could edit these questions and tag them with "rex", the link on the website wouldn't address an empty space :)
thank you
https://serverfault.com/questions/894597/how-to-create-a-directory-with-rex
https://serverfault.com/questions/913558/passwordless-ssh-local-port-forwarding
https://serverfault.com/questions/923386/how-to-distribure-sudoers-files-with-rex-configuration-management
https://serverfault.com/questions/922862/how-to-backup-a-file-before-changing-it-with-rex-configuration-management-rex
Repo file in Get Rex uses $releasever but the path for the last releases is missing.
I use Rex without problems in Fedora 22 & 23, but replacing $releasever to 21.
Please add the folders 22/ & 23/ to https://rex.linux-files.org/Fedora/ (Maybe a symbolic link to 21/ folder)
When a search is executed, API results are listed twice, once for each API version:
Commands.pm (API version 1.3)
[...]
Commands.pm (API version 1.4)
[...]
I expect it would quickly get confusing as we release more versions, so I guess it would be nice/enough to only list the latest API version in search results.
The API version can be changed later on the linked page if needed.
When I paste link to Rex's website on twitter, linkedin of facebook, they won't display nice logo of project but picture with "Linux Tag" or "Fork me on GitHub" instead.
I searched for '-b': http://www.rexify.org/search?q=-b
the last hit was "JobControl - Getting started guide":
http://www.rexify.org/howtos/jobcontrol/index.html+header
which gave me a "Page not found" error.
Actually there were 5 such broken links. All with +header at the end.
The website is the primary point for both new and existing Rex users to learn about the project, and to keep themselves up-to-date. It helps a lot if both the infrastructure and content of the website are simple and easy to maintain and edit.
Using GitHub pages for the website would help maintenance considerably:
there were a few placeholder pages before conversion, which were probably drafts, and I assume their content is in the database of the previous CMS
Those need to be checked and probably need to be imported
On this page: https://www.rexify.org/docs/guides/using_modules_and_templates.html
The example starting with: for my $server (@{ $ntp_servers }) {
Doesnt seem to work, perhaps I am missing something?
Statocles is a static site generator, which was proposed earlier to use for managing website contents.
It seems it is capable of supporting many if not all of our use cases directly:
It is also written in Perl and maintained by a Rex user/contributor, which might help adoption and customization.
I just searched for http://www.rexify.org/search?q=timeout the resulting page told me there is something related in the API, but did not provide any link to read more about it. (and I really wanted to see if and how I might be able to set a short timeout for some of the commands)
Found here:
) Set the password for the sudo command. timeout($seconds) Set the timeout for the ssh
The goal here is to complete Rex's documentation and refer from the website to that document, eliminating the need for content/guide/feature_flags.md
On get.rexify.org
Link from Need Help? section to http://rexify.org/feature.html return 404 for now.
It seems the current setup has the following missing redirects:
I am not sure if it is on purpose, but I think this is the default Mojolicious favicon. Maybe it would be better to generate a favicon from the logo http://www.rexify.org/img/top_logo.png
To be documented
no highlight and field at my local setup. why use base64 in the content?
On http://www.rexify.org/howtos/start.html
Instead of this
"Now change into this directory and create a Rexfile."
something like this:
"Now change into this directory and create a file called 'Rexfile' with the following content."
might be clearer.
The site layout is not working so great on mobile browsers (reports from Android Chrome/Firefox). It would be nice to improve that, so patches are welcome! :)
I get "aw snap" both on Chrome and Opera, which means all mobile Webkit browsers are probably affected. Only Firefox work OK on my mobile (Android 4.2).
There used to be scheduled trainings listed. There aren't any at this time, however, training contact details for those who want to receive trainings are to be added to the site.
To further simplify the site, we want to use as little (or no) JS as possible.
A content idea is to describe how to add support for new platforms, like how to tell Rex to do the following:
bare minimum to run commands
manage systems
It should also be possible to do all that in external modules, not just within the core.
On the page about Rex::Commands, there are anchors that are poined to nowhere, thus making a false impression that they are actually clickable links.
It would be nice if this page: http://www.rexify.org/docs/guides/just_enough_perl_for_rex.html could link to the Perl Tutorial at http://perlmaven.com/perl-tutorial
"Continuous Deployment with Jenkins and Rex"
Is listed on the howtos twice :)
I've already found the -t on the command line, but when I tried to find it via the website
http://www.rexify.org/search?q=threads returned no hit.
Is it be possible to set a default number of threads in the Rexfile?
On one hand, it would be nice to replace the current syntax highlighting based on highlight.js with Statocles' built-in highlighter plugin, if we can make that work.
On the other hand (and perhaps until the above replacement is being evaluated), we could also update highlight.js to a recent version, preferably one which only supports the languages we actually need to highlight on the rexify site (I guess Perl+Bash+YAML, not sure if anything else is presented as code which needs highlighting).
Todos:
http://www.rexify.org/docs/guides/start_using__r__ex.html Under 'Managed Hosts'
there is a sentence that I think could be improved
"Rex doesn't try use any non-core Perl modules on the remote hosts, but some operating systems (e.g. RHEL/CentOS 7, Fedora 21) might not supply them out of the box. In this case you might need to install them first (currently this means the Digest::MD5 module)."
I think it would be better:
"Rex only uses core Perl modules on the remote hosts, but some operating systems (e.g. RHEL/CentOS 7, Fedora 21) might not supply all of them out of the box. In this case you might need to install them first (currently this means the Digest::MD5 module)."
And then IMHO, the "install" should be a link to another page, or it should open some hidden text, that explains how to install those modules on the OS-es where they are missing.
Set up a build for the site on updates for the 'master' branch and deploy automatically when the build succeeds.
The navigation data structure is quite extensive; we want a more lightweight approach.
I would like to volunteer to help write a gentler introduction to Rex and the world of automated server/computer administration. Some basic topics I would include are:
Basically, this intro would assume the person has little knowledge about server management software. Not being overly familiar with this class of software myself, I would need some general guidance but I will do all the writing.
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
Django
The Web framework for perfectionists with deadlines.
Laravel
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft
Open source projects and samples from Microsoft.
Google
Google ❤️ Open Source for everyone.
Alibaba
Alibaba Open Source for everyone
D3
Data-Driven Documents codes.
Tencent
China tencent open source team.
