github projects teams
GitHubに関するこのチュートリアルでは、GitHubプロジェクト、組織とチーム、リポジトリのフォーク、問題とプロジェクトのマイルストーン、GitHubWikiなどの概念について説明します。
GitHubの一連のチュートリアルの前回のチュートリアルでは、開発者がプラットフォームを利用してプロジェクト関連のアーティファクトを保存し、バージョン管理を行う方法を説明しました。また、プルリクエスト、ブランチのマージ、分岐、および保護に関する概念も確認しました。
まあ、それだけではありません。このチュートリアルでは、さらに深く掘り下げて、GitHubが開発者のために他に何ができるかを調べます。
=> こちらで完璧なGitHubトレーニングガイドをご覧ください。
これが私たちが焦点を当てるものです。
- 組織とチームを作成する
- リポジトリをフォークする
- 問題の作成とマイルストーンのプロジェクト
- プロジェクトボードを作成する
- GitHubWikiの作成
学習内容:
組織とチームを作成する
このセクションの前身として、GitHubは次の3種類のアカウントを提供します。
- 個人ユーザーアカウント ここでは、無制限のパブリックおよびプライベートリポジトリを作成し、共同編集者を招待することもできます。
- 組織アカウント これは主に共有アカウントの概念であり、このセクションで詳しく説明します。
- エンタープライズアカウント これは、GitHubを使用するユーザーのポリシーを内部で管理する企業によって使用されます。これは通常、GitHubEnterpriseのオンプレミスバージョンで使用されます。
パート1では、そのユーザーがリポジトリの単一の所有者である単一の個人アカウントを使用してリポジトリがどのように作成されるかを確認しました。これは、3〜9人、またはそれ以上の人数がいる小規模なスクラムチームに適しています。また、単一のプロジェクトのリポジトリを作成することもできます。
しかし、実行のために複数のリポジトリと複数のチームが同じものにアクセスする必要がある大規模なGithubプロジェクトがある場合はどうなりますか?ここでは、GitHubOrganizationが1つの大きなプロジェクトの複数のリポジトリをグループ化するのにどのように役立つかを確認する必要があります。したがって、複数のリポジトリ/チームが関与するため、複数の所有者も存在します。
新しい組織の作成を開始するには、をクリックします + 右上で選択します 新しい組織。
それに応じてプランを選択してください。今のところ無料プランを利用します。 オープンソースチーム。
組織に関する詳細を入力し、をクリックします 次。
Javaで新しいリストを作成する方法
メンバーを組織に追加し、をクリックします セットアップを完了します。
次のステップは、プロジェクトのニーズに応じてリポジトリの作成を開始し、それにチームを追加することです。
をクリックすることもできます 誰かを招待する 作成したばかりの組織にメンバーを追加します。メンバーが追加されると、役割をメンバーまたは所有者として割り当てることもできます。これを行うには、 人 タブで選択します 役割の変更 そのメンバーのために。
さて、今のところ、1人のユーザーを所有者として、もう1人をメンバーとして保持します。したがって、所有者は複数のリポジトリを作成し、それぞれのリポジトリにチームを割り当てることができます。
リポジトリを作成する前に、まずチームを作成しましょう。に移動します チーム タブをクリックしてクリックします 新しいチーム。
UIチームとミドルウェアチームの2つのチームを作成します。
クリック チームを作成します。 チームが作成されたら、以下に示すようにチームにメンバーを追加できます。
同様に、他のチームを作成し、それにメンバーを追加します。これで、2つのチームがあることがわかります。
リポジトリの作成に進みましょう。だから、シナリオとして、今私たちは作成します 2つのリポジトリ つまり、1つはUI関連のコードを保持し、もう1つはミドルウェアコードを保持します。チームはそれに応じて割り当てられます。
に移動します リポジトリ タブを作成し、 新しいリポジトリ 。
クリックしてください リポジトリを作成する ボタン。次に、UIチームにリポジトリへのアクセスを提供します。
に移動します チーム タブ。クリックしてください UIチーム に行きます リポジトリ タブ。各チームをクリックして、からリポジトリを再度追加します。 リポジトリ タブ。
リポジトリの名前を入力して、リポジトリを追加します。
また、 書き込み許可 このリポジトリへのチームメンバーの場合、つまり、チームメンバーはこのリポジトリを読み取り、複製し、プッシュすることができます。
同様に、上記の手順を実行して、ミドルウェアリポジトリを他のチームに追加します。したがって、現在、リポジトリを含む組織とチームもあります。チームメンバーは、アクセス権のあるリポジトリのクローンを作成して、同じリポジトリで作業できます。
GitHubフォーク
リポジトリをフォークし、元のリポジトリとの同期を維持します。
前のセクションと前のチュートリアルでは、リポジトリが作成され、ソースコードが追加されているのを見ました。さて、元のリポジトリがそれを行う場所ではないときに、チームがいくつかのコード変更をテストしたい場合はどうでしょうか。
元のリポジトリをそのままにして、コードへの変更を試すには、コピーを作成する必要があります。これは呼ばれます GitHub フォーク 。 フォークを作成するには、組織ではなく個人アカウントで作成されたリポジトリに移動します。クリック フォーク 右上にあります。
元のリポジトリをフォークする必要があるアカウントを選択します。この場合、リポジトリがフォークされる組織アカウントを選択します。
リポジトリは次のようにフォークされます Demo-Proj-Org / Demo_Project_Repo_VN 。したがって、コードを使用した実験は、元のリポジトリではなく、フォークされたリポジトリで実行できます。
元のリポジトリで変更が行われた場合は、フォークされたリポジトリが 同期 。コマンドラインオプションを使用して、フォークされたリポジトリを同期させることができますが、プルリクエストを作成する方が簡単なオプションです。
元のリポジトリ内のファイルに変更が加えられたと仮定して、プルリクエストの作成に進みます。
リンクをクリックしてください フォーク間で比較します。
図のように、ヘッドを元のリポジトリとして選択し、ベースをフォークされたリポジトリとして選択して、をクリックします。 プルリクエストを作成します。
クリック プルリクエストをマージし、マージを確認します。
変更はフォークされたリポジトリに表示され、元のリポジトリと同期されます。
GitHubの問題とプロジェクトのマイルストーン
通常、すべてのプロジェクトで、進捗状況の一部としてタスク、欠陥、拡張機能などを追跡する必要があります。 GitHubの問題を使用して、プロジェクトボードとともに上記のすべての問題を追跡できます。
問題がある場合は、プルリクエストに同じものを関連付けて、プルリクエストがマージされたときに自動的に閉じることができるようにすることができます。また、未解決の問題がある場合は、他のリポジトリに転送することもできます。このセクションでは、問題の使用方法についてさらに詳しく説明します。
問題とマイルストーンの作成
リポジトリのメインページに移動し、に移動します 問題点 タブ。クリック 新しい問題。
共同作業者に割り当てて作業し、ラベルを追加して拡張機能として区別します。良い習慣はまたについて言及することです マイルストーン 提起された問題の進行状況を追跡するため。
クリック 新しい問題を送信します。
問題の概要が表示されます。発行番号は#11であり、後で参照されることに注意してください。
問題は別のリポジトリに転送することもできます。それを行うためのオプションは下部にあります 「転送の問題」。
追加する 期日 マイルストーンへ–R1。リポジトリのメインページで、 問題点 タブをクリックしてクリックします マイルストーン 。
編集 マイルストーンR1の詳細と、期日を追加します。完了したら、変更を保存します。
マイルストーンR1には2つの未解決の問題があり、完了率も確認できます。
統合テストでテストされる2つの主要な項目は、インターフェイスと期待される結果です。
マイルストーンR1をクリックして、このマイルストーンで提供される問題を確認します。問題を上下に移動することで、問題の優先順位を変更することもできます。
フィルタの問題
オープン/クローズ状態にあり、複数の共同作業者に割り当てられている複数の問題があると想定します。特定の基準に基づいてこれらの問題を検索することは非常に重要です。
例えば、 割り当てられたすべての問題、オープン状態のすべての問題など。GitHubには、問題をフィルタリングしたり、リクエストをプルしたりするための検索オプションが用意されています。
(問題)タブに移動します フィルタボックスに次のように基準を入力します。
たとえば、未解決の問題はすべて未解決状態で、共同編集者に割り当てられています。
タイプ:問題の状態:開いている担当者:vniranjan2512マイルストーン:R1ラベル:拡張
問題をプルリクエストに関連付ける
プルリクエストが特定のキーワードと問題番号で参照され、マージされると、問題は自動的に閉じられます。コミットがキーワードと課題番号で参照されている場合でも、課題はクローズされます。
キーワードは任意です。 閉じる、閉じる、修正、修正、解決、解決。
例えば、 プルリクエストまたはコミットメッセージの言及 #11を閉じます。
プルリクエストを作成し、メッセージに示されているようにキーワードと参照番号を伝えます。クリック プルリクエストを作成してマージします。
この問題は、プルリクエストのマージ時に自動的にクローズされます。少しの自動化が絶対に必要です。
ソースコードから新しい問題を作成または開く
コードが変更された場合は、新しい問題を開くことができます。これにより、コード変更行のURLが問題に追加されます。コードの非編集モードで、コード行の横にある3つのドット(…)をクリックして、( 新刊の参考文献 。
問題の詳細が更新されました。
ピンの問題
問題をピン留めして、問題を見つけやすくし、からの重複する問題を回避することもできます。 作成されています。
問題を開き、問題の右下にあるをクリックします ピンの問題。
これで、問題が問題リストの上に追加されます。
注意: 最大3つの問題をいつでも固定できます。
GitHubプロジェクトボード
GitHubのプロジェクトボードは、問題を視覚化する簡単な方法を提供します。プロジェクトの進行状況を表示し、まだ開始されていない問題、進行中の問題、および完了した問題を確認できます。
GitHubのプロジェクトボードは、ワークフローが事前定義されているかんばんテンプレートに基づいて作成でき、カスタマイズも可能です。この例では、ユーザーアカウントに基づいて作成されたボードを紹介します。
リポジトリのメインページで、 プロジェクト タブを作成し、 新しいプロジェクト。
上からわかるように、プロジェクトボードは次のことに役立ちます。
- タスクの並べ替え
- プロジェクトを計画する
- ワークフローを自動化する
- 進捗状況を追跡する
- ステータスの共有
- プロジェクトを閉じる
基本的なかんばんテンプレートを備えた新しいプロジェクトボード。
ボードはワークフローで作成されます。をクリックして、ワークフロー列を追加することもできます。 +列を追加します。
ワークフローは自動化することもできます。 例えば、 新しい問題が作成された場合は、直接追加できます。 To-Doステータス。 を選択 自動化を管理する そのステータスのオプション。
チェックボックスを選択します 新しく追加されました (自動化の更新)をクリックします。そのため、新しい課題が作成されると、その課題に対して選択されたプロジェクトが自動的にに追加されます。 To-Doステータス。 また、既存の問題をステータスにドラッグアンドドロップして、あるステータスから別のステータスに移動することもできます。
列にメモを追加して、その列の問題に関する重要な情報を確実に提供することもできます。クリックしてください + 署名してメモを追加します。
クリック 追加。
ドキュメントのGitHubWiki
プロジェクトで非常に重要なアクティビティの1つは、チーム全体が使用できるようにリポジトリのドキュメントを作成して維持することです。 GitHubリポジトリには、GitHubWikiを使用してそのようなドキュメントを作成するためのサポートが付属しています。したがって、プロジェクトとその使用法に関するすべての情報をwikiに取り込むことができます。
Wikiは、GitHubの公開リポジトリで無料で利用できます。 Wikiはオープンソースのマークアップライブラリを使用します。ウィキを作成しながら、このライブラリを使用する方法を見ていきます。
リポジトリのWikiサポートを有効にする
リポジトリのメインページで、をクリックします。 設定 タブを押して、 ウィキ オプションが下で選択されている 特徴 セクション。
GitHubWikiを作成する
リポジトリのメインページで、 ウィキ タブ。クリック 最初のページを作成します。
タイトルを入力し、Wikiにテキストを追加します。また、Markdownサポートを使用してフォーマットオプションを使用することもできます。クリックしてください ページを保存 一度行われた。
上記のコンテンツでは、#は見出し1、##は見出し2、###は見出し3であることに注意してください。 *は順不同のリストに使用されます。プレビューは以下のようになります。
xboxoneに最適なVRヘッドセット
に ウィキ タブをクリックします +カスタムフッターを追加します。
コンテンツを追加してページを保存します。
保存したWikiを開くと、フッターが表示されます。
サイドバーを追加
wikiタブで+をクリックします カスタムサイドバーを追加します。
サイドバーのコンテンツを追加し、ページを保存します。
ウィキを開くと、サイドバーが表示されます。
Wikiの履歴を表示する
履歴では、誰が変更を行ったか、メッセージをコミットしたか、変更が行われた日付を確認できます。
Wikiを開き、ページを編集します。クリック ページ履歴、 右側にあります。
ハッシュをクリックして変更を確認します。リビジョンを選択して、変更を比較し、新しいリビジョンの変更を元に戻します。クリック 変更を元に戻します。
変更は以前のリビジョンに戻されます。
注意 :Wikiを編集する権限に基づいて、変更を元に戻すことができます。
結論
GitHubシリーズのパート1とパート2では、バージョン管理アクティビティ、リポジトリの作成、プルリクエスト、ブランチ、コードレビュー、組織とチーム、リポジトリのフォーク、ラベル、マイルストーン、問題、GitHubプロジェクト、Wikiについて説明しました。
今後のチュートリアルでは、リリースの作成、Jiraとの統合などについて説明します。 Gitコマンド これは、開発者がGitHubリポジトリに変更をプッシュする前に役立ちます。
すべての開発者が、GitHubのこの実践的なアプローチがプロジェクトで役立つことを願っています。
=> 独占的なGitHubトレーニングチュートリアルシリーズについては、こちらをご覧ください。
推奨読書
- ソフトウェアプロジェクトにおけるリスクの種類
- 開発者向けのGitHubチュートリアル| GitHubの使用方法
- DevOpsでEclipseを使用してJAVAプロジェクトにMicrosoftTFSを使用する方法
- JIRAアジャイルチュートリアル:アジャイルプロジェクトを管理するためにJIRAを効果的に使用する方法
- 手動プロジェクトと自動化プロジェクトでは、テスト計画はどのように異なりますか?
- Seleniumアサーションの例-プロジェクトでの実用的なアプリケーション
- オンサイト-ソフトウェアテストプロジェクトのオフショアモデル(およびそれを機能させる方法)
- GitとGitHub:例を使用して違いを探る