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