Skip to main content

GitHub Enterprise Serverを使い始める

your GitHub Enterprise Server instance の設定と管理を開始します。

このガイドでは、エンタープライズ管理者として your GitHub Enterprise Server instance の設定、構成、管理を行う方法について説明します。

GitHub には、GitHub Enterprise をデプロイするための方法として、次の 2 つが用意されています。

  • GitHub Enterprise Cloud
  • GitHub Enterprise Server

GitHub Enterprise Cloud は、GitHub でホストされます。 GitHub Enterprise Server は、自身のデータセンターまたはサポートされているクラウド プロバイダーにデプロイしてホストすることができます。

GitHub Enterprise Server の詳細については、「GitHub Enterprise Server について」を参照してください。

パート 1: GitHub Enterprise Server のインストール方法

GitHub Enterprise Server を使い始めるには、Enterprise アカウントの作成とインスタンスのインストールを行い、初期設定に管理コンソールを使用し、インスタンスを構成し、支払いを管理する必要があります。

1. Enterprise アカウントの作成

GitHub Enterprise Server をインストールする前に、GitHub の営業チーム に連絡して、GitHub.com に Enterprise アカウントを作成できます。 GitHub.com の Enterprise アカウントは、支払いや、GitHub Connect を介した GitHub.com での共有機能に役立ちます。 詳細については、「Enterprise アカウントについて」を参照してください。

2. GitHub Enterprise Server のインストール

GitHub Enterprise Server を使い始めるには、選択した仮想化プラットフォームにアプライアンスをインストールする必要があります。 詳細については、「GitHub Enterprise Server インスタンスをセットアップする」を参照してください。

3. 管理コンソールの使用

your GitHub Enterprise Server instance を初めて起動する場合、管理コンソールを使用して、初期設定プロセスを実行します。 また、管理コンソールを使用して、ライセンス、ドメイン、認証、TLS などのインスタンス設定を管理することもできます。 詳細については、「Accessing the management console」 (管理コンソールへのアクセス) を参照してください。

4. your GitHub Enterprise Server instance の構成

管理コンソールに加えて、サイト管理ダッシュボードと管理シェル (SSH) を使用して your GitHub Enterprise Server instance を管理することもできます。 たとえば、アプリケーションやレート制限を構成したり、レポートを表示したり、コマンドライン ユーティリティを使用したりすることができます。 詳細については、「Enterprise を設定する」を参照してください。

動的ホスト構成プロトコル (DHCP) を介して GitHub Enterprise Server で使用される既定のネットワーク設定を使用することも、仮想マシン コンソールを使用してネットワーク設定を構成することもできます。 プロキシサーバあるいはファイアウォールルールを設定することもできます。 詳細については、「ネットワークを設定する」を参照してください。

5. 高可用性の構成

your GitHub Enterprise Server instance を高可用性向けに構成して、ハードウェア障害やネットワークの停止による影響を最小限に抑えることができます。 詳細については、「High Availability の設定」を参照してください。

6. ステージング インスタンスのセットアップ

ステージング インスタンスを設定して、your GitHub Enterprise Server instance に適用される前に変更をテストし、ディザスター リカバリーを計画し、更新プログラムを試すことができます。 詳細については、「ステージング インスタンスのセットアップ」を参照してください。

7. バックアップとディザスター リカバリーの指定

運用データを保護するには、GitHub Enterprise Server Backup Utilities による your GitHub Enterprise Server instance の自動バックアップを構成できます。 詳細については、「Configuring backups on your appliance」 (アプライアンスでのバックアップの構成) を参照してください。

8. Enterprise の支払いの管理

Enterprise アカウントに接続されているすべての Organization および GitHub Enterprise Server インスタンスの支払いは、有料のすべての GitHub.com サービスに対する単一の請求料金として集計されます。 Enterprise オーナーと支払いマネージャーは、Enterprise アカウントの支払い設定にアクセスして管理することができます。 詳細については、「Managing billing for your enterprise」 (Enterprise の支払いの管理) を参照してください。

パート 2: Team の編成と管理

