Bitbucket/Get Started
Appearance
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]- Review Atlassian: Sign up for Bitbucket Cloud.
- Review YouTube: Introduction to Bitbucket.
- Visit Bitbucket: Create your account.
- Enter your email address, full name, and password.
- Confirm your email address.
- 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]- Review Atlassian: Create and Clone a Repository.
- Visit Bitbucket: Account Signin and log into Bitbucket.
- Select Repositories / Create repository.
- Enter
Test
for the repository name. - Select the option to make it a private repository.
- Select Git as the repository type.
- Create the repository.
Create a README
[edit | edit source]- Review Atlassian: Display README Text on the Overview.
- 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.
- Commit the change to create the README file.
- Observe the new front page for your repository.
- 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.
- In your Bitbucket repository on the left, select
Source
. - On the right, select
...
andAdd file
. - Enter
test.txt
for the filename. - Enter anything you wish for the file content.
- Commit the change.
Edit a File
[edit | edit source]- In your Bitbucket repository on the left, select
Source
. - On the right, select
test.txt
. - Select
Edit
. - Change the file content to anything you wish, but something different so you can see the change.
- Select
View diff
to see the change. - Commit the change.
Create a Folder and File
[edit | edit source]- In your Bitbucket repository on the left, select
Source
. - On the right, select
New file
orAdd file
or...
andAdd file
. - Enter
My Folder/My File.txt
for the filename. - Enter anything you wish for the file content.
- Commit the change.
Share Repository
[edit | edit source]- In your Bitbucket repository at the top, select
...
andShare repository
. - Enter the email address of the Bitbucket user you would like to share your repository with in the text box under "Users".
- Select the permissions you would like the user to have from
Read
,Write
, orAdmin
. - Select
Add
to add the user to your repository.
Delete a Folder and File
[edit | edit source]- In your Bitbucket repository on the left, select
Source
. - On the right, select
My Folder
. - Select
My File.txt
to view the file. - On the right, select the down arrow beside
Edit
and selectDelete
. - Commit the change.
- In your Bitbucket repository on the left, select
Source
. - Observe that an empty folder is automatically removed from a git repository.
Delete a Repository
[edit | edit source]- In your Bitbucket repository on the left, select
Settings
. - Observe the repository options available.
- At the bottom of the page, select
Delete repository
. - Delete your Test repository.
Use Bitbucket
[edit | edit source]You are now ready to use Bitbucket and create your own repository.