Add Zuul FAQ page

As Zuul gets more attention we are getting questions that can likely be
captured in an FAQ and hopefully make the answers easier to find. Add
this document to the website.

Change-Id: Ia076c4f5b3a3949dd8e79ac5825189fb64645950
This commit is contained in:
Clark Boylan 2019-09-02 10:18:38 -07:00
parent 0dc670ec5a
commit c897715571
5 changed files with 191 additions and 0 deletions

View File

@ -45,6 +45,7 @@
<li><a href="docs/zuul-jobs">Zuul Jobs</a></li> <li><a href="docs/zuul-jobs">Zuul Jobs</a></li>
<li><a href="docs/zuul-base-jobs">Base Jobs</a></li> <li><a href="docs/zuul-base-jobs">Base Jobs</a></li>
<li><a href="docs/zuul-sphinx/">Zuul Sphinx</a></li> <li><a href="docs/zuul-sphinx/">Zuul Sphinx</a></li>
<li><a href="docs/faq.html">Zuul FAQ</a></li>
</ul> </ul>
</li> </li>
<li class="current"><a href="community.html">Community</a></li> <li class="current"><a href="community.html">Community</a></li>
@ -98,6 +99,7 @@
<li><a href="https://opendev.org/zuul/zuul/">Source</a></li> <li><a href="https://opendev.org/zuul/zuul/">Source</a></li>
<li><a href="https://pypi.org/project/zuul/">Install</a></li> <li><a href="https://pypi.org/project/zuul/">Install</a></li>
<li><a href="https://zuul-ci.org/docs/">Documentation</a></li> <li><a href="https://zuul-ci.org/docs/">Documentation</a></li>
<li><a href="https://zuul-ci.org/docs/faq.html">FAQ</a></li>
</ul> </ul>
</section> </section>
<section class="3u 6u$(narrower) 12u$(mobilep)"> <section class="3u 6u$(narrower) 12u$(mobilep)">

175
www/docs/faq.html Normal file
View File

