You are browsing a read-only backup copy of Wikitech. The live site can be found at wikitech.wikimedia.org

Help:Getting Started

From Wikitech-static
Revision as of 16:16, 17 December 2021 by imported>Aklapper (→‎Add members and admin users to a project)
Jump to navigation Jump to search

Overview

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:

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.
  • 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

  1. Choose a project to join with OpenStack browser.
  2. Request membership by creating a Phabricator task and assigning it directly to the project administrator(s).
    • You can find the list of project admins by going to http://openstack-browser.toolforge.org/project/<project-name>.

Create a new project

  1. Follow the instructions on the "Cloud-VPS (Project-requests)" phabricator task.

Add members and admin users to a project

Project admins can add new members or grant administrative permissions to members via https://horizon.wikimedia.org/project/member/

  1. Log at #wikimedia-cloud connect that you added/granted admin to the member.

Learn about project instances

To learn more about project instances, read the project instances documentation.

Log your actions

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 #wikimedia-cloud connect channel on Libera Chat by sending a message like: !log <projectname> <message>

Get started with Gerrit

Gerrit is Wikimedia's code review system.

Once you have created your Wikimedia account and Wikimedia developer account, including your UNIX shell username, follow the instructions in the Gerrit tutorial to get started.

Communication and support

Support and administration of the WMCS resources is provided by the Wikimedia Foundation Cloud Services team and Wikimedia movement volunteers. Please reach out with questions and join the conversation:

Discuss and receive general support
Receive mail announcements about critical changes
Subscribe to the cloud-announce@ mailing list (all messages are also mirrored to the cloud@ list)
Track work tasks and report bugs
Use the Phabricator workboard #Cloud-Services for bug reports and feature requests about the Cloud VPS infrastructure itself
Learn about major near-term plans
Read the News wiki page
Read news and stories about Wikimedia Cloud Services
Read the Cloud Services Blog (for the broader Wikimedia movement, see the Wikimedia Technical Blog)

See also