このガイドでは、GitHub アカウントの設定と、コラボレーションやコミュニティに関する GitHub Enterprise Server 機能について説明します。
パート 1: GitHub アカウントの構成
GitHub Enterprise Server の使用を開始するための最初の手� �は、アカウントにアクセスし、2 要� 認証を設定し、プロファイルを表示することです。
GitHub Enterprise Server を使用するすべてのユーザーは、専用の個人アカウントを持っています。これは、複数の組織やチー� の一部である� �合があります。 個人アカウントは、 でのユーザーの ID であり、ユーザーを個人として表すものです。
1. アカウントへのアクセス
GitHub Enterprise Server インスタンスの管理者は、アカウントの認証方法とアクセス方法についてユーザーに通知します。 プロセスは、インスタンス用に構成した認証モードによって異なります。
2. 2 要� 認証の構成
2 要� 認証 (2FA) は、Web サイトまたはアプリにログインするときに使用されるセキュリティの追� のレイヤーです。 アカウントの安全のため、2FA を構成することを強くお勧めします。 詳細については、「2 要� 認証について」を参照してく� さい。
3. GitHub プロファイルとコントリビューション グラフの表示
GitHub プロファイルでは、ピン留めしたリポジトリと gist、公開用に選択した組織メンバーシップ、行ったコントリビューション、および作成したプロジェクトを通じて、自分の作業の様子を確認できます。 詳細については、「プロファイルについて」および「プロファイルでコントリビューションを表示する」を参照してく� さい。
パート 2: GitHub Enterprise Server のツールとプロセスの使用
GitHub Enterprise Server を最適に使用するには、Git を設定する必要があります。 Git は、GitHub に関連してローカルコンピュータで発生するすべての動作の� �本を担っています。 GitHub Enterprise Server で効果的に共同作業を行うには、GitHub Flavored Markdown を使用して issue や pull request を記述します。
1. Git の学習
GitHub の開発における共同作業は、ユーザーがローカル リポジトリから GitHub Enterprise Server にコミットを発行し、他のユーザーが Git を使用してそれらを表示し、フェッチし、更新するというアプローチで進められます。 Git の詳細については、「Git ハンドブック」ガイドを参照してく� さい。 GitHub Enterprise Server での Git の使用方法について詳しくは、「GitHub のフロー」を参照してく� さい。
2. Git の設定
Git をローカルのコンピューターで使用する� �合は、コマンド ライン、IDE エディター、テキスト エディターのいずれを使用するかにかかわらず、Git をインストールして設定する必要があります。 詳細については、「Git のセットアップ」を参照してく� さい。
ビジュアル インターフェイスを使用する� �合は、GitHub Desktop をダウンロードして使用できます。 GitHub Desktop は Git にパッケージ化されているため、Git を個別にインストールする必要はありません。 詳細については、「GitHub Desktop の概要」を参照してく� さい。
Git をインストールすると、ローカル コンピューターから GitHub Enterprise Server リポジトリに接続できるようになります。これは、自分のリポジトリでも、別のユーザーのフォークでも可能です。 Git から のリポジトリに接続する� �合は、HTTPS または SSH を使用して GitHub Enterprise Server での認証を行う必要があります。 詳細については、「リモート リポジトリについて」を参照してく� さい。
3. GitHub Enterprise Server の操作方法の選択
すべてのユーザーは、GitHub を操作するために独自のワークフローを使用します。使用するインターフェイスと方法は、ユーザーの好みとニーズに応じて決まります。
これらの各方法で GitHub Enterprise Server への認証を行う方法について詳しくは、「GitHub への認証方法について」を参照してく� さい。
| 方法 | 説明 | ユース ケース |
|---|---|---|
| GitHub.com を参照する | ファイルをローカルで操作する必要がない� �合、GitHub Enterprise Server では、リポジトリの作成とフォークからファイルの編集、pull request の オープンまで、ほとんどの Git 関連アクションをブラウザーで直接実行できます。 | この方法は、ビジュアル インターフェイスが必要な� �合で、ローカルでの作業を必要とせず、変更を簡単にすばやく行う必要がある� �合に便利です。 |
| GitHub Desktop | GitHub Desktop は、コマンドライン上でテキストコマンドを使うのではなく、ビジュアルインターフェースを使って、あなたの GitHub.com ワークフローを拡張し簡略化します。 GitHub Desktop の使用を開始する方法について詳しくは、「GitHub Desktop の概要」を参照してく� さい。 | この方法は、ファイルをローカルで操作する必要があるが、ビジュアル インターフェイスを通じて Git を使用し、GitHub Enterprise Server を操作したいという� �合に最適です。 |
| IDE またはテキスト エディター | Git でファイルを開いて編集したり、拡張機能を使用したり、プロジェクト構� を表示したりするための、既定のテキスト エディター (Atom や Visual Studio Code など) を設定することができます。 詳細については、「Git とテキスト エディターの関連付け」を参照してく� さい。 | これは、複雑なファイルやプロジェクトを操作している� �合や、すべてを 1 か所に配置したい� �合に便利です。テキスト エディターや IDE を使用すると、エディター内でコマンド ラインに直接アクセスできる� �合が多いためです。 |
| コマンド ライン (GitHub CLI の有無を問わず) | Git の使用方法と GitHub Enterprise Server の操作方法を最も詳細に制御およびカスタマイズするには、コマンド ラインを使用します。 Git コマンドの使用について詳しくは、「Git チートシート」を参照してく� さい。 GitHub CLI は、ユーザーがインストールできる個別のコマンドライン ツールです。これを使用すると、pull request、issue、GitHub Actions、およびその他の GitHub 機能をターミナルに集めて、すべての作業を 1 か所で行うことができます。 詳細については、「GitHub CLI」を参照してく� さい。 | これは、既にコマンド ラインからの操作を行っている (コンテキストの切り替えを回避したい) ユーザーや、コマンド ラインを使用する方が快適なユーザーにとって特に便利です。 |
| GitHub Enterprise Server API | GitHub には、GitHub Enterprise Server の操作に使用できる REST API と GraphQL API が用意されています。 詳しくは、「API を使ってみる」をご覧く� さい。 | GitHub Enterprise Server API は、一般的なタスクを自動化したり、データをバックアップしたり、GitHub を拡張する統合を作成したりしたい� �合に特に役立ちます。 |
4. GitHub Enterprise Server での書き込み
書式設定に GitHub Flavored Markdown を使用すると、issue や pull request の内容を整理し、明確に伝えることができます。これは、読み書きしやすい構文と一部のカスタ� 機能を組み合わせたものです。 詳細については、GitHub での書き込みと書式設定に関するページを参照してく� さい。
GitHub Flavored Markdown については、GitHub Skills の「Communicate using Markdown (Markdown を使用したコミュニケーション)」コースで学習できます。
5. GitHub Enterprise Server での検索
統合検索機能を使うと、GitHub Enterprise Server 上の多くのリポジトリ、ユーザー、コードの行から探しているものを見つけることができます。 検索は GitHub Enterprise Server 全体にわたってグローバルに実行することも、特定のリポジトリや組織に絞って実行することもできます。 GitHub Enterprise Server で実行できる検索の種類について詳しくは、「GitHub での検索について」を参照してく� さい。
検索構文を使用すると、修飾子を使ってクエリを作成し、検索対象を明確に指定できます。 検索で使用する検索構文の詳細については、「GitHub での検索」を参照してく� さい。
6. GitHub Enterprise Server でのファイルの管理
GitHub Enterprise Server では、自分のリポジトリ内、または書き込みアクセス権を持つ任意のリポジトリ内のファイルを作成、編集、移動、削除できます。 ファイルの変更履歴を行単位で追跡することもできます。 詳細については、「GitHub でのファイルの管理」を参照してく� さい。
パート 3: GitHub Enterprise Server での共同作業
GitHub Enterprise Server では、複数のリポジトリで任意の数のユーザーが連携的に作業できます。 ユーザーは、設定を構成したり、プロジェクト ボードを作成したり、通知を管理したりして、効果的なコラボレーションを促進できます。
1. リポジトリの操作
リポジトリを作成する
リポジトリは、プロジェクトのフォルダーのようなものです。 個人アカウントには、任意の数のパブリック リポジトリとプライベート リポジトリを含めることができます。 リポジトリには、フォルダーとファイル、画像、ビデオ、スプレッドシート、データ セットのほか、リポジトリ内のすべてのファイルのリビジョン履歴を含めることができます。 詳細については、リポジトリに関する説明を参照してく� さい。
新しいリポジトリを作成する際には、プロジェクトの概要を紹介する README ファイルと共に、リポジトリを初期化する必要があります。 詳細については、「新しいリポジトリの作成」を参照してく� さい。
リポジトリをクローンする
既存のリポジトリを GitHub Enterprise Server からローカル コンピューターに複製すると、ファイルの追� や削除、マージ競合の修正、複雑なコミットが行いやすくなります。 リポジトリをクローンすると、その時点で GitHub にあるすべてのリポジトリ データの完全なコピーがプルダウンされます。これには、プロジェクトのすべてのファイルとフォルダーの全バージョンが含まれます。 詳細については、「リポジトリをクローンする」を参照してく� さい。
リポジトリをフォークする
フォークは、自分が管理するリポジトリのコピーです。ここで行った変更は、プロジェクト所有者に pull request を送信しない限り、元のリポジトリには影響しません。 一般的にフォークは、他のユーザのプロジェクトへの変更を提案するため、あるいは他のユーザのプロジェクトを自分のアイディアの出発点として活用するために使用します。 詳細については、「フォークの操作」を参照してく� さい。
2. プロジェクトのインポート
既存のプロジェクトの中に、GitHub Enterprise Server に移行したいものがある� �合は、GitHub Importer、コマンド ライン、または外部移行ツールを使用してプロジェクトをインポートできます。 詳細については、「GitHub にソース コードをインポートする」を参照してく� さい。
3. コラボレーターとアクセス許可の管理
リポジトリの Issue、プルリクエスト、プロジェクトボードを使ってプロジェクトで他者とコラボレーションできます。 リポジトリ設定の [コラボレーター] タブから、他のユーザーをコラボレーターとしてリポジトリに招待できます。 詳細については、「コラボレーターを個人リポジトリに招待する」を参照してく� さい。
ユーザーは、自分の個人アカウントで作成したリポジトリの所有者となり、そのリポジトリを完全に制御できます。 コラボレーターにはリポジトリへの書き込みアクセス権が付与されますが、操作のアクセス許可は制限されます。 詳しい情� �については、「個人アカウントのリポジトリのアクセス許可レベル」を参照してく� さい。
4. リポジトリ設定の管理
リポジトリの所有者は、リポジトリの可視性、トピック、ソーシャル メディア プレビューなど、いくつかの設定を構成できます。 詳細については、「リポジトリ設定の管理」を参照してく� さい。
5. 健全なコントリビューションを促すプロジェクトの設定
所有者は、参� ガイドライン、行動規範、サポート リソースなどのファイルをリポジトリに追� することで、コラボレーターが参� しやすい環境を作り、有意義で有用な貢献を促進することができます。 詳細については、「健全なコントリビューションを促すプロジェクトをセットアップする」を参照してく� さい。
6. GitHub Issues とプロジェクト ボードの使用
GitHub Issues を使用すると、issue や pull request に関する作業を整理し、プロジェクト ボードでワークフローを管理できます。 詳細については、「Issue について」と「プロジェクト ボードについて」を参照してく� さい。
7. 通知の管理
通知では、ユーザーがサブスクライブまたは参� している GitHub のアクティビティに関する最新情� �が伝えられます。 会話に関心がなくなった� �合は、今後受信する通知の種類を、サブスクライブ解除、Watch 解除、またはカスタマイズできます。 詳細については、「通知について」を参照してく� さい。
8. GitHub Pages の使用
GitHub Pages を使用すると、 上のリポジトリから Web サイトを直接作成またはホストできます。 詳細については、「GitHub Pages について」を参照してく� さい。
パート 4: GitHub Enterprise Server での作業のカスタマイズと自動化
GitHub Marketplace のツール、GitHub Enterprise Server API、既存の GitHub Enterprise Server 機能を使用し、作業をカスタマイズしたり、自動化したりできます。
1. GitHub Enterprise Server API の使用
GitHub Enterprise Server API には REST API と GraphQL API という 2 つのバージョンがあります。 GitHub Enterprise Server API を使用し、一般的なタスクを自動化したり、データをバックアップしたり、GitHub Enterprise Server を拡張する統合を作成したりできます。 詳細については、「GitHub の API について」を参照してく� さい。
2. GitHub Actions の構築
GitHub Actions を利用すると、GitHub Enterprise Server で の開発ワークフローを自動化したり、カスタマイズしたりできます。 独自のアクションを作成したり、GitHubコミュニティで共有されたアクションを利用したりカスタマイズしたりできます。 詳細については、「GitHub Actions について学ぶ」を参照してく� さい。
3. GitHub Packages の発行と管理
GitHub Packagesはソフトウェアパッケージのホスティングサービスであり、ソフトウェアパッケージをプライベートもしくはパブリックでホストでき、パッケージをプロジェクト中で依存関係として使えるようになります。 詳細については、「GitHub Packages の概要」を参照してく� さい。
パート 5: GitHub Enterprise Server での安全な作業
GitHub Enterprise Server には、リポジトリ内のコードとシークレットをセキュリティで保護するのに役立つ、さまざまなセキュリティ機能があります。 一部の機能はすべてのリポジトリで利用できますが、その他の機能はパブリック リポジトリおよび GitHub Advanced Security ライセンスのあるリポジトリでのみ利用できます。 GitHub Enterprise Server のセキュリティ機能の概要については、「GitHub セキュリティ機能」を参照してく� さい。
1. リポジトリの保護
リポジトリ管理者は、リポジトリのセキュリティ設定を構成することで、リポジトリをセキュリティで保護できます。 これには、リポジトリへのアクセスの管理、セキュリティ ポリシーの設定、依存関係の管理が含まれます。 パブリック リポジトリの� �合、および GitHub Advanced Security が有効になっている組織が所有するプライベート リポジトリの� �合は、コードとシークレットのスキャンを構成して、脆弱性を自動的に特定し、トークンとキーが公開されないようにすることもできます。
リポジトリをセキュリティで保護するために実行できる手� �の詳細については、「リポジトリのセキュリティ保護」を参照してく� さい。
パート 6: GitHub のコミュニティへの参�
GitHub コミュニティにはさまざまな参� 方法があります。 オープン ソース プロジェクトに貢献したり、GitHub Community Support の人と交流したり、GitHub Skills で学習したりできます。
1. オープンソース プロジェクトへの貢献
GitHub でオープン ソース プロジェクトに貢献することは、想像しうるあらゆるスキルを習い、教え、築き上げる方法として有益です。 詳細については、オープン ソース ガイドの「オープン ソースに投稿する方法」を参照してく� さい。
プロジェクトや Good First Issue に関して、過去の投稿、星、その他のアクティビティに基づいて、パーソナライズされた推奨事� �を [詳細] で検索できます。
2. GitHub Community Support とのやり取り
世界中の開発者とつながり、質問をしたり、答えたり、学ん� り、GitHub Enterprise Server のスタッフと直接やりとりできます。 会話を開始するには、「GitHub Community Support」を参照してく� さい。
3. GitHub Docs で GitHub Enterprise Server について読む
GitHub Enterprise Server で使用できる機能が掲載されたドキュメントを読むことができます。 詳細については、「GitHub Docs のバージョンについて」を参照してく� さい。
4. GitHub Skills を使用した学習
GitHub Skills では、自分の GitHub リポジトリでリアルで楽しいプロジェクトを完了することで新しいスキルを習得できます。 各コースは GitHub コミュニティによって作成された実践的なレッスンであり、親切なボットが講師を務めます。
詳細については、「Git と GitHub 学習リソース」を参照してく� さい。