View source for Help:Getting Started

{{Mbox|image=[[File:Ambox PR.svg|40x40px|link=|alt=]]|text=Please read the [[Help:Cloud_Services_Introduction|Wikimedia Cloud Services Introduction]].}}

{{Warn|content=This page is being considered for merging & redirection. The information is redundant and this is documented elsewhere.}}

==Overview==

[[Help:Cloud_Services_Introduction|Wikimedia Cloud Services]] provides tools, services, and support for technical collaborators who want to contribute to Wikimedia software projects. 

This page outlines the accounts you will need and basic first steps, which will allow you to contribute to this wiki and Wikimedia's technical spaces, including:

* [[Portal:Toolforge|Toolforge]] 
* [[toollabs:openstack-browser/project/|Cloud VPS Projects]]
* [[w:Gerrit_(software)| Gerrit]]

'''You will learn how to:'''

* Join an existing project or begin a new project.
* Add members or admins to projects.
* Create and configure instances within a project.
* Find help and ways to participate.

== Set up your accounts ==

To access and contribute to Cloud Services projects and tools, you will need the following accounts. Please note, these are two distinct accounts:

*'''Wikimedia account''' - this account is used to contribute to Wikipedia and its sister projects.
** When you create your Wikimedia account, you will create a username and password.
*[[Help:Create_a_Wikimedia_developer_account|'''Wikimedia developer account''']] - this account is used to log into this wiki, Toolforge, Cloud VPS, Gerrit and other protected Wikimedia Services.
** When you create your Wikimedia developer account, you will create a username (sometimes called LDAP username), UNIX shell username, and password.

== Get started with Toolforge ==

{{#lst:Portal:Toolforge/Toolforge quickstart|quickstart}}

== Get started with Cloud VPS Projects ==

=== Join an existing project ===

# Choose a project to join with [[toollabs:openstack-browser/|OpenStack browser]].
# Request membership by [[phab: maniphest/task/edit/form/1/ | creating a Phabricator task]] and assigning it directly to the project administrator(s).
#*You can find the list of project admins by going to <kbd><nowiki>http://openstack-browser.toolforge.org/project/<project-name></nowiki></kbd>.

=== Create a new project ===

# Follow the instructions on the [[phab:project/view/2875/|"Cloud-VPS (Project-requests)" phabricator task]].

=== Add members and admin users to a project ===
{{Outdated-inline}}
Project admins can use the following steps to add new members or grant administrative permissions to members.

# Go to [[Special:NovaProject]].
# Use '''Add member''' link to add new members.
# Use '''Add member''' link for the '''projectadmin''' role in the '''Role''' column.
#* Log at {{irc|wikimedia-cloud}} that you added/granted admin to the member. 

=== Learn about project instances ===

To learn more about project instances, read the [[Help:Instances|project instances documentation]].

=== Log your actions ===
{{See also|Tool:Stashbot}}

It is best practice to log changes to all instances of your project.

Wikimedia Cloud Services provides a [[Server Admin Log]] for users to log their project server administration actions on. 

You can add a log entry in the {{irc|wikimedia-cloud}} channel on [[w:Libera Chat|Libera Chat]] by sending a message like: <code>!log <projectname> <message></code>

== Get started with Gerrit ==

Gerrit is Wikimedia's code review system.

Once you have [[#Set up your accounts|created your Wikimedia account and Wikimedia developer account]], including your UNIX shell username, follow the instructions in the [https://www.mediawiki.org/wiki/Gerrit/Tutorial#Set_Up_SSH_Keys_in_Gerrit Gerrit tutorial] to get started.

{{:Help:Cloud Services communication}}

== See also ==

* [[Help:At_a_glance:_Cloud_VPS_and_Toolforge|At-a-Glance: Cloud VPS and Toolforge]]


[[Category:Cloud Services]]