Getting started with Git and Stash

Atlassian Stash は、エンタープライズチーム用の Git リポジトリ管理ソリューションです。組織の全員が Git リポジトリ上で容易にコラボレーションすることができます。

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

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

仮定

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

ローカルコンピューターに Git バージョン 1.7.6 以上がインストールされている。
サポートされているブラウザを使用している。
Stash をインストールし、実行している。まだの場合は、「はじめに」を参照してください。

Git リソースを読み、Git チュートリアルで Git を始めるためのヒントを確認してください。

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

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

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

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

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

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

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

認証についての詳細は、「ユーザーとグループ」を参照してください。

既存のユーザー ID を Stash と一緒に使用したい場合は、「外部ユーザーディレクトリ」を参照してください。

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

プロジェクトを作成する

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

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

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

詳細は「プロジェクトの作成」を参照してください。

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

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

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

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

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

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

詳細は「プロジェクトの権限を使用する」を参照してください。

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

リポジトリを作成する

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

リポジトリが作成されたら、プロジェクト権限はリポジトリに適用されます。つまり、プロジェクト内で作成されたすべてのリポジトリは、同じアクセス権と権限設定を共有します。使用したい Git プロジェクトが既にある場合は、既存のプロジェクトからコードをインポートするを参照してください。

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

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

詳細は「リポジトリの作成」を参照してください。

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

このセクションでは、作成したばかりのリポジトリを複製し、次にコミットをプッシュし返す方法について説明しています。画面の右上に、使用できる複製 URL が表示されます。SSH アクセスを利用可能な場合もあります。

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 へのリンクを示すファイルブラウザに置き換えられていることがわかります。

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

Stash でコードを取得する方法についての詳細は、「既存のプロジェクトからコードをインポートする」を参照してください。巨大な Git リポジトリ (いくつかの GB より大きい) は Git クライアントのパフォーマンスに影響を与える可能性があります – このディスカッションを参照してください。

詳細は「Git チュートリアルとトレーニング」をご覧ください。また、頻繁に使用することになる基本 Git コマンドのリストをご覧ください。

ページツリー