Help:Create a Wikimedia developer account: Difference between revisions

From Wikitech
Content deleted Content added
No edit summary
Line 43: Line 43:
#* The UNIX shell username will be used to interact with servers via [[Help:Access|ssh]] and for [[:mw:Gerrit/Getting_started|git with Gerrit]].
#* The UNIX shell username will be used to interact with servers via [[Help:Access|ssh]] and for [[:mw:Gerrit/Getting_started|git with Gerrit]].
# Create your Wikimedia developer account.
# Create your Wikimedia developer account.

==== Next steps ====

# [https://toolsadmin.wikimedia.org/tools/membership/apply Fill out an access request to join the Toolforge project].
# [[:mw:Gerrit/Tutorial#Generate_a_new_SSH_key|Generate an SSH key]], if you do not already have one.
# Associate your SSH public key with your Wikimedia developer account using the [[Special:Preferences#mw-prefsection-openstack|'''Preferences > OpenStack tab''']] or [https://toolsadmin.wikimedia.org/profile/settings/ssh-keys Toolforge admin console].
# Wait for your access request for the Tools project to be processed. You should receive a message on your [[Special:MyTalk | Wikitech talk page]]).

==== Common issues ====
* Your LDAP username and your UNIX shell login username may be different. Visit [https://toolsadmin.wikimedia.org/profile/settings/accounts '''Settings > Linked accounts in the Toolforge admin console'''] and check your "Shell account name".
* The passwords you chose for your developer account and SSH key may be different.


== VPS and General Users ==
== VPS and General Users ==
Line 63: Line 52:
#* The UNIX shell username will be used to interact with servers via [[Help:Access|ssh]] and for [[:mw:Gerrit/Getting_started|git with Gerrit]].
#* The UNIX shell username will be used to interact with servers via [[Help:Access|ssh]] and for [[:mw:Gerrit/Getting_started|git with Gerrit]].
# Create your Wikimedia developer account.
# Create your Wikimedia developer account.

=== Uploading an SSH key {{anchor|Upload_your_SSH_key}} ===

Wikimedia Cloud Services products and [[gerrit:|Wikimedia Code Review]] use an [[w:Secure_Shell|SSH key]] to authenticate you. If you already have an SSH key you can use that one, or [[mw:Git/Tutorial#Set_Up_SSH_Keys_in_Gerrit|generate a new one]] specifically for Wikimedia use; the default public key name generated by [[w:Ssh-keygen|ssh-keygen]] is typically <tt>id_rsa.pub</tt>.

Upload the generated public key from the [[Special:Preferences#mw-prefsection-openstack|'{{MediaWiki:Prefs-openstack}}' tab in your Preferences]] '''or''' use [https://toolsadmin.wikimedia.org/profile/settings/ssh-keys the toolsadmin interface].

See Also: [[Help:SSH|SSH Help]]

You can test your key by attempting to connect to the <code>bastion</code> VPS project: <code>ssh -v bastion.wmflabs.org</code>.

{{note|You will only be able to ssh to <code>bastion</code> '''after''' you have been added as a member of at least one VPS project (e.g. Toolforge). Users can verify their project membership via OpenStack Browser at <code>https<nowiki>:</nowiki>//tools.wmflabs.org/openstack-browser/user/<shellname></code>}}

==== Upload your SSH key to Gerrit ====

Upload your public key to [https://gerrit.wikimedia.org Gerrit (Wikimedia's code review tool)].
# β€œSign In” with your Wikimedia Developer Account
# Click β€œSettings” link in drop down menu under your username at page top right
# Click β€œSSH Public Keys” in left sidebar
# Paste your public key into the text field and click β€œAdd” button. Thereafter, the form presents "Add key ..." button instead, for if you have more keys you want to add.

Revision as of 23:18, 6 April 2018

The steps outlined here may not be accurate and require review and testing.

Overview

This page will teach you how to create a Wikimedia developer account.

A Wikimedia developer account is required in addition to a Wikimedia account, if you plan to access, use, and make contributions to Wikimedia's protected services.

Some of the protected services that require both a Wikimedia developer account and a Wikimedia unified account include:

Prerequisites

Step 1: Create a Wikimedia account

Step 2: Decide which service you need a Wikimedia developer account for

  • Toolforge users should follow this process to create Wikimedia developer accounts.
  • VPS and general users should follow this process to create Wikimedia developer accounts.

Toolforge users

Create a Wikimedia developer account

  1. Go to the Toolforge admin console.
  2. In the Login with your Wikimedia account box press the Login using Wikimedia account button.
  3. You will be taken to a Wikimedia account login screen.
  4. Enter your Wikimedia account username and password.
  5. Once you are logged into your Wikimedia account, you will return to the Toolforge admin console.
  6. You will be prompted to create an LDAP username, a UNIX shell username, and password. You will also be prompted to enter your email address and agree to the terms of service and code of conduct for technical spaces.
    • The LDAP username will be used to log in on Wikitech, Gerrit and the Toolforge admin console.
    • The UNIX shell username will be used to interact with servers via ssh and for git with Gerrit.
  7. Create your Wikimedia developer account.

VPS and General Users

Create a Wikimedia developer account

  1. Go to the Wikimedia developer account creation page on Wikitech, and fill in the fields.
    • The LDAP username will be used to log in on Wikitech, Gerrit and the Toolforge admin console.
    • The UNIX shell username will be used to interact with servers via ssh and for git with Gerrit.
  2. Create your Wikimedia developer account.