Bitbucket/Get Started

From Wikiversity
Jump to navigation Jump to search

To get started with Bitbucket, you will need to create a user account and then create a repository. In this article you will also use the web interface to create a README, add files and folders to the repository, and then delete files and delete the repository.

Create a User Account[edit | edit source]

  1. Review Atlassian: Sign up for Bitbucket Cloud.
  2. Review YouTube: Introduction to Bitbucket.
  3. Visit Bitbucket: Create your account.
  4. Enter your email address, full name, and password.
  5. Confirm your email address.
  6. Select a username for your profile. Your username will be used to identify your repositories. For example, a username of Wikiversity would have URLs similar to https://bitbucket.org/wikiversity/repository_name.

Create a Repository[edit | edit source]

  1. Review Atlassian: Create and Clone a Repository.
  2. Visit Bitbucket: Account Signin and log into Bitbucket.
  3. Select Repositories / Create repository.
  4. Enter Test for the repository name.
  5. Select the option to make it a private repository.
  6. Select Git as the repository type.
  7. Create the repository.

Create a README[edit | edit source]

  1. Review Atlassian: Display README Text on the Overview.
  2. Create a README for the new repository. The README may contain anything you like. Because it is a private repository, only you and users you invite will be able to see this repository. Note: A README may automatically be created for you when creating the repository.
  3. Commit the change to create the README file.
  4. Observe the new front page for your repository.
  5. If desired, edit the README and commit additional changes now that you are able to see how the README will appear.

Create a File[edit | edit source]

Bitbucket repositories are typically managed using the git command line or a git utility. But it is also possible to edit content directly using the Bitbucket website.

  1. In your Bitbucket repository on the left, select Source.
  2. On the right, select ... and Add file.
  3. Enter test.txt for the filename.
  4. Enter anything you wish for the file content.
  5. Commit the change.

Edit a File[edit | edit source]

  1. In your Bitbucket repository on the left, select Source.
  2. On the right, select test.txt.
  3. Select Edit.
  4. Change the file content to anything you wish, but something different so you can see the change.
  5. Select View diff to see the change.
  6. Commit the change.

Create a Folder and File[edit | edit source]

  1. In your Bitbucket repository on the left, select Source.
  2. On the right, select New file or Add file or ... and Add file.
  3. Enter My Folder/My File.txt for the filename.
  4. Enter anything you wish for the file content.
  5. Commit the change.

Share Repository[edit | edit source]

  1. In your Bitbucket repository at the top, select ... and Share repository.
  2. Enter the email address of the Bitbucket user you would like to share your repository with in the text box under "Users".
  3. Select the permissions you would like the user to have from Read, Write, or Admin.
  4. Select Add to add the user to your repository.

Delete a Folder and File[edit | edit source]

  1. In your Bitbucket repository on the left, select Source.
  2. On the right, select My Folder.
  3. Select My File.txt to view the file.
  4. On the right, select the down arrow beside Edit and select Delete.
  5. Commit the change.
  6. In your Bitbucket repository on the left, select Source.
  7. Observe that an empty folder is automatically removed from a git repository.

Delete a Repository[edit | edit source]

  1. In your Bitbucket repository on the left, select Settings.
  2. Observe the repository options available.
  3. At the bottom of the page, select Delete repository.
  4. Delete your Test repository.

Use Bitbucket[edit | edit source]

You are now ready to use Bitbucket and create your own repository.

See Also[edit | edit source]