Enterprise オーナーまたは管理者は、ユーザー、リポジトリ、Team、Organization のレベルの設定を管理できます。 Enterprise のメンバーの管理、Organization の作成と管理、リポジトリ管理に関するポリシーの設定、Team の作成と管理を行うことができます。

1. your GitHub Enterprise Server instance のメンバーの管理

You can manage settings and audit activity for the members of your GitHub Enterprise Server instance. You can promote an enterprise member to be a site administrator, manage dormant users, view the audit log for user activity, and customize messages that enterprise members will see. For more information, see "Managing users in your enterprise."

2. Organization の作成

You can create new organizations in your GitHub Enterprise Server instance to reflect your company or group's structure. For more information, see "Creating a new organization from scratch."

3. Organization へのメンバーの追加

You can add members to organizations in your GitHub Enterprise Server instance as long as you are an organization owner in the organizations you want to manage. You can also configure visibility of organization membership. For more information, see "Adding people to your organization" and "Configuring visibility for organization membership."

4. チームの作成

Teams は、特定のリポジトリに対するアクセス許可をグループとして付与できる組織メンバーのグループです。 各組織で、個々のチームまたは複数のレベルの入れ子になったチームを作成できます。 詳細については、「チームの作成」と「チームへのユーザーの追加」を参照してください。

5. Organization とリポジトリのアクセス許可レベルの設定

各 Organization の限られた数のメンバーに、Organization の完全な管理アクセスを提供する Organization のオーナー ロールを与えることをお勧めします。 詳細については、「Organization のロール」を参照してください。

管理者権限を持つ Organization の場合、詳細な権限レベルを使って各リポジトリへのアクセスをカスタマイズすることもできます。 詳細については、Organization のリポジトリの権限レベルに関するページを参照してください。

6. リポジトリ管理ポリシーの適用

As an enterprise owner, you can set repository management policies for all organizations in your GitHub Enterprise Server instance, or allow policies to be set separately in each organization. For more information, see "Enforcing repository management policies in your enterprise."

パート 3: 安全なビルド

your GitHub Enterprise Server instance のセキュリティを強化するには、エンタープライズ メンバーの認証を構成し、ツールと監査ログを使用してコンプライアンスを維持し、組織のセキュリティおよび分析機能を構成し、必要に応じて GitHub Advanced Security を有効にすることができます。

1. Enterprise メンバーの認証

GitHub Enterprise Server の組み込み認証方法を使用するか、CAS、LDAP、SAML などの外部の認証プロバイダーを選び、既存のアカウントを統合して、your GitHub Enterprise Server instance へのユーザー アクセスを一元的に管理することができます。 詳しくは、「Enterprise の認証について」をご覧ください。

また、Organization ごとに 2 要素認証を要求することもできます。 詳細については、「Organization に 2 要素認証を要求する」を参照してください。

2. コンプライアンスの維持

必要な状態チェックとコミット検証を実装して、Organization のコンプライアンス標準を適用し、コンプライアンス ワークフローを自動化できます。 また、Organization の監査ログを使用して、Team によって実行されるアクションをレビューすることもできます。 詳細については、「Pre-receive フックを使ってポリシーを適用する」および「About the audit log for your enterprise」 (Enterprise の監査ログについて) を参照してください。

3. Organization のセキュリティ機能の構成

To keep the organizations in your GitHub Enterprise Server instance secure, you can use a variety of GitHub security features, including security policies, dependency graphs, secret scanning and Dependabot security and version updates. For more information, see "Securing your organization" and "Managing security and analysis settings for your organization."

4. GitHub Advanced Security 機能の有効化

GitHub Enterprise Server ライセンスをアップグレードして、GitHub Advanced Security を含めることができます。 これにより、コードやシークレット スキャンなど、ユーザーがコード内のセキュリティ上の問題を検出して修正するのに役立つ追加機能が提供されます。 詳細については、「Enterprise の GitHub Advanced Security」を参照してください。

パート 4: GitHub での Enterprise の作業のカスタマイズと自動化

GitHub と OAuth Apps、GitHub Enterprise Server API、GitHub Actions、GitHub Packages、GitHub Pages を使用して、Enterprise 内の Organization での作業をカスタマイズおよび自動化できます。

