This guide will walk you through setting up, configuring and managing GitHub Enterprise Serverのインスタンス as an enterprise administrator.
GitHub provides two ways to deploy GitHub Enterprise.
- GitHub Enterprise Cloud
- GitHub Enterprise Server
GitHub hosts GitHub Enterprise Cloud. You can deploy and host GitHub Enterprise Server in your own datacenter or a supported cloud provider.
For an overview of how GitHub Enterprise Server works, see "System overview."
パート 1: GitHub Enterprise Server のインストール方法
To get started with GitHub Enterprise Server, you will need to create your enterprise account, install the instance, use the Management Console for initial setup, configure your instance, and manage billing.
1. Creating your enterprise account
Before you install GitHub Enterprise Server, you can create an enterprise account on GitHub.com by contacting GitHub's Sales team. An enterprise account on GitHub.com is useful for billing and for shared features with GitHub.com via GitHub Connect. 詳細は「Enterprise アカウントについて」を参照してください。
2. GitHub Enterprise Serverのインストール
To get started with GitHub Enterprise Server, you will need to install the appliance on a virtualization platform of your choice. 詳細は「GitHub Enterprise Serverインスタンスをセットアップする」を参照してください。
3. Using the Management Console
You will use the Management Console to walk through the initial setup process when first launching GitHub Enterprise Serverのインスタンス. You can also use the Management Console to manage instance settings such as the license, domain, authentication, and TLS. For more information, see "Accessing the management console."
4. GitHub Enterprise Serverのインスタンス を設定する
In addition to the Management Console, you can use the site admin dashboard and the administrative shell (SSH) to manage GitHub Enterprise Serverのインスタンス. For example, you can configure applications and rate limits, view reports, use command-line utilities. For more information, see "Configuring your enterprise."
You can use the default network settings used by GitHub Enterprise Server via the dynamic host configuration protocol (DHCP), or you can also configure the network settings using the virtual machine console. プロキシサーバあるいはファイアウォールルールを設定することもできます。 For more information, see "Configuring network settings."
5. High Availability の設定
You can configure GitHub Enterprise Serverのインスタンス for high availability to minimize the impact of hardware failures and network outages. For more information, see "Configuring high availability."
6. ステージングインスタンスのセットアップ
You can set up a staging instance to test modifications, plan for disaster recovery, and try out updates before applying them to GitHub Enterprise Serverのインスタンス. 詳しい情報については "ステージングインスタンスのセットアップ"を参照してください。
7. Designating backups and disaster recovery
To protect your production data, you can configure automated backups of GitHub Enterprise Serverのインスタンス with GitHub Enterprise Serverバックアップユーティリティ. 詳しくは、" アプライアンスでのバックアップの設定。"を参照してください。
8. Enterprise の支払いを管理する
Billing for all the organizations and GitHub Enterprise Server instances connected to your enterprise account is aggregated into a single bill charge for all of your paid GitHub.com services. Enterprise owners and billing managers can access and manage billing settings for enterprise accounts. For more information, see "Managing billing for your enterprise."
Part 2: Organizing and managing your team
As an enterprise owner or administrator, you can manage settings on user, repository, team and organization levels. You can manage members of your enterprise, create and manage organizations, set policies for repository management, and create and manage teams.
1. Managing members of GitHub Enterprise Serverのインスタンス
You can manage settings and audit activity for the members of GitHub Enterprise Serverのインスタンス. 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 GitHub Enterprise Serverのインスタンス to reflect your company or group's structure. 詳しい情報については、「新しい Organization をゼロから作成する」を参照してください。
3. Adding members to organizations
You can add members to organizations in GitHub Enterprise Serverのインスタンス 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. Teamの作成
Teams are groups of organization members that can be granted permissions to specific repositories as a group. You can create individual teams or multiple levels of nested teams in each of your organizations. For more information, see "Creating teams" and "Adding people to teams."
5. Setting organization and repository permission levels
We recommend giving a limited number of members in each organization an organization owner role, which provides complete administrative access for that organization. 詳しい情報については、「Organization の権限レベル」を参照してください。
For organizations where you have admin permissions, you can also customize access to each repository with granular permission levels. For more information, see "Repository permissions levels for an organization."
6. Enforcing repository management policies
As an enterprise owner, you can set repository management policies for all organizations in GitHub Enterprise Serverのインスタンス, or allow policies to be set separately in each organization. 詳しい情報については、「Enterprise でのリポジトリ管理ポリシーを適用する」を参照してください。
Part 3: Building securely
To increase the security of GitHub Enterprise Serverのインスタンス, you can configure authentication for enterprise members, use tools and audit logging to stay in compliance, configure security and analysis features for your organizations, and optionally enable GitHub Advanced Security.
1. Authenticating enterprise members
You can use GitHub Enterprise Server's built-in authentication method, or you can choose between an established authentication provider, such as CAS, LDAP, or SAML, to integrate your existing accounts and centrally manage user access to GitHub Enterprise Serverのインスタンス. For more information, see "Authenticating users for GitHub Enterprise Serverのインスタンス."
You can also require two-factor authentication for each of your organizations. For more information, see "Requiring two factor authentication for an organization."
2. Staying in compliance
You can implement required status checks and commit verifications to enforce your organization's compliance standards and automate compliance workflows. You can also use the audit log for your organization to review actions performed by your team. For more information, see "Enforcing policy with pre-receive hooks" and "Audit logging."
3. Enabling GitHub Advanced Security features
You can upgrade your GitHub Enterprise Server license to include GitHub Advanced Security. This provides extra features that help users find and fix security problems in their code, such as code and secret scanning. For more information, see "GitHub Advanced Security for your enterprise."
Part 4: Customizing and automating your enterprise's work on GitHub
You can customize and automate work in organizations in your enterprise with GitHub and OAuth App, GitHub API, GitHub Actions, GitHub Packages , and GitHub Pages.
1. Building GitHub Apps and OAuth App
You can build integrations with the GitHub API, such as GitHub Apps or OAuth App, for use in organizations in your enterprise to complement and extend your workflows. 詳しい情報については「アプリケーションについて」を参照してください。
2. Using the GitHub API
There are two versions of the GitHub API: the REST API and the GraphQL API. You can use the GitHub APIs to automate common tasks, back up your data, or create integrations that extend GitHub Enterprise Server. For more information, see "About GitHub's APIs."
3. Building GitHub Actions
With GitHub Actions, you can automate and customize GitHub Enterprise Serverのインスタンス's development workflow on GitHub Enterprise Server. 独自のアクションを作成したり、GitHubコミュニティで共有されたアクションを利用したりカスタマイズしたりできます。 詳しい情報については、「GitHub Actions を学ぶ」を参照してください。
For more information on enabling and configuring GitHub Actions on GitHub Enterprise Server, see "Getting started with GitHub Actions for GitHub Enterprise Server."
4. Publishing and managing GitHub Packages
GitHub Packagesはソフトウェアパッケージのホスティングサービスであり、ソフトウェアパッケージをプライベートもしくはパブリックでホストでき、パッケージをプロジェクト中で依存関係として使えるようになります。 For more information, see “Introduction to GitHub Packages."
For more information on enabling and configuring GitHub Packages for GitHub Enterprise Serverのインスタンス, see "Getting started with GitHub Packages for your enterprise."
5. GitHub Pagesを使用する
GitHub Pages is a static site hosting service that takes HTML, CSS, and JavaScript files straight from a repository and publishes a website. You can enable or disable GitHub Pages for your enterprise members at the organization level. For more information, see "Configuring GitHub Pages for your enterprise" and "About GitHub Pages."
Part 5: Connecting with other GitHub resources
You can use GitHub Connect to share resources.
If you are the owner of both a GitHub Enterprise Server instance and a GitHub Enterprise Cloud organization or enterprise account, you can enable GitHub Connect. GitHub Connect allows you to share specific workflows and features between GitHub Enterprise Serverのインスタンス and GitHub Enterprise Cloud, such as unified search and contributions. 詳細は、「GitHub Enterprise ServerをGitHub Enterprise Cloudに接続する」を参照してください。
Part 6: Using GitHub's learning and support resources
Your enterprise members can learn more about Git and GitHub with our learning resources, and you can get the support you need when setting up and managing GitHub Enterprise Serverのインスタンス with GitHub Enterprise Support.
1. Learning with GitHub Learning Lab
Your enterprise members can learn new skills by completing fun, realistic projects in their very own GitHub repository with GitHub Learning Lab. Each course is a hands-on lesson created by the GitHub community and taught by the friendly Learning Lab bot.
For more information, see “Git and GitHub learning resources."
2. Working with GitHub Enterprise Support
GitHub Enterprise Server includes access to GitHub Enterprise Support. GitHub Enterprise Support can help you troubleshoot issues that come up on GitHub Enterprise Server. You can also choose to sign up for GitHub Premium Support for additional features. For more information, see "About GitHub Enterprise Support."