@ -0,0 +1,175 @@
<!DOCTYPE HTML>
<!--
Arcana by HTML5 UP
html5up.net | @ajlkn
Free for personal and commercial use under the CCA 3.0 license (html5up.net/license)
-->
<html>
<head>
<title>Zuul: FAQ</title>
<meta charset="utf-8" />
<link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png">
<link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png">
<link rel="manifest" href="/site.webmanifest">
<link rel="mask-icon" href="/safari-pinned-tab.svg" color="#071d49">
<meta name="msapplication-TileColor" content="#00aba9">
<meta name="theme-color" content="#ffffff">
<meta name="viewport" content="width=device-width, initial-scale=1" />
<!--[if lte IE 8]><script src="../assets/js/ie/html5shiv.js"></script><![endif]-->
<link rel="stylesheet" href="../assets/css/main.css" />
<!--[if lte IE 8]><link rel="stylesheet" href="../assets/css/ie8.css" /><![endif]-->
<!--[if lte IE 9]><link rel="stylesheet" href="../assets/css/ie9.css" /><![endif]-->
</head>
<body>
<div id="page-wrapper">
<!-- Header -->
<div id="header">
<!-- Logo -->
<h1>
<a href="/"><img id="logo" src="../images/logo.svg" alt="Zuul"/></a>
</h1>
<!-- Nav -->
<nav id="nav">
<ul>
<li><a href="/">Home</a></li>
<li><a href="../users.html">Users</a></li>
<li class="current">
<a href=".">Documentation</a>
<ul>
<li><a href="zuul/">Zuul</a></li>
<li><a href="nodepool/">Nodepool</a></li>
<li><a href="zuul-jobs/">Zuul Jobs</a></li>
<li><a href="zuul-base-jobs/">Base Jobs</a></li>
<li><a href="zuul-sphinx/">Zuul Sphinx</a></li>
<li><a href="faq.html">Zuul FAQ</a></li>
</ul>
</li>
<li><a href="/community.html">Community</a></li>
</ul>
</nav>
</div>
<section class="wrapper style1">
<div class="container">
<div id="content">
<article>
<header class="major">
<h2>Zuul FAQ</h2>
</header>
<h3>
What version control systems does Zuul support?
</h3>
<p>
Zuul currently only has support for the git version control
system.
</p>
<h3>
What code review systems does Zuul support?
</h3>
<p>
Zuul currently supports Gerrit, GitHub, GitHub Enterprise,
and Pagure. Work is in progress to add Bitbucket support.
</p>
<h3>
Where can I run my Zuul jobs?
</h3>
<p>
Zuul uses Ansible to execute jobs which means Zuul can run jobs
on platforms that Ansible is able to communicate with. This
includes Linux (and other Unix like operating systems), Windows,
and even network switches.
</p>
<p>
To provision these resources Zuul uses Nodepool which can talk
to a variety of cloud resources as well as staticly configured
hosts. Currently AWS, Kubernetes, OpenShift and OpenStack cloud
resources are supported. Work to support Azure is in progress.
</p>
<h3>
How does Zuul compare to Jenkins?
</h3>
<p>
Zuul is purpose built to be a gating continuous integration and
deployment system. Jenkins is a generic automation tool that
can be used to perform CI and CD.
Major differences that come out of this include:
<ul>
<li>Zuul expects all configuration to be managed as code.</li>
<li>Zuul provides test environment provisioning via Nodepool.</li>
<li>Zuul includes out of the box support for gating commits.</li>
</ul>
</p>
<h3>
What are the system requirements to run Zuul?
</h3>
<p>
Zuul scales with the size of your code base. An all in one
Zuul installation capable of running small workloads will fit
a server with 8GB of memory and 80GB of disk (this is how we
test Zuul).
For bigger projects you can run multiple Zuul executors and
mergers to handle larger numbers of concurrent jobs. This means
you can start small and expand as needed to meet demand.
</p>
</article>
</div>
</div>
</section>
<!-- Footer -->
<div id="footer">
<div class="container">
<div class="row">
<section class="3u 6u(narrower) 12u$(mobilep)">
<h3>Get Zuul</h3>
<ul class="links">
<li><a href="https://opendev.org/zuul/zuul/">Source</a></li>
<li><a href="https://pypi.org/project/zuul/">Install</a></li>
<li><a href="https://zuul-ci.org/docs/">Documentation</a></li>
<li><a href="https://zuul-ci.org/docs/faq.html">FAQ</a></li>
</ul>
</section>
<section class="3u 6u$(narrower) 12u$(mobilep)">
<h3>Get Involved</h3>
<ul class="links">
<li><a href="http://lists.zuul-ci.org/cgi-bin/mailman/listinfo">Mailing lists</a></li>
<li><a href="http://webchat.freenode.net/?channels=%23zuul">IRC</a> #zuul on Freenode</li>
<li><a href="https://storyboard.openstack.org/#!/project/679">Bugs</a></li>
<li><a href="https://review.opendev.org/#/q/status:open+project:zuul/zuul">Code Review</a></li>
</ul>
</section>
</div>
</div>
<!-- Copyright -->
<div class="copyright">
<ul class="menu">
<li>&copy; Zuul Contributors. Licensed under Creative Commons Attribution 3.0</li><li>Zuul is collaboratively developed under the Apache 2 license and managed by the OpenStack Foundation.</li><li>Design based on Arcana from: <a href="http://html5up.net">HTML5 UP</a></li><li><a href="https://opendev.org/zuul/zuul-website/">Browse page source</a></li>
</ul>
</div>
</div>
</div>
<!-- Scripts -->
<script src="../assets/js/jquery.min.js"></script>
<script src="../assets/js/jquery.dropotron.min.js"></script>
<script src="../assets/js/skel.min.js"></script>
<script src="../assets/js/util.js"></script>
<!--[if lte IE 8]><script src="../assets/js/ie/respond.min.js"></script><![endif]-->
<script src="../assets/js/main.js"></script>
</body>
</html>

View File