1. GitHub Apps と OAuth Apps のビルド

GitHub Apps や OAuth Apps などの GitHub Enterprise Server API との統合を構築し、ワークフローを補完および拡張するために Enterprise 内の Organization で使用することができます。 詳細については、「About apps」 (アプリについて) を参照してください。

2. GitHub Enterprise Server API の使用

GitHub Enterprise Server API には REST API と GraphQL API という 2 つのバージョンがあります。 GitHub Enterprise Server API を使用し、一般的なタスクを自動化したり、データをバックアップしたり、GitHub Enterprise Server を拡張する統合を作成したりできます。 詳細については、「GitHub の API について」を参照してください。

3. GitHub Actions のビルド

With GitHub Actions, you can automate and customize your GitHub Enterprise Server instance's development workflow on GitHub Enterprise Server. You can create your own actions, and use and customize actions shared by the GitHub community. For more information, see "Learn GitHub Actions."

GitHub Enterprise Server で GitHub Actions を有効にして構成する方法の詳細については、「GitHub Enterprise Server の GitHub Actions を使い始める」を参照してください。

4. GitHub Packages の公開と管理

GitHub Packagesはソフトウェアパッケージのホスティングサービスであり、ソフトウェアパッケージをプライベートもしくはパブリックでホストでき、パッケージをプロジェクト中で依存関係として使えるようになります。 詳細については、「GitHub Packages の概要」を参照してください。

your GitHub Enterprise Server instance の GitHub Packages を有効にして構成する方法の詳細については、「エンタープライズの GitHub Packages を使い始める」を参照してください。

5. GitHub Pages の使用

GitHub Pages は、HTML、CSS、JavaScript ファイルをリポジトリから直接取得し、Web サイトを発行する静的サイト ホスティング サービスです。 組織レベルでエンタープライズ メンバーの GitHub Pages を有効または無効にすることができます。 詳細については、「エンタープライズの GitHub Pages を構成する」と「GitHub Pages について」を参照してください。

パート 5: 他の GitHub リソースとの接続

GitHub Connect を使用してリソースを共有することができます。

GitHub Enterprise Server インスタンスと、GitHub Enterprise Cloud の Organization または Enterprise アカウントの両方のオーナーである場合、GitHub Connect を有効にすることができます。 GitHub Connect を使用すると、your GitHub Enterprise Server instance と GitHub Enterprise Cloud の間で、統合検索やコントリビューションなどの特定のワークフローや機能を共有できます。 詳細については、「GitHub Enterprise Cloud への GitHub Enterprise Server の接続」を参照してください。

パート 6: GitHub の学習およびサポート リソースの使用

エンタープライズ メンバーは、学習リソースを使用して Git と GitHub の詳細を学ぶことができます。また、your GitHub Enterprise Server instance の設定および管理を行う際に、GitHub エンタープライズ サポートを使用して必要なサポートを受けることができます。

1. GitHub Docs で GitHub Enterprise Server に関するドキュメントを読む

GitHub Enterprise Server で使用できる機能が掲載されたドキュメントを読むことができます。 詳細については、「GitHub Docs のバージョンについて」を参照してください。

エンタープライズで GitHub Enterprise Server を最も効果的に使用する方法については、「エンタープライズのベスト プラクティス」を参照してください。

2. GitHub Skills による学習

GitHub Skills では、エンタープライズ メンバーは自分の GitHub リポジトリでリアルで楽しいプロジェクトを完了することで新しいスキルを習得できます。 各コースは GitHub コミュニティによって作成された実践的なレッスンであり、親切なボットが講師を務めます。

詳細については、「Git と GitHub 学習リソース」を参照してください。

3. GitHub Enterprise サポートの使用

GitHub Enterprise Server には、GitHub Enterprise サポート へのアクセスが含まれます。 GitHub Enterprise サポート は、GitHub Enterprise Server で発生する問題の解決に役立ちます。 GitHub Premium Support にサインアップし、追加機能を得ることもできます。 詳細については、「GitHub Enterprise サポート について」を参照してください。