1
0
mirror of https://github.com/gluster/glusterdocs.git synced 2026-02-05 15:47:01 +01:00

Add Ops guide onto docs

Signed-off-by: Nigel Babu <nigelb@redhat.com>
This commit is contained in:
Nigel Babu
2016-05-03 13:44:44 +05:30
parent 232b9fed87
commit 1598de07af
3 changed files with 61 additions and 0 deletions

28
Ops-Guide/Overview.md Normal file
View File

@@ -0,0 +1,28 @@
Over the years the infrastructure and services consumed by the Gluster.org
community have grown organically. There have been instances of design and
planning but the growth has mostly been ad-hoc and need based.
Central to the plan of revitalizing the Gluster.org community is the ability to
provide well maintained infrastructure services with predictable uptimes and
resilience. We're migrating the existing services into the Community Cage. The
implied objective is that the transition would open up ways and means of the
formation a loose coalition among Infrastructure Administrators who provide
expertise and guidance to the community projects within the OSAS team.
A small group of Gluster.org community members were asked to assess the current
utilization and propose a planned growth. The ad-hoc nature of the existing
infrastructure is an impediment to the development of a proposal based on
standardized methods of extrapolation. A part of the projection is based on a
combination of patterns and heuristics - problems which have been observed and
how mitigation strategies have enabled the community to continue to consume the
services available.
The guiding principle for the assessment has been the need to migrate services
to "Software-as-a-Service" models and providers wherever applicable and deemed
fit. To illustrate this specific directive - the documentation/docs aspect of
Gluster.org has been continously migrating artifacts to readthedocs.org while
focusing on simple integration with the website. The website itself has been
put within the Gluster.org Github.com account to enable ease of maintenance and
sustainability.
For more details look at the full [Tools List](/Ops-Guide/Tools.md).

30
Ops-Guide/Tools.md Normal file
View File

@@ -0,0 +1,30 @@
## Tools We Use
| Service/Tool | Purpose | Hosted At |
|----------------------|------------------------------------|-----------------|
| Gerrit | Code Review | Temporary Racks|
| Jenkins | CI, build-verification-test | Temporary Racks|
| Backups | Website, Gerrit and Jenkins backup | Temporary Racks|
| Bugs WebUI | A dashboard for all OPEN bugs | Temporary Racks|
| Docs | Documentation content | readthedocs.org |
| download.gluster.org | Official download site of the binaries | Temporary Racks|
| Sonar | Static analysis | Rackspace |
| Salt-master | Manage part of the infra | Rackspace |
| Web-Builder | Cronjob building and deploying the website | Rackspace |
| Mailman | Lists mailman | Rackspace |
| www.gluster.org | Web asset | Rackspace |
| SuperColony | real name of website server (and do-it-all server ) | Rackspace |
## Notes
* download.gluster.org: Resiliency is important for availability and metrics.
Since it's official download, access need to restricted as much as possible.
TODO: Who has access?
* Sonar: Infrequently used and mostly idle.
* Salt-master: Michael would have more detail. TODO: Add more detail.
* Web-Builder: Managed by misc with salt. Stateless, Can be trashed and
reinstalled.
* Mailman: Should be migrated to a separate host. Should be made more redundant
(ie, more than 1 MX).
* www.gluster.org: Framework, Artifacts now exist under gluster.github.com. Has
various legacy installation of software (mediawiki, etc ), being cleaned as
we find them.

View File

@@ -85,6 +85,9 @@ pages:
- Bug Reporting Template : Contributors-Guide/Bug-reporting-template.md
- GlusterFS Release process : Contributors-Guide/GlusterFS-Release-process.md
- Guidelines For Maintainers : Contributors-Guide/Guidelines-For-Maintainers.md
- Ops Guide:
- Index: Ops-Guide/Overview.md
- Tools: Ops-Guide/Tools.md
- Upgrade-Guide:
- Upgrade-Guide Index: Upgrade-Guide/README.md
- Upgrade to 3.5: Upgrade-Guide/upgrade_to_3.5.md