@ -45,6 +45,7 @@
<li><a href="zuul-jobs/">Zuul Jobs</a></li> <li><a href="zuul-jobs/">Zuul Jobs</a></li>
<li><a href="zuul-base-jobs/">Base Jobs</a></li> <li><a href="zuul-base-jobs/">Base Jobs</a></li>
<li><a href="zuul-sphinx/">Zuul Sphinx</a></li> <li><a href="zuul-sphinx/">Zuul Sphinx</a></li>
<li><a href="faq.html">Zuul FAQ</a></li>
</ul> </ul>
</li> </li>
<li><a href="/community.html">Community</a></li> <li><a href="/community.html">Community</a></li>
@ -101,6 +102,14 @@
</div> </div>
</div> </div>
</section> </section>
<section class="6u 12u(narrower)">
<div class="box post">
<div class="inner">
<h3><a href="faq.html">Zuul FAQ</a></h3>
<p>Find answers to common questions.</p>
</div>
</div>
</section>
</div> </div>
</div> </div>
</section> </section>
@ -115,6 +124,7 @@
<li><a href="https://opendev.org/zuul/zuul/">Source</a></li> <li><a href="https://opendev.org/zuul/zuul/">Source</a></li>
<li><a href="https://pypi.org/project/zuul/">Install</a></li> <li><a href="https://pypi.org/project/zuul/">Install</a></li>
<li><a href="https://zuul-ci.org/docs/">Documentation</a></li> <li><a href="https://zuul-ci.org/docs/">Documentation</a></li>
<li><a href="https://zuul-ci.org/docs/faq.html">FAQ</a></li>
</ul> </ul>
</section> </section>
<section class="3u 6u$(narrower) 12u$(mobilep)"> <section class="3u 6u$(narrower) 12u$(mobilep)">

View File

@ -45,6 +45,7 @@
<li><a href="docs/zuul-jobs">Zuul Jobs</a></li> <li><a href="docs/zuul-jobs">Zuul Jobs</a></li>
<li><a href="docs/zuul-base-jobs">Base Jobs</a></li> <li><a href="docs/zuul-base-jobs">Base Jobs</a></li>
<li><a href="docs/zuul-sphinx/">Zuul Sphinx</a></li> <li><a href="docs/zuul-sphinx/">Zuul Sphinx</a></li>
<li><a href="docs/faq.html">Zuul FAQ</a></li>
</ul> </ul>
</li> </li>
<li><a href="community.html">Community</a></li> <li><a href="community.html">Community</a></li>
@ -215,6 +216,7 @@
<li><a href="https://opendev.org/zuul/zuul/">Source</a></li> <li><a href="https://opendev.org/zuul/zuul/">Source</a></li>
<li><a href="https://pypi.org/project/zuul/">Install</a></li> <li><a href="https://pypi.org/project/zuul/">Install</a></li>
<li><a href="https://zuul-ci.org/docs/">Documentation</a></li> <li><a href="https://zuul-ci.org/docs/">Documentation</a></li>
<li><a href="https://zuul-ci.org/docs/faq.html">FAQ</a></li>
</ul> </ul>
</section> </section>
<section class="3u 6u$(narrower) 12u$(mobilep)"> <section class="3u 6u$(narrower) 12u$(mobilep)">

View File

@ -45,6 +45,7 @@
<li><a href="docs/zuul-jobs">Zuul Jobs</a></li> <li><a href="docs/zuul-jobs">Zuul Jobs</a></li>
<li><a href="docs/zuul-base-jobs">Base Jobs</a></li> <li><a href="docs/zuul-base-jobs">Base Jobs</a></li>
<li><a href="docs/zuul-sphinx/">Zuul Sphinx</a></li> <li><a href="docs/zuul-sphinx/">Zuul Sphinx</a></li>
<li><a href="docs/faq.html">Zuul FAQ</a></li>
</ul> </ul>
</li> </li>
<li><a href="community.html">Community</a></li> <li><a href="community.html">Community</a></li>
@ -227,6 +228,7 @@
<li><a href="https://opendev.org/zuul/zuul/">Source</a></li> <li><a href="https://opendev.org/zuul/zuul/">Source</a></li>
<li><a href="https://pypi.org/project/zuul/">Install</a></li> <li><a href="https://pypi.org/project/zuul/">Install</a></li>
<li><a href="https://zuul-ci.org/docs/">Documentation</a></li> <li><a href="https://zuul-ci.org/docs/">Documentation</a></li>
<li><a href="https://zuul-ci.org/docs/faq.html">FAQ</a></li>
</ul> </ul>
</section> </section>
<section class="3u 6u$(narrower) 12u$(mobilep)"> <section class="3u 6u$(narrower) 12u$(mobilep)">