Atlassian Stash is the Git repository management solution for enterprise teams. It allows everyone in your organisation to easily collaborate on your Git repositories.

このページは、Stash の基本を通じてガイドします。最後には、次の方法がわかるようになります:

• 協力者用のアカウントを作成し、これらを権限を持つグループに整理する。
• プロジェクトを作成し、権限を設定する。
• リポジトリを作成し、相互作用のための基本コマンドを知る。

仮定

このガイドでは、ユーザーが過去に Git を体験したことがないと仮定しています。ただし、以下を想定しています。

• ローカルコンピューターに Git バージョン 1.7.6 以上がインストールされている。
• You are using a supported browser.
• You have Stash installed and running. If you haven't, see Getting started.

Please read Git resources or check out our Git tutorials for tips on getting started with Git.

Stash にユーザーを追加し、権限を与える

Stash でまず最初にできることは、協力者の追加です。

ヘッダーの「構成」メニューをクリックして Stash 管理エリアに移動してから、ユーザー (「アカウント」の下) をクリックします。

ユーザーの作成をクリックし、ユーザー作成フォームへ直接移動します:

ユーザーを作成したら、権限の変更をクリックしてアクセス権限を設定します。

ユーザー認証には 4 のレベルがあります。

• システム管理者 — Stash インスタンスのすべての構成設定にアクセスできる。
• 管理者 — システム管理者と同じ権限だが、ファイルパスや Stash サーバー設定は変更できない。
• プロジェクト作成者 — プロジェクトを作成、編集、削除できる。
• Stash ユーザー — Stash へアクセスできるアクティブユーザー。

See Users and groups for more information about authentication.

See External user directories if you have existing user identities you wish to use with Stash.

最初のプロジェクトを作成し、協力者と共有する

プロジェクトを作成する

Stash で次にできることは、プロジェクトの作成です。このプロジェクトに後からリポジトリを追加します。

「プロジェクト」へ移動し、プロジェクトの作成をクリックします。(最初は、本画面のように多くのプロジェクトは表示されません。)

フォームを入力して送信し、新しいプロジェクトを作成します。

See Creating projects for more information.

プロジェクトへのアクセス権を他のユーザーに開く

プロジェクト管理者は、プロジェクトの権限を他の協力者へ与えることができます。

設定をクリックしてから、次にプロジェクトの権限をクリックします。

「プロジェクトの権限」ページでは、作成済みのプロジェクトに対してユーザーやグループを追加できます。

プロジェクトのアクセス権には 3 のレベルがあります。

• 管理者 — リポジトリやプロジェクトを作成、編集および削除でき、プロジェクトの権限を設定できます。
• 書き込み— プロジェクトのすべてのリポジトリからプッシュやプルができます。
• 読み取り — プロジェクトのリポジトリのコードヤコメントを参照したり、プルすることのみできます。

See Using project permissions for more information.

リポジトリを作成し、Stash でコードを取得します。

リポジトリを作成する

プロジェクト管理者は、プロジェクト内でリポジトリを作成できます。

Once a repository is created, the project permissions are applied to the repository. That means all repositories created in a project share the same access and permission settings. If you already have a Git project you'd like to use, see Importing code from an existing project.

リポジトリの作成をクリックし、リポジトリ作成フォームを開きます。

送信されたら、リポジトリホームページへ直接移動します。リポジトリ内にはまだコンテンツがないため、リポジトリへコードをプッシュするのに役立つ指示が表示されます。

See Creating repositories for more information.

シンプルな複製とプッシュ

This section describes how to clone the repository you just created and then push a commit back to it. You can see the clone URL to use at the top right of the screen. SSH access may be available.

In a terminal, run the following command (replace <stashURL> with the URL for your instance of Stash):

git clone <stashURL>/git/<projectname>/<reponame>.git

あなたの Stash ユーザー名とパスワードを使用します。

ターミナルでの結果は、以下のスクリーンショットのようになるはずです。

この時点で、ローカルコンピューターのユーザースペース内に、Git によって追跡された新しい空のディレクトリが作成されているようです。コンテンツを追加し、Stash にプッシュし返しましょう。

<reponame>ディレクトリで、helloworld.txt という名前のテキストファイルを作成し、その中に「Hello World」と書き込みます。

次に、ターミナルで次のコマンドを実行します

cd <reponame>
git add .
git commit -m "My first commit"
git push origin master

すべてが成功すると、Stash 画面を更新したときに、リポジトリのホームページが、helloworld.txt へのリンクを示すファイルブラウザに置き換えられていることがわかります。

これで、協力者とコーディングできるようになりました。

For more information about getting your code into Stash, see Importing code from an existing project. Note that huge Git repositories (larger that a few GBs) are likely to impact the performance of the Git client – see this discussion.

Check out our Git tutorials and training for more information, and have a look at this list of basic Git commands that you will probably use often.