Help:At a glance: Cloud VPS and Toolforge: Difference between revisions
BryanDavis (talk | contribs) wikimedia-labs renamed to wikimedia-cloud |
cleanup Wikimedia Labs and Tool Labs (a few remaining), add new FAQ at bottom |
||
Line 1: | Line 1: | ||
{{TOC|align=right}} |
{{TOC|align=right}} |
||
'''Frequently asked questions''' about Wikimedia |
'''Frequently asked questions''' about Wikimedia Cloud VPS and Toolforge. |
||
Ever wondered what is the difference between ''Labs'', ''Tool Labs'', ''Projects'' and ''Tools''? Are you confused by new terms used on Wikimedia |
Ever wondered what is the difference between ''Labs'', ''Tool Labs'', ''Projects'' and ''Tools''? Are you confused by new terms used on Wikimedia Cloud VPS? Hopefully this page will help. |
||
Note: If you know all this, but you are looking for more technical details, see [[Help:Terminology]]. |
Note: If you know all this, but you are looking for more technical details, see [[Help:Terminology]]. |
||
{{Clear}} |
{{Clear}} |
||
== What is Wikimedia |
== What is Wikimedia Cloud VPS? == |
||
'''Wikimedia |
'''Wikimedia Cloud VPS''' (or '''Cloud VPS''') is a [[:w:Cloud computing|cloud computing]] infrastructure powered by [[:w:OpenStack|OpenStack]] for projects related to the [[:meta:Wikimedia movement|Wikimedia movement]]. Volunteer contributors can use this infrastructure to create and maintain open source software projects. |
||
Cloud VPS is divided into projects. Each project has separate members and administrators who can create and maintain virtual machines ("instances") for use by that project. Each project can have own its own access policies, DNS records, etc. |
|||
For help with |
For help with Cloud VPS, see [[Help:Cloud Services Introduction]]. |
||
== What is |
== What is Toolforge (aka Tools)? == |
||
Toolforge is one of the projects hosted by Wikimedia Cloud VPS. The Toolforge administrators manage a pool of virtual servers that provide a shared project hosting environment that can be used by Toolforge users. These resources include [[Help:Toolforge/Web|web servers]], [[Help:Toolforge/Database|databases]] and [[Help:Toolforge#Redis|other data storage]], and a [[Help:Toolforge/Grid|distributed job processing system]]. These services provide a reliable and scalable hosting environment for volunteers to develop and operate their tools and bots. |
|||
Users of the |
Users of the Toolforge project create "tool" accounts (technically [[#What_is_a_Service_group.3F|service groups]]) which allow one or more users to collaborate to manage the software source code, configuration, and jobs for that tool or bot. |
||
For help with |
For help with Toolforge, see [[Help:Toolforge]]. |
||
== What is the difference between |
== What is the difference between Cloud VPS and Toolforge? == |
||
{{ |
{{anchor|Labs vs Tool labs}} |
||
{{Shortcut|Help:Cloud VPS vs Toolforge}} |
|||
Cloud VPS is an [[:w:Cloud_computing#Infrastructure_as_a_service_.28IaaS.29|Infrastructure as a service (IaaS)]] solution. It provides virtual machines, storage, firewall, and HTTPS proxy resources to projects. The members of each individual project are responsible for managing applications, data, runtime, middleware, and OSes themselves. |
|||
Toolforge is a [[:w:Cloud_computing#Platform_as_a_service_.28PaaS.29|Platform as a service (PaaS)]] solution. It provides [[Help:Toolforge/Web|web servers]], [[Help:Toolforge/Database|databases]] and [[Help:Toolforge#Redis|other data storage]], and a [[Help:Toolforge/Grid|distributed job processing system]] as managed services that can be used by tools and their maintainers. |
|||
== What is a Project? == |
== What is a Project? == |
||
A project is a unit of privilege separation inside the |
A project is a unit of privilege separation inside the Cloud VPS environment. Each project has separate management of membership, virtual machines, HTTPS proxies, firewall rules, etc. Examples of projects include [[Portal:Toolforge|Toolforge]] and the [[Nova_Resource:Deployment-prep|Beta Cluster]]. |
||
== What is an Instance? == |
== What is an Instance? == |
||
An instance is a virtual machine that hosted inside Wikimedia |
An instance is a virtual machine that hosted inside Wikimedia Cloud VPS. Every instance belongs to a project. An example of an instance is "tools-exec-02". |
||
== What is a Service group? == |
== What is a Service group? == |
||
A service group is an LDAP user account which is meant to be used as a service user account for various applications. For example, if you want to install an application and run its executables as a service user (as opposed to running it as your personal user name), you can create a service group for one or more applications. |
A service group is an LDAP user account which is meant to be used as a service user account for various applications. For example, if you want to install an application and run its executables as a service user (as opposed to running it as your personal user name), you can create a service group for one or more applications. |
||
Service groups can be configured per project. In the case of |
Service groups can be configured per project. In the case of Toolforge, each tool automatically has its own service group to keep tools from accessing each other without permission. |
||
== What is |
== What is Cloud VPS for? == |
||
Wikimedia |
Wikimedia Cloud VPS is for the volunteers to get involved in Wikimedia operations and software development. Cloud VPS contains many projects, each of which uses one or more instances. [[Nova_Resource:Tools|Toolforge]] is one of the most important projects in Wikimedia Cloud VPS. |
||
== How does |
== How does Cloud VPS work? == |
||
Wikimedia |
Wikimedia Cloud VPS is a virtualization cluster and hosts various virtual machines (called instances) using [http://www.openstack.org/software/openstack-compute OpenStack Compute].This is slightly different from your normal servers that you ssh to (i.e. Toolserver), as virtual machines do not exist physically, but reside inside a much bigger machine called the host machine. More details about the physical setup of Cloud VPS can be found under [[Labs infrastructure]]. |
||
== I am new to Wikimedia |
== I am new to Wikimedia Cloud VPS. What should I do next? == |
||
If you haven’t done so, [https://wikitech.wikimedia.org/w/index.php?title=Special:UserLogin&returnto=Help%3AGetting+Started&type=signup create a user account] here on Wikitech. Go through our [[Help:Getting Started|Getting Started]] and [[Help:Contents|Help]] documents. If you want more help drop by our irc channel {{irc|#wikimedia-cloud}} channel on Freenode or drop a mail to our mailing list [https://lists.wikimedia.org/mailman/listinfo/labs-l labs-l mailing list] and ask for help. |
If you haven’t done so, [https://wikitech.wikimedia.org/w/index.php?title=Special:UserLogin&returnto=Help%3AGetting+Started&type=signup create a user account] here on Wikitech. Go through our [[Help:Getting Started|Getting Started]] and [[Help:Contents|Help]] documents. If you want more help drop by our irc channel {{irc|#wikimedia-cloud}} channel on Freenode or drop a mail to our mailing list [https://lists.wikimedia.org/mailman/listinfo/labs-l labs-l mailing list] and ask for help. |
||
Line 57: | Line 58: | ||
== What is shell access? == |
== What is shell access? == |
||
Shell access to Wikimedia |
Shell access to Wikimedia Cloud VPS gives you the ability to access the virtual machine instances. It depends on your accounts access rights and the projects you have been assigned. Only project admins are allowed to create and manage instances. |
||
== What is Puppet? == |
== What is Puppet? == |
||
Line 66: | Line 67: | ||
== What is a bastion instance? == |
== What is a bastion instance? == |
||
For security purposes most lab instances cannot be directly accessed from the Internet. To log in to other instances a bastion instance is used. The |
For security purposes most lab instances cannot be directly accessed from the Internet. To log in to other instances a bastion instance is used. The Cloud VPS bastion (bastion.wmflabs.org) is accessible by every wikitech account holder with shell access. |
||
== Where can I find other |
== Where can I find other Cloud VPS Terminology explained? == |
||
On [[Help:Terminology|Terminology]] page. |
On [[Help:Terminology|Terminology]] page. |
||
== What were Wikimedia Labs and Tool labs? == |
|||
These were the old names for Wikimedia Cloud VPS and for Toolforge. They are slowly being [[phab:phame/post/view/59/labs_and_tool_labs_being_renamed/ | renamed]] to clarify everything, from mid-2017. |
|||
[[Category:Wikimedia Labs]] |
[[Category:Wikimedia Labs]] |
Revision as of 00:27, 29 July 2017
Frequently asked questions about Wikimedia Cloud VPS and Toolforge.
Ever wondered what is the difference between Labs, Tool Labs, Projects and Tools? Are you confused by new terms used on Wikimedia Cloud VPS? Hopefully this page will help.
Note: If you know all this, but you are looking for more technical details, see Help:Terminology.
What is Wikimedia Cloud VPS?
Wikimedia Cloud VPS (or Cloud VPS) is a cloud computing infrastructure powered by OpenStack for projects related to the Wikimedia movement. Volunteer contributors can use this infrastructure to create and maintain open source software projects.
Cloud VPS is divided into projects. Each project has separate members and administrators who can create and maintain virtual machines ("instances") for use by that project. Each project can have own its own access policies, DNS records, etc.
For help with Cloud VPS, see Help:Cloud Services Introduction.
What is Toolforge (aka Tools)?
Toolforge is one of the projects hosted by Wikimedia Cloud VPS. The Toolforge administrators manage a pool of virtual servers that provide a shared project hosting environment that can be used by Toolforge users. These resources include web servers, databases and other data storage, and a distributed job processing system. These services provide a reliable and scalable hosting environment for volunteers to develop and operate their tools and bots.
Users of the Toolforge project create "tool" accounts (technically service groups) which allow one or more users to collaborate to manage the software source code, configuration, and jobs for that tool or bot.
For help with Toolforge, see Help:Toolforge.
What is the difference between Cloud VPS and Toolforge?
Cloud VPS is an Infrastructure as a service (IaaS) solution. It provides virtual machines, storage, firewall, and HTTPS proxy resources to projects. The members of each individual project are responsible for managing applications, data, runtime, middleware, and OSes themselves.
Toolforge is a Platform as a service (PaaS) solution. It provides web servers, databases and other data storage, and a distributed job processing system as managed services that can be used by tools and their maintainers.
What is a Project?
A project is a unit of privilege separation inside the Cloud VPS environment. Each project has separate management of membership, virtual machines, HTTPS proxies, firewall rules, etc. Examples of projects include Toolforge and the Beta Cluster.
What is an Instance?
An instance is a virtual machine that hosted inside Wikimedia Cloud VPS. Every instance belongs to a project. An example of an instance is "tools-exec-02".
What is a Service group?
A service group is an LDAP user account which is meant to be used as a service user account for various applications. For example, if you want to install an application and run its executables as a service user (as opposed to running it as your personal user name), you can create a service group for one or more applications.
Service groups can be configured per project. In the case of Toolforge, each tool automatically has its own service group to keep tools from accessing each other without permission.
What is Cloud VPS for?
Wikimedia Cloud VPS is for the volunteers to get involved in Wikimedia operations and software development. Cloud VPS contains many projects, each of which uses one or more instances. Toolforge is one of the most important projects in Wikimedia Cloud VPS.
How does Cloud VPS work?
Wikimedia Cloud VPS is a virtualization cluster and hosts various virtual machines (called instances) using OpenStack Compute.This is slightly different from your normal servers that you ssh to (i.e. Toolserver), as virtual machines do not exist physically, but reside inside a much bigger machine called the host machine. More details about the physical setup of Cloud VPS can be found under Labs infrastructure.
I am new to Wikimedia Cloud VPS. What should I do next?
If you haven’t done so, create a user account here on Wikitech. Go through our Getting Started and Help documents. If you want more help drop by our irc channel ##wikimedia-cloud connect channel on Freenode or drop a mail to our mailing list labs-l mailing list and ask for help.
I have a project idea. How can I request a new project?
If you haven’t done so, create a user account on Wikitech. If you need to create a new project for your development work, place your request on phabricator. You can also get help by dropping by our irc channel on Freenode (#wikimedia-cloud connect) or sending a mail to our mailing list .
I want to contribute to an existing project. where can I find the project list ?
How can I contact a human? (How can I get help from a human)
Drop by our irc channel on Freenode (#wikimedia-cloud connect) or send a mail to our mailing list labs-l mailing list.
What is shell access?
Shell access to Wikimedia Cloud VPS gives you the ability to access the virtual machine instances. It depends on your accounts access rights and the projects you have been assigned. Only project admins are allowed to create and manage instances.
What is Puppet?
Puppet is a configuration management system. When instances are created, they build themselves according to a set of rules (manifests, template, and files) defined by puppet. learn more about puppet.
What is gerrit?
Gerrit is a code review system that manages git repositories. It will provide a simple framework for reviewing every commit before it is accepted into the code base. When a volunteer submit a patch it is reviewed using Gerrit by the project admins before it gets merged to the code base. See the Gerrit tutorial on mediawiki.org for more information.
What is a bastion instance?
For security purposes most lab instances cannot be directly accessed from the Internet. To log in to other instances a bastion instance is used. The Cloud VPS bastion (bastion.wmflabs.org) is accessible by every wikitech account holder with shell access.
Where can I find other Cloud VPS Terminology explained?
On Terminology page.
What were Wikimedia Labs and Tool labs?
These were the old names for Wikimedia Cloud VPS and for Toolforge. They are slowly being renamed to clarify everything, from mid-2017.