BIN
assets/images/help/copilot/access-removal-list.png
Normal file
|
After Width: | Height: | Size: 16 KiB |
BIN
assets/images/help/copilot/add-people-add-teams.png
Normal file
|
After Width: | Height: | Size: 5.2 KiB |
BIN
assets/images/help/copilot/add-teams.png
Normal file
|
After Width: | Height: | Size: 11 KiB |
BIN
assets/images/help/copilot/allow-all-members.png
Normal file
|
After Width: | Height: | Size: 16 KiB |
BIN
assets/images/help/copilot/confirm-seat-assignment-selected.png
Normal file
|
After Width: | Height: | Size: 7.8 KiB |
BIN
assets/images/help/copilot/confirm-seat-assignment.png
Normal file
|
After Width: | Height: | Size: 16 KiB |
BIN
assets/images/help/copilot/csv-results.png
Normal file
|
After Width: | Height: | Size: 16 KiB |
BIN
assets/images/help/copilot/disable-access.png
Normal file
|
After Width: | Height: | Size: 16 KiB |
|
After Width: | Height: | Size: 22 KiB |
BIN
assets/images/help/copilot/duplication-detection-org-policy.png
Normal file
|
After Width: | Height: | Size: 22 KiB |
|
After Width: | Height: | Size: 14 KiB |
BIN
assets/images/help/copilot/manage-access-search.png
Normal file
|
After Width: | Height: | Size: 6.0 KiB |
BIN
assets/images/help/copilot/manage-org-access-enterprise.png
Normal file
|
After Width: | Height: | Size: 26 KiB |
BIN
assets/images/help/copilot/monthly-usage-enterprise.png
Normal file
|
After Width: | Height: | Size: 23 KiB |
BIN
assets/images/help/copilot/org-level-seat-view.png
Normal file
|
After Width: | Height: | Size: 10 KiB |
BIN
assets/images/help/copilot/proxy-authorization.png
Normal file
|
After Width: | Height: | Size: 6.0 KiB |
BIN
assets/images/help/copilot/proxy-configuration-jetbrains.png
Normal file
|
After Width: | Height: | Size: 32 KiB |
BIN
assets/images/help/copilot/proxy-strict-ssl.png
Normal file
|
After Width: | Height: | Size: 5.7 KiB |
BIN
assets/images/help/copilot/proxy-textbox.png
Normal file
|
After Width: | Height: | Size: 9.6 KiB |
BIN
assets/images/help/copilot/remove-access-button.png
Normal file
|
After Width: | Height: | Size: 7.9 KiB |
BIN
assets/images/help/copilot/remove-access.png
Normal file
|
After Width: | Height: | Size: 11 KiB |
BIN
assets/images/help/copilot/save-disabled.png
Normal file
|
After Width: | Height: | Size: 16 KiB |
BIN
assets/images/help/copilot/save-org-settings-enterprise.png
Normal file
|
After Width: | Height: | Size: 5.6 KiB |
BIN
assets/images/help/copilot/selected-users-teams.png
Normal file
|
After Width: | Height: | Size: 16 KiB |
BIN
assets/images/help/copilot/server-certificates-jetbrains.png
Normal file
|
After Width: | Height: | Size: 6.2 KiB |
BIN
assets/images/help/copilot/set-org-permissions-enterprise.png
Normal file
|
After Width: | Height: | Size: 12 KiB |
BIN
assets/images/help/copilot/user-permissions-save.png
Normal file
|
After Width: | Height: | Size: 16 KiB |
@@ -89,7 +89,6 @@ To discover how a member was added to an organization, you can filter the member
|
||||
* {% data reusables.enterprise-accounts.emu-forks %}
|
||||
* Only private and internal repositories can be created in organizations owned by an {% data variables.enterprise.prodname_emu_enterprise %}, depending on organization and enterprise repository visibility settings.
|
||||
* {% data variables.enterprise.prodname_managed_users_caps %} are limited in their use of {% data variables.product.prodname_pages %}. For more information, see "[About {% data variables.product.prodname_pages %}](/pages/getting-started-with-github-pages/about-github-pages#limitations-for-enterprise-managed-users)."
|
||||
* {% data reusables.copilot.emus-cannot-use-copilot %}
|
||||
|
||||
## Getting started with {% data variables.product.prodname_emus %}
|
||||
|
||||
|
||||
@@ -0,0 +1,62 @@
|
||||
---
|
||||
title: Enforcing policies for GitHub Copilot in your enterprise
|
||||
intro: 'You can enforce policies for {% data variables.product.prodname_copilot_for_business %} within your enterprise''s organizations, or allow policies to be set in each organization.'
|
||||
permissions: Enterprise owners can enforce policies for {% data variables.product.prodname_copilot_for_business %} in an enterprise.
|
||||
product: '{% data reusables.gated-features.copilot-billing %}'
|
||||
versions:
|
||||
ghec: '*'
|
||||
type: how_to
|
||||
topics:
|
||||
- Copilot
|
||||
- Enterprise
|
||||
- Organizations
|
||||
- Policies
|
||||
shortTitle: GitHub Copilot policies
|
||||
---
|
||||
|
||||
## About policies for {% data variables.product.prodname_copilot %} in your enterprise
|
||||
|
||||
{% data reusables.copilot.about-copilot %}
|
||||
|
||||
You can enforce policies for {% data variables.product.prodname_copilot_for_business %} within your enterprise's organizations, or allow policies to be set in each organization.
|
||||
|
||||
If you set up a subscription for {% data variables.product.prodname_copilot_for_business %}, you can grant and revoke access to {% data variables.product.prodname_copilot %} for organizations within your enterprise. Once you grant an organization access to {% data variables.product.prodname_copilot %}, the admins of that organization can grant access to individuals and teams. For more information, see "[Configuring {% data variables.product.prodname_copilot %} settings in your organization](/copilot/configuring-github-copilot/configuring-github-copilot-settings-in-your-organization)."
|
||||
|
||||
{% data variables.product.prodname_copilot_for_business %} subscriptions are billed monthly, based on the number of {% data variables.product.prodname_copilot %} seats assigned to users within your enterprise. For more information, see "[{% data variables.product.prodname_copilot %} pricing for {% data variables.product.prodname_ghe_cloud %}](/enterprise-cloud@latest/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot#github-copilot-pricing-for-github-enterprise-cloud)."
|
||||
|
||||
{% data variables.product.prodname_copilot %} includes a filter which detects code suggestions matching public code on {% data variables.product.prodname_dotcom %}. {% data variables.product.prodname_copilot_for_business %} lets you choose whether to enable or disable the filter at the enterprise-level, or allow organization admins to decide at the organization-level. When the filter is enabled, {% data variables.product.prodname_copilot %} checks code suggestions with their surrounding code of about 150 characters against public code on {% data variables.product.prodname_dotcom %}. If there is a match or near match, the suggestion will not be shown.
|
||||
|
||||
## Enforcing a policy to manage the use of {% data variables.product.prodname_copilot_for_business %} in your enterprise
|
||||
|
||||
{% data reusables.enterprise-accounts.policies-tab %}
|
||||
{% data reusables.enterprise-accounts.copilot-tab %}
|
||||
1. Under "Manage organization access to {% data variables.product.prodname_copilot %}," configure the access for your {% data variables.product.prodname_copilot %} subscription.
|
||||
- To disable {% data variables.product.prodname_copilot %} for all organizations in your enterprise, select **Disabled**.
|
||||
- To enable {% data variables.product.prodname_copilot %} for all organizations in your enterprise, both current and future, select **Allow for all organizations**.
|
||||
- To enable {% data variables.product.prodname_copilot %} for specific organizations, select **Allow for specific organizations**.
|
||||
|
||||

|
||||
|
||||
1. If you selected **Allow for specific organizations**, select the organizations you want to enable {% data variables.product.prodname_copilot %} for. Alternatively, you can select the organizations you want to disable {% data variables.product.prodname_copilot %} access for.
|
||||
- Click **Set organization permissions** and select **Enable** or **Disable** to grant or deny {% data variables.product.prodname_copilot %} access for the specified organizations.
|
||||
|
||||

|
||||
|
||||
1. Click **Save changes**.
|
||||
|
||||

|
||||
|
||||
## Enforcing a policy to manage the use of {% data variables.product.prodname_copilot %} suggestions that match public code in your enterprise
|
||||
|
||||
{% data reusables.enterprise-accounts.policies-tab %}
|
||||
{% data reusables.enterprise-accounts.copilot-tab %}
|
||||
1. Under "Suggestions matching public code," click the dropdown menu and select the policy you want to enforce.
|
||||
- To allow {% data variables.product.prodname_copilot %} suggestions matching public code, select **Allowed**.
|
||||
- To block {% data variables.product.prodname_copilot %} suggestions matching public code, select **Blocked**.
|
||||
- To allow each of your organizations to set their own policy on the use of {% data variables.product.prodname_copilot %} suggestions matching public code, select **No policy (let each organization decide)**.
|
||||
|
||||

|
||||
|
||||
## Further reading
|
||||
|
||||
- "[{% data variables.product.prodname_copilot_for_business %} Privacy Statement](/free-pro-team@latest/site-policy/privacy-policies/github-copilot-for-business-privacy-statement)"
|
||||
@@ -21,6 +21,7 @@ children:
|
||||
- /enforcing-policies-for-security-settings-in-your-enterprise
|
||||
- /enforcing-policies-for-dependency-insights-in-your-enterprise
|
||||
- /enforcing-policies-for-github-actions-in-your-enterprise
|
||||
- /enforcing-policies-for-github-copilot-in-your-enterprise
|
||||
- /enforcing-policies-for-code-security-and-analysis-for-your-enterprise
|
||||
- /enforcing-policies-for-personal-access-tokens-in-your-enterprise
|
||||
shortTitle: Enforce policies
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: About billing for GitHub Copilot
|
||||
intro: 'If you want to use {% data variables.product.prodname_copilot %}, you need a subscription for your {% data variables.product.prodname_dotcom %} account.'
|
||||
intro: 'If you want to use {% data variables.product.prodname_copilot %}, you either need a subscription for {% data variables.product.prodname_copilot_for_individuals %} in your personal account, or you need to be assigned a seat by an organization on {% data variables.product.prodname_ghe_cloud %} with a subscription for {% data variables.product.prodname_copilot_for_business %}.'
|
||||
product: '{% data reusables.gated-features.copilot-billing %}'
|
||||
versions:
|
||||
feature: copilot
|
||||
@@ -10,12 +10,30 @@ shortTitle: Billing for GitHub Copilot
|
||||
---
|
||||
## About billing for {% data variables.product.prodname_copilot %}
|
||||
|
||||
If you want to use {% data variables.product.prodname_copilot %}, you will need a subscription for your {% data variables.product.prodname_dotcom %} personal account. For more information about {% data variables.product.prodname_copilot %}, see "[About {% data variables.product.prodname_copilot %}](/en/copilot/overview-of-github-copilot/about-github-copilot)."
|
||||
If you want to use {% data variables.product.prodname_copilot %}, you will need a subscription for your {% data variables.product.prodname_dotcom %} personal account, or if you are a member of a {% data variables.product.prodname_ghe_cloud %} organization with a {% data variables.product.prodname_copilot_business_short %} subscription, you will need to be assigned a seat by an organization admin. For more information about {% data variables.product.prodname_copilot %}, see "[About {% data variables.product.prodname_copilot %}](/en/copilot/overview-of-github-copilot/about-github-copilot)."
|
||||
|
||||
Before starting a paid subscription, you can set up a one-time 60-day trial to evaluate {% data variables.product.prodname_copilot %}. To begin a trial, you will need to choose a monthly or yearly billing cycle, and provide a payment method. If you do not cancel the trial before the end of the 60 days, the trial will automatically convert to a paid subscription. You can cancel your {% data variables.product.prodname_copilot %} trial at any time during the 60 days and you won't be charged. If you cancel before the end of the trial, you will continue to have access to {% data variables.product.prodname_copilot %} until the 60-day trial period ends. For more information, see "[Managing your GitHub Copilot subscription](/en/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription)."
|
||||
For more information about managing {% data variables.product.prodname_copilot %} through {% data variables.product.prodname_ghe_cloud %}, see "[Enforcing policies for {% data variables.product.prodname_copilot %} in your enterprise](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise){% ifversion ghec %}.{% endif %}"{% ifversion fpt %} in the {% data variables.product.prodname_ghe_cloud %} documentation.{% endif %}
|
||||
|
||||
Before starting a paid subscription for a personal account, you can set up a one-time 60-day trial to evaluate {% data variables.product.prodname_copilot %}. To begin a trial, you will need to choose a monthly or yearly billing cycle, and provide a payment method. If you do not cancel the trial before the end of the 60 days, the trial will automatically convert to a paid subscription. You can cancel your {% data variables.product.prodname_copilot %} trial at any time during the 60 days and you won't be charged. If you cancel before the end of the trial, you will continue to have access to {% data variables.product.prodname_copilot %} until the 60-day trial period ends. For more information, see "[Managing your {% data variables.product.prodname_copilot_for_individuals %} subscription](/en/billing/managing-billing-for-github-copilot/managing-your-github-copilot-for-individuals-subscription)."
|
||||
|
||||
## Pricing for {% data variables.product.prodname_copilot_for_individuals %}
|
||||
|
||||
## {% data variables.product.prodname_copilot %} pricing
|
||||
|
||||
The {% data variables.product.prodname_copilot %} subscription is available on a monthly or yearly cycle. If you choose a monthly billing cycle, you will be billed $10 per calendar month. If you choose a yearly billing cycle, you will be billed $100 per year. You can modify your billing cycle at any time, and the modification will be reflected from the start of your next billing cycle.
|
||||
|
||||
If you have an active {% data variables.product.prodname_copilot %} subscription, and are then assigned a seat as part of a {% data variables.product.prodname_copilot_for_business %} subscription in {% data variables.product.prodname_ghe_cloud %}, your personal {% data variables.product.prodname_copilot %} subscription will be automatically canceled. You will receive a prorated refund for any remaining portion of your personal subscription's current billing cycle. You will then be able to continue using {% data variables.product.prodname_copilot %} according to the policies set at the enterprise or organization level.
|
||||
|
||||
A free subscription for {% data variables.product.prodname_copilot %} is available to verified students, teachers, and maintainers of popular open-source repositories on {% data variables.product.company_short %}. If you meet the criteria as an open source maintainer, you will be automatically notified when you visit the {% data variables.product.prodname_copilot %} subscription page. As a student, if you currently receive the {% data variables.product.prodname_student_pack %}, you will also be offered a free subscription when you visit the {% data variables.product.prodname_copilot %} subscription page. For more information about the {% data variables.product.prodname_student_pack %}, see "[Apply to {% data variables.product.prodname_global_campus %} as a student](/free-pro-team@latest/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/apply-to-github-global-campus-as-a-student)."
|
||||
|
||||
{% ifversion ghec %}
|
||||
## Pricing for {% data variables.product.prodname_copilot_for_business %}
|
||||
|
||||
The {% data variables.product.prodname_copilot_for_business %} subscription is available on a monthly cycle, and is billed at $19 per user per month. Billing for {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_ghe_cloud %} is processed at the end of each billing cycle.
|
||||
|
||||
Billed users are calculated based on the number of {% data variables.product.prodname_copilot %} seats assigned at the beginning of a billing cycle, or assigned during the billing cycle. Any seat assigned part way through the billing cycle will be prorated based on the number of days remaining in the cycle. Any seat assignment removed during a billing cycle will take effect from the beginning of the next cycle.
|
||||
|
||||
Seat assignment for {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_ghe_cloud %} is managed by admins of organizations which have been granted access to {% data variables.product.prodname_copilot %} at the enterprise level. If you are a member of multiple organizations under the same enterprise, you can be assigned {% data variables.product.prodname_copilot %} seats in more than one organization, but your enterprise will only be billed once. For more information, see "[Configuring {% data variables.product.prodname_copilot %} settings in your organization](/enterprise-cloud@latest/copilot/configuring-github-copilot/configuring-github-copilot-settings-in-your-organization)."
|
||||
|
||||
Policy settings and the usage overview for {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_ghe_cloud %} are available at the enterprise level. For more information, see "[Enforcing policies for {% data variables.product.prodname_copilot %} in your enterprise](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise)" and "[Viewing your {% data variables.product.prodname_copilot %} usage](/enterprise-cloud@latest/billing/managing-billing-for-github-copilot/viewing-your-github-copilot-usage)."
|
||||
|
||||
{% endif %}
|
||||
@@ -1,11 +1,12 @@
|
||||
---
|
||||
title: Managing billing for GitHub Copilot
|
||||
shortTitle: GitHub Copilot
|
||||
intro: 'You can try {% data variables.product.prodname_copilot %} with a free trial before starting your subscription, and modify or cancel your subscription at any time.'
|
||||
intro: 'You can try {% data variables.product.prodname_copilot_for_individuals %} with a free trial before starting your subscription, and modify or cancel your subscription at any time. You can also view your usage of {% data variables.product.prodname_copilot_for_business %}, and learn about how the costs are calculated.'
|
||||
versions:
|
||||
feature: copilot
|
||||
children:
|
||||
- /about-billing-for-github-copilot
|
||||
- /managing-your-github-copilot-subscription
|
||||
- /managing-your-github-copilot-for-individuals-subscription
|
||||
- /viewing-your-github-copilot-usage
|
||||
---
|
||||
|
||||
|
||||
@@ -1,7 +1,9 @@
|
||||
---
|
||||
title: Managing your GitHub Copilot subscription
|
||||
intro: 'Set up your {% data variables.product.prodname_copilot %} trial and manage your subscription.'
|
||||
title: Managing your GitHub Copilot for Individuals subscription
|
||||
intro: 'Set up your {% data variables.product.prodname_copilot %} trial for your personal account and manage your subscription.'
|
||||
product: '{% data reusables.gated-features.copilot-billing %}'
|
||||
redirect_from:
|
||||
- /billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription
|
||||
versions:
|
||||
feature: copilot
|
||||
type: how_to
|
||||
@@ -10,7 +12,9 @@ topics:
|
||||
shortTitle: Your GitHub Copilot subscription
|
||||
---
|
||||
|
||||
## Setting up a trial of {% data variables.product.prodname_copilot %}
|
||||
## Setting up a trial of {% data variables.product.prodname_copilot %} for your personal account
|
||||
|
||||
Before you can start using {% data variables.product.prodname_copilot %}, you will need to set up a free trial or subscription.
|
||||
|
||||
{% data reusables.copilot.signup-procedure %}
|
||||
|
||||
@@ -21,7 +25,8 @@ shortTitle: Your GitHub Copilot subscription
|
||||
1. In the "{% data variables.product.prodname_copilot %}" section, select the **Edit** dropdown.
|
||||
- If you are on a monthly billing cycle, select **Change to yearly billing**.
|
||||
- If you are on a yearly billing cycle, select **Change to monthly billing**.
|
||||

|
||||
|
||||

|
||||
|
||||
|
||||
## Canceling your {% data variables.product.prodname_copilot %} subscription
|
||||
@@ -33,18 +38,19 @@ You can cancel your {% data variables.product.prodname_copilot %} subscription a
|
||||
1. In the "{% data variables.product.prodname_copilot %}" section, select the **Edit** dropdown.
|
||||
- If you have a paid subscription, click **Cancel {% data variables.product.prodname_copilot %}**.
|
||||
|
||||

|
||||

|
||||
|
||||
- If you are within your 60 day trial period, click **Cancel trial**.
|
||||

|
||||
- If you are within your 60-day trial period, click **Cancel trial**.
|
||||
|
||||

|
||||
|
||||
2. In the "Cancel {% data variables.product.prodname_copilot %}" modal, click **I understand, cancel {% data variables.product.prodname_copilot %}**
|
||||
|
||||

|
||||

|
||||
|
||||
- If you are within your 60 day trial period, click **I understand, cancel {% data variables.product.prodname_copilot %} trial**.
|
||||
- If you are within your 60-day trial period, click **I understand, cancel {% data variables.product.prodname_copilot %} trial**.
|
||||
|
||||

|
||||

|
||||
|
||||
## Further reading
|
||||
|
||||
@@ -0,0 +1,42 @@
|
||||
---
|
||||
title: Viewing your GitHub Copilot usage
|
||||
intro: 'You can view how many users have access to {% data variables.product.prodname_copilot %} across all the organizations in your enterprise.'
|
||||
product: '{% data reusables.gated-features.copilot-billing %}'
|
||||
miniTocMaxHeadingLevel: 3
|
||||
permissions: 'Enterprise owners can view usage for {% data variables.product.prodname_copilot %} in their enterprise.'
|
||||
versions:
|
||||
ghec: '*'
|
||||
type: how_to
|
||||
topics:
|
||||
- Copilot
|
||||
shortTitle: View your usage
|
||||
---
|
||||
|
||||
## About your {% data variables.product.prodname_copilot %} usage
|
||||
|
||||
You can view usage information for {% data variables.product.prodname_copilot %} in your enterprise, broken down by organization, or in your organization, broken down by seat assignment status. At the enterprise level, this information includes the number of seats assigned in each organization, and the total spending associated with each organization, for the current billing cycle. At the organization level, this information includes the total number of seats, seats carried over from the previous billing cycle, new seats added during the current cycle, and seats to be removed at the end of the current cycle.
|
||||
|
||||
If an organization admin has assigned one or more seats partway through the current billing cycle, the enterprise-level information will display a decimal number of seats. For example, if the organization started the billing cycle with 3 seats assigned, and then assigned an additional seat half way through the cycle, the seat usage information will display 3.5 seats. The "3" representing the seats assigned at the start of the cycle, and the "0.5" representing the additional seat assigned halfway through the cycle.
|
||||
|
||||
The spending information will display the total spending for each organization for the current billing cycle. The total spending for the organization for the current cycle will usually be the number of seats assigned, multiplied by the cost per seat ($19 per seat per month). However, if the same organization member is assigned a seat in multiple organizations, their seat usage will be reflected in each organization, but as the enterprise will only be charged once, their spending will only be reflected in the organization where they were first assigned a seat.
|
||||
|
||||
## Viewing your usage for {% data variables.product.prodname_copilot_for_business %}
|
||||
|
||||
### At the enterprise-level
|
||||
|
||||
{% data reusables.enterprise-accounts.settings-tab %}
|
||||
{% data reusables.enterprise-accounts.billing-tab %}
|
||||
1. Under "{% data variables.product.prodname_copilot_short %} monthly usage," view the breakdown of your {% data variables.product.prodname_copilot %} usage.
|
||||
- Under "Seat usage" you can view the total number of seats currently assigned per organization, with a decimal number representing seats assigned partway through the current billing cycle.
|
||||
- Under "Spending" you can view the total cost of {% data variables.product.prodname_copilot_for_business %} for the current billing cycle per organization.
|
||||
|
||||

|
||||
|
||||
### At the organization-level
|
||||
|
||||
{% data reusables.profile.access_org %}
|
||||
{% data reusables.profile.org_settings %}
|
||||
1. In the "Access" section of the sidebar, click **{% octicon "credit-card" aria-label="The credit card icon" %} Billing and plans**.
|
||||
1. Under "{% data variables.product.prodname_copilot_short %}", view the breakdown of your {% data variables.product.prodname_copilot %} usage and upcoming changes in your organization.
|
||||
|
||||

|
||||
@@ -11,7 +11,9 @@ shortTitle: JetBrains
|
||||
|
||||
## About {% data variables.product.prodname_copilot %} in JetBrains IDEs
|
||||
|
||||
If you use a Jetbrains IDE, {% data variables.product.prodname_copilot %} can autocomplete code as you type. After installation, you can enable or disable {% data variables.product.prodname_copilot %}, and you can configure advanced settings within your IDE or on {% data variables.product.prodname_dotcom_the_website %}.
|
||||
If you use a Jetbrains IDE, {% data variables.product.prodname_copilot %} can autocomplete code as you type. After installation, you can enable or disable {% data variables.product.prodname_copilot %}, and you can configure advanced settings within your IDE or on {% data variables.product.prodname_dotcom_the_website %}. This article describes how to configure {% data variables.product.prodname_copilot %} in the IntelliJ IDE, but the user interfaces of other Jetbrains IDEs may differ.
|
||||
|
||||
{% data reusables.copilot.dotcom-settings %}
|
||||
|
||||
## Prerequisites
|
||||
|
||||
@@ -78,6 +80,21 @@ You can manage advanced settings for {% data variables.product.prodname_copilot
|
||||
1. Edit the settings according to your personal preferences.
|
||||
- To adjust the behaviour and appearance of code suggestions, and whether to automatically check for updates, select or deselect the corresponding checkboxes.
|
||||
- If you have selected to receive automatic updates, you can choose whether to receive stable, but less frequent updates, or nightly updates, which may be less stable. Click the **Update channel** dropdown and select **Stable** for stable updates, or **Nightly** for nightly updates.
|
||||
- Under "Disabled languages", use the checkboxes to select or deselect the languages you want to disable {% data variables.product.prodname_copilot %} for.
|
||||
- Under "Disabled languages," use the checkboxes to select or deselect the languages you want to disable {% data variables.product.prodname_copilot %} for.
|
||||
|
||||
## Configuring proxy settings for {% data variables.product.prodname_copilot %}
|
||||
|
||||
You can configure {% data variables.product.prodname_copilot %} to connect through an HTTP proxy server in a Jetbrains IDE. {% data variables.product.prodname_copilot %} supports basic HTTP proxy setups, with or without basic authentication.
|
||||
|
||||
1. In your JetBrains IDE, click the **File** menu, then click **Settings**.
|
||||
1. Under **Appearance & Behavior**, click **System Settings** and then click **HTTP Proxy**.
|
||||
1. Select the **Manual proxy configuration** checkbox, and then select the **HTTP** checkbox.
|
||||
1. In the "Host name" field, enter the hostname of your proxy server, and in the "Port number" field, enter the port number of your proxy server.
|
||||
|
||||

|
||||
|
||||
1. Optionally, in the left sidebar, click **Tools** and then click **Server Certificates**. Then select or deselect the "Accept non-trusted certificates automatically" checkbox, depending on whether you want to accept non-trusted certificates automatically.
|
||||
|
||||

|
||||
|
||||
{% data reusables.copilot.dotcom-settings %}
|
||||
|
||||
@@ -83,17 +83,16 @@ If you don't want to use the default keyboard shortcuts in {% data variables.pro
|
||||
|
||||
You can choose to enable or disable inline suggestions for {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}.
|
||||
|
||||
1. In the **File** menu, navigate to **Preferences** and click **Settings**.
|
||||

|
||||
1. In the left-side panel of the settings tab, click **Extensions** and then select **Copilot**.
|
||||
1. Under "Inline Suggest:Enable", select or deselect the checkbox to enable or disable inline suggestions.
|
||||
{% data reusables.copilot.vscode-settings %}
|
||||
1. In the left-side panel of the settings tab, click **Extensions** and then select **{% data variables.product.prodname_copilot_short %}**.
|
||||
1. Under "Inline Suggest:Enable," select or deselect the checkbox to enable or disable inline suggestions.
|
||||
|
||||
## Enabling or disabling {% data variables.product.prodname_copilot %} for specific languages
|
||||
|
||||
You can specify which languages you want to enable or disable {% data variables.product.prodname_copilot %} for.
|
||||
|
||||
1. From the {% data variables.product.prodname_vscode %}, click the **Extensions** tab, then navigate to the **Copilot** section. For more information, see "[Enabling and disabling inline suggestions](#enabling-and-disabling-inline-suggestions)."
|
||||
1. Under "Enable or disable Copilot for specified languages", click **Edit in settings.json**.
|
||||
1. Under "Enable or disable {% data variables.product.prodname_copilot_short %} for specified languages," click **Edit in settings.json**.
|
||||
1. In the _settings.json_ file, add or remove the languages you want to enable or disable {% data variables.product.prodname_copilot %} for. For example, to enable Python in {% data variables.product.prodname_copilot %}, add `"python": true` to the list, ensuring there is a trailing comma after all but the last list item.
|
||||
|
||||
```json
|
||||
@@ -110,4 +109,22 @@ You can specify which languages you want to enable or disable {% data variables.
|
||||
}
|
||||
```
|
||||
|
||||
## Configuring proxy settings for {% data variables.product.prodname_copilot %}
|
||||
|
||||
You can configure {% data variables.product.prodname_copilot %} to connect through an HTTP proxy server in {% data variables.product.prodname_vscode %}. {% data variables.product.prodname_copilot %} supports basic HTTP proxy setups, with or without basic authentication.
|
||||
|
||||
{% data reusables.copilot.vscode-settings %}
|
||||
1. In the left-side panel of the settings tab, click **Application** and then select **Proxy**.
|
||||
1. In the textbox under "Proxy", type the address of your proxy server, for example `http://localhost:3128`. Alternatively, {% data variables.product.prodname_copilot %} will use the `http_proxy` and `https_proxy` variables from your environment.
|
||||
|
||||

|
||||
|
||||
1. Optionally, under "Http: Proxy Authorization", click **Edit in settings.json** and add your required value to send as the `Proxy-Authorization` header for every network request.
|
||||
|
||||

|
||||
|
||||
1. Optionally, under "Http: Proxy Strict SSL", select or deselect the checkbox to enable or disable strict SSL.
|
||||
|
||||

|
||||
|
||||
{% data reusables.copilot.dotcom-settings %}
|
||||
|
||||
@@ -32,13 +32,20 @@ You can use the default keyboard shortcuts in {% data variables.product.prodname
|
||||
If you don't want to use the default keyboard shortcuts in {% data variables.product.prodname_vs %} when using {% data variables.product.prodname_copilot %}, you can rebind the shortcuts in the Keyboard editor using your preferred keyboard shortcuts for each specific command.
|
||||
|
||||
1. In the {% data variables.product.prodname_vs %} toolbar, under **Tools**, click **Options**.
|
||||
|
||||

|
||||
|
||||
1. In the "Options" dialog, under **Environment**, click **Keyboard**.
|
||||
|
||||

|
||||
|
||||
1. Under "Show commands containing:", search for the command you want to rebind.
|
||||

|
||||
1. Under "Press shortcut keys", type the shorcut you want to assign to the command, then click **Assign**.
|
||||

|
||||
|
||||

|
||||
|
||||
1. Under "Press shortcut keys," type the shortcut you want to assign to the command, then click **Assign**.
|
||||
|
||||
```
|
||||
|
||||
{% data reusables.copilot.enabling-or-disabling-vs %}
|
||||
|
||||
|
||||
@@ -0,0 +1,144 @@
|
||||
---
|
||||
title: Configuring GitHub Copilot settings in your organization
|
||||
intro: 'You can configure {% data variables.product.prodname_copilot %} in your organization, including granting and revoking access to individuals and teams, and determining whether to block suggestions that match public code.'
|
||||
product: '{% data reusables.gated-features.copilot %}'
|
||||
miniTocMaxHeadingLevel: 3
|
||||
permissions: 'Organization owners and members with admin permissions can configure {% data variables.product.prodname_copilot %} in their organization.'
|
||||
versions:
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Copilot
|
||||
shortTitle: Organization settings
|
||||
---
|
||||
|
||||
|
||||
## About {% data variables.product.prodname_copilot %} settings in your organization
|
||||
|
||||
{% data reusables.copilot.about-copilot %}
|
||||
|
||||
To configure {% data variables.product.prodname_copilot %} use in your organization, the organization must be owned by a {% data variables.product.prodname_ghe_cloud %} account, and an enterprise admin must first enable {% data variables.product.prodname_copilot_business_short %} for your organization. Organization admins will then be able to manage seat assignment within the organization.
|
||||
|
||||
Depending on the policy settings configured at the enterprise level, an organization admin may also be able to determine whether to allow or block {% data variables.product.prodname_copilot %} suggestions that match public code. For more information, see "[Enforcing policies for {% data variables.product.prodname_copilot %} in your enterprise](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise)."
|
||||
|
||||
## Configuring access to {% data variables.product.prodname_copilot %} in your organization
|
||||
|
||||
Once a {% data variables.product.prodname_ghe_cloud %} admin enables a {% data variables.product.prodname_copilot_business_short %} subscription in your organization, you can assign {% data variables.product.prodname_copilot %} seats to individuals and teams in your organization.
|
||||
|
||||
### Enabling access to {% data variables.product.prodname_copilot %} for all current and future users in your organization
|
||||
|
||||
{% data reusables.profile.access_org %}
|
||||
{% data reusables.profile.org_settings %}
|
||||
1. In the "Code planning, and automation" section of the sidebar, click **{% octicon "copilot" aria-label="The copilot icon" %} {% data variables.product.prodname_copilot_short %}**, and then click **Access**.
|
||||
1. Under "User permissions," to enable {% data variables.product.prodname_copilot %} for all current and future users in your organization, select **Allow for all members**.
|
||||
|
||||

|
||||
|
||||
1. In the "Confirm seat assignment" dialog, to confirm that you want to enable {% data variables.product.prodname_copilot %} for all current and future users in your organization, click **Confirm**.
|
||||
|
||||

|
||||
|
||||
1. To save your changes, click **Save**.
|
||||
|
||||

|
||||
|
||||
### Enabling access to {% data variables.product.prodname_copilot %} for specific users in your organization
|
||||
|
||||
{% data reusables.profile.access_org %}
|
||||
{% data reusables.profile.org_settings %}
|
||||
1. In the "Code planning, and automation" section of the sidebar, click **{% octicon "copilot" aria-label="The copilot icon" %} {% data variables.product.prodname_copilot_short %}**, and then click **Access**.
|
||||
1. Under "User permissions," to enable {% data variables.product.prodname_copilot %} for selected teams or users in your organization, select **Selected teams/users** and click **Save**.
|
||||
|
||||

|
||||
|
||||
1. If you are updating user access from the **Allow for all members** setting, in the "Confirm seat assignment" dialog, select how you want to start assigning access.
|
||||
- To unassign all members and then select those who should have access, select **Start from scratch**.
|
||||
- To keep all members who currently have access and then select those who should not have access, select **Keep all users**.
|
||||
|
||||

|
||||
|
||||
1. If you selected **Start from scratch**, click **Add people** or **Add teams** to add individual users, or entire teams.
|
||||
|
||||

|
||||
|
||||
1. If you selected **Add people**, in the "Enable GitHub Copilot access for selected members of ORGANIZATION" dialog, you can either search for individual members, or you can add members in bulk by uploading a CSV file.
|
||||
|
||||

|
||||
|
||||
- To search for members, type the member's username, full name, or email address in the search bar.
|
||||
- To add members in bulk, click **Upload CSV**, and then upload a CSV file including either the username or email address for each member you want to add, separated by a comma.
|
||||
|
||||
{% warning %}
|
||||
|
||||
**Warning:** When you upload a CSV file, {% data variables.product.prodname_copilot %} will search all users on {% data variables.product.prodname_dotcom_the_website %} for matches. If the CSV includes users who are not members of your organization, they will be invited to join your organization when you click **Add XX members**.
|
||||
|
||||
{% endwarning %}
|
||||
|
||||
- Review the list of users generated from your CSV file. To confirm that you want to grant access to the listed users, click **Add XX member(s) to access list**, or to reject the list, click **Cancel**.
|
||||
|
||||

|
||||
|
||||
1. If you selected **Add teams**, in the "Enable GitHub Copilot access for selected teams of ORGANIZATION" dialog, start typing the team name in the search bar, select the team you want to add and click **Select a team above**.
|
||||
|
||||

|
||||
|
||||
1. If you selected **Keep all users**, review the full list of your organization members and selected the individuals whose {% data variables.product.prodname_copilot %} access you want to revoke.
|
||||
|
||||

|
||||
|
||||
1. Click the **XX members selected** dropdown, and then click **Remove**.
|
||||
|
||||

|
||||
|
||||
### Disabling access to {% data variables.product.prodname_copilot %} for your whole organization
|
||||
|
||||
{% data reusables.profile.access_org %}
|
||||
{% data reusables.profile.org_settings %}
|
||||
1. In the "Code planning, and automation" section of the sidebar, click **{% octicon "copilot" aria-label="The copilot icon" %} {% data variables.product.prodname_copilot_short %}**, and then click **Access**.
|
||||
1. Under "User permissions," to disable {% data variables.product.prodname_copilot %} for all users in your organization, select **Disabled**.
|
||||
|
||||

|
||||
|
||||
1. To save your changes, click **Save**.
|
||||
|
||||

|
||||
|
||||
### Disabling access to {% data variables.product.prodname_copilot %} for specific users in your organization
|
||||
|
||||
Removing a user from the organization(s) that had assigned them a {% data variables.product.prodname_copilot %} seat will automatically unassign the seat from them. Alternatively, you can unassign a member's {% data variables.product.prodname_copilot %} seat, while preserving their membership. These changes will take effect from the beginning of the next billing cycle.
|
||||
|
||||
{% data reusables.profile.access_org %}
|
||||
{% data reusables.profile.org_settings %}
|
||||
1. In the "Code planning, and automation" section of the sidebar, click **{% octicon "copilot" aria-label="The copilot icon" %} {% data variables.product.prodname_copilot_short %}**, and then click **Access**.
|
||||
1. Under "User permissions,", select **Selected teams/users** and then click **Save**.
|
||||
|
||||

|
||||
|
||||
- In the "Confirm seat assignment" pop-up dialog, select **Keep all users**.
|
||||
|
||||

|
||||
|
||||
1. Under "Manage access," in the search bar, type the member's username, full name, or email address.
|
||||
|
||||

|
||||
|
||||
1. To remove the member from the list of users who have access to {% data variables.product.prodname_copilot %}, click **Remove**.
|
||||
|
||||

|
||||
|
||||
## Configuring suggestion matching policies for {% data variables.product.prodname_copilot %} in your organization
|
||||
|
||||
{% data variables.product.prodname_copilot %} includes a filter which detects code suggestions matching public code on {% data variables.product.prodname_dotcom %}. When the filter is enabled, {% data variables.product.prodname_copilot %} checks code suggestions with their surrounding code of about 150 characters against public code on {% data variables.product.prodname_dotcom %}. If there is a match or near match, the suggestion will not be shown to you.
|
||||
|
||||
If your enterprise admin has selected **No policy (let each organization decide)** for suggestion matching at the enterprise level, you can set a suggestion matching policy for your organization. If an organization member is assigned a seat by multiple organizations with different suggestion matching policies under the same enterprise, {% data variables.product.prodname_copilot %} will use the most restrictive policy.
|
||||
|
||||
|
||||
{% data reusables.profile.access_org %}
|
||||
{% data reusables.profile.org_settings %}
|
||||
1. In the "Code planning, and automation" section of the sidebar, click **{% octicon "copilot" aria-label="The copilot icon" %} {% data variables.product.prodname_copilot_short %}**, and then click **Policies**.
|
||||
1. In the "Suggestions matching public code" dropdown, select **Allow** or **Block** to allow or block suggestions matching public code.
|
||||
|
||||

|
||||
|
||||
## Further reading
|
||||
|
||||
- "[{% data variables.product.prodname_copilot_for_business %} Privacy Statement](/free-pro-team@latest/site-policy/privacy-policies/github-copilot-for-business-privacy-statement)"
|
||||
@@ -2,6 +2,7 @@
|
||||
title: Configuring GitHub Copilot settings on GitHub.com
|
||||
intro: 'You can configure {% data variables.product.prodname_copilot %}''s behavior on {% data variables.product.prodname_dotcom_the_website %}, which affects how {% data variables.product.prodname_copilot %} functions in any IDE that you use.'
|
||||
product: '{% data reusables.gated-features.copilot %}'
|
||||
permissions: 'People with individual {% data variables.product.prodname_copilot %} subscriptions can configure their settings on {% data variables.product.prodname_dotcom_the_website %}.'
|
||||
miniTocMaxHeadingLevel: 3
|
||||
topics:
|
||||
- Copilot
|
||||
|
||||
@@ -12,5 +12,6 @@ children:
|
||||
- /configuring-github-copilot-in-visual-studio
|
||||
- /configuring-github-copilot-in-a-jetbrains-ide
|
||||
- /configuring-github-copilot-in-neovim
|
||||
- /configuring-github-copilot-settings-in-your-organization
|
||||
---
|
||||
|
||||
|
||||
@@ -19,6 +19,8 @@ If you use a JetBrains IDE, you can view and incorporate suggestions from {% dat
|
||||
|
||||
## Prerequisites
|
||||
|
||||
{% data reusables.copilot.subscription-prerequisite %}
|
||||
|
||||
{% data reusables.copilot.jetbrains-ides %}
|
||||
|
||||
## Installing the {% data variables.product.prodname_copilot %} extension in your JetBrains IDE
|
||||
|
||||
@@ -19,7 +19,7 @@ If you use a Neovim, you can view and incorporate suggestions from {% data varia
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- To use {% data variables.product.prodname_copilot %} you must have an active {% data variables.product.prodname_copilot %} subscription. For more information, see "[About billing for {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)."
|
||||
{% data reusables.copilot.subscription-prerequisite %}
|
||||
|
||||
- To use {% data variables.product.prodname_copilot %} in Neovim you must have Neovim and Node.js version 17 or below installed. For more information, see the [Neovim documentation](https://neovim.io/doc/) and the [Node.js website](https://nodejs.org/en/).
|
||||
|
||||
|
||||
@@ -19,7 +19,9 @@ If you use {% data variables.product.prodname_vscode %}, you can view and incorp
|
||||
|
||||
## Prerequisites
|
||||
|
||||
To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}, you must have {% data variables.product.prodname_vscode %} installed. For more information, see the [{% data variables.product.prodname_vscode %} download page](https://code.visualstudio.com/Download).
|
||||
{% data reusables.copilot.subscription-prerequisite %}
|
||||
|
||||
- To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}, you must have {% data variables.product.prodname_vscode %} installed. For more information, see the [{% data variables.product.prodname_vscode %} download page](https://code.visualstudio.com/Download).
|
||||
|
||||
## Installing the {% data variables.product.prodname_vscode %} extension
|
||||
|
||||
|
||||
@@ -19,7 +19,9 @@ If you use {% data variables.product.prodname_vs %}, you can view and incorporat
|
||||
|
||||
## Prerequisites
|
||||
|
||||
To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vs %}, you must have {% data variables.product.prodname_vs %} 2022 17.2 or later installed. For more information, see the [Visual Studio IDE](https://visualstudio.microsoft.com/vs/) documentation.
|
||||
{% data reusables.copilot.subscription-prerequisite %}
|
||||
|
||||
- To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vs %}, you must have {% data variables.product.prodname_vs %} 2022 17.2 or later installed. For more information, see the [Visual Studio IDE](https://visualstudio.microsoft.com/vs/) documentation.
|
||||
|
||||
{% note %}
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: About GitHub Copilot
|
||||
intro: '{% data variables.product.prodname_copilot %} can help you code by offering autocomplete-style suggestions. You can learn what to consider while using {% data variables.product.prodname_copilot %}, and how {% data variables.product.prodname_copilot %} works.'
|
||||
intro: '{% data variables.product.prodname_copilot %} can help you code by offering autocomplete-style suggestions. You can learn how {% data variables.product.prodname_copilot %} works, and what to consider while using {% data variables.product.prodname_copilot %}.'
|
||||
versions:
|
||||
feature: copilot
|
||||
topics:
|
||||
@@ -20,17 +20,17 @@ shortTitle: About GitHub Copilot
|
||||
|
||||
You can see real-world examples of {% data variables.product.prodname_copilot %} in action. For more information, see the [{% data variables.product.prodname_copilot %}](https://copilot.github.com/) website.
|
||||
|
||||
GitHub Copilot offers suggestions from a model that OpenAI built from billions of lines of open source code. As a result, the training set for {% data variables.product.prodname_copilot %} may contain insecure coding patterns, bugs, or references to outdated APIs or idioms. When {% data variables.product.prodname_copilot %} produces suggestions based on this training data, those suggestions may also contain undesirable patterns.
|
||||
{% data variables.product.prodname_copilot %} offers suggestions from a model that OpenAI built from billions of lines of open source code. As a result, the training set for {% data variables.product.prodname_copilot %} may contain insecure coding patterns, bugs, or references to outdated APIs or idioms. When {% data variables.product.prodname_copilot %} produces suggestions based on this training data, those suggestions may also contain undesirable patterns.
|
||||
|
||||
You are responsible for ensuring the security and quality of your code. We recommend you take the same precautions when using code generated by {% data variables.product.prodname_copilot %} that you would when using any code you didn't write yourself. These precautions include rigorous testing, IP scanning, and tracking for security vulnerabilities. {% data variables.product.company_short %} provides a number of features to help you monitor and improve code quality, such as {% data variables.product.prodname_actions %}, {% data variables.product.prodname_dependabot %}, {% data variables.product.prodname_codeql %} and {% data variables.product.prodname_code_scanning %}. All these features are free to use in public repositories. For more information, see "[Understanding {% data variables.product.prodname_actions %}](/actions/learn-github-actions/understanding-github-actions)" and "[{% data variables.product.company_short %} security features](/code-security/getting-started/github-security-features)."
|
||||
|
||||
{% data variables.product.prodname_copilot %} uses filters to block offensive words in the prompts and avoid producing suggestions in sensitive contexts. We are committed to constantly improving the filter system to more intelligently detect and remove offensive suggestions generated by {% data variables.product.prodname_copilot %}, including biased, discriminatory, or abusive outputs. If you see an offensive suggestion generated by {% data variables.product.prodname_copilot %}, please report the suggestion directly to copilot-safety@github.com so that we can improve our safeguards.
|
||||
|
||||
{% data reusables.copilot.emus-cannot-use-copilot %}
|
||||
|
||||
## About billing for {% data variables.product.prodname_copilot %}
|
||||
|
||||
{% data variables.product.prodname_copilot %} is a paid feature, requiring a monthly or yearly subscription. Verified students, teachers, and maintainers of popular open source projects on {% data variables.product.prodname_dotcom %} are eligible to use {% data variables.product.prodname_copilot %} for free. If you meet the criteria for a free {% data variables.product.prodname_copilot %} subscription, you will be automatically notified when you visit the {% data variables.product.prodname_copilot %} subscription page. If you do not meet the criteria for a free {% data variables.product.prodname_copilot %} subscription, you will be offered a 60 day free trial, after which a paid subscription is required for continued use. For more information, see "[About billing for {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)."
|
||||
{% data variables.product.prodname_copilot %} is a paid feature, requiring a monthly or yearly subscription. {% data variables.product.prodname_copilot %} subscriptions can be paid for and managed through a personal account on {% data variables.product.prodname_dotcom_the_website %} with {% data variables.product.prodname_copilot_for_individuals %}, or paid for and managed centrally through an enterprise account on {% data variables.product.prodname_ghe_cloud %} with {% data variables.product.prodname_copilot_for_business %}.
|
||||
|
||||
Verified students, teachers, and maintainers of popular open source projects on {% data variables.product.prodname_dotcom %} are eligible to use {% data variables.product.prodname_copilot_individuals_short %} for free. If you meet the criteria for a free {% data variables.product.prodname_copilot_individuals_short %} subscription, you will be automatically notified when you visit the {% data variables.product.prodname_copilot %} subscription page. If you do not meet the criteria for a free {% data variables.product.prodname_copilot_individuals_short %} subscription, you will be offered a 60-day free trial, after which a paid subscription is required for continued use. {% data variables.product.prodname_copilot_for_business %} does not include a free trial. For more information, see "[About billing for {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)."
|
||||
|
||||
## About the license for the {% data variables.product.prodname_copilot %} plugin in JetBrains IDEs
|
||||
|
||||
@@ -38,4 +38,5 @@ You are responsible for ensuring the security and quality of your code. We recom
|
||||
|
||||
## Further reading
|
||||
|
||||
- "[{% data variables.product.company_short %} Terms for Additional Products and Features](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot)"
|
||||
- "[{% data variables.product.company_short %} Terms for Additional Products and Features](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot)"{% ifversion ghec %}
|
||||
- "[{% data variables.product.prodname_copilot_for_business %} Privacy Statement](/free-pro-team@latest/site-policy/privacy-policies/github-copilot-for-business-privacy-statement)"{% endif %}
|
||||
|
||||
@@ -14,7 +14,7 @@ topics:
|
||||
|
||||
{% data variables.product.prodname_copilot %} is an AI pair programmer. You can use {% data variables.product.prodname_copilot %} to get suggestions for whole lines or entire functions right inside your editor.
|
||||
|
||||
This guide will show you how to sign up for {% data variables.product.prodname_copilot %}, install the {% data variables.product.prodname_copilot %} extension in {% data variables.product.prodname_vscode %}, and get your first suggestion. For more information on {% data variables.product.prodname_copilot %}, see "[About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)." For more in-depth information on how to use {% data variables.product.prodname_copilot %} in a variety of environments, see "[Getting Started](/copilot/getting-started-with-github-copilot)."
|
||||
This guide will show you how to sign up for {% data variables.product.prodname_copilot %} through your personal account, install the {% data variables.product.prodname_copilot %} extension in {% data variables.product.prodname_vscode %}, and get your first suggestion. For more information on {% data variables.product.prodname_copilot %}, see "[About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)." For more in-depth information on how to use {% data variables.product.prodname_copilot %} in a variety of environments, see "[Getting Started](/copilot/getting-started-with-github-copilot)."
|
||||
|
||||
## Prerequisites
|
||||
|
||||
@@ -23,6 +23,14 @@ This guide will show you how to sign up for {% data variables.product.prodname_c
|
||||
|
||||
## Signing up for {% data variables.product.prodname_copilot %}
|
||||
|
||||
Before you can start using {% data variables.product.prodname_copilot %}, you will need to set up a free trial or subscription for your personal account.
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** If you are a member of an organization owned by a {% data variables.product.prodname_ghe_cloud %} account with a {% data variables.product.prodname_copilot %} subscription, and you have been assigned a {% data variables.product.prodname_copilot %} seat by your organization, you can proceed to "[Installing the {% data variables.product.prodname_copilot %} extension for {% data variables.product.prodname_vscode %}](/copilot/quickstart#installing-the-github-copilot-extension-for-visual-studio-code)."
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.copilot.signup-procedure %}
|
||||
|
||||
## Installing the {% data variables.product.prodname_copilot %} extension for {% data variables.product.prodname_vscode %}
|
||||
|
||||
@@ -34,7 +34,7 @@ Once you are a verified {% data variables.product.prodname_global_campus %} stud
|
||||
- Discover student-created repositories from GitHub Community Exchange. For more information, see "[About GitHub Community Exchange](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-community-exchange)."
|
||||
|
||||
{% data variables.product.prodname_global_campus %} students also receive the following {% data variables.product.prodname_dotcom %} benefits.
|
||||
- **{% data variables.product.prodname_copilot %}**: Verified students receive a free subscription for {% data variables.product.prodname_copilot %}. You will be automatically notified about the free subscription when you visit the {% data variables.product.prodname_copilot %} subscription page in your account settings. For more information about subscribing to and using {% data variables.product.prodname_copilot %}, see "[Managing your {% data variables.product.prodname_copilot %} subscription](/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription#setting-up-a-trial-of-github-copilot)" and "[About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)."
|
||||
- **{% data variables.product.prodname_copilot %}**: Verified students receive a free subscription for {% data variables.product.prodname_copilot %}. You will be automatically notified about the free subscription when you visit the {% data variables.product.prodname_copilot %} subscription page in your account settings. For more information about subscribing to and using {% data variables.product.prodname_copilot %}, see "[Managing your {% data variables.product.prodname_copilot_for_individuals %} subscription](/billing/managing-billing-for-github-copilot/managing-your-github-copilot-for-individuals-subscription#setting-up-a-trial-of-github-copilot)" and "[About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)."
|
||||
- **{% data variables.product.prodname_github_codespaces %}**: {% data reusables.education.student-codespaces-benefit %} For more information on getting started with {% data variables.product.prodname_github_codespaces %}, see "[{% data variables.product.prodname_github_codespaces %} overview](/codespaces/overview)."
|
||||
|
||||
{% note %}
|
||||
|
||||
@@ -30,7 +30,7 @@ Before applying for an individual discount, check if your learning community is
|
||||
- Stay in the know on what the student community is interested in by rewatching recent [Campus TV](https://www.twitch.tv/githubeducation) episodes. Campus TV is created by {% data variables.product.prodname_dotcom %} and student community leaders and can be watched live or on demand.
|
||||
- Request a {% data variables.product.prodname_dotcom %} swag bag with educational materials and goodies for your students.
|
||||
|
||||
A free subscription for {% data variables.product.prodname_copilot %} is available to verified teachers with {% data variables.product.prodname_education %}. You will be automatically notified about the free subscription when you visit the {% data variables.product.prodname_copilot %} subscription page in your account settings. For more information about subscribing to and using {% data variables.product.prodname_copilot %}, see "[Managing your {% data variables.product.prodname_copilot %} subscription](/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription#setting-up-a-trial-of-github-copilot)" and "[About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)."
|
||||
A free subscription for {% data variables.product.prodname_copilot %} is available to verified teachers with {% data variables.product.prodname_education %}. You will be automatically notified about the free subscription when you visit the {% data variables.product.prodname_copilot %} subscription page in your account settings. For more information about subscribing to and using {% data variables.product.prodname_copilot %}, see "[Managing your {% data variables.product.prodname_copilot_for_individuals %} subscription](/billing/managing-billing-for-github-copilot/managing-your-github-copilot-for-individuals-subscription#setting-up-a-trial-of-github-copilot)" and "[About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)."
|
||||
|
||||
## Further reading
|
||||
|
||||
|
||||
@@ -107,6 +107,8 @@ _Data_
|
||||
|
||||
GitHub Copilot (i) may, depending on your preferred telemetry settings, collect snippets of Your Code, and (ii) will collect additional usage information through the IDE or editor tied to your Account. This may include personal data, as referenced in the [GitHub Privacy Statement](/site-policy/privacy-policies/github-privacy-statement). You can learn more about the collection and use of GitHub Copilot data in the [GitHub Copilot FAQ](https://github.com/features/copilot#faq-privacy).
|
||||
|
||||
For enterprise users, your use of GitHub Copilot is governed by the [GitHub Copilot Product Specific Terms](https://github.com/customer-terms/github-copilot-product-specific-terms).
|
||||
|
||||
## GitHub Enterprise Importer
|
||||
Importer is a framework for exporting data from other sources to be imported to the GitHub platform. Importer is provided “AS-IS”.
|
||||
|
||||
|
||||
@@ -0,0 +1,37 @@
|
||||
---
|
||||
title: GitHub Copilot for Business Privacy Statement
|
||||
versions:
|
||||
fpt: '*'
|
||||
topics:
|
||||
- Policy
|
||||
- Legal
|
||||
---
|
||||
|
||||
Effective Date: December 7, 2022
|
||||
|
||||
Use of GitHub Copilot for Business is also subject to the [GitHub Privacy Statement](/site-policy/privacy-policies/github-privacy-statement), the [Acceptable Use Policies](/site-policy/acceptable-use-policies/github-acceptable-use-policies) and the [GitHub Copilot for Business license terms](https://github.com/customer-terms/github-copilot-product-specific-terms).
|
||||
|
||||
## What data does Copilot for Business collect?
|
||||
Copilot for Business relies on file content and additional data to work. It collects data to provide the service, some of which is then saved for further analysis and product improvements. Copilot for Business collects data as described below:
|
||||
|
||||
## User Engagement Data
|
||||
When you use Copilot for Business it will collect usage information about events generated when interacting with the IDE or editor. These events include user edit actions like completions accepted and dismissed, and error and general usage data to identify metrics like latency and features engagement. This information may include personal data, such as pseudonymous identifiers.
|
||||
|
||||
## Code Snippets Data
|
||||
Copilot for Business does not retain any Code Snippets Data (source code that you are editing, related files and other files open in the same IDE or editor, URLs of repositories and files paths).
|
||||
|
||||
## How is data in Copilot for Business used and shared?
|
||||
User Engagement Data is used by GitHub, Microsoft, and OpenAI to provide the service and to enable improvements.
|
||||
|
||||
Such uses may include:
|
||||
- Evaluating GitHub Copilot, for example, by measuring the positive impact it has on the user
|
||||
- Fine tuning ranking and sorting algorithms and prompt crafting
|
||||
- Detecting potential abuse of GitHub Copilot or violation of [Acceptable Use Policies](/site-policy/acceptable-use-policies/github-acceptable-use-policies).
|
||||
- Conducting experiments and research related to developers and their use of developer tools and services.
|
||||
|
||||
## How can users of Copilot for Business control use of their data?
|
||||
User engagement data (which includes pseudonymous identifiers and general usage data), is required for the use of GitHub Copilot and will continue to be collected, processed, and shared with Microsoft and OpenAI when you use GitHub Copilot.
|
||||
|
||||
### Copilot for Business does not collect any Code Snippets Data.
|
||||
|
||||
For more information on how GitHub processes and uses personal data, please see the [GitHub Privacy Statement](/site-policy/privacy-policies/github-privacy-statement).
|
||||
@@ -11,6 +11,7 @@ children:
|
||||
- /github-subprocessors-and-cookies
|
||||
- /github-codespaces-privacy-statement
|
||||
- /github-candidate-privacy-policy
|
||||
- /github-copilot-for-business-privacy-statement
|
||||
redirect_from:
|
||||
- /github/site-policy/github-data-protection-addendum
|
||||
- /github/site-policy-deprecated/github-data-protection-addendum
|
||||
|
||||
1
data/reusables/copilot/about-copilot.md
Normal file
@@ -0,0 +1 @@
|
||||
{% data variables.product.prodname_copilot %} is a new AI-powered code completion tool that helps you write code faster. {% data variables.product.prodname_copilot %} is available through {% data variables.product.prodname_dotcom %} personal accounts with {% data variables.product.prodname_copilot_for_individuals %} and through {% data variables.product.prodname_ghe_cloud %} with {% data variables.product.prodname_copilot_for_business %}. For more information, see "[About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)."
|
||||
@@ -1,2 +1,2 @@
|
||||
- {% data variables.product.prodname_copilot %} is free to use for verified students, teachers, and open source maintainers.
|
||||
- If you are not a student, teacher, or open source maintainer, you can try {% data variables.product.prodname_copilot %} for free with a one-time 60 day trial. After the free trial, you will need a paid subscription for continued use. You must provide billing information in order to start a free trial. For more information, see "[About billing for {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)."
|
||||
- If you are not a student, teacher, or open source maintainer, you will need an active trial or subscription. For more information, see "[About billing for {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)."
|
||||
|
||||
@@ -2,7 +2,9 @@
|
||||
|
||||
Once you have an active {% data variables.product.prodname_copilot %} trial or subscription, you can adjust {% data variables.product.prodname_copilot %} settings for your personal account on {% data variables.product.prodname_dotcom %} in the [{% data variables.product.prodname_copilot %} settings](https://github.com/settings/copilot). The settings apply anywhere that you use {% data variables.product.prodname_copilot %}. You can configure the suggestions that {% data variables.product.prodname_copilot %} offers and how {% data variables.product.company_short %} uses your telemetry data.
|
||||
|
||||
## Enabling or disabling duplication detection
|
||||
### Enabling or disabling duplication detection
|
||||
|
||||
{% data reusables.copilot.duplication-setting-org %}
|
||||
|
||||
{% data variables.product.prodname_copilot %} includes a filter which detects code suggestions matching public code on {% data variables.product.prodname_dotcom %}. You can choose to enable or disable the filter. When the filter is enabled, {% data variables.product.prodname_copilot %} checks code suggestions with their surrounding code of about 150 characters against public code on {% data variables.product.prodname_dotcom %}. If there is a match or near match, the suggestion will not be shown to you.
|
||||
|
||||
@@ -12,7 +14,9 @@ Once you have an active {% data variables.product.prodname_copilot %} trial or s
|
||||

|
||||
{% data reusables.copilot.save-settings %}
|
||||
|
||||
## Enabling or disabling telemetry
|
||||
### Enabling or disabling telemetry
|
||||
|
||||
{% data reusables.copilot.telemetry-setting-org %}
|
||||
|
||||
You can choose whether your code snippets are collected and retained by GitHub and further processed and shared with Microsoft and OpenAI by adjusting your user settings. For more information about data that {% data variables.product.prodname_copilot %} may collect depending on your telemetry settings, see "[{% data variables.product.company_short %} Terms for Additional Products and Features](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot)" and the [{% data variables.product.prodname_copilot %} privacy FAQ](https://github.com/features/copilot/#faq-privacy).
|
||||
|
||||
|
||||
5
data/reusables/copilot/duplication-setting-org.md
Normal file
@@ -0,0 +1,5 @@
|
||||
{% note %}
|
||||
|
||||
**Note:** If you are a member of an organization on {% data variables.product.prodname_ghe_cloud %} who has been assigned a {% data variables.product.prodname_copilot %} seat through your organization, you will not be able to configure duplication detection in your personal account settings. Your duplication detection setting will be inherited from your organization or enterprise.
|
||||
|
||||
{% endnote %}
|
||||
@@ -1,7 +1,5 @@
|
||||
Before you can start using {% data variables.product.prodname_copilot %}, you will need to set up a free trial or subscription.
|
||||
|
||||
{% data reusables.user-settings.access_settings %}
|
||||
1. In the "Code, planning, and automation" section of the sidebar, click **{% octicon "copilot" aria-label="The copilot icon" %} GitHub Copilot**.
|
||||
1. In the "Code, planning, and automation" section of the sidebar, click **{% octicon "copilot" aria-label="The copilot icon" %} {% data variables.product.prodname_copilot %}**.
|
||||
1. On the {% data variables.product.prodname_copilot %} settings page, click **Enable {% data variables.product.prodname_copilot %}**.
|
||||
|
||||

|
||||
|
||||
1
data/reusables/copilot/subscription-prerequisite.md
Normal file
@@ -0,0 +1 @@
|
||||
- To use {% data variables.product.prodname_copilot %} you must have an active {% data variables.product.prodname_copilot %} subscription. For more information, see "[About billing for {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)."
|
||||
5
data/reusables/copilot/telemetry-setting-org.md
Normal file
@@ -0,0 +1,5 @@
|
||||
{% note %}
|
||||
|
||||
**Note:** If you are a member of an organization on {% data variables.product.prodname_ghe_cloud %} who has been assigned a {% data variables.product.prodname_copilot %} seat through your organization, you will not be able to configure telemetry in your personal account settings. Telemetry will be automatically disabled.
|
||||
|
||||
{% endnote %}
|
||||
2
data/reusables/copilot/vscode-settings.md
Normal file
@@ -0,0 +1,2 @@
|
||||
1. In the **File** menu, navigate to **Preferences** and click **Settings**.
|
||||

|
||||
1
data/reusables/enterprise-accounts/copilot-tab.md
Normal file
@@ -0,0 +1 @@
|
||||
1. Under "{% octicon "law" aria-label="The law icon" %} Policies", click **{% data variables.product.prodname_copilot_short %}**.
|
||||
@@ -1 +1,3 @@
|
||||
Billing for {% data variables.product.prodname_copilot %} can currently only be managed through personal accounts. Organizations cannot manage {% data variables.product.prodname_copilot %} billing for organization members at this time. If you are interested in managing billing for {% data variables.product.prodname_copilot %} through your organization, you can join the [waitlist](https://github.com/features/copilot/org_signup).
|
||||
{% data variables.product.prodname_copilot %} can be managed through personal accounts with {% data variables.product.prodname_copilot_for_individuals %} or through invoiced {% data variables.product.prodname_ghe_cloud %} accounts with {% data variables.product.prodname_copilot_for_business %}.<br><br>
|
||||
|
||||
{% data variables.product.prodname_ghe_cloud %} accounts paying through credit card or PayPal, and organizations on the {% data variables.product.prodname_team %} or {% data variables.product.prodname_free_team %} plans cannot manage {% data variables.product.prodname_copilot %} for their members at this time. If you are interested in managing {% data variables.product.prodname_copilot %} through your {% data variables.product.prodname_ghe_cloud %} account paying through credit card or PayPal, or your organization on the {% data variables.product.prodname_team %} or {% data variables.product.prodname_free_team %} plan, you can contact sales and request to join the [waitlist](https://github.com/enterprise/contact?ref_page=/pricing?_features=site_copilot_biz_ga&ref_cta=Contact%20Sales&ref_loc=cards).
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
{% data variables.product.prodname_copilot %} is available to {% data variables.product.company_short %} customers with a personal account on {% data variables.product.prodname_dotcom_the_website %}. {% data reusables.copilot.emus-cannot-use-copilot %}<br><br>
|
||||
{% data variables.product.prodname_copilot %} is available to {% data variables.product.company_short %} customers with a personal account on {% data variables.product.prodname_dotcom_the_website %} and {% data variables.product.prodname_ghe_cloud %} organizations owned by an enterprise account.<br><br>
|
||||
|
||||
{% data variables.product.prodname_copilot %} is free to use for verified students, teachers, and maintainers of popular open source projects. If you are not a student, teacher, or maintainer of a popular open source project, you can try {% data variables.product.prodname_copilot %} for free with a one-time 60 day trial. After the free trial, you will need a paid subscription for continued use. For more information, see "[About billing for {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)."
|
||||
{% data variables.product.prodname_copilot %} is free to use for verified students, teachers, and maintainers of popular open source projects. If you are not a student, teacher, or maintainer of a popular open source project, you can try {% data variables.product.prodname_copilot %} for free with a one-time 60-day trial. After the free trial, you will need a paid subscription for continued use. For more information, see "[About billing for {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)."
|
||||
|
||||
@@ -223,6 +223,10 @@ prodname_arctic_vault: 'Arctic Code Vault'
|
||||
# GitHub Copilot
|
||||
prodname_copilot: 'GitHub Copilot'
|
||||
prodname_copilot_short: 'Copilot'
|
||||
prodname_copilot_for_business: 'GitHub Copilot for Business'
|
||||
prodname_copilot_for_individuals: 'GitHub Copilot for Individuals'
|
||||
prodname_copilot_business_short: 'Copilot for Business'
|
||||
prodname_copilot_individuals_short: 'Copilot for Individuals'
|
||||
|
||||
# Command Palette
|
||||
prodname_command_palette: 'GitHub Command Palette'
|
||||
|
||||
@@ -16,12 +16,12 @@ type: overview
|
||||
topics:
|
||||
- Action development
|
||||
- Fundamentals
|
||||
ms.openlocfilehash: ac933a5014750f75373fafa7f8dd52333b79a469
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 1e81bea551ceff1980b0bbe96202f60db0d0e7f2
|
||||
ms.sourcegitcommit: 9af8891fea10039b3374c76818634e05410e349d
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147154574'
|
||||
ms.lasthandoff: 12/06/2022
|
||||
ms.locfileid: '148191951'
|
||||
---
|
||||
{% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %}
|
||||
|
||||
@@ -35,7 +35,7 @@ ms.locfileid: '147154574'
|
||||
|
||||
## アクションの種類
|
||||
|
||||
DockerコンテナのアクションとJavaScriptのアクションをビルドできます。 アクションには、アクションの入力、出力、およびメインのエントリポイントを定義するメタデータファイルが必要です。 メタデータ ファイル名は、`action.yml` または `action.yaml` である必要があります。 詳細については、「[{% data variables.product.prodname_actions %} のメタデータ構文](/articles/metadata-syntax-for-github-actions)」を参照してください。
|
||||
Docker コンテナーと JavaScript のアクション、および複合アクションを構築できます。 アクションには、アクションの入力、出力、およびメインのエントリポイントを定義するメタデータファイルが必要です。 メタデータ ファイル名は、`action.yml` または `action.yaml` である必要があります。 詳細については、「[{% data variables.product.prodname_actions %} のメタデータ構文](/articles/metadata-syntax-for-github-actions)」を参照してください。
|
||||
|
||||
| 種類 | オペレーティング システム |
|
||||
| ---- | ------------------- |
|
||||
|
||||
@@ -271,3 +271,10 @@ jobs:
|
||||
From your repository, click the **Actions** tab, and select the latest workflow run. Under **Jobs** or in the visualization graph, click **A job to say hello**. You should see "Hello Mona the Octocat" or the name you used for the `who-to-greet` input and the timestamp printed in the log.
|
||||
|
||||

|
||||
|
||||
## Template repositories for creating JavaScript actions
|
||||
|
||||
{% data variables.product.prodname_dotcom %} provides template repositories for creating JavaScript and TypeScript actions. You can use these templates to quickly get started with creating a new action that includes tests, linting, and other recommended practices.
|
||||
|
||||
* [`javascript-action` template repository](https://github.com/actions/javascript-action)
|
||||
* [`typescript-action` template repository](https://github.com/actions/typescript-action)
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Enabling Server Statistics for your enterprise
|
||||
intro: 'You can analyze your own aggregate data from {% data variables.product.prodname_ghe_server %} and help us improve {% data variables.product.company_short %} products by enabling {% data variables.product.prodname_server_statistics %}.'
|
||||
title: 自社でサーバー統計を有効にする
|
||||
intro: '{% data variables.product.prodname_server_statistics %} を有効にすることで、{% data variables.product.prodname_ghe_server %} からの独自の集計データを分析し、{% data variables.product.company_short %} 製品の改善に役立てることができます。'
|
||||
versions:
|
||||
feature: server-statistics
|
||||
redirect_from:
|
||||
@@ -8,23 +8,27 @@ redirect_from:
|
||||
topics:
|
||||
- Enterprise
|
||||
shortTitle: Server Statistics
|
||||
ms.openlocfilehash: 125651de793a45240008de34845762e6de637040
|
||||
ms.sourcegitcommit: 9af8891fea10039b3374c76818634e05410e349d
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/06/2022
|
||||
ms.locfileid: '148191871'
|
||||
---
|
||||
## {% data variables.product.prodname_server_statistics %}について
|
||||
|
||||
## About {% data variables.product.prodname_server_statistics %}
|
||||
{% data variables.product.prodname_server_statistics %} は、{% data variables.location.product_location %} から集計された使用状況データを収集します。これを使うと、組織のニーズをより適切に予測し、チームの作業を把握し、{% data variables.product.prodname_ghe_server %} から得られる価値を確認できます。
|
||||
|
||||
{% data variables.product.prodname_server_statistics %} collects aggregate usage data from {% data variables.location.product_location %}, which you can use to better anticipate the needs of your organization, understand how your team works, and show the value you get from {% data variables.product.prodname_ghe_server %}.
|
||||
{% data variables.product.prodname_server_statistics %} によって収集されるのは、リポジトリ、イシュー、pull request、およびその他の機能に関する特定の集計メトリックのみです。 {% data variables.product.prodname_dotcom %} のコンテンツは収集されません (コード、イシュー、コメント、pull request のコンテンツなど)。 詳しい情報については、「[{% data variables.product.prodname_server_statistics %}について](/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/about-server-statistics)」を参照してください。
|
||||
|
||||
{% data variables.product.prodname_server_statistics %} only collects certain aggregate metrics on repositories, issues, pull requests, and other features. {% data variables.product.prodname_dotcom %} content, such as code, issues, comments, or pull request content, is not collected. For more information, see "[About {% data variables.product.prodname_server_statistics %}](/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/about-server-statistics)."
|
||||
{% data variables.product.prodname_server_statistics %}を有効にすると、{% data variables.product.company_short %}の改善にも役立ちます。 お客様から提供された集計データは、お客様が {% data variables.product.prodname_dotcom %} をどのように使っているかを把握し、より適切な情報に基づいた製品の意思決定を行う助けとなり、最終的にはお客様の利益になります。
|
||||
|
||||
By enabling {% data variables.product.prodname_server_statistics %}, you are also helping to improve {% data variables.product.company_short %}. The aggregated data you will provide helps us understand how our customers are using {% data variables.product.prodname_dotcom %}, and make better and more informed product decisions, ultimately benefiting you.
|
||||
## {% data variables.product.prodname_server_statistics %}の有効化
|
||||
|
||||
## Enabling {% data variables.product.prodname_server_statistics %}
|
||||
{% data variables.product.prodname_server_statistics %}を有効にする前に、まず {% data variables.product.prodname_ghe_server %} インスタンスを {% data variables.product.prodname_github_connect %} を使って {% data variables.product.prodname_dotcom_the_website %} に接続する必要があります。 詳細については、「[{% data variables.product.prodname_ghe_cloud %} への {% data variables.product.prodname_ghe_server %} の接続](/enterprise-server@3.1/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud/connecting-github-enterprise-server-to-github-enterprise-cloud)」を参照してください。
|
||||
|
||||
Before you can enable {% data variables.product.prodname_server_statistics %}, you must first connect your {% data variables.product.prodname_ghe_server %} instance to {% data variables.product.prodname_dotcom_the_website %} through {% data variables.product.prodname_github_connect %}. For more information, see "[Connecting {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_ghe_cloud %}](/enterprise-server@3.1/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud/connecting-github-enterprise-server-to-github-enterprise-cloud)."
|
||||
{% data variables.product.prodname_server_statistics %} は {% data variables.product.prodname_ghe_server %} からいつでも無効にできます。
|
||||
|
||||
You can disable {% data variables.product.prodname_server_statistics %} from {% data variables.product.prodname_ghe_server %} at any time.
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.github-connect-tab %}
|
||||
4. Under "Share server statistics with GitHub.com", select the dropdown menu and click **Enabled** or **Disabled**.
|
||||

|
||||
{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.github-connect-tab %}
|
||||
4. [GitHub.com でサーバー統計を共有する] でドロップダウン メニューを選び、 **[有効]** または **[無効]** をクリックします。
|
||||

|
||||
|
||||
@@ -23,29 +23,36 @@ Subdomain isolation mitigates cross-site scripting and other related vulnerabili
|
||||
|
||||
When subdomain isolation is enabled, {% data variables.product.prodname_ghe_server %} replaces several paths with subdomains. After enabling subdomain isolation, attempts to access the previous paths for some user-supplied content, such as `http(s)://HOSTNAME/raw/`, may return `404` errors.
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.3-7-new-subdomains %}
|
||||
|
||||
| Path without subdomain isolation | Path with subdomain isolation |
|
||||
| --- | --- |
|
||||
| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/` | `http(s)://docker.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/_registry/npm/` | `https://npm.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/_registry/rubygems/` | `https://rubygems.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/_registry/maven/` | `https://maven.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/_registry/nuget/` | `https://nuget.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` |
|
||||
{%- ifversion viewscreen-and-notebooks %}
|
||||
| `http(s)://HOSTNAME/viewscreen/` | `http(s)://viewscreen.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/notebooks/` | `http(s)://notebooks.HOSTNAME/` |
|
||||
{%- else %}
|
||||
| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/notebooks/` | `http(s)://notebooks.HOSTNAME/` |
|
||||
{%- endif %}
|
||||
| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` |
|
||||
{%- ifversion ghes < 3.7 %}
|
||||
| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` |
|
||||
{%- endif %}
|
||||
| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` |
|
||||
{%- ifversion viewscreen-and-notebooks %}
|
||||
| `http(s)://HOSTNAME/viewscreen/` | `http(s)://viewscreen.HOSTNAME/` |
|
||||
{%- endif %}
|
||||
{%- ifversion ghes > 3.4 %}
|
||||
| Not supported | `https://containers.HOSTNAME/` |
|
||||
{%- endif %}
|
||||
| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` | {% ifversion ghes %}
|
||||
| `https://HOSTNAME/` | `http(s)://docker.HOSTNAME/`{% endif %}{% ifversion ghes %}
|
||||
| `https://HOSTNAME/_registry/npm/` | `https://npm.HOSTNAME/`
|
||||
| `https://HOSTNAME/_registry/rubygems/` | `https://rubygems.HOSTNAME/`
|
||||
| `https://HOSTNAME/_registry/maven/` | `https://maven.HOSTNAME/`
|
||||
| `https://HOSTNAME/_registry/nuget/` | `https://nuget.HOSTNAME/`{% endif %}{% ifversion ghes > 3.4 %}
|
||||
| Not supported | `https://containers.HOSTNAME/` |{% endif %}
|
||||
|
||||
## Prerequisites
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Enabling GitHub Actions with MinIO storage
|
||||
intro: 'You can enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} and use MinIO storage to store data generated by workflow runs.'
|
||||
title: MinIO ストレージで GitHub Actions を有効化する
|
||||
intro: '{% data variables.product.prodname_ghe_server %} で {% data variables.product.prodname_actions %} を有効化し、MinIO ストレージを使用してワークフローの実行によって生成されたデータを保存できます。'
|
||||
permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.'
|
||||
versions:
|
||||
ghes: '*'
|
||||
@@ -14,36 +14,35 @@ redirect_from:
|
||||
- /admin/github-actions/enabling-github-actions-with-minio-gateway-for-nas-storage
|
||||
- /admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-gateway-for-nas-storage
|
||||
shortTitle: MinIO storage
|
||||
ms.openlocfilehash: 3d9c6cfca6b81a66185515c8757cef22290ead30
|
||||
ms.sourcegitcommit: 8f1801040a84ca9353899a2d1e6782c702aaed0d
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/16/2022
|
||||
ms.locfileid: '148166570'
|
||||
---
|
||||
## 前提条件
|
||||
|
||||
## Prerequisites
|
||||
{% data variables.product.prodname_actions %} を有効化する前に、次のステップを完了していることを確認してください。
|
||||
|
||||
Before enabling {% data variables.product.prodname_actions %}, make sure you have completed the following steps:
|
||||
* ワークフローの実行によって生成されるデータを保存するための MinIO バケットを作成します。 MinIO のインストールと構成の詳細については、MinIO ドキュメントの「[MinIO ハイ パフォーマンス オブジェクト ストレージ](https://min.io/docs/minio/container/index.html)」および「[mc mb](https://min.io/docs/minio/linux/reference/minio-mc/mc-mb.html)」を参照してください。
|
||||
|
||||
* Create your MinIO bucket for storing data generated by workflow runs. For more information about installing and configuring MinIO, see "[MinIO High Performance Object Storage](https://min.io/docs/minio/container/index.html)" and "[mc mb](https://min.io/docs/minio/linux/reference/minio-mc/mc-mb.html)" in the MinIO documentation.
|
||||
アプライアンスでのリソースの競合を回避するために、MinIO を {% data variables.location.product_location %} とは別にホストすることをお勧めします。
|
||||
|
||||
To avoid resource contention on the appliance, we recommend that MinIO be hosted separately from {% data variables.location.product_location %}.
|
||||
{% indented_data_reference reusables.actions.enterprise-s3-permission spaces=2 %} {% data reusables.actions.enterprise-common-prereqs %}
|
||||
|
||||
{% indented_data_reference reusables.actions.enterprise-s3-permission spaces=2 %}
|
||||
{% data reusables.actions.enterprise-common-prereqs %}
|
||||
## MinIO ストレージで {% data variables.product.prodname_actions %} を有効化する
|
||||
|
||||
## Enabling {% data variables.product.prodname_actions %} with MinIO storage
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.actions %} {% data reusables.actions.enterprise-enable-checkbox %}
|
||||
1. [Artifact & Log Storage]\(成果物とログ ストレージ\) の下で、 **[Amazon S3]** を選択し、ストレージ バケットの詳細を入力します。
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
{% data reusables.enterprise_site_admin_settings.management-console %}
|
||||
{% data reusables.enterprise_management_console.actions %}
|
||||
{% data reusables.actions.enterprise-enable-checkbox %}
|
||||
1. Under "Artifact & Log Storage", select **Amazon S3**, and enter your storage bucket's details:
|
||||
* **[AWS Service URL]\(AWS サービス URL\)** : MinIO サービスの URL。 たとえば、`https://my-minio.example:9000` のようにします。
|
||||
* **[AWS S3 Bucket]\(AWS S3 バケット\)** : S3 バケットの名前。
|
||||
* **[AWS S3 Access Key]\(AWS S3 アクセス キー\)** および **[AWS S3 Secret Key]\(AWS S3 秘密鍵\)** : MinIO インスタンスで使用される `MINIO_ACCESS_KEY` および `MINIO_SECRET_KEY`。
|
||||
|
||||
* **AWS Service URL**: The URL to your MinIO service. For example, `https://my-minio.example:9000`.
|
||||
* **AWS S3 Bucket**: The name of your S3 bucket.
|
||||
* **AWS S3 Access Key** and **AWS S3 Secret Key**: The `MINIO_ACCESS_KEY` and `MINIO_SECRET_KEY` used for your MinIO instance.
|
||||

|
||||
1. [Artifact & Log Storage]\(成果物とログ ストレージ\) の下で、 **[Force path style]\(パス スタイルの強制\)** を選択します。
|
||||
|
||||

|
||||
1. Under "Artifact & Log Storage", select **Force path style**.
|
||||
|
||||

|
||||
{% data reusables.enterprise_management_console.test-storage-button %}
|
||||
{% data reusables.enterprise_management_console.save-settings %}
|
||||
![[パス スタイルの強制] のチェックボックス](/assets/images/enterprise/management-console/actions-minio-force-path-style.png) {% data reusables.enterprise_management_console.test-storage-button %} {% data reusables.enterprise_management_console.save-settings %}
|
||||
|
||||
{% data reusables.actions.enterprise-postinstall-nextsteps %}
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
title: About support for your IdP's Conditional Access Policy
|
||||
title: IdP の条件付きアクセス ポリシーのサポートについて
|
||||
shortTitle: Conditional access policy
|
||||
intro: 'When your enterprise uses OIDC SSO, {% data variables.product.prodname_dotcom %} can validate access to your enterprise and its resources using your IdP''s Conditional Access Policy (CAP).'
|
||||
intro: 'Enterprise が OIDC SSO を使っている場合、{% data variables.product.prodname_dotcom %} は、お客様の IdP の条件付きアクセス ポリシー (CAP) を使って、Enterprise とそのリソースへのアクセスを検証できます。'
|
||||
product: '{% data reusables.gated-features.emus %}'
|
||||
versions:
|
||||
feature: oidc-for-emu
|
||||
@@ -10,35 +10,40 @@ topics:
|
||||
- Authentication
|
||||
- Enterprise
|
||||
- SSO
|
||||
ms.openlocfilehash: aed7008bd008ccfd6303ccbb36f4d6f3bd7002ca
|
||||
ms.sourcegitcommit: c562c85cc75ffe1eb4e9595d8adc09ec71697ab1
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/22/2022
|
||||
ms.locfileid: '148179998'
|
||||
---
|
||||
|
||||
{% data reusables.enterprise-accounts.azure-emu-support-oidc %}
|
||||
|
||||
## About support for Conditional Access Policies
|
||||
## 条件付きアクセス ポリシーのサポートについて
|
||||
|
||||
{% data reusables.enterprise-accounts.emu-cap-validates %}
|
||||
|
||||
{% data variables.product.product_name %} supports CAP for any {% data variables.enterprise.prodname_emu_enterprise %} where OIDC SSO is enabled. {% data variables.product.product_name %} enforces your IdP's IP conditions but cannot enforce your device compliance conditions. Enterprise owners can choose to use this IP allow list configuration instead of {% data variables.product.product_name %}'s IP allow list, and can do so once OIDC SSO is configured. For more information about IP allow lists, see "[Restricting network traffic with an IP allow list](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list)" and "[Managing allowed IP addresses for your organization](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)."
|
||||
{% data variables.product.product_name %} では、OIDC SSO が有効になっている {% data variables.enterprise.prodname_emu_enterprise %} の CAP がサポートされます。 {% data variables.product.product_name %} によって IdP の IP 条件が適用されますが、デバイスのコンプライアンス条件は適用できません。 Enterprise 所有者は、{% data variables.product.product_name %} の IP 許可リストではなく、この IP 許可リスト構成を使用することを選ぶことができ、OIDC SSO が構成されたらそれを行うことができます。 IP 許可リストについて詳しくは、「[IP 許可リストを使用したネットワーク トラフィックの制限](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list)」および「[Organization の許可された IP アドレスの管理](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)」をご覧ください。
|
||||
|
||||
|
||||
For more information about using OIDC with {% data variables.product.prodname_emus %}, see "[Configuring OIDC for Enterprise Managed Users](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users)" and "[Migrating from SAML to OIDC](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc)."
|
||||
OIDC と {% data variables.product.prodname_emus %} の使用の詳細については、「[エンタープライズ マネージド ユーザー向けの OIDC の構成](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users)」と「[SAML から OIDC への移行](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc)」を参照してください。
|
||||
|
||||
## Considerations for integrations and automations
|
||||
## 統合と自動化に関する考慮事項
|
||||
|
||||
{% data variables.product.prodname_dotcom %} sends the originating IP address to your IdP for validation against your CAP. To make sure actions and apps are not blocked by your IdP's CAP, you will need to make changes to your configuration.
|
||||
CAP に対する検証のために、{% data variables.product.prodname_dotcom %} から IdP に送信元の IP アドレスが送信されます。 アクションとアプリが IdP の CAP によってブロックされないようにするには、構成を変更する必要があります。
|
||||
|
||||
{% data reusables.enterprise-accounts.oidc-gei-warning %}
|
||||
|
||||
### {% data variables.product.prodname_actions %}
|
||||
|
||||
Actions that use a {% data variables.product.pat_generic %} will likely be blocked by your IdP's CAP. We recommend that {% data variables.product.pat_generic %}s are created by a service account which is then exempted from IP controls in your IdP's CAP.
|
||||
{% data variables.product.pat_generic %} を使用するアクションは、IdP の CAP によってブロックされる可能性が高いです。 {% data variables.product.pat_generic %}は、サービス アカウントを使って作成し、IdP の CAP で IP 制御の対象外とすることをお勧めします。
|
||||
|
||||
If you're unable to use a service account, another option for unblocking actions that use {% data variables.product.pat_generic %}s is to allow the IP ranges used by {% data variables.product.prodname_actions %}. For more information, see "[About GitHub's IP addresses](/authentication/keeping-your-account-and-data-secure/about-githubs-ip-addresses)."
|
||||
サービス アカウントを使用できない場合、{% data variables.product.pat_generic %}を使うアクションのブロックを解除する別のオプションとして、{% data variables.product.prodname_actions %} で使われる IP 範囲を許可することができます。 詳細については、「[GitHub の IP アドレスについて](/authentication/keeping-your-account-and-data-secure/about-githubs-ip-addresses)」を参照してください。
|
||||
|
||||
### {% data variables.product.prodname_github_apps %} and {% data variables.product.prodname_oauth_apps %}
|
||||
### {% data variables.product.prodname_github_apps %} と {% data variables.product.prodname_oauth_apps %}
|
||||
|
||||
When {% data variables.product.prodname_github_apps %} and {% data variables.product.prodname_oauth_apps %} make requests on a member's behalf, {% data variables.product.prodname_dotcom %} will send the IP address of the app's server to your IdP for validation. If the IP address of the app's server is not validated by your IdP's CAP, the request will fail.
|
||||
{% data variables.product.prodname_github_apps %} と {% data variables.product.prodname_oauth_apps %} がメンバーの代理で要求を行うと、検証のために {% data variables.product.prodname_dotcom %} から IdP にアプリのサーバーの IP アドレスが送信されます。 アプリのサーバーの IP アドレスが IdP の CAP によって検証されない場合、要求は失敗します。
|
||||
|
||||
You can contact the owners of the apps you want to use, ask for their IP ranges, and configure your IdP's CAP to allow access from those IP ranges. If you're unable to contact the owners, you can review your IdP sign-in logs to review the IP addresses seen in the requests, then allow-list those addresses.
|
||||
使いたいアプリの所有者に連絡し、その IP の範囲を問い合わせて、その IP の範囲からのアクセスを許可するように IdP の CAP を構成することができます。 所有者に連絡できない場合は、IdP のサインイン ログを確認し、要求に出現する IP アドレスを確認し、それらのアドレスを許可リストに登録できます。
|
||||
|
||||
If you do not wish to allow all of the IP ranges for all of your enterprise's apps, you can also exempt installed {% data variables.product.prodname_github_apps %} and authorized {% data variables.product.prodname_oauth_apps %} from the IdP allow list. If you do so, these apps will continue working regardless of the originating IP address. For more information, see "[Enforcing policies for security settings in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#allowing-access-by-github-apps)."
|
||||
すべてのエンタープライズのアプリに対してすべての IP 範囲を許可しない場合は、インストールされている {% data variables.product.prodname_github_apps %} と承認された {% data variables.product.prodname_oauth_apps %} を IdP 許可リストから除外することもできます。 その場合、これらのアプリは発信元 IP アドレスに関係なく、動作し続けます。 詳細については、「[Enforcing policies for security settings in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#allowing-access-by-github-apps)」 (Enterprise でセキュリティ設定のポリシーを適用する) を参照してください。
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Enabling GitHub Packages with Azure Blob Storage
|
||||
intro: 'Set up {% data variables.product.prodname_registry %} with Azure Blob Storage as your external storage.'
|
||||
title: Azure Blob Storage で GitHub Packages を有効化する
|
||||
intro: 'Azure Blob Storage を外部ストレージとして {% data variables.product.prodname_registry %} を設定します。'
|
||||
versions:
|
||||
ghes: '*'
|
||||
type: tutorial
|
||||
@@ -9,42 +9,44 @@ topics:
|
||||
- Packages
|
||||
- Storage
|
||||
shortTitle: Enable Packages with Azure
|
||||
ms.openlocfilehash: b851f698baba60323cbaaa69122cacdc92ec83c2
|
||||
ms.sourcegitcommit: 3ece72cf2d90987575d369c44101d19d3bb06f76
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/02/2022
|
||||
ms.locfileid: '148190388'
|
||||
---
|
||||
|
||||
{% warning %}
|
||||
|
||||
**Warnings:**
|
||||
- It is critical that you set the restrictive access policies you need for your storage bucket, because {% data variables.product.company_short %} does not apply specific object permissions or additional access control lists (ACLs) to your storage bucket configuration. For example, if you make your bucket public, data in the bucket will be accessible on the public internet.
|
||||
- We recommend using a dedicated bucket for {% data variables.product.prodname_registry %}, separate from the bucket you use for {% data variables.product.prodname_actions %} storage.
|
||||
- Make sure to configure the bucket you'll want to use in the future. We do not recommend changing your storage after you start using {% data variables.product.prodname_registry %}.
|
||||
**警告:**
|
||||
- {% data variables.product.company_short %} は特定のオブジェクトのアクセス許可または追加のアクセス制御リスト (ACL) をストレージバケット設定に適用しないため、ストレージバケットに必要な制限付きアクセスポリシーを設定することが重要です。 たとえば、バケットを公開すると、バケット内のデータにパブリックなインターネットからアクセスできるようになります。
|
||||
- {% data variables.product.prodname_actions %} ストレージに使用するバケットとは別に、{% data variables.product.prodname_registry %} 専用のバケットを使用することをお勧めします。
|
||||
- 今後使用予定のバケットを忘れずに設定するようにしてください。 {% data variables.product.prodname_registry %} の使用開始後にストレージを変更することはお勧めしません。
|
||||
|
||||
{% endwarning %}
|
||||
|
||||
## Prerequisites
|
||||
## 前提条件
|
||||
|
||||
Before you can enable and configure {% data variables.product.prodname_registry %} on {% data variables.location.product_location_enterprise %}, you need to prepare your Azure Blob storage bucket. To prepare your Azure Blob storage bucket, we recommend consulting the official Azure Blob storage docs at the official [Azure Blob Storage documentation site](https://docs.microsoft.com/en-us/azure/storage/blobs/).
|
||||
{% data variables.location.product_location_enterprise %}で {% data variables.product.prodname_registry %} を有効にして設定する前に、Azure Blob Storage バケットを準備する必要があります。 Azure Blob Storage バケットを準備するために、公式 [Azure Blob Storage ドキュメント サイト](https://docs.microsoft.com/en-us/azure/storage/blobs/)で公式 Azure Blob Storage ドキュメントを参照することをお勧めします。
|
||||
|
||||
## Enabling {% data variables.product.prodname_registry %} with Azure Blob Storage
|
||||
## Azure Blob Storage で {% data variables.product.prodname_registry %} を有効化する
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
{% data reusables.enterprise_site_admin_settings.management-console %}
|
||||
{% data reusables.enterprise_site_admin_settings.packages-tab %}
|
||||
{% data reusables.package_registry.enable-enterprise-github-packages %}
|
||||
1. Under "Packages Storage", select **Azure Blob Storage** and enter your Azure container name for your packages storage bucket and connection string.
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_site_admin_settings.packages-tab %} {% data reusables.package_registry.enable-enterprise-github-packages %}
|
||||
1. [Packages Storage] で **[Azure Blob Storage]** を選択し、パッケージストレージバケットの Azure コンテナ名と接続文字列型を入力します。
|
||||
|
||||
- You must create a storage container prior to setting the container name and connection string.
|
||||
- コンテナー名と接続文字列を設定する前に、ストレージ コンテナーを作成する必要があります。
|
||||
|
||||

|
||||

|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** You can find your Azure Connection String by navigating to the Access Key menu in your Azure storage account.
|
||||
Usage of a SAS Token or SAS URL as connection string is not currently supported.
|
||||
**注:** Azure ストレージ アカウントの [アクセス キー] メニューに移動すると、Azure の接続文字列を見つけることができます。
|
||||
現在、接続文字列としての SAS トークンまたは SAS URL の使用はサポートされていません。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.enterprise_management_console.save-settings %}
|
||||
|
||||
## Next steps
|
||||
## 次の手順
|
||||
|
||||
{% data reusables.package_registry.next-steps-for-packages-enterprise-setup %}
|
||||
|
||||
@@ -56,7 +56,7 @@ You can enforce policies to control how members of your enterprise on {% data va
|
||||
|
||||
Each time someone creates a new repository within your enterprise, that person must choose a visibility for the repository. When you configure a default visibility setting for the enterprise, you choose which visibility is selected by default. For more information on repository visibility, see "[About repositories](/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility)."
|
||||
|
||||
If an enterprise owner disallows members from creating certain types of repositories, members will not be able to create that type of repository even if the visibility setting defaults to that type. For more information, see "[Setting a policy for repository creation](#setting-a-policy-for-repository-creation)."
|
||||
If an enterprise owner disallows members from creating certain types of repositories, members will not be able to create that type of repository even if the visibility setting defaults to that type. For more information, see "[Enforcing a policy for repository creation](#enforcing-a-policy-for-repository-creation)."
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% ifversion ghes or ghae %}
|
||||
@@ -166,7 +166,7 @@ Across all organizations owned by your enterprise, you can set the default branc
|
||||
|
||||
Across all organizations owned by your enterprise, you can allow members with admin access to change a repository's visibility, restrict repository visibility changes to organization owners, or allow owners to administer the setting on the organization level. When you prevent members from changing repository visibility, only enterprise owners can change the visibility of a repository.
|
||||
|
||||
If an enterprise owner has restricted repository creation to organization owners only, then members will not be able to change repository visibility. If an enterprise owner has restricted member repository creation to private repositories only, then members will only be able to change the visibility of a repository to private. For more information, see "[Setting a policy for repository creation](#setting-a-policy-for-repository-creation)."
|
||||
If an enterprise owner has restricted repository creation to organization owners only, then members will not be able to change repository visibility. If an enterprise owner has restricted member repository creation to private repositories only, then members will only be able to change the visibility of a repository to private. For more information, see "[Enforcing a policy for repository creation](#enforcing-a-policy-for-repository-creation)."
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.policies-tab %}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: About billing for GitHub Actions
|
||||
intro: 'If you want to use {% data variables.product.prodname_actions %} beyond the storage or minutes included in your account, you will be billed for additional usage.'
|
||||
title: GitHub Actions の課金について
|
||||
intro: 'アカウントに含まれるストレージや利用時間 (分) を超えて{% data variables.product.prodname_actions %}を使用したい場合は、追加の使用分が請求されます。'
|
||||
miniTocMaxHeadingLevel: 3
|
||||
redirect_from:
|
||||
- /github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions
|
||||
@@ -13,105 +13,104 @@ topics:
|
||||
- Actions
|
||||
- Spending limits
|
||||
shortTitle: Billing for GitHub Actions
|
||||
ms.openlocfilehash: fcc8f84b8a11b214ca66e8a3851a1afc9df6213a
|
||||
ms.sourcegitcommit: 9af8891fea10039b3374c76818634e05410e349d
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/06/2022
|
||||
ms.locfileid: '148191887'
|
||||
---
|
||||
## About billing for {% data variables.product.prodname_actions %}
|
||||
## {% data variables.product.prodname_actions %} の課金について
|
||||
|
||||
{% data reusables.actions.actions-billing %}
|
||||
|
||||
{% data reusables.actions.actions-spending-limit-brief %} For more information, see "[About spending limits](#about-spending-limits)."
|
||||
{% data reusables.actions.actions-spending-limit-brief %}詳細については、「[使用制限について](#about-spending-limits)」を参照してください。
|
||||
|
||||
{% ifversion ghec %}
|
||||
If you purchased {% data variables.product.prodname_enterprise %} through a Microsoft Enterprise Agreement, you can connect your Azure Subscription ID to your enterprise account to enable and pay for {% data variables.product.prodname_actions %} usage beyond the amounts including with your account. For more information, see "[Connecting an Azure subscription to your enterprise](/billing/managing-billing-for-your-github-account/connecting-an-azure-subscription-to-your-enterprise)."
|
||||
{% ifversion ghec %}Microsoft Enterprise Agreement を通じて {% data variables.product.prodname_enterprise %} を購入した場合は、ご自身の Azure サブスクリプション ID をエンタープライズ アカウントに接続して、ご自身のアカウントに含まれている金額を超える {% data variables.product.prodname_actions %} の使用を有効にして支払うことができます。 詳細については、「[Azure サブスクリプションを Enterprise に接続する](/billing/managing-billing-for-your-github-account/connecting-an-azure-subscription-to-your-enterprise)」を参照してください。
|
||||
{% endif %}
|
||||
|
||||
Minutes reset every month, while storage usage does not.
|
||||
時間 (分) は毎月リセットされますが、ストレージはリセットされません。
|
||||
|
||||
### Included storage and minutes
|
||||
### 含まれるストレージと分
|
||||
|
||||
{% ifversion actions-hosted-runners %}
|
||||
{% note %}
|
||||
{% ifversion actions-hosted-runners %} {% note %}
|
||||
|
||||
**Note**: Entitlement minutes cannot be used for Windows and Ubuntu runners over 2-cores. These runners will always be charged for, including in public repos. For more information, see "[Per-minute rates for runners](/billing/managing-billing-for-github-actions/about-billing-for-github-actions#per-minute-rates)."
|
||||
**注**: 2 コアを超える Windows ランナーおよび Ubuntu ランナーには、エンタイトルメント (分) を使用できません。 これらのランナーは、パブリック リポジトリを含め、常に課金されます。 詳しくは、[ランナーの 1 分あたりの料金](/billing/managing-billing-for-github-actions/about-billing-for-github-actions#per-minute-rates)に関するページを参照してください。
|
||||
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
{% endnote %} {% endif %}
|
||||
|
||||
|Product | Storage | Minutes (per month)|
|
||||
|製品 | Storage | 分 (月あたり)|
|
||||
|------- | ------- | ---------|
|
||||
| {% data variables.product.prodname_free_user %} | 500 MB | 2,000 |
|
||||
| {% data variables.product.prodname_pro %} | 1 GB | 3,000 |
|
||||
| {% data variables.product.prodname_free_team %} for organizations | 500 MB | 2,000 |
|
||||
| 組織の {% data variables.product.prodname_free_team %} | 500 MB | 2,000 |
|
||||
| {% data variables.product.prodname_team %} | 2 GB | 3,000 |
|
||||
| {% data variables.product.prodname_ghe_cloud %} | 50 GB | 50,000 |
|
||||
|
||||
Jobs that run on Windows and macOS runners that {% data variables.product.prodname_dotcom %} hosts consume minutes at 2 and 10 times the rate that jobs on Linux runners consume. For example, using 1,000 Windows minutes would consume 2,000 of the minutes included in your account. Using 1,000 macOS minutes, would consume 10,000 minutes included in your account.
|
||||
{% data variables.product.prodname_dotcom %}がホストするWindows及びmacOSのランナー上で実行されるジョブは、Linuxのランナー上のジョブの消費に対して2倍及び10倍の分を消費します。 たとえば、Windows で 1,000 分使用すると、アカウントに含まれている 2,000 分が消費されます。 macOS で 1,000 分使用すると、アカウントに含まれている 10,000 分が消費されます。
|
||||
|
||||
### Minute multipliers
|
||||
### 分の倍率
|
||||
|
||||
| Operating system | Minute multiplier |
|
||||
| オペレーティング システム | 分の倍率 |
|
||||
|------- | ---------|
|
||||
| Linux | 1 |
|
||||
| macOS| 10 |
|
||||
| Windows | 2 |
|
||||
|
||||
The storage used by a repository is the total storage used by {% data variables.product.prodname_actions %} artifacts and {% data variables.product.prodname_registry %}. Your storage cost is the total usage for all repositories owned by your account. For more information about pricing for {% data variables.product.prodname_registry %}, see "[About billing for {% data variables.product.prodname_registry %}](/billing/managing-billing-for-github-packages/about-billing-for-github-packages)."
|
||||
リポジトリが使用するストレージは、{% data variables.product.prodname_actions %}の成果物と{% data variables.product.prodname_registry %}の消費の合計のストレージです。 ストレージのコストは、お客様のアカウントで所有しているすべてのリポジトリの合計使用量です。 {% data variables.product.prodname_registry %} の価格について詳しくは、「[{% data variables.product.prodname_registry %} の課金について](/billing/managing-billing-for-github-packages/about-billing-for-github-packages)」を参照してください。
|
||||
|
||||
If your account's usage surpasses these limits and you have set a spending limit above $0 USD, you will pay $0.008 USD per GB of storage per day and per-minute usage depending on the operating system used by the {% data variables.product.prodname_dotcom %}-hosted runner. {% data variables.product.prodname_dotcom %} rounds the minutes and partial minutes each job uses up to the nearest whole minute.
|
||||
アカウントによる使用がこれらの制限を超え、使用制限を 0 米国ドルより上に設定している場合、日ごとにストレージの GB あたり 0.008 米国ドル、そして {% data variables.product.prodname_dotcom %} ホステッド ランナーで使用されるオペレーティング システムに応じた使用量を分単位で支払うことになります。 {% data variables.product.prodname_dotcom %} は、各ジョブが使った分と分未満をもっとも近い分に切り上げます。
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** Minute multipliers do not apply to the per-minute rates shown below.
|
||||
**注:** 分の乗数は、以下に示す分あたりの料金には適用されません。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
### Per-minute rates
|
||||
### 分あたりの料金
|
||||
|
||||
{% data reusables.billing.billing-standard-runners %}
|
||||
{%- ifversion actions-hosted-runners %}
|
||||
{% data reusables.billing.billing-hosted-runners %}
|
||||
{%- endif %}
|
||||
{% data reusables.billing.billing-standard-runners %} {%- ifversion actions-hosted-runners %} {% data reusables.billing.billing-hosted-runners %} {%- endif %}
|
||||
|
||||
- The number of jobs you can run concurrently across all repositories in your user or organization account depends on your GitHub plan. For more information, see "[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration)" for {% data variables.product.prodname_dotcom %}-hosted runners and "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)" for self-hosted runner usage limits.
|
||||
- {% data reusables.user-settings.context_switcher %}
|
||||
{% ifversion actions-hosted-runners %}
|
||||
- For {% data variables.actions.hosted_runner %}s, there is no additional cost for configurations that assign public static IP addresses to a {% data variables.actions.hosted_runner %}. For more information on {% data variables.actions.hosted_runner %}s, see "[Using {% data variables.actions.hosted_runner %}s](/actions/using-github-hosted-runners/using-larger-runners)."
|
||||
- Entitlement minutes cannot be used for {% data variables.actions.hosted_runner %}s.
|
||||
- The {% data variables.actions.hosted_runner %}s are not free for public repositories.
|
||||
- アカウントもしくはOrganization内のすべてのリポジトリにわたって同時に実行できるジョブ数は、あなたのGitHubのプランによります。 詳細について、{% data variables.product.prodname_dotcom %} ホステッド ランナーに関しては「[使用制限と課金](/actions/reference/usage-limits-billing-and-administration)」を、セルフホステッド ランナーの使用制限に関しては「[セルフホステッド ランナーについて](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)」を参照してください。
|
||||
- {% data reusables.user-settings.context_switcher %} {% ifversion actions-hosted-runners %}
|
||||
- {% data variables.actions.hosted_runner %} の場合、パブリック静的 IP アドレスを {% data variables.actions.hosted_runner %} に割り当てる構成に追加のコストは発生しません。 {% data variables.actions.hosted_runner %} について詳しくは、「[{% data variables.actions.hosted_runner %} の使用](/actions/using-github-hosted-runners/using-larger-runners)」を参照してください。
|
||||
- {% data variables.actions.hosted_runner %} にはエンタイトルメント (分) を使用できません。
|
||||
- {% data variables.actions.hosted_runner %} は、パブリック リポジトリについては無料ではありません。
|
||||
{% endif %}
|
||||
|
||||
## Calculating minute and storage spending
|
||||
## 利用時間 (分) とストレージ消費量の計算
|
||||
|
||||
{% data reusables.dotcom_billing.pricing_calculator.pricing_cal_actions %}
|
||||
|
||||
At the end of the month, {% data variables.product.prodname_dotcom %} calculates the cost of minutes and storage used over the amount included in your account.
|
||||
月末に、{% data variables.product.prodname_dotcom %}はアカウントに含まれている量に対して使用された分とストレージのコストを計算します。
|
||||
|
||||
### Sample minutes cost calculation
|
||||
### 分のコスト計算例
|
||||
|
||||
For example, if your organization uses {% data variables.product.prodname_team %} and allows unlimited spending, using 5,000 minutes could have a total storage and minute overage cost of $56 USD, depending on the operating systems used to run jobs.
|
||||
たとえば、Organizationが{% data variables.product.prodname_team %}を使用しており、使用量に制限をしていない場合、5,000分を使用すればジョブを実行しているオペレーティングシステムによって、合計でストレージと分は56米ドルの超過コストになるかもしれません。
|
||||
|
||||
- 5,000 (3,000 Linux and 2,000 Windows) minutes = $56 USD ($24 USD + $32 USD).
|
||||
- 3,000 Linux minutes at $0.008 USD per minute = $24 USD.
|
||||
- 2,000 Windows minutes at $0.016 USD per minute = $32 USD.
|
||||
- 5,000 (3,000 Linux と 2,000 Windows) 分 = 56米ドル (24米ドル + 32米ドル)。
|
||||
- 単価 0.008米ドル で 3,000 Linux 分 = 24米ドル。
|
||||
- 単価 0.016米ドル で 2,000 Windows 分 = 32米ドル。
|
||||
|
||||
{% data variables.product.prodname_dotcom %} calculates your storage usage for each month based on hourly usage during that month.
|
||||
{% data variables.product.prodname_dotcom %} 毎月の利用状況は、その月の時間あたりの利用状況に基づいて計算されます。
|
||||
|
||||
### Sample storage cost calculation
|
||||
### ストレージのコスト計算例
|
||||
|
||||
For example, if you use 3 GB of storage for 10 days of March and 12 GB for 21 days of March, your storage usage would be:
|
||||
たとえば、3 月の 10 日間に 3 GB のストレージを使用し、3 月の 21 日間に 12 GB 使用した場合、ストレージの使用量は次のようになります。
|
||||
|
||||
- 3 GB x 10 days x (24 hours per day) = 720 GB-Hours
|
||||
- 12 GB x 21 days x (24 hours per day) = 6,048 GB-Hours
|
||||
- 720 GB-Hours + 6,048 GB-Hours = 6,768 GB-Hours
|
||||
- 6,768 GB-Hours / (744 hours per month) = 9.0967 GB-Months
|
||||
- 3 GB x 10日 x (1日24 時間) = 720 GB時間
|
||||
- 12 GB x 21日 x (1日24 時間) = 6,048 GB時間
|
||||
- 720 GB時間 + 6,048 GB時間 = 6,768 GB時間
|
||||
- 6,768 GB時間 / (月あたり744時間) = 9.0967 GB月
|
||||
|
||||
At the end of the month, {% data variables.product.prodname_dotcom %} rounds your storage to the nearest MB. Therefore, your storage usage for March would be 9.097 GB.
|
||||
月末に、{% data variables.product.prodname_dotcom %}はストレージ使用量を最も近いGBに丸めます。 そのため、3 月のストレージ使用量は 9.097 GB になります。
|
||||
|
||||
Your {% data variables.product.prodname_actions %} usage shares your account's existing billing date, payment method, and receipt. {% data reusables.dotcom_billing.view-all-subscriptions %}
|
||||
{% data variables.product.prodname_actions %} の利用については、アカウントの既存の請求日、支払い方法、領収書が共有されます。 {% data reusables.dotcom_billing.view-all-subscriptions %}
|
||||
|
||||
## About spending limits
|
||||
## 利用上限について
|
||||
|
||||
{% data reusables.actions.actions-spending-limit-detailed %}
|
||||
|
||||
For information on managing and changing your account's spending limit, see "[Managing your spending limit for {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions/managing-your-spending-limit-for-github-actions)."
|
||||
アカウントの使用制限の管理と変更については、「[{% data variables.product.prodname_actions %} の使用制限の管理](/billing/managing-billing-for-github-actions/managing-your-spending-limit-for-github-actions)」を参照してください。
|
||||
|
||||
{% data reusables.dotcom_billing.actions-packages-unpaid-account %}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Managing privately reported security vulnerabilities
|
||||
intro: Repository maintainers can manage security vulnerabilities that have been privately reported to them by security reseachers for repositories where private vulnerability reporting is enabled.
|
||||
title: 非公開で報告されたセキュリティの脆弱性の管理
|
||||
intro: リポジトリの保守担当者は、プライベート脆弱性レポートが有効になっているリポジトリのセキュリティ リサーチャーによって非公開で報告されたセキュリティ脆弱性を管理できます。
|
||||
permissions: 'Anyone with admin permissions to a repository can see, review, and manage privately-reported vulnerabilities for the repository.'
|
||||
versions:
|
||||
fpt: '*'
|
||||
@@ -11,35 +11,38 @@ topics:
|
||||
- Security advisories
|
||||
- Vulnerabilities
|
||||
shortTitle: Manage vulnerability reports
|
||||
ms.openlocfilehash: 942533788dc6ad9280ddc023f583462c7a0ff7f8
|
||||
ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/09/2022
|
||||
ms.locfileid: '148160292'
|
||||
---
|
||||
|
||||
{% data reusables.security-advisory.private-vulnerability-reporting-beta %}
|
||||
|
||||
{% data reusables.security-advisory.private-vulnerability-reporting-enable %}
|
||||
|
||||
## About privately reporting a security vulnerability
|
||||
## セキュリティの脆弱性を非公開で報告する方法について
|
||||
|
||||
Private vulnerability reporting makes it easy for security researchers to report vulnerabilities directly to you using a simple form.
|
||||
プライベート脆弱性レポートを使用すると、セキュリティ リサーチャーは簡単なフォームを使用して脆弱性を直接報告できます。
|
||||
|
||||
When a security researcher reports a vulnerability privately, you are notified and can choose to either accept it, ask more questions, or reject it. If you accept the report, you're ready to collaborate on a fix for the vulnerability in private with the security researcher.
|
||||
セキュリティ リサーチャーによって脆弱性が非公開で報告されると、通知を受け取り、承諾するか、さらに質問するか、拒否するかを選択できます。 レポートを承諾した場合は、セキュリティ リサーチャーと非公開で脆弱性の修正を共同で行う準備が整います。
|
||||
|
||||
## Managing security vulnerabilities that are privately reported
|
||||
## 非公開で報告されるセキュリティの脆弱性の管理
|
||||
|
||||
{% data variables.product.prodname_dotcom %} notifies repository maintainers when security researchers privately report vulnerabilities in their repository, and sends notifications if maintainers watch the repository or if they have notifications enabled for the repository. For more information, see "[Configuring notifications](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications)."
|
||||
{% data variables.product.prodname_dotcom %} は、セキュリティ リサーチャーがリポジトリの脆弱性を非公開で報告したときにリポジトリの保守担当者に通知し、保守担当者がリポジトリを監視するか、リポジトリに対して通知を有効にした場合に通知を送信します。 詳細については、「[通知の設定](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications)」を参照してください。
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-security %}
|
||||
{% data reusables.repositories.sidebar-advisories %}
|
||||
1. Click the advisory you want to review. An advisory that is privately reported will have a status of `Needs triage`.
|
||||
{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} {% data reusables.repositories.sidebar-advisories %}
|
||||
1. 確認するアドバイザリをクリックします。 非公開で報告されるアドバイザリの状態は `Needs triage` になります。
|
||||
|
||||

|
||||

|
||||
|
||||
2. Carefully review the report. You can:
|
||||
- Collaborate with the security researcher on a patch in private, by clicking **Start a temporary private fork**. This gives you a place for further discussions with the contributor without changing the status of the proposed advisory from `Needs triage`.
|
||||
- Accept the vulnerability report as a draft advisory on {% data variables.product.prodname_dotcom %}, by clicking **Accept and open as draft**. If you choose this option:
|
||||
- This doesn't make the report public.
|
||||
- The report becomes a draft repository security advisory and you can work on it in the same way as any draft advisory that you create.
|
||||
For more information on security advisories, see "[About repository security advisories](/code-security/security-advisories/repository-security-advisories/about-repository-security-advisories)."
|
||||
- Reject the report by clicking **Close security advisory**. Where possible, you should add a comment explaining why you don't consider the report a security risk before you close the advisory.
|
||||
2. レポートを慎重に確認します。 次のようにすることができます。
|
||||
- **[一時的なプライベート フォークを開始する]** をクリックして、パッチについてセキュリティ リサーチャーと非公開で共同作業します。 これにより、提案されたアドバイザリの状態を `Needs triage` から変更することなく、共同作成者とさらに話し合う場所が提供されます。
|
||||
- **[承諾してドラフトとして開く]** をクリックして、{% data variables.product.prodname_dotcom %} のドラフト アドバイザリとして脆弱性レポートを承諾します。 このオプションを選択した場合、次のようになります。
|
||||
- これにより、レポートが公開されることはありません。
|
||||
- レポートはドラフトのリポジトリ セキュリティ アドバイザリになり、作成するドラフト アドバイザリと同じ方法で作業できます。
|
||||
セキュリティ アドバイザリの詳細については、「[リポジトリ セキュリティ アドバイザリについて](/code-security/security-advisories/repository-security-advisories/about-repository-security-advisories)」を参照してください。
|
||||
- **[セキュリティ アドバイザリを閉じる]** をクリックして、レポートを拒否します。 可能であれば、アドバイザリを閉じる前に、レポートをセキュリティ リスクと見なさない理由を説明するコメントを追加する必要があります。
|
||||
|
||||

|
||||

|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Privately reporting a security vulnerability
|
||||
intro: Some public repositories configure security advisories so that anyone can report security vulnerabilities directly and privately to the maintainers.
|
||||
title: セキュリティの脆弱性を非公開で報告する
|
||||
intro: 一部のパブリック リポジトリでは、セキュリティ アドバイザリを構成して、誰もがセキュリティの脆弱性を直接、または非公開で保守担当者に報告できるようにします。
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
@@ -10,61 +10,64 @@ topics:
|
||||
- Security advisories
|
||||
- Vulnerabilities
|
||||
shortTitle: Privately reporting
|
||||
ms.openlocfilehash: 7f4f208bd2724608cf9955efd82a256c3479e884
|
||||
ms.sourcegitcommit: 2ff4a43f0b14939da79d56c54402cfee8d90ae23
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/17/2022
|
||||
ms.locfileid: '148169558'
|
||||
---
|
||||
|
||||
{% data reusables.security-advisory.private-vulnerability-reporting-beta %}
|
||||
|
||||
{% data reusables.security-advisory.private-vulnerability-reporting-enable %}
|
||||
|
||||
## About privately reporting a security vulnerability
|
||||
## セキュリティの脆弱性を非公開で報告する方法について
|
||||
|
||||
Security researchers often feel responsible for alerting users to a vulnerability that could be exploited. If there are no clear instuctions about contacting maintainers of the repository containing the vulnerability, security researchers may have no other choice but to post about the vulnerability on social media, send direct messages to the maintainer, or even create public issues. This situation can potentially lead to a public disclosure of the vulnerability details.
|
||||
セキュリティ リサーチャーは、多くの場合、脆弱性についてユーザーに通知しなくてはならないと感じますが、脆弱性は悪用されることがあります。 脆弱性を含むリポジトリのメンテナンス担当者への連絡について明確な指示がない場合には、セキュリティ リサーチャーが、その脆弱性についてソーシャル メディアに投稿したり、メンテナンス担当者にダイレクト メッセージを送信したり、issue を作成して公開したりすることになります。 このような状況では、脆弱性の詳細が広く知れわたってしまう可能性があります。
|
||||
|
||||
Private vulnerability reporting makes it easy for security researchers to report vulnerabilities directly to repository maintainer using a simple form.
|
||||
プライベート脆弱性レポートを使用すると、セキュリティ リサーチャーは簡単なフォームを使用してリポジトリの保守担当者に脆弱性を直接報告できます。
|
||||
|
||||
For security researchers, the benefits of using private vulnerability reporting are:
|
||||
- Less frustration, and less time spent trying to figure out how to contact the maintainer.
|
||||
- A smoother process for disclosing and discussing vulnerability details.
|
||||
- The opportunity to discuss vulnerability details privately with repository maintainer.
|
||||
セキュリティ リサーチャーの場合、プライベート脆弱性レポートを使うと次のような利点があります。
|
||||
- フラストレーションが少なく、保守担当者に連絡する方法を把握するのに費やす時間も少なくなります。
|
||||
- 脆弱性の詳細を開示して話し合うためのよりスムーズなプロセス。
|
||||
- リポジトリの保守担当者と非公開で脆弱性の詳細について話し合う機会。
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** If the repository doesn't have private vulnerabiliy reporting enabled, you need to initiate the reporting process by following the instructions in the security policy for the repository, or create an issue asking the maintainers for a preferred security contact. For more information, see "[About coordinated disclosure of security vulnerabilities](/code-security/security-advisories/guidance-on-reporting-and-writing/about-coordinated-disclosure-of-security-vulnerabilities#about-reporting-and-disclosing-vulnerabilities-in-projects-on-github)."
|
||||
**注:** リポジトリでプライベート脆弱性レポートが有効になっていない場合は、リポジトリのセキュリティ ポリシーの手順に従ってレポート プロセスを開始するか、推奨されるセキュリティ連絡先を保守担当者に要求する issue を作成する必要があります。 詳細については、「[セキュリティ脆弱性の調整された開示について](/code-security/security-advisories/guidance-on-reporting-and-writing/about-coordinated-disclosure-of-security-vulnerabilities#about-reporting-and-disclosing-vulnerabilities-in-projects-on-github)」を参照してください。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
## Privately reporting a security vulnerability
|
||||
## セキュリティの脆弱性を非公開で報告する
|
||||
|
||||
Security researchers can privately report a security vulnerability to repository maintainers.
|
||||
セキュリティ リサーチャーは、リポジトリの保守担当者に脆弱性を非公開で報告できます。
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-security %}
|
||||
{% data reusables.repositories.sidebar-advisories %}
|
||||
1. Click **Report a vulnerability** to open the advisory form.
|
||||
{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} {% data reusables.repositories.sidebar-advisories %}
|
||||
1. **[脆弱性の報告]** をクリックして、アドバイザリ フォームを開きます。
|
||||
|
||||

|
||||
![[脆弱性の報告] ボタンを示すスクリーンショット](/assets/images/help/security/report-a-vulnerability-button.png)
|
||||
|
||||
2. Fill in the advisory details form.
|
||||
2. アドバイザリの詳細フォームに入力します。
|
||||
{% tip %}
|
||||
|
||||
**Tip:** In this form, only the title and description are mandatory. (In the general draft security advisory form, which the repository maintainer initiates, specifying the ecosystem is also required.) However, we recommend security researchers provide as much information as possible on the form so that the maintainers can make an informed decision about the submitted report. You can adopt the template used by our security researchers from the {% data variables.product.prodname_security %}, which is available on the [`github/securitylab` repository](https://github.com/github/securitylab/blob/main/docs/report-template.md)."
|
||||
**ヒント:** このフォームでは、タイトルと説明のみが必須です。 (リポジトリの保守担当者が開始する一般的なドラフト セキュリティ アドバイザリ フォームでは、エコシステムを指定する必要もあります)。ただし、セキュリティ リサーチャーは、送信されたレポートに関して保守担当者が情報に基づいた意思決定を行えるように、フォームにできるだけ多くの情報を提供することをお勧めします。 GitHub のセキュリティ研究者が使ったテンプレートを、[`github/securitylab` リポジトリ](https://github.com/github/securitylab/blob/main/docs/report-template.md)で利用できる {% data variables.product.prodname_security %} から採用できます。
|
||||
|
||||
{% endtip %}
|
||||
|
||||
For more information about the fields available and guidance on filling in the form, see "[Creating a repository security advisory](/code-security/security-advisories/repository-security-advisories/creating-a-repository-security-advisory)" and "[Best practices for writing repository security advisories](/code-security/security-advisories/guidance-on-reporting-and-writing/best-practices-for-writing-repository-security-advisories)."
|
||||
使用可能なフィールドとフォームへの入力に関するガイダンスの詳細については、「[リポジトリ セキュリティ アドバイザリの作成](/code-security/security-advisories/repository-security-advisories/creating-a-repository-security-advisory)」および「[リポジトリ セキュリティ アドバイザリを作成するためのベスト プラクティス](/code-security/security-advisories/guidance-on-reporting-and-writing/best-practices-for-writing-repository-security-advisories)」を参照してください。
|
||||
|
||||
1. At the bottom of the form, click **Submit report**. {% data variables.product.prodname_dotcom %} will display a message letting you know that maintainers have been notified and that you have a pending credit for this security advisory.
|
||||
1. フォームの下部にある **[レポートの送信]** をクリックします。 {% data variables.product.prodname_dotcom %} には、保守担当者に通知されたことと、このセキュリティ アドバイザリの保留中のクレジットがあることを知らせるメッセージが表示されます。
|
||||
|
||||

|
||||
![[レポートの送信] ボタンを示すスクリーンショット](/assets/images/help/security/advisory-submit-report-button.png)
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Tip:** When the report is submitted, {% data variables.product.prodname_dotcom %} automatically adds the reporter of the vulnerability as a collaborator and as a credited user on the proposed advisory.
|
||||
**ヒント:** レポートが送信されると、{% data variables.product.prodname_dotcom %} によって、コラボレーターとして、また提案されたアドバイザリのクレジット ユーザーとして脆弱性の報告者が自動的に追加されます。
|
||||
|
||||
{% endtip %}
|
||||
|
||||
1. Optionally, click **Start a temporary private fork** if you want to start to fix the issue. Note that only the repository maintainer can merge that private fork.
|
||||
1. 必要に応じて、issue の解決を開始する場合は、 **[一時的なプライベート フォークを開始する]** をクリックします。 リポジトリの保守担当者のみがそのプライベート フォークをマージできることに注意してください。
|
||||
|
||||

|
||||

|
||||
|
||||
The next steps depend on the action taken by the repository maintainer. For more information, see "[Managing privately reported security vulnerabilities](/code-security/security-advisories/guidance-on-reporting-and-writing/managing-privately-reported-security-vulnerabilities)."
|
||||
次の手順は、リポジトリの保守担当者によって実行されるアクションによって異なります。 詳細については、「[非公開で報告されたセキュリティ脆弱性の管理](/code-security/security-advisories/guidance-on-reporting-and-writing/managing-privately-reported-security-vulnerabilities)」を参照してください。
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Creating a repository security advisory
|
||||
intro: You can create a draft security advisory to privately discuss and fix a security vulnerability in your open source project.
|
||||
title: リポジトリ セキュリティ アドバイザリの作成
|
||||
intro: セキュリティアドバイザリのドラフトを作成して、オープンソースプロジェクトのセキュリティ脆弱性について非公開で議論して修正することができます。
|
||||
redirect_from:
|
||||
- /articles/creating-a-maintainer-security-advisory
|
||||
- /github/managing-security-vulnerabilities/creating-a-maintainer-security-advisory
|
||||
@@ -15,31 +15,31 @@ topics:
|
||||
- Security advisories
|
||||
- Vulnerabilities
|
||||
shortTitle: Create repository advisories
|
||||
ms.openlocfilehash: 5c78a8b0c0a2d5085a876de2b0788ef093c4c6b1
|
||||
ms.sourcegitcommit: 74c60a4564bcc17e47b5a67941ac6d9fe13b6a5c
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/30/2022
|
||||
ms.locfileid: '148186156'
|
||||
---
|
||||
|
||||
Anyone with admin permissions to a repository can create a security advisory.
|
||||
リポジトリに対する管理者権限があるユーザなら誰でも、セキュリティアドバイザリを作成できます。
|
||||
|
||||
{% data reusables.security-advisory.security-researcher-cannot-create-advisory %}
|
||||
|
||||
## Creating a security advisory
|
||||
## セキュリティ アドバイザリの作成
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-security %}
|
||||
{% data reusables.repositories.sidebar-advisories %}
|
||||
1. Click **New draft security advisory** to open the draft advisory form. The fields marked with an asterisk are required.
|
||||

|
||||
1. Type a title for your security advisory.
|
||||
{% data reusables.repositories.security-advisory-edit-details %}
|
||||
{% data reusables.repositories.security-advisory-edit-severity %}
|
||||
{% data reusables.repositories.security-advisory-edit-cwe-cve %}
|
||||
{% data reusables.repositories.security-advisory-edit-description %}
|
||||
1. Click **Create draft security advisory**.
|
||||

|
||||
{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} {% data reusables.repositories.sidebar-advisories %}
|
||||
1. **[新しいドラフト セキュリティ アドバイザリ]** をクリックし、ドラフト アドバイザリ フォームを開きます。 アスタリスクが付いているフィールドは必須です。
|
||||
![[アドバイザリのドラフトを開く] ボタン](/assets/images/help/security/security-advisory-new-draft-security-advisory-button.png)
|
||||
1. セキュリティアドバイザリのタイトルを入力します。
|
||||
{% data reusables.repositories.security-advisory-edit-details %} {% data reusables.repositories.security-advisory-edit-severity %} {% data reusables.repositories.security-advisory-edit-cwe-cve %} {% data reusables.repositories.security-advisory-edit-description %}
|
||||
1. **[セキュリティ アドバイザリのドラフトの作成]** をクリックします。
|
||||
![[セキュリティ アドバイザリの作成] ボタン](/assets/images/help/security/security-advisory-create-security-advisory-button.png)
|
||||
|
||||
## Next steps
|
||||
## 次の手順
|
||||
|
||||
- Comment on the draft security advisory to discuss the vulnerability with your team.
|
||||
- Add collaborators to the security advisory. For more information, see "[Adding a collaborator to a repository security advisory](/code-security/repository-security-advisories/adding-a-collaborator-to-a-repository-security-advisory)."
|
||||
- Privately collaborate to fix the vulnerability in a temporary private fork. For more information, see "[Collaborating in a temporary private fork to resolve a repository security vulnerability](/code-security/repository-security-advisories/collaborating-in-a-temporary-private-fork-to-resolve-a-repository-security-vulnerability)."
|
||||
- Add individuals who should receive credit for contributing to the security advisory. For more information, see "[Editing a repository security advisory](/code-security/repository-security-advisories/editing-a-repository-security-advisory#about-credits-for-security-advisories)."
|
||||
- Publish the security advisory to notify your community of the security vulnerability. For more information, see "[Publishing a repository security advisory](/code-security/repository-security-advisories/publishing-a-repository-security-advisory)."
|
||||
- セキュリティアドバイザリのドラフトにコメントして、チームと脆弱性について話し合います。
|
||||
- セキュリティアドバイザリにコラボレータを追加します。 詳細については、「[リポジトリ セキュリティ アドバイザリへのコラボレータの追加](/code-security/repository-security-advisories/adding-a-collaborator-to-a-repository-security-advisory)」を参照してください。
|
||||
- 一時的なプライベートフォークで、脆弱性を修正するため非公式でコラボレートします。 詳細については、「[一時的なプライベート フォークで、リポジトリのセキュリティ脆弱性を解決するためにコラボレートする](/code-security/repository-security-advisories/collaborating-in-a-temporary-private-fork-to-resolve-a-repository-security-vulnerability)」を参照してください。
|
||||
- セキュリティアドバイザリへの貢献に対してクレジットを受け取る必要がある個人を追加します。 詳細については、「[リポジトリ セキュリティ アドバイザリの編集](/code-security/repository-security-advisories/editing-a-repository-security-advisory#about-credits-for-security-advisories)」を参照してください。
|
||||
- コミュニティにセキュリティの脆弱性を知らせるため、セキュリティアドバイザリを公開します。 詳細については、「[リポジトリ セキュリティ アドバイザリの公開](/code-security/repository-security-advisories/publishing-a-repository-security-advisory)」を参照してください。
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Creating a codespace for a repository
|
||||
intro: You can create a codespace for a branch in a repository to develop online.
|
||||
title: リポジトリの codespace を作成する
|
||||
intro: リポジトリのブランチの codespace を作成して、オンラインで開発できます。
|
||||
redirect_from:
|
||||
- /github/developing-online-with-github-codespaces/creating-a-codespace
|
||||
- /github/developing-online-with-codespaces/creating-a-codespace
|
||||
@@ -14,95 +14,100 @@ topics:
|
||||
- Fundamentals
|
||||
- Developer
|
||||
shortTitle: Create a codespace for a repo
|
||||
ms.openlocfilehash: 409c946feda4ffbd3d9ab615b6ea07fabee3f530
|
||||
ms.sourcegitcommit: 1f3bd126ca000982c538f1621d47722737740943
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/01/2022
|
||||
ms.locfileid: '148188321'
|
||||
---
|
||||
## リポジトリの codespace の作成について
|
||||
|
||||
## About creating a codespace for a repository
|
||||
{% data reusables.codespaces.ways-to-create-a-codespace %} この記事のタブを使用して、codespace を作成するこれらの各方法の手順を表示します。
|
||||
|
||||
{% data reusables.codespaces.ways-to-create-a-codespace %} Use the tabs in this article to display instructions for each of these ways of creating a codespace.
|
||||
|
||||
{% data reusables.codespaces.starting-new-project-template %} For more information, see "[Creating a codespace from a template](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)."
|
||||
{% data reusables.codespaces.starting-new-project-template %} 詳細については、「[テンプレートから codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)」を参照してください。
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note**: If you use a JetBrains IDE, you can use {% data variables.product.prodname_cli %} to create a codespace. You can then use the JetBrains Gateway application to open the codespace in a JetBrains IDE. For more information, see "[Using Codespaces in your JetBrains IDE](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide)."
|
||||
**注**: JetBrains IDE を使用する場合は、{% data variables.product.prodname_cli %} を使用して codespace を作成できます。 その後、JetBrains Gateway アプリケーションを使用して、JetBrains IDE で codespace を開くことができます。 詳細については、「[JetBrains IDE での Codespaces の使用](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide)」を参照してください。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
You can use {% data variables.product.prodname_github_codespaces %} on your personal {% data variables.product.prodname_dotcom_the_website %} account, with the quota of free use included each month for accounts on the Free and Pro plans. {% data reusables.codespaces.codespaces-continue-by-paying %}
|
||||
個人の {% data variables.product.prodname_dotcom_the_website %} アカウントで {% data variables.product.prodname_github_codespaces %} を使用できます。Free プランと Pro プランのアカウントには毎月無料使用のクォータが含まれています。 {% data reusables.codespaces.codespaces-continue-by-paying %}
|
||||
|
||||
Organizations can enable members and outside collaborators to create and use codespaces at the organization's expense. For more information, see "[Enabling {% data variables.product.prodname_github_codespaces %} for your organization](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization)."
|
||||
組織は、メンバーと外部コラボレーターが組織の費用で codespace を作成して使用できるようにすることができます。 詳しくは、「[Organization での {% data variables.product.prodname_github_codespaces %} の有効化](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization)」をご覧ください。
|
||||
|
||||
{% data reusables.codespaces.codespaces-are-personal %}
|
||||
|
||||
If you create a codespace from a repository, the codespace will be associated with a specific branch, which cannot be empty. You can create more than one codespace per repository or even per branch.
|
||||
リポジトリから codespace を作成すると、codespace は特定のブランチに関連付けられます。空にすることはできません。 リポジトリごと、さらにはブランチごとに1つ以上のcodespaceを作成できます。
|
||||
|
||||
{% data reusables.codespaces.you-can-see-all-your-codespaces %}
|
||||
|
||||
### The codespace creation process
|
||||
### codespace の作成プロセス
|
||||
|
||||
When you create a codespace, a number of steps happen to create and connect you to your development environment:
|
||||
codespace を作成すると、開発環境を作成して開発環境に接続するためのいくつかの手順が発生します。
|
||||
|
||||
- Step 1: VM and storage are assigned to your codespace.
|
||||
- Step 2: Container is created and your repository is cloned.
|
||||
- Step 3: You can connect to the codespace.
|
||||
- Step 4: Codespace continues with post-creation setup.
|
||||
- 手順 1: VM とストレージが codespace に割り当てられます。
|
||||
- 手順 2: コンテナーが作成され、リポジトリが複製されます。
|
||||
- 手順 3: codespace に接続できます。
|
||||
- 手順 4: codespace では、作成後のセットアップが続行されます。
|
||||
|
||||
For more information on what happens when you create a codespace, see "[Deep Dive](/codespaces/getting-started/deep-dive)."
|
||||
codespace を作成した場合に起きることの詳細については、[詳細情報](/codespaces/getting-started/deep-dive)に関するページを参照してください。
|
||||
|
||||
For more information on the lifecycle of a codespace, see "[The codespace lifecycle](/codespaces/getting-started/the-codespace-lifecycle)."
|
||||
codespace のライフサイクルの詳細については、「[Codespace のライフサイクル](/codespaces/getting-started/the-codespace-lifecycle)」を参照してください。
|
||||
|
||||
If you want to use Git hooks for your codespace, then you should set up hooks using the [`devcontainer.json` lifecycle scripts](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_lifecycle-scripts), such as `postCreateCommand`, during step 4. Since your codespace container is created after the repository is cloned, any [git template directory](https://git-scm.com/docs/git-init#_template_directory) configured in the container image will not apply to your codespace. Hooks must instead be installed after the codespace is created. For more information on using `postCreateCommand`, see the [`devcontainer.json` reference](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_devcontainerjson-properties) in the {% data variables.product.prodname_vscode_shortname %} documentation.
|
||||
codespace に Git フックを使用する場合は、手順 4. で [`devcontainer.json`ライフサイクル スクリプト](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_lifecycle-scripts) (例: `postCreateCommand`) を使用してフックを設定する必要があります。 リポジトリの複製後に codespace コンテナーが作成されるため、コンテナー イメージで構成された [Git テンプレート ディレクトリ](https://git-scm.com/docs/git-init#_template_directory) は codespace には適用されません。 代わりに、codespace の作成後にフックをインストールする必要があります。 `postCreateCommand` の使用について詳しくは、{% data variables.product.prodname_vscode_shortname %} ドキュメントの「[`devcontainer.json` リファレンス](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_devcontainerjson-properties)」を参照してください。
|
||||
|
||||
{% data reusables.codespaces.use-visual-studio-features %}
|
||||
|
||||
{% data reusables.codespaces.prebuilds-crossreference %}
|
||||
|
||||
## Creating a codespace for a repository
|
||||
## リポジトリの codespace を作成する
|
||||
|
||||
{% webui %}
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
1. Under the repository name, use the "Branch" dropdown menu, and select the branch you want to create a codespace for.
|
||||
1. リポジトリ名の下で、[ブランチ] ドロップダウンメニューを使用して、codespace を作成するブランチを選びます。
|
||||
|
||||

|
||||
![[ブランチ] ドロップダウンメニュー](/assets/images/help/codespaces/branch-drop-down.png)
|
||||
|
||||
1. Click the **{% octicon "code" aria-label="The code icon" %} Code** button, then click the **Codespaces** tab.
|
||||
1. **[{% octicon "code" aria-label="The code icon" %} コード]** ボタンをクリックし、 **[Codespaces]** タブをクリックします。
|
||||
|
||||

|
||||
![[New codespace] ボタン](/assets/images/help/codespaces/new-codespace-button.png)
|
||||
|
||||
If codespaces for this repository are billable to an organization, or its parent enterprise, a message is displayed below the **Create codespace on BRANCH** button telling you who will pay for the codespace.
|
||||
このリポジトリの codespace が組織、またはその親エンタープライズに対して課金可能な場合は、 **[<ブランチ名> で codespace を作成する]** ボタンの下に、codespace の料金を支払うユーザーを示すメッセージが表示されます。
|
||||
|
||||
1. Create your codespace, either using the default options, or after configuring advanced options:
|
||||
1. 既定のオプションを使用するか、詳細オプションを構成した後に、codespace を作成します。
|
||||
|
||||
* **Use the default options**
|
||||
* **既定のオプションを使用する**
|
||||
|
||||
To create a codespace using the default options, click the plus sign ({% octicon "plus" aria-label="The plus icon" %}). Alternatively, if you don't currently have any codespaces for this repository, you can click **Create codespace on BRANCH**.
|
||||
既定のオプションを使用して codespace を作成するには、プラス記号 ({% octicon "plus" aria-label="The plus icon" %}) をクリックします。 または、現在このリポジトリの codespace がない場合は、 **[ブランチで codespace を作成する]** をクリックできます。
|
||||
|
||||
* **Configure options**
|
||||
* **構成オプション**
|
||||
|
||||
To configure advanced options for your codespace, such as a different machine type or a particular `devcontainer.json` file:
|
||||
別のマシンの種類や特定の `devcontainer.json` ファイルなど、codespace の詳細オプションを構成するには:
|
||||
|
||||
1. Click the ellipsis (**...**) at the top right of the **Codespaces** tab and select **New with options**.
|
||||
1. **[Codespaces]** タブの右上にある省略記号 ( **...** ) をクリックし、 **[オプションを含む新規]** を選びます。
|
||||
|
||||

|
||||

|
||||
|
||||
1. On the options page for your codespace, choose your preferred options from the dropdown menus.
|
||||
1. codespace のオプション ページで、ドロップダウン メニューから任意のオプションを選びます。
|
||||
|
||||

|
||||

|
||||
|
||||
{% note %}
|
||||
|
||||
**Notes**
|
||||
**メモ**
|
||||
|
||||
* You can bookmark the options page to give you a quick way to create a codespace for this repository and branch.
|
||||
* The [https://github.com/codespaces/new](https://github.com/codespaces/new) page provides a quick way to create a codespace for any repository and branch. You can get to this page quickly by typing `codespace.new` into your browser's address bar.
|
||||
* For more information about the `devcontainer.json` file, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#devcontainerjson)."
|
||||
* For more information about machine types, see "[Changing the machine type for your codespace](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace#about-machine-types)."
|
||||
* オプション ページをブックマークすると、このリポジトリとブランチの codespace をすばやく作成できるようになります。
|
||||
* [https://github.com/codespaces/new](https://github.com/codespaces/new) ページでは、リポジトリとブランチの codespace をすばやく作成できます。 ブラウザーのアドレス バーに「`codespace.new`」と入力すると、このページにすばやくアクセスできます。
|
||||
* `devcontainer.json` ファイルの詳細については、「[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#devcontainerjson)」をご覧ください。
|
||||
* マシンの種類について詳しくは、「[codespace のマシンの種類を変更する](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace#about-machine-types)」をご覧ください。
|
||||
* {% data reusables.codespaces.codespaces-machine-type-availability %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
1. Click **Create codespace**.
|
||||
1. **[Create codespace]\(codespace の作成\)** をクリックします。
|
||||
|
||||
{% endwebui %}
|
||||
|
||||
@@ -116,30 +121,30 @@ If you want to use Git hooks for your codespace, then you should set up hooks us
|
||||
|
||||
{% data reusables.cli.cli-learn-more %}
|
||||
|
||||
To create a new codespace, use the `gh codespace create` subcommand.
|
||||
新しい codespace を作成するには、`gh codespace create` サブコマンドを使用します。
|
||||
|
||||
```shell
|
||||
gh codespace create
|
||||
```
|
||||
|
||||
You are prompted to choose a repository. If codespaces for this repository are billable to an organization, or its parent enterprise, a message is displayed telling you who will pay for the codespace. You are then prompted to choose a branch, a dev container configuration file (if more than one is available), and a machine type (if more than one is available).
|
||||
リポジトリの選択を求められます。 このリポジトリの codespace が組織、またはその親エンタープライズに対して課金可能な場合は、codespace の料金を支払うユーザーを示すメッセージが表示されます。 その場合、ブランチ、開発コンテナー構成ファイル (複数ある場合)、コンピューターの種類 (複数ある場合) を選ぶように求められます。
|
||||
|
||||
Alternatively, you can use flags to specify some or all of the options:
|
||||
または、フラグを使用して、次に示すオプションの一部またはすべてを特定することもできます。
|
||||
|
||||
```shell
|
||||
gh codespace create -r OWNER/REPO -b BRANCH --devcontainer-path PATH -m MACHINE-TYPE
|
||||
```
|
||||
|
||||
In this example, replace `owner/repo` with the repository identifier. Replace `branch` with the name of the branch, or the full SHA hash of the commit, that you want to be initially checked out in the codespace. If you use the `-r` flag without the `b` flag, the codespace is created from the default branch.
|
||||
この例の `owner/repo` をリポジトリ識別子に置き換えます。 `branch` を codespace で最初にチェックアウトするブランチの名前、またはコミットの完全な SHA ハッシュに置き換えます。 `b` フラグなしで `-r` フラグを使用する場合、codespace は既定のブランチから作成されます。
|
||||
|
||||
Replace `path` with the path to the dev container configuration file you want to use for the new codespace. If you omit this flag and more than one dev container file is available you will be prompted to choose one from a list. For more information about the dev container configuration file, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)."
|
||||
新しいコードスペースで使用する開発コンテナー構成ファイルへのパスに `path` を置き換えます。 このフラグを省略し、複数の開発コンテナー ファイルを使用できる場合は、リストから 1 つを選ぶダイアログが表示されます。 開発コンテナーの構成ファイルについて詳しくは、「[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)」を参照してください。
|
||||
|
||||
Replace `machine-type` with a valid identifier for an available machine type. Identifiers are strings such as: `basicLinux32gb` and `standardLinux32gb`. The type of machines that are available depends on the repository, your personal account, and your location. If you enter an invalid or unavailable machine type, the available types are shown in the error message. If you omit this flag and more than one machine type is available you will be prompted to choose one from a list.
|
||||
`machine-type` を使用可能なマシンの種類の有効な識別子に置き換えます。 識別子は、`basicLinux32gb` や `standardLinux32gb` のような文字列です。 使用可能なマシンの種類は、リポジトリ、個人用アカウント、場所によって異なります。 無効または使用できないマシンの種類を入力すると、使用可能な種類がエラー メッセージに表示されます。 このフラグを省略し、複数のマシンの種類を使用できる場合は、リストから 1 つを選択するダイアログが表示されます。
|
||||
|
||||
For full details of the options for this command, see [the {% data variables.product.prodname_cli %} manual](https://cli.github.com/manual/gh_codespace_create).
|
||||
このコマンドのオプションについて詳しくは、[{% data variables.product.prodname_cli %} マニュアル](https://cli.github.com/manual/gh_codespace_create)を参照してください。
|
||||
|
||||
{% endcli %}
|
||||
|
||||
## Further reading
|
||||
- "[Opening an existing codespace](/codespaces/developing-in-codespaces/opening-an-existing-codespace)"
|
||||
- "[Adding an 'Open in {% data variables.product.prodname_github_codespaces %}' badge](/codespaces/setting-up-your-project-for-codespaces/adding-a-codespaces-badge)"
|
||||
## 参考資料
|
||||
- [既存の codespace を開く](/codespaces/developing-in-codespaces/opening-an-existing-codespace)
|
||||
- 「[[{% data variables.product.prodname_github_codespaces %} で開く] バッジの追加](/codespaces/setting-up-your-project-for-codespaces/adding-a-codespaces-badge)」
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Creating a codespace from a template
|
||||
intro: If you're starting a new project, you can create a codespace from a blank template or choose a template specially designed for the type of work you want to do.
|
||||
title: テンプレートから codespace を作成する
|
||||
intro: 新しいプロジェクトを開始する場合、空のテンプレートから codespace を作成するか、実行する作業の種類用に特別に設計されたテンプレートを選ぶことができます。
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
@@ -11,92 +11,95 @@ topics:
|
||||
- Developer
|
||||
shortTitle: Create a codespace from a template
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: 9e7ee0d110e962fa755f5f57cc70bc3cab341808
|
||||
ms.sourcegitcommit: 1f3bd126ca000982c538f1621d47722737740943
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/01/2022
|
||||
ms.locfileid: '148188313'
|
||||
---
|
||||
## {% data variables.product.prodname_github_codespaces %} のテンプレートについて
|
||||
|
||||
## About templates for {% data variables.product.prodname_github_codespaces %}
|
||||
|
||||
If you're starting a new project, you can get started with development work quickly by creating a codespace from a template. You'll be able to work on your project in a cloud-based development environment, save your files in the cloud, and publish your work to a new remote repository that you can share with others or clone to your local machine.
|
||||
新しいプロジェクトを開始する場合、テンプレートから codespace を作成すると、開発作業をすばやく開始できます。 クラウドベースの開発環境でプロジェクトに取り組み、ファイルをクラウドに保存し、新しいリモート リポジトリに作業内容を公開することで、他のユーザーと共有したり、ローカル コンピューターに複製したりできます。
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note**: Codespaces created from a template, rather than from a repository, are always billed to your personal account. For more information, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)."
|
||||
**注**: codespace をリポジトリではなくテンプレートから作成すると、常に個人アカウントに課金されます。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} の支払いについて](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)」をご覧ください。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
You can start from a blank template, choose from templates maintained by {% data variables.product.company_short %} for popular technologies such as React or Jupyter Notebook, or launch a codespace from any template repository on {% data variables.product.prodname_dotcom %}. With a blank template, you'll start with an empty directory, with access to cloud-based compute resources and the tools, languages, and runtime environments that come preinstalled with the default codespace image. With other templates, you'll get starter files for the technology you're working with, plus typically some extra files such as a README file, a `.gitignore` file, and dev container configuration files containing some custom environment configuration. For more information on dev containers and the default image, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)."
|
||||
空のテンプレートから開始する、{% data variables.product.company_short %} が管理するテンプレートから React や Jupyter Notebook などの一般的なテクノロジを選ぶ、または {% data variables.product.prodname_dotcom %} 上の任意のテンプレート リポジトリから codespace を起動できます。 空のテンプレートを使う場合は、まず空のディレクトリから始めます。クラウドベースのコンピューティング リソースと、既定の codespace イメージにプレインストールされているツール、言語、ランタイム環境にアクセスできます。 他のテンプレートを使う場合は、扱うテクノロジのスターター ファイルに加え、通常は、README ファイル、`.gitignore` ファイル、カスタム環境構成を含む開発コンテナー構成ファイルなどの追加ファイルをいくつか取得します。 開発コンテナーと既定のイメージについて詳しくは、「[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)」を参照してください。
|
||||
|
||||
As an example, if you create a codespace from {% data variables.product.company_short %}'s React template, you'll arrive in a workspace containing template files for a simple application, such as `index.js`, `app.js`, and `package.json`. Shortly after the codespace opens, a development server will start up automatically, and you will be able to view the running application in a simple browser tab within the {% data variables.product.prodname_vscode_shortname %} web client.
|
||||
たとえば、{% data variables.product.company_short %} の React テンプレートから codespace を作成すると、`index.js`、`app.js`、`package.json` など、シンプルなアプリケーション向けのテンプレート ファイルが用意されているワークスペースが表示されます。 codespace が開いた直後に、開発サーバーが自動的に起動し、{% data variables.product.prodname_vscode_shortname %} Web クライアント内のシンプルなブラウザー タブで、実行中のアプリケーションを表示できるようになります。
|
||||
|
||||

|
||||

|
||||
|
||||
The files and configuration included in templates are defined in template repositories. The template repository is cloned into your codespace when you create the codespace. After that, the link is severed, and your codespace won't be linked to a remote repository until you publish to one.
|
||||
テンプレートに含まれるファイルと構成は、テンプレート リポジトリで定義されています。 codespace を作成すると、テンプレート リポジトリは codespace に複製されます。 その後、リンクは切断され、公開するまで codespace はリモート リポジトリにリンクされないようになります。
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Tip:** To help people get started with your framework, library, or other project, you can set up a template repository for use with {% data variables.product.prodname_github_codespaces %}. For more information, see "[Setting up a template repository for {% data variables.product.prodname_github_codespaces %}](/codespaces/setting-up-your-project-for-codespaces/setting-up-a-template-repository-for-github-codespaces)."
|
||||
**ヒント:** ユーザーがフレームワーク、ライブラリ、またはその他のプロジェクトを使い始められるように、{% data variables.product.prodname_github_codespaces %} で使うテンプレート リポジトリを設定できます。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} のテンプレート リポジトリを設定する](/codespaces/setting-up-your-project-for-codespaces/setting-up-a-template-repository-for-github-codespaces)」を参照してください。
|
||||
|
||||
{% endtip %}
|
||||
|
||||
## Creating a codespace from a {% data variables.product.company_short %} template
|
||||
## {% data variables.product.company_short %} テンプレートから codespace を作成する
|
||||
|
||||
Templates maintained by {% data variables.product.company_short %}, including the blank template, are available from the "Your codespaces" page.
|
||||
空のテンプレートなど、{% data variables.product.company_short %} が管理するテンプレートは、"自分の codespace" ページから入手できます。
|
||||
|
||||
{% data reusables.codespaces.your-codespaces-procedure-step %}
|
||||
{% data reusables.codespaces.view-all-templates-step %}
|
||||
1. Optionally, to view the template repository containing the files for a template, click the name of the template.
|
||||
{% data reusables.codespaces.your-codespaces-procedure-step %} {% data reusables.codespaces.view-all-templates-step %}
|
||||
1. 必要に応じて、テンプレートのファイルを含むテンプレート リポジトリを表示するには、テンプレートの名前をクリックします。
|
||||
|
||||

|
||||
![[クイック スタート テンプレートの探索] セクションの [React] が強調表示されているスクリーンショット](/assets/images/help/codespaces/react-template-name.png)
|
||||
|
||||
1. Under the template you want to launch, click **Use this template**.
|
||||
1. 起動するテンプレートの下にある **[このテンプレートを使用]** をクリックします。
|
||||
|
||||

|
||||
![React テンプレートの下にある [このテンプレートを使用] ボタンが強調表示されているクイック スタート テンプレートのスクリーンショット](/assets/images/help/codespaces/react-template-button.png)
|
||||
|
||||
{% data reusables.codespaces.template-codespaces-default-editor %}
|
||||
|
||||
## Creating a codespace from a template repository
|
||||
## テンプレート リポジトリから codespace を作成する
|
||||
|
||||
You can create a codespace from any template repository, then publish your work to a new repository when you are ready. For more information on template repositories, see "[Creating a repository from a template](/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template#about-repository-templates)."
|
||||
任意のテンプレート リポジトリから codespace を作成し、準備ができたら新しいリポジトリに作業内容を公開できます。 テンプレート リポジトリについて詳しくは、「[テンプレートからリポジトリを作成する](/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template#about-repository-templates)」を参照してください。
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.codespaces.open-template-in-codespace-step %}
|
||||
{% data reusables.repositories.navigate-to-repo %} {% data reusables.codespaces.open-template-in-codespace-step %}
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** If you're a maintainer of the template repository, and want to commit changes to the template repository itself, you should create a codespace from the **{% octicon "code" aria-label="The code icon" %} Code** dropdown. For more information, see "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository)."
|
||||
**注:** 自分がテンプレート リポジトリの保守管理者で、テンプレート リポジトリ自体に変更をコミットする場合は、 **[{% octicon "code" aria-label="The code icon" %} コード]** ドロップダウンから codespace を作成する必要があります。 詳しくは、「[リポジトリの codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository)」を参照してください。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.codespaces.template-codespaces-default-editor %}
|
||||
|
||||
## Publishing to a repository on {% data variables.product.product_name %}
|
||||
## {% data variables.product.product_name %} のリポジトリに公開する
|
||||
|
||||
{% data reusables.codespaces.about-publishing-templates %}
|
||||
|
||||
### Publishing from {% data variables.product.prodname_vscode_shortname %}
|
||||
### {% data variables.product.prodname_vscode_shortname %} から公開する
|
||||
|
||||
{% data reusables.codespaces.publishing-template-codespaces %}
|
||||
|
||||
When a codespace is published, you have access to a greater range of options to customize your {% data variables.product.prodname_github_codespaces %} experience. For example, you can:
|
||||
codespace が公開されると、自分の {% data variables.product.prodname_github_codespaces %} エクスペリエンスをカスタマイズするためのさまざまなオプションにアクセスできます。 たとえば、次のように操作できます。
|
||||
|
||||
- Change the machine type of your codespace to make sure you're using resources appropriate for the work you're doing (see "[Changing the machine type for your codespace](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace)").
|
||||
- Allow {% data variables.product.prodname_dotcom %} to automatically use GPG to sign commits you make in your codespace (see "[Managing GPG verification for {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces)").
|
||||
- Share encrypted secrets with your codespace (see "[Managing encrypted secrets for your codespaces](/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces)").
|
||||
- codespace のコンピューターの種類を変更して、作業に適したリソースを使っていることを確認します (「[codespace のコンピューターの種類を変更する](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace)」を参照してください)。
|
||||
- {% data variables.product.prodname_dotcom %} が自動的に GPG を使って codespace で行うコミットに署名できるようにします (「[{% data variables.product.prodname_github_codespaces %} の GPG 検証を管理する](/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces)」を参照してください)。
|
||||
- 暗号化されたシークレットを codespace と共有します (「[codespaces の暗号化されたシークレットを管理する](/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces)」を参照してください)。
|
||||
|
||||
### Publishing from {% data variables.product.prodname_dotcom_the_website %}
|
||||
### {% data variables.product.prodname_dotcom_the_website %} から公開する
|
||||
|
||||
You can publish an unpublished codespace from the "Your codespaces" page on {% data variables.product.prodname_dotcom_the_website %}. This is useful if you want to publish a codespace that you don't currently have open in your browser. If you do this, your work will be preserved in a repository, but there won't be a link between your existing codespace and the new repository. However, you can navigate to the new repository and create a codespace from there, and this codespace will be connected to the repository.
|
||||
公開されていない codespace は、{% data variables.product.prodname_dotcom_the_website %} の "自分の codespace" ページから公開できます。 これは、ブラウザー内で現在開いていない codespace を公開する場合に便利です。 これを行うと、作業内容はリポジトリに保持されますが、既存の codespace と新しいリポジトリの間のリンクはなくなります。 ただし、新しいリポジトリに移動し、そこから codespace を作成すると、この codespace はそのリポジトリに接続されるようになります。
|
||||
|
||||
{% data reusables.codespaces.your-codespaces-procedure-step %}
|
||||
1. Next to the unpublished codespace, click the ellipsis (**...**), then select **Publish to a new repository**.
|
||||
1. 公開されていない codespace の横にある省略記号 ( **...** ) をクリックし、 **[新しいリポジトリに公開する]** を選びます。
|
||||
|
||||

|
||||
1. Choose a name for your new repository, set it as **Public** or **Private**, and click **Create repository**.
|
||||
![[新しいリポジトリに公開する] ボタンのスクリーンショット](/assets/images/help/codespaces/publish-to-new-repository.png)
|
||||
1. 新しいリポジトリの名前を選び、 **[パブリック]** または **[プライベート]** に設定して、 **[リポジトリの作成]** をクリックします。
|
||||
|
||||

|
||||
1. Optionally, to view the new repository, click **See repository**.
|
||||
![[新しいリポジトリに公開する] ドロップダウンのスクリーンショット](/assets/images/help/codespaces/template-new-repository-settings.png)
|
||||
1. 必要に応じて、新しいリポジトリを表示するには、 **[リポジトリの表示]** をクリックします。
|
||||
|
||||
## Further reading
|
||||
## 参考資料
|
||||
|
||||
- "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)"
|
||||
- "[The codespace lifecycle](/codespaces/getting-started/the-codespace-lifecycle)"
|
||||
- "[Using source control in your codespace](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace)"
|
||||
- [リポジトリの codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)
|
||||
- [codespace ライフサイクル](/codespaces/getting-started/the-codespace-lifecycle)
|
||||
- [codespace でソース管理を使う](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace)
|
||||
|
||||
@@ -9,12 +9,12 @@ topics:
|
||||
- Codespaces
|
||||
redirect_from:
|
||||
- /codespaces/prebuilding-your-codespaces/about-codespaces-prebuilds
|
||||
ms.openlocfilehash: e0962e410f2227a23ff98c8a3e7995ea8ec8a914
|
||||
ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8
|
||||
ms.openlocfilehash: eecb77b541cc735fcf788fbc5da6960cabad899d
|
||||
ms.sourcegitcommit: 9af8891fea10039b3374c76818634e05410e349d
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/09/2022
|
||||
ms.locfileid: '148158798'
|
||||
ms.lasthandoff: 12/06/2022
|
||||
ms.locfileid: '148191919'
|
||||
---
|
||||
## 概要
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
title: Configuring prebuilds
|
||||
title: プレビルドの構成
|
||||
shortTitle: Configure prebuilds
|
||||
intro: You can configure your project to prebuild a codespace automatically each time you push a change to your repository.
|
||||
intro: 変更をリポジトリにプッシュするたびに自動的に codespace をプレビルドするようにプロジェクトを構成できます。
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
@@ -10,106 +10,111 @@ topics:
|
||||
- Codespaces
|
||||
- Set up
|
||||
permissions: People with admin access to a repository can configure prebuilds for the repository.
|
||||
ms.openlocfilehash: dbb355e150695f27d1d6a7fa51eccc33a0ebde4f
|
||||
ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/09/2022
|
||||
ms.locfileid: '148159118'
|
||||
---
|
||||
プレビルド構成は、リポジトリの特定のブランチと特定の開発コンテナー構成ファイルの組み合わせに対して設定できます。
|
||||
|
||||
You can set up a prebuild configuration for the combination of a specific branch of your repository with a specific dev container configuration file.
|
||||
通常、プレビルドが有効な親ブランチから作られたブランチはすべて、同じ開発コンテナー構成のプレビルドも取得します。 これは、親ブランチと同じ開発コンテナー構成を使う子ブランチのプレビルドがほとんどの場合同一であるためであり、これにより、開発者はこれらのブランチの codespace の作成時間を短縮できるというメリットも得られます。 詳細については、[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)に関するページをご覧ください。
|
||||
|
||||
Any branches created from a prebuild-enabled parent branch will typically also get prebuilds for the same dev container configuration. This is because prebuilds for child branches that use the same dev container configuration as the parent branch are, for the most part, identical, so developers can benefit from faster codespace creation times on those branches also. For more information, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)."
|
||||
通常、ブランチにプレビルドを構成すると、複数のマシンの種類でプレビルドを使用できるようになります。 しかし、リポジトリが 32 GB を超える場合、提供されるストレージは 32 GB に制限されているため、2 コアと 4 コアのマシンの種類ではプレビルドを使用できません。
|
||||
|
||||
Typically, when you configure prebuilds for a branch, prebuilds will be available for multiple machine types. However, if your repository is greater than 32 GB, prebuilds won't be available for 2-core and 4-core machine types, since the storage these provide is limited to 32 GB.
|
||||
## 前提条件
|
||||
|
||||
## Prerequisites
|
||||
プレビルドは、{% data variables.product.prodname_actions %} を使用して作成されます。 その結果、プレビルドを構成するリポジトリに対して {% data variables.product.prodname_actions %} を有効にする必要があります。 詳細については、「[リポジトリの {% data variables.product.prodname_actions %} 設定の管理](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository)」を参照してください。
|
||||
|
||||
Prebuilds are created using {% data variables.product.prodname_actions %}. As a result, {% data variables.product.prodname_actions %} must be enabled for the repository for which you are configuring prebuilds. For more information, see "[Managing {% data variables.product.prodname_actions %} settings for a repository](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository)."
|
||||
|
||||
## Configuring prebuilds
|
||||
## プレビルドの構成
|
||||
|
||||
{% data reusables.codespaces.accessing-prebuild-configuration %}
|
||||
1. In the "Prebuild configuration" section of the page, click **Set up prebuild**.
|
||||
1. ページの [プレビルド構成] セクションで、 **[プレビルドの設定]** をクリックします。
|
||||
|
||||

|
||||
![[プレビルドの設定] ボタン](/assets/images/help/codespaces/prebuilds-set-up.png)
|
||||
|
||||
1. Choose the branch for which you want to set up prebuilds.
|
||||
1. プレビルドを設定するブランチを選びます。
|
||||
|
||||

|
||||

|
||||
|
||||
{% note %}
|
||||
|
||||
**Note**: Any branches created from a prebuild-enabled base branch will typically also get prebuilds for the same dev container configuration. For example, if you enable prebuilds for a dev container configuration file on the default branch of the repository, branches based on the default branch will, in most cases, also get prebuilds for the same dev container configuration.
|
||||
**注**: 通常、プレビルドが有効なベース ブランチから作られたブランチはすべて、同じ開発コンテナー構成のプレビルドも取得します。 たとえば、リポジトリの既定のブランチで開発コンテナー構成ファイルのプレビルドを有効にすると、ほとんどの場合、既定のブランチに基づくブランチも同じ開発コンテナー構成のプレビルドを取得するようになります。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
1. Optionally, in the **Configuration file** dropdown menu that's displayed, choose the `devcontainer.json` configuration file that you want to use for your prebuilds. For more information, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#devcontainerjson)."
|
||||
1. 必要に応じて、表示される **[構成ファイル]** ドロップダウン メニューで、ご自分のプレビルドに使う `devcontainer.json` 構成ファイルを選びます。 詳細については、[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#devcontainerjson)に関するページをご覧ください。
|
||||
|
||||

|
||||

|
||||
|
||||
1. Choose how you want to automatically trigger prebuild updates.
|
||||
1. プレビルドの更新を自動的にトリガーする方法を選びます。
|
||||
|
||||
* **Every push** (the default setting) - With this setting, prebuilds will be updated on every push made to the given branch. This will ensure that codespaces generated from a prebuild always contain the latest codespace configuration, including any recently added or updated dependencies.
|
||||
* **On configuration change** - With this setting, prebuilds will be updated every time associated configuration files for a given repo and branch are updated. This ensures that changes to the dev container configuration files for the repository are used when a codespace is generated from a prebuild. The {% data variables.product.prodname_actions %} workflow that updates the prebuilds will run less often, so this option will use fewer {% data variables.product.prodname_actions %} minutes. However, this option will not guarantee that codespaces always include recently added or updated dependencies, so these may have to be added or updated manually after a codespace has been created.
|
||||
* **Scheduled** - With this setting, you can have your prebuilds updated on a custom schedule that's defined by you. This can reduce consumption of {% data variables.product.prodname_actions %} minutes, however, with this option, codespaces may be created that do not use the latest dev container configuration changes.
|
||||
* **すべてのプッシュ** (既定の設定) - この設定では、特定のブランチに対して行われるすべてのプッシュで、プレビルドの構成が更新されます。 これにより、プレビルドから生成された codespace には、最近追加または更新された依存関係を含む最新の codespace 構成が常に含まれます。
|
||||
* **構成の変更時** - この設定では、特定のリポジトリとブランチの関連する構成ファイルが更新されるたびに、プレビルドが更新されます。 これにより、プレビルドから codespace が生成されるときに、リポジトリの開発コンテナー構成ファイルに対する変更が確実に使用されます。 プレビルドを更新する {% data variables.product.prodname_actions %} ワークフローは実行頻度が低いため、このオプションでは使用する {% data variables.product.prodname_actions %} の使用時間 (分) が少なくなります。 ただし、このオプションでは、codespace に常に最近追加または更新された依存関係が含まれるという保証はないため、codespace の作成後に手動で追加または更新する必要がある場合があります。
|
||||
* **スケジュール済み** - この設定では、ユーザーが定義したカスタム スケジュールに基づいてプレビルドを更新できます。 これにより、{% data variables.product.prodname_actions %} の使用時間 (分) を減らすことができますが、このオプションでは、最新の開発コンテナー構成の変更を使用しない codespace を作成できます。
|
||||
|
||||

|
||||

|
||||
|
||||
1. Optionally, select **Reduce prebuild available to only specific regions** to create prebuilds only in specified regions. Select the regions in which you want prebuilds to be available.
|
||||
1. 必要に応じて、 **[特定のリージョンでのみ使用できるプレビルドを減らす]** を選び、指定したリージョンにのみプレビルドを作成します。 プレビルドを使用できるようにするリージョンを選びます。
|
||||
|
||||
By default, prebuilds are created in all of the available regions, incurring storage charges per prebuild.
|
||||
既定では、使用可能なすべてのリージョンにプレビルドが作成され、プレビルドごとにストレージ料金が発生します。
|
||||
|
||||

|
||||

|
||||
|
||||
{% note %}
|
||||
|
||||
**Notes**:
|
||||
* The prebuild in each region incurs individual storage charges. You should, therefore, only enable prebuilds for regions in which you know they'll be used. For more information, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#billing-for-codespaces-prebuilds)."
|
||||
* Developers can set their default region for {% data variables.product.prodname_github_codespaces %}, which can allow you to enable prebuilds for fewer regions. For more information, see "[Setting your default region for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-region-for-github-codespaces)."
|
||||
**注**:
|
||||
* 各リージョンのプレビルドでは、個々のストレージ料金が発生します。 そのため、使用されることがわかっているリージョンに対してのみプレビルドを有効にする必要があります。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} の支払いについて](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#billing-for-codespaces-prebuilds)」をご覧ください。
|
||||
* 開発者は、{% data variables.product.prodname_github_codespaces %} の既定のリージョンを設定できます。これにより、より少ないリージョンでプレビルドを有効にすることができます。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} の既定のリージョンの設定](/codespaces/customizing-your-codespace/setting-your-default-region-for-github-codespaces)」を参照してください。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
1. Optionally, under **Template history**, set the number of prebuild versions to be retained. You can input any number between 1 and 5. The default number of saved versions is 2, which means that only the latest prebuild and the previous version are saved.
|
||||
1. 必要に応じて、 **[テンプレートの履歴]** で、保持するプレビルドのバージョンを設定します。 1 から 5 の任意の数を入力できます。 保存されるバージョンの既定の数は 2 です。つまり、最新のプレビルドと前のバージョンのみが保存されます。
|
||||
|
||||

|
||||

|
||||
|
||||
Depending on your prebuild trigger settings, your prebuild could change with each push or on each dev container configuration change. Retaining older versions of prebuilds enables you to create a prebuild from an older commit with a different dev container configuration than the current prebuild. This setting allows you to set the number of retained versions to a level that is appropriate for your needs.
|
||||
プレビルドのトリガー設定によっては、プッシュごと、または開発コンテナー構成の変更ごとに、プレビルドが変更される可能性があります。 以前のバージョンのプレビルドを保持すると、現在のプレビルドとは異なる開発コンテナー構成を使用して、以前のコミットからプレビルドを作成できます。 この設定を使用すると、保持されているバージョンの数を、ニーズに適したレベルに設定できます。
|
||||
|
||||
If you set the number of prebuild versions to save to 1, {% data variables.product.prodname_github_codespaces %} will only save the latest version of the prebuild and will delete the older version each time the template is updated. This means you will not get a prebuilt codespace if you go back to an older dev container configuration.
|
||||
保存するプレビルドのバージョンの数を 1 に設定した場合、{% data variables.product.prodname_github_codespaces %} によりプレビルドの最新バージョンのみが保存され、テンプレートが更新されるたびに古いバージョンが削除されます。 つまり、以前の開発コンテナー構成に戻った場合、プレビルドの codespace は取得されません。
|
||||
|
||||
There is a storage cost associated with each prebuild version that's retained. For example, if you are generating prebuilds in 4 regions and retaining 2 versions, you will be charged for storage of up to 8 prebuilds. For more information on billing, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#codespaces-pricing)."
|
||||
保持されている各プレビルド バージョンには、ストレージ コストが関連付けられています。 たとえば、4 つのリージョンでプレビルドを生成し、2 つのバージョンを保持している場合、最大 8 つのプレビルドのストレージに対して課金されます。 課金について詳しくは、「[{% data variables.product.prodname_github_codespaces %} の支払いについて](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#codespaces-pricing)」をご覧ください。
|
||||
|
||||
1. Optionally, add users or teams to notify when the prebuild workflow run fails for this configuration. You can begin typing a username, team name, or full name, then click the name once it appears to add them to the list. The users or teams you add will receive an email when prebuild failures occur, containing a link to the workflow run logs to help with further investigation.
|
||||
1. 必要に応じて、この構成でプレビルド ワークフローの実行が失敗したときに通知するユーザーまたはチームを追加します。 ユーザー名、チーム名、またはフル ネームの入力を開始し、表示されたら名前をクリックしてリストに追加できます。 追加したユーザーまたはチームは、プレビルド エラーが発生したときに電子メールを受信します。詳しい調査に役立つワークフロー実行ログへのリンクが含まれています。
|
||||
|
||||

|
||||

|
||||
|
||||
1. Optionally, at the bottom of the page, click **Show advanced options**.
|
||||
1. 必要に応じて、ページの下部にある **[詳細オプションの表示]** をクリックします。
|
||||
|
||||

|
||||
![[詳細オプションの表示] が強調表示されているプレビルド構成ページのスクリーンショット](/assets/images/help/codespaces/show-advanced-options.png)
|
||||
|
||||
In the "Advanced options" section, if you select **Disable prebuild optimization**, codespaces will be created without a prebuild if the latest prebuild workflow has failed or is currently running. For more information, see "[Troubleshooting prebuilds](/codespaces/troubleshooting/troubleshooting-prebuilds#preventing-out-of-date-prebuilds-being-used)."
|
||||
[詳細オプション] セクションで、 **[プレビルドの最適化を無効にする]** を選んだ場合、最新のプレビルド ワークフローが失敗したか、現在実行中の場合は、プレビルドなしで codespace が作成されます。 詳しくは、「[プレビルドのトラブルシューティング](/codespaces/troubleshooting/troubleshooting-prebuilds#preventing-out-of-date-prebuilds-being-used)」を参照してください。
|
||||
|
||||
1. Click **Create**.
|
||||
1. **Create** をクリックしてください。
|
||||
|
||||
{% data reusables.codespaces.prebuilds-permission-authorization %}
|
||||
|
||||
After you create a prebuild configuration it is listed on the {% data variables.product.prodname_github_codespaces %} page of your repository settings. A {% data variables.product.prodname_actions %} workflow is queued and then run to create prebuilds in the regions you specified, based on the branch and dev container configuration file you selected.
|
||||
プレビルド構成を作ると、リポジトリ設定の {% data variables.product.prodname_github_codespaces %} ページに一覧表示されます。 {% data variables.product.prodname_actions %} ワークフローがキューに登録され、指定したリージョンで、選んだブランチと開発コンテナー構成ファイルに基づいて、プレビルドを作るために実行されます。
|
||||
|
||||

|
||||

|
||||
|
||||
For information about editing and deleting prebuild configurations, see "[Managing prebuilds](/codespaces/prebuilding-your-codespaces/managing-prebuilds)."
|
||||
プレビルド構成の編集と削除について詳しくは、「[プレビルドを管理する](/codespaces/prebuilding-your-codespaces/managing-prebuilds)」を参照してください。
|
||||
|
||||
## Configuring environment variables
|
||||
## 環境変数の設定
|
||||
|
||||
To allow the prebuild process to access environment variables required to create your development environment, you can set these either as {% data variables.product.prodname_codespaces %} repository secrets or as {% data variables.product.prodname_codespaces %} organization secrets. For more information, see "[Adding secrets for a repository](/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces#adding-secrets-for-a-repository)" and "[Adding secrets for an organization](/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces#adding-secrets-for-an-organization)."
|
||||
開発環境を作成するために必要な環境変数にプレビルド プロセスでアクセスできるようにするには、これらを {% data variables.product.prodname_codespaces %} リポジトリ シークレットとして、または {% data variables.product.prodname_codespaces %} Organization シークレットとして設定できます。 詳細については、「[リポジトリのシークレットの追加](/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces#adding-secrets-for-a-repository)」および「[のシークレットの追加](/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces#adding-secrets-for-an-organization)」を参照してください。
|
||||
|
||||
Secrets that you create in this way will be accessible by anyone who creates a codespace from this repository. If you do not want this, you can alternatively set the `CODESPACES_PREBUILD_TOKEN` secret. The `CODESPACES_PREBUILD_TOKEN` secret is only used for prebuilding and its value is not accessible in users' codespaces.
|
||||
この方法で作ったシークレットは、このリポジトリから codespace を作るすべてのユーザーがアクセスできます。 そのようにしたくない場合は、代わりに `CODESPACES_PREBUILD_TOKEN` シークレットを設定できます。 `CODESPACES_PREBUILD_TOKEN` シークレットはプレビルドにのみ使用され、ユーザーの codespace ではその値にアクセスできません。
|
||||
|
||||
Prebuilds cannot use any user-level secrets while building your environment, because these are not available until after the codespace has been created.
|
||||
環境の構築中は、プレビルドでユーザー レベルのシークレットを使うことはできません。これは、codespace が作られるまで利用できないためです。
|
||||
|
||||
## Configuring time-consuming tasks to be included in the prebuild
|
||||
## プレビルドに含める時間のかかるタスクの構成
|
||||
|
||||
You can use the `onCreateCommand` and `updateContentCommand` commands in your `devcontainer.json` to include time-consuming processes as part of the prebuild creation. For more information, see the {% data variables.product.prodname_vscode %} documentation, "[devcontainer.json reference](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_lifecycle-scripts)."
|
||||
`devcontainer.json` で `onCreateCommand` および `updateContentCommand` コマンドを使用して、プレビルド作成の一部として時間のかかるプロセスを含めることができます。 詳細については、{% data variables.product.prodname_vscode %} のドキュメントの「[devcontainer.json リファレンス](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_lifecycle-scripts)」を参照してください。
|
||||
|
||||
`onCreateCommand` is run only once, when the prebuild is created, whereas `updateContentCommand` is run at creation of the prebuild and at subsequent updates to it. Incremental builds should be included in `updateContentCommand` since they represent the source of your project and need to be included for every prebuild update.
|
||||
`onCreateCommand` はプレビルドが作成されるときに 1 回だけ実行されますが、`updateContentCommand` はテンプレートの作成時とそれ以降の更新時に実行されます。 インクリメンタル ビルドは `updateContentCommand` に含める必要があります。これらはプロジェクトのソースを表し、プレビルドの更新ごとに含める必要があるためです。
|
||||
|
||||
## Further reading
|
||||
## 参考資料
|
||||
|
||||
- "[Allowing a prebuild to access other repositories](/codespaces/prebuilding-your-codespaces/allowing-a-prebuild-to-access-other-repositories)"
|
||||
- "[Troubleshooting prebuilds](/codespaces/troubleshooting/troubleshooting-prebuilds)"
|
||||
- [プレビルドで他のリポジトリにアクセスできるようにする](/codespaces/prebuilding-your-codespaces/allowing-a-prebuild-to-access-other-repositories)
|
||||
- [プレビルドに関するトラブルシューティング](/codespaces/troubleshooting/troubleshooting-prebuilds)
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
title: Adding an "Open in GitHub Codespaces" badge
|
||||
title: '[GitHub Codespaces で開く] バッジの追加'
|
||||
shortTitle: Add a Codespaces badge
|
||||
intro: You can add a badge to a Markdown file in your repository which people can click to create a codespace.
|
||||
intro: リポジトリ内の Markdown ファイルにバッジを追加し、ユーザーがクリックして codespace を作成できるようにすることができます。
|
||||
allowTitleToDifferFromFilename: true
|
||||
versions:
|
||||
fpt: '*'
|
||||
@@ -10,50 +10,55 @@ type: how_to
|
||||
topics:
|
||||
- Codespaces
|
||||
- Set up
|
||||
ms.openlocfilehash: c69a815501f5943a56d32af3e58cd7850a69588b
|
||||
ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/09/2022
|
||||
ms.locfileid: '148158782'
|
||||
---
|
||||
## 概要
|
||||
|
||||
## Overview
|
||||
Markdown ファイルに [{% data variables.product.prodname_github_codespaces %} で開く] バッジを追加すると、リポジトリの codespace を簡単に作成できます。
|
||||
|
||||
Adding an "Open in {% data variables.product.prodname_github_codespaces %}" badge to a Markdown file gives people an easy way to create a codespace for your repository.
|
||||

|
||||
|
||||

|
||||
バッジを作成するときに、そのバッジで作成される codespace に対して特定の構成オプションを選ぶことができます。
|
||||
|
||||
When you create a badge you can choose specific configuration options for the codespace that the badge will create.
|
||||
ユーザーがバッジをクリックすると、codespace の作成用の [詳細オプション] ページに移動します。選んだオプションは事前に選択されています。 詳細オプション ページについて詳しくは、「[リポジトリの codespace の作成](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository)」を参照してください。
|
||||
|
||||
When people click the badge they'll be taken to the advanced options page for codespace creation, with the options you chose preselected. For more information about the advanced options page, see "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository)."
|
||||
[詳細オプション] ページから、ユーザーは必要に応じて事前に選択された設定を変更し、 **[codespace の作成]** をクリックできます。
|
||||
|
||||
From the advanced options page, users can change the preselected settings if required, then click **Create codespace**.
|
||||
|
||||
## Creating an "Open in {% data variables.product.prodname_github_codespaces %}" badge
|
||||
## [{% data variables.product.prodname_github_codespaces %} で開く] バッジの作成
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
1. Under the repository name, use the "Branch" dropdown menu, and select the branch you want to create the badge for.
|
||||
1. リポジトリ名の下で、[ブランチ] ドロップダウンメニューを使用して、バッジを作成するブランチを選択します。
|
||||
|
||||

|
||||
![[ブランチ] ドロップダウン メニューのスクリーンショット](/assets/images/help/codespaces/branch-drop-down.png)
|
||||
|
||||
1. Click the **{% octicon "code" aria-label="The code icon" %} Code** button, then click the **Codespaces** tab.
|
||||
1. **[{% octicon "code" aria-label="The code icon" %} コード]** ボタンをクリックし、 **[Codespaces]** タブをクリックします。
|
||||
|
||||

|
||||
![[新しい codespace] ボタンのスクリーンショット](/assets/images/help/codespaces/new-codespace-button.png)
|
||||
|
||||
1. Click the ellipsis (**...**) at the top right of the **Codespaces** tab, then click **New with options**.
|
||||
1. **[Codespaces]** タブの右上にある省略記号 ( **...** ) をクリックし、 **[オプションを含む新規]** をクリックします。
|
||||
|
||||

|
||||
![[codespace の構成と作成] オプションのスクリーンショット](/assets/images/help/codespaces/default-machine-type.png)
|
||||
|
||||
1. On the advanced options page for codespace creation, select the values you want to be preselected in each field.
|
||||
1. codespace 作成の [詳細オプション] ページで、各フィールドで事前に選択される値を選びます。
|
||||
|
||||

|
||||
![[詳細オプション] ページのスクリーンショット](/assets/images/help/codespaces/advanced-options.png)
|
||||
|
||||
1. Copy the URL from the browser's address bar.
|
||||
1. Add the following Markdown to, for example, the `README.md` file of your repository:
|
||||
1. ブラウザーのアドレス バーから URL をコピーします。
|
||||
1. たとえば、リポジトリの `README.md` ファイルに次の Markdown を追加します。
|
||||
|
||||
```Markdown{:copy}
|
||||
[](COPIED-URL)
|
||||
```
|
||||
|
||||
For example:
|
||||
次に例を示します。
|
||||
|
||||
```Markdown
|
||||
[](https://github.com/codespaces/new?hide_repo_select=true&ref=main&repo=0000000&machine=premiumLinux&devcontainer_path=.devcontainer%2Fdevcontainer.json&location=WestUs2)
|
||||
```
|
||||
|
||||
In the above example, `0000000` will be the reference number of your repository. The other details in the URL are determined by the values you selected in the fields on the advanced options page.
|
||||
上記の例では、`0000000` がリポジトリの参照番号になります。 URL のその他の詳細は、[詳細オプション] ページのフィールドで選んだ値によって決まります。
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
title: Troubleshooting prebuilds
|
||||
title: プレビルドに関するトラブルシューティング
|
||||
shortTitle: Codespaces prebuilds
|
||||
intro: You can use prebuilds to speed up the creation of codespaces. This article provides troubleshooting steps for common issues with prebuilds.
|
||||
intro: プレビルドを使用して、codespace の作成を高速化できます。 この記事では、プレビルドを使った一般的な問題のトラブルシューティング手順を示します。
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
@@ -9,86 +9,91 @@ type: reference
|
||||
topics:
|
||||
- Codespaces
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: b8c45f9eae6094b78026d055ebea27c3748a8681
|
||||
ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/09/2022
|
||||
ms.locfileid: '148158886'
|
||||
---
|
||||
{% data variables.product.prodname_github_codespaces %} のプレビルドの詳細については、「[codespace のプレビルド](/codespaces/prebuilding-your-codespaces)」を参照してください。
|
||||
|
||||
For more information about {% data variables.product.prodname_github_codespaces %} prebuilds, see "[Prebuilding your codespaces](/codespaces/prebuilding-your-codespaces)."
|
||||
## codespace がプレビルドから作成されたかどうかの確認
|
||||
|
||||
## Checking whether a codespace was created from a prebuild?
|
||||
codespace を作成する際には、使用する仮想マシンの種類を選択できます。 仮想マシンの種類に対してプレビルドが使用可能な場合は、その横に "{% octicon "zap" aria-label="The zap icon" %} Prebuild ready \(プレビルド対応\)" が表示されます。
|
||||
|
||||
When you create a codespace, you can choose the type of the virtual machine you want to use. If a prebuild is available for the type of virtual machine, "{% octicon "zap" aria-label="The zap icon" %} Prebuild ready" is shown next to it.
|
||||

|
||||
|
||||

|
||||
{% data variables.product.prodname_github_codespaces %} エディターの基本設定を [{% data variables.product.prodname_vscode %} for Web] に設定しており、プレビルドが使用されている場合は、[codespace の設定] ページに "プレビルド codespace が見つかりました" というメッセージが表示されます。
|
||||
|
||||
If you have your {% data variables.product.prodname_github_codespaces %} editor preference set to "{% data variables.product.prodname_vscode %} for Web" then the "Setting up your codespace" page will show the message "Prebuilt codespace found" if a prebuild is being used.
|
||||

|
||||
|
||||

|
||||
同様に、エディターの基本設定が [{% data variables.product.prodname_vscode_shortname %}] の場合、統合ターミナルには、新しい codespace を作成するときに、"リポジトリのプレビルド構成で定義されたプレビルド codespace を使用しています" というメッセージが含まれます。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} の既定のエディターを設定する](/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces)」をご覧ください。
|
||||
|
||||
Similarly, if your editor preference is "{% data variables.product.prodname_vscode_shortname %}" then the integrated terminal will contain the message "You are on a prebuilt codespace defined by the prebuild configuration for your repository" when you create a new codespace. For more information, see "[Setting your default editor for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces)."
|
||||
|
||||
After you have created a codespace you can check whether it was created from a prebuild by running the following {% data variables.product.prodname_cli %} command in the terminal:
|
||||
codespace を作成した後、ターミナルで次の {% data variables.product.prodname_cli %} コマンドを実行して、プレビルドから作成されたかどうかを確認できます。
|
||||
|
||||
```shell{:copy}
|
||||
gh api /user/codespaces/$CODESPACE_NAME --jq .prebuild
|
||||
```
|
||||
|
||||
This returns `true` if the codespace was created using a prebuild.
|
||||
codespace がプレビルドを使用して作成された場合は、`true` が返されます。
|
||||
|
||||
Alternatively, if {% data variables.product.prodname_cli %} (`gh`) is not installed, you can use the following command, which returns `createFromPrebuild` if the codespace was created from a prebuild:
|
||||
{% data variables.product.prodname_cli %} (`gh`) がインストールされていない場合は、次のコマンドを使用できます。codespace がプレビルドから作成された場合は、`createFromPrebuild` が返されます。
|
||||
|
||||
```shell{:copy}
|
||||
cat /workspaces/.codespaces/shared/environment-variables.json | jq '.ACTION_NAME'
|
||||
```
|
||||
|
||||
## The "Prebuild Ready" label is sometimes missing
|
||||
## "Prebuild Ready" ラベルが欠落している場合がある
|
||||
|
||||
You may notice that sometimes, when you create a new codespace from a prebuild-enabled branch, the "{% octicon "zap" aria-label="The zap icon" %} Prebuild Ready" label is not displayed in the dialog box for choosing a machine type. This means that prebuilds are not currently available.
|
||||
プレビルドが有効なブランチから新しい codespace を作成する場合、コンピューターの種類を選択するためのダイアログ ボックスに "{% octicon "zap" aria-label="The zap icon" %} Prebuild Ready" ラベルが表示されないことがあります。 これは、プレビルドが現在使用できないことを意味します。
|
||||
|
||||
By default, each time you push to a prebuild-enabled branch, the prebuild is updated. If the push involves a change to the dev container configuration then, while the update is in progress, the "{% octicon "zap" aria-label="The zap icon" %} Prebuild Ready" label is removed from the list of machine types. During this time you can still create codespaces without a prebuild. If required, you can reduce the occasions on which prebuilds are unavailable for a repository by setting the prebuild to be updated only when you make a change to your dev container configuration files, or only on a custom schedule. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-prebuilds)."
|
||||
既定では、プレビルドが有効なブランチにプッシュするたびに、プレビルドが更新されます。 プッシュ操作に開発コンテナー構成への変更が含まれている場合は、更新中に、"{% octicon "zap" aria-label="The zap icon" %} Prebuild Ready \(プレビルド対応\)" ラベルがマシンの種類のリストから削除されます。 この期間も、プレビルドを使用せずに codespace を作成できます。 必要であれば、開発コンテナー構成ファイルを変更したときのみ、またはカスタム スケジュールで指定したときにのみプレビルドが更新されるように設定することで、リポジトリにプレビルドを使用できない場合を減らすことができます。 詳細については、「[プレビルドの構成](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-prebuilds)」を参照してください。
|
||||
|
||||
If your branch is not specifically enabled for prebuilds it may still benefit from prebuilds if it was branched from a prebuild-enabled branch. However, if the dev container configuration is changed on your branch, so that it's not the same as the configuration on the base branch, prebuilds will no longer be available on your branch.
|
||||
ブランチがプレビルドに対して特に有効になっていない場合でも、プレビルドが有効なブランチから分岐された場合はプレビルドの利点が得られる可能性があります。 しかし、開発コンテナー構成がご利用のブランチで変更されたために、ベース ブランチの構成とは異なる場合、プレビルドはご利用のブランチで使用できなくなります。
|
||||
|
||||
Here are things to check if the "{% octicon "zap" aria-label="The zap icon" %} Prebuild Ready" label is not displayed for a particular branch:
|
||||
特定のブランチに対して "{% octicon "zap" aria-label="The zap icon" %} Prebuild Ready" ラベルが表示されない場合の確認事項を以下に示します。
|
||||
|
||||
* Confirm that a prebuild configuration exists for this branch. If you’re not a repository administrator, you'll need to reach out to one to confirm this.
|
||||
* Confirm that the prebuild configuration includes your region.
|
||||
* Check whether a change to the dev container configuration was pushed to the prebuild-enabled branch recently. If so, you will typically have to wait until the prebuild workflow run for this push completes before prebuilds are available again.
|
||||
* If no configuration changes were recently made, go to the **Actions** tab of your repository, click **{% octicon "codespaces" aria-label="The Codespaces icon" %} {% data variables.product.prodname_codespaces %} Prebuilds** in the workflows list, and check that prebuild workflow runs for the branch are succeeding. If latest runs of a workflow failed, and one or more of these failed runs contained changes to the dev container configuration, then there will be no available prebuilds for the associated branch.
|
||||
* このブランチのプレビルド構成が存在することを確認する。 リポジトリ管理者でない場合は、管理者に連絡して確認する必要があります。
|
||||
* プレビルド構成に自分のリージョンが含まれることを確認する。
|
||||
* 開発コンテナー構成への変更が、最近、プレビルドが有効になったブランチにプッシュされたかどうかを確認する。 そうである場合は、通常、このプッシュに対してプレビルド ワークフローが実行されるまで待たないと、プレビルドを再び使用することはできません。
|
||||
* 構成の変更が最近行われなかった場合は、リポジトリの **[アクション]** タブに移動し、ワークフロー リストの **{% octicon "codespaces" aria-label="The Codespaces icon" %} [{% data variables.product.prodname_codespaces %} プレビルド]** をクリックし、ブランチに対してプレビルド ワークフローが正常に実行されたことを確認します。 ワークフローの最新の実行が失敗し、これらの失敗した実行の 1 つ以上に開発コンテナー構成への変更が含まれていた場合、関連するブランチに対して使用可能なプレビルドはありません。
|
||||
|
||||
## Some resources cannot be accessed in codespaces created using a prebuild
|
||||
## プレビルドを使って作った codespace で一部のリソースにアクセスできない
|
||||
|
||||
If the `devcontainer.json` configuration file for a prebuild configuration specifies that permissions for access to other repositories are required, then the repository administrator is prompted to authorize these permissions when they create or update the prebuild configuration. If the administrator does not grant all of the requested permissions there's a chance that problems may occur in the prebuild, and in codespaces created from this prebuild. This is true even if the user who creates a codespace based on this prebuild _does_ grant all of the permissions when they are prompted to do so.
|
||||
プレビルド構成の `devcontainer.json` 構成ファイルで、他のリポジトリへのアクセス許可が必要であることが指定されている場合、リポジトリ管理者は、プレビルド構成を作成または更新するときに、これらのアクセス許可を認可するように求められます。 管理者が要求されたすべてのアクセス許可を付与していない場合、プレビルドと、このプレビルドから作った codespace で問題が発生する可能性があります。 これは、このプレビルドに基づいて codespace を作るユーザーが、すべてのアクセス許可を付与するように求められ、"付与した" 場合でも起こります。
|
||||
|
||||
## Troubleshooting failed workflow runs for prebuilds
|
||||
## プレビルドに対するワークフロー実行が失敗した場合のトラブルシューティング
|
||||
|
||||
### Increasing the {% data variables.product.prodname_actions %} spending limit
|
||||
### {% data variables.product.prodname_actions %} の使用制限を増やす
|
||||
|
||||
Prebuilds are created and updated using {% data variables.product.prodname_actions %}. Your prebuild workflows will fail if you have used all of your {% data variables.product.prodname_actions %} minutes and have reached your spending limit. If this occurs you can increase your {% data variables.product.prodname_actions %} spending limit to allow the workflows to run. For more information, see "[Managing your spending limit for {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions/managing-your-spending-limit-for-github-actions)."
|
||||
プレビルドは、{% data variables.product.prodname_actions %} を使用して作成および更新されます。 {% data variables.product.prodname_actions %} の分数をすべて使用し、使用制限に達した場合、プレビルド ワークフローは失敗します。 このような場合は、{% data variables.product.prodname_actions %} の使用制限を増やして、ワークフローが実行できるようにします。 詳しい情報については、「[{% data variables.product.prodname_actions %} の使用制限の管理](/billing/managing-billing-for-github-actions/managing-your-spending-limit-for-github-actions)」を参照してください。
|
||||
|
||||
### Authorizing access permissions
|
||||
### アクセス許可の承認
|
||||
|
||||
If the `devcontainer.json` configuration file for a prebuild configuration is updated to specify that permissions for access to other repositories are required, and a repository administrator has not been prompted to authorize these permissions for the prebuild configuration, then the prebuild workflow may fail. Try updating the prebuild configuration, without making any changes. If, when you click **Update**, the authorization page is displayed, check that the requested permissions are appropriate and, if so, authorize the request. For more information, see "[Managing prebuilds](/codespaces/prebuilding-your-codespaces/managing-prebuilds#editing-a-prebuild-configuration)" and "[Managing access to other repositories within your codespace](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces#setting-additional-repository-permissions)."
|
||||
プレビルド構成の `devcontainer.json` 構成ファイルが、他のリポジトリへのアクセス許可が必要であることを指定するように更新され、リポジトリ管理者がプレビルド構成にこれらのアクセス許可を認可するように求められなかった場合、プレビルド ワークフローが失敗する可能性があります。 何も変更せずに、プレビルド構成を更新してみてください。 **[更新]** をクリックして、認可ページが表示される場合は、要求されたアクセス許可が適切であることを確認し、適切であれば、要求を認可します。 詳しくは、「[プレビルドを管理する](/codespaces/prebuilding-your-codespaces/managing-prebuilds#editing-a-prebuild-configuration)」と「[codespace 内の他のリポジトリへのアクセスを管理する](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces#setting-additional-repository-permissions)」をご覧ください。
|
||||
|
||||
If the workflow runs for a prebuild configuration are failing, you can temporarily disable the prebuild configuration while you investigate. For more information, see "[Managing prebuilds](/codespaces/prebuilding-your-codespaces/managing-prebuilds#disabling-a-prebuild-configuration)."
|
||||
プレビルド構成に対するワークフロー実行が失敗する場合は、調査の間、一時的にプレビルド構成を無効にすることができます。 詳細については、「[プレビルドの管理](/codespaces/prebuilding-your-codespaces/managing-prebuilds#disabling-a-prebuild-configuration)」を参照してください。
|
||||
|
||||
### Preventing out-of-date prebuilds being used
|
||||
### 古いプレビルドが使用されないようにする
|
||||
|
||||
By default, if the latest prebuild workflow has failed, then a previous prebuild for the same combination of repository, branch, and `devcontainer.json` configuration file will be used to create new codespaces. This behavior is called prebuild optimization.
|
||||
既定では、最新のプレビルド ワークフローが失敗した場合、リポジトリ、ブランチ、および `devcontainer.json` 構成ファイルの同じ組み合わせに対して以前のプレビルドが使用され、新しい codespace が作成されます。 この動作は、プレビルド最適化と呼ばれます。
|
||||
|
||||
We recommend keeping prebuild optimization enabled, because it helps ensure that codespaces can still be created quickly if an up-to-date prebuild is not available. However, as a repository administrator, you can disable prebuild optimization if you run into problems with prebuilt codespaces being behind the current state of the branch. If you disable prebuild optimization, codespaces for the relevant combination of repository, branch, and `devcontainer.json` file will be created without a prebuild if the latest prebuild workflow has failed or is currently running.
|
||||
プレビルドの最適化を有効にしておくことをお勧めします。これは、最新のプレビルドが使用できない場合でも codespace を迅速に作成できるようにするためです。 ただし、リポジトリ管理者は、プレビルドの codespace が現在のブランチの状態の背後にあるという問題が発生した場合に、プレビルドの最適化を無効にすることができます。 プレビルドの最適化を無効にすると、最新のプレビルド ワークフローが失敗した場合、または現在実行中の場合、リポジトリ、ブランチ、`devcontainer.json` ファイルの関連する組み合わせの codespace がプレビルドなしで作成されます。
|
||||
|
||||
{% data reusables.codespaces.accessing-prebuild-configuration %}
|
||||
1. To the right of the affected prebuild configuration, select the ellipsis (**...**), then click **Edit**.
|
||||
1. 影響を受けるプレビルド構成の右側にある省略記号 ( **...** ) を選び、 **[編集]** をクリックします。
|
||||
|
||||

|
||||
1. Scroll to the bottom of the "Edit configuration" page and click **Show advanced options**.
|
||||
![[編集] が強調表示されているプレビルドの一覧のスクリーンショット](/assets/images/help/codespaces/edit-prebuild-configuration.png)
|
||||
1. [構成の編集] ページの下部までスクロールし、 **[詳細オプションの表示]** をクリックします。
|
||||
|
||||

|
||||
1. If you're sure you want to disable the default setting, select **Disable prebuild optimization**.
|
||||
![[詳細オプションの表示] が強調表示されているプレビルド構成ページのスクリーンショット](/assets/images/help/codespaces/show-advanced-options.png)
|
||||
1. 既定の設定を無効にする必要がある場合は、 **[プレビルドの最適化を無効にする]** を選びます。
|
||||
|
||||

|
||||
1. To save your change, click **Update**.
|
||||
![詳細オプション セクションと [プレビルドの最適化を無効にする] 設定のスクリーンショット](/assets/images/help/codespaces/disable-prebuild-optimization.png)
|
||||
1. 変更を保存するには、 **[更新]** をクリックします。
|
||||
|
||||
## Further reading
|
||||
## 参考資料
|
||||
|
||||
- "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds)"
|
||||
- "[Managing prebuilds](/codespaces/prebuilding-your-codespaces/managing-prebuilds)"
|
||||
- [プレビルドの構成](/codespaces/prebuilding-your-codespaces/configuring-prebuilds)
|
||||
- [プレビルドの管理](/codespaces/prebuilding-your-codespaces/managing-prebuilds)
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: 既定のコミュニティ正常性ファイルの作成
|
||||
intro: CONTRIBUTING や CODE_OF_CONDUCT など、デフォルトのコミュニティ健全性ファイルを作成できます。 デフォルトのファイルは、そのような種類の独自ファイルを持たないアカウントが所有するすべてのリポジトリに使用されます。
|
||||
title: Creating a default community health file
|
||||
intro: 'You can create default community health files, such as CONTRIBUTING and CODE_OF_CONDUCT. Default files will be used for any repository owned by the account that does not contain its own file of that type.'
|
||||
redirect_from:
|
||||
- /articles/creating-a-default-community-health-file-for-your-organization
|
||||
- /github/building-a-strong-community/creating-a-default-community-health-file-for-your-organization
|
||||
@@ -12,41 +12,46 @@ versions:
|
||||
topics:
|
||||
- Community
|
||||
shortTitle: Community health file
|
||||
ms.openlocfilehash: 762af2fcbbc16e0bfc671df2409fede9ea6e2c67
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '145117637'
|
||||
---
|
||||
## デフォルトのコミュニティ健全性ファイルについて
|
||||
|
||||
既定のコミュニティ正常性ファイルは、`.github` という名前のパブリック リポジトリ、リポジトリのルート、または `docs` や `.github` フォルダーに追加できます。
|
||||
## About default community health files
|
||||
|
||||
{% data variables.product.product_name %} は、次のいずれかの場所にその種類の独自ファイルを持たないアカウントが所有するリポジトリのデフォルトファイルを使用および表示します。
|
||||
- リポジトリのルート
|
||||
- `.github` フォルダー
|
||||
- `docs` フォルダー
|
||||
You can add default community health files to a public repository called `.github`, in the root of the repository or in the `docs` or `.github` folders.
|
||||
|
||||
たとえば、独自の CONTRIBUTING ファイルを持たないリポジトリで Issue またはプルリクエストを作成すると、デフォルトの CONTRIBUTING ファイルへのリンクが表示されます。 リポジトリの独自の `.github/ISSUE_TEMPLATE` フォルダーにファイルがある場合{% ifversion fpt or ghes or ghec %} (Issue テンプレートや *config.yml* ファイルを含む){% endif %}、既定の `.github/ISSUE_TEMPLATE` フォルダーの内容は使われません。
|
||||
{% data variables.product.product_name %} will use and display default files for any repository owned by the account that does not have its own file of that type in any of the following places:
|
||||
- the root of the repository
|
||||
- the `.github` folder
|
||||
- the `docs` folder
|
||||
|
||||
既定のファイルは、`.github` リポジトリにのみ格納されるため、個別のリポジトリのクローン、パッケージ、ダウンロードには含まれません。
|
||||
For example, anyone who creates an issue or pull request in a repository that does not have its own CONTRIBUTING file will see a link to the default CONTRIBUTING file. If a repository has any files in its own `.github/ISSUE_TEMPLATE` folder{% ifversion fpt or ghes or ghec %}, including issue templates or a *config.yml* file,{% endif %} none of the contents of the default `.github/ISSUE_TEMPLATE` folder will be used.
|
||||
|
||||
## サポートされているファイルの種類
|
||||
Default files are not included in clones, packages, or downloads of individual repositories because they are stored only in the `.github` repository.
|
||||
|
||||
次のコミュニティ正常性ファイルの既定のものを、Organization {% ifversion fpt or ghes or ghec %} または個人アカウント {% endif %} に作成できます。
|
||||
## Supported file types
|
||||
|
||||
コミュニティ正常性ファイル | 説明 --- | ---{% ifversion fpt or ghec %} *CODE_OF_CONDUCT.md* | CODE_OF_CONDUCT ファイルでは、コミュニティに参加する方法の標準が定義されています。 詳細については、「[プロジェクトへの行動規範の追加](/articles/adding-a-code-of-conduct-to-your-project/)」を参照してください。{% endif %} *CONTRIBUTING.md* | CONTRIBUTING ファイルでは、プロジェクトに投稿する方法が示されています。 詳細については、「[リポジトリ コントリビューターのためのガイドラインを定める](/articles/setting-guidelines-for-repository-contributors/)」を参照してください。{% ifversion fpt or ghec %} *FUNDING.yml* | FUNDING ファイルでは、リポジトリにスポンサー ボタンが表示されて、オープンソース プロジェクトの資金調達オプションの表示が増えます。 詳細については、「[リポジトリにスポンサー ボタンを表示する](/articles/displaying-a-sponsor-button-in-your-repository)」を参照してください。{% endif %} Issue と pull request のテンプレート{% ifversion fpt or ghes or ghec %}および *config.yml*{% endif %} | Issue と pull request のテンプレートでは、自分のリポジトリに共同作成者が Issue や pull request を開くときに含めてほしい情報をカスタマイズおよび標準化します。 詳細については、「[Issue とプル リクエストのテンプレートについて](/articles/about-issue-and-pull-request-templates/)」を参照してください。{% ifversion fpt or ghes or ghec %} *SECURITY.md* | SECURITY ファイルでは、プロジェクトでセキュリティ脆弱性を報告する方法の手順を示します。 詳細については、「[リポジトリにセキュリティ ポリシーを追加する](/code-security/getting-started/adding-a-security-policy-to-your-repository)」を参照してください。{% endif %} *SUPPORT.md* | SUPPORT ファイルでは、プロジェクトに関するヘルプを得る方法がわかるようにします。 詳細については、「[プロジェクトへのサポート リソースの追加](/articles/adding-support-resources-to-your-project/)」を参照してください。
|
||||
You can create defaults in your organization{% ifversion fpt or ghes or ghec %} or personal account{% endif %} for the following community health files:
|
||||
|
||||
デフォルトのライセンスファイルを作成することはできません。 ライセンスファイルは、プロジェクトのクローン時、パッケージ時、またはダウンロード時に含められるよう、個々のリポジトリに追加する必要があります。
|
||||
Community health file | Description
|
||||
--- | ---{% ifversion fpt or ghec %}
|
||||
*CODE_OF_CONDUCT.md* | A CODE_OF_CONDUCT file defines standards for how to engage in a community. For more information, see "[Adding a code of conduct to your project](/articles/adding-a-code-of-conduct-to-your-project/)."{% endif %}
|
||||
*CONTRIBUTING.md* | A CONTRIBUTING file communicates how people should contribute to your project. For more information, see "[Setting guidelines for repository contributors](/articles/setting-guidelines-for-repository-contributors/)."{% ifversion discussion-category-forms %}
|
||||
Discussion category forms | Discussion category forms customize the templates that are available for community members to use when they open new discussions in your repository. For more information, see "[Creating discussion category forms](/discussions/managing-discussions-for-your-community/creating-discussion-category-forms)."{% endif %}{% ifversion fpt or ghec %}
|
||||
*FUNDING.yml* | A FUNDING file displays a sponsor button in your repository to increase the visibility of funding options for your open source project. For more information, see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)."{% endif %}
|
||||
Issue and pull request templates{% ifversion fpt or ghes or ghec %} and *config.yml*{% endif %} | Issue and pull request templates customize and standardize the information you'd like contributors to include when they open issues and pull requests in your repository. For more information, see "[About issue and pull request templates](/articles/about-issue-and-pull-request-templates/)."{% ifversion fpt or ghes or ghec %}
|
||||
*SECURITY.md* | A SECURITY file gives instructions for how to report a security vulnerability in your project. For more information, see "[Adding a security policy to your repository](/code-security/getting-started/adding-a-security-policy-to-your-repository)."{% endif %}
|
||||
*SUPPORT.md* | A SUPPORT file lets people know about ways to get help with your project. For more information, see "[Adding support resources to your project](/articles/adding-support-resources-to-your-project/)."
|
||||
|
||||
## デフォルトのファイル用にリポジトリを作成
|
||||
You cannot create a default license file. License files must be added to individual repositories so the file will be included when a project is cloned, packaged, or downloaded.
|
||||
|
||||
## Creating a repository for default files
|
||||
|
||||
{% data reusables.repositories.create_new %}
|
||||
2. **[所有者]** ドロップダウン メニューを使用し、既定のファイルを作成する Organization {% ifversion fpt or ghes or ghec %} または個人アカウント {% endif %} を選択します。
|
||||
![[所有者] ドロップダウン メニュー](/assets/images/help/repository/create-repository-owner.png)
|
||||
3. リポジトリの名前として「 **.github**」と入力し、必要に応じて説明を入力します。
|
||||

|
||||
4. リポジトリの状態が **[パブリック]** に設定されていることを確認します (既定のファイルのリポジトリをプライベートにすることはできません)。
|
||||
 {% data reusables.repositories.initialize-with-readme %} {% data reusables.repositories.create-repo %}
|
||||
7. リポジトリの中に、サポートされているコミュニティ健全性ファイルの 1 つを作成します。 Issue テンプレート{% ifversion fpt or ghes or ghec %}とその構成ファイル{% endif %}は、`.github/ISSUE_TEMPLATE` という名前のフォルダーに存在する必要があります。 他のすべてのサポートされるファイルは、リポジトリのルート、`.github` フォルダー、または `docs` フォルダーに置くことができます。 詳細については、「[新しいファイルの作成](/articles/creating-new-files/)」を参照してください。
|
||||
2. Use the **Owner** drop-down menu, and select the organization{% ifversion fpt or ghes or ghec %} or personal account{% endif %} you want to create default files for.
|
||||

|
||||
3. Type **.github** as the name for your repository, and an optional description.
|
||||

|
||||
4. Make sure the repository status is set to **Public** (a repository for default files cannot be private).
|
||||

|
||||
{% data reusables.repositories.initialize-with-readme %}
|
||||
{% data reusables.repositories.create-repo %}
|
||||
7. In the repository, create one of the supported community health files. Issue templates{% ifversion fpt or ghes or ghec %} and their configuration file{% endif %} must be in a folder called `.github/ISSUE_TEMPLATE`. All other supported files may be in the root of the repository, the `.github` folder, or the `docs` folder. For more information, see "[Creating new files](/articles/creating-new-files/)."
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Creating a pull request template for your repository
|
||||
intro: 'When you add a pull request template to your repository, project contributors will automatically see the template''s contents in the pull request body.'
|
||||
title: リポジトリ用のプルリクエストテンプレートの作成
|
||||
intro: リポジトリにプルリクエストのテンプレートを追加すると、プロジェクトのコントリビューターはプルリクエストの本体にテンプレートの内容を自動的に見ることになります。
|
||||
redirect_from:
|
||||
- /articles/creating-a-pull-request-template-for-your-repository
|
||||
- /github/building-a-strong-community/creating-a-pull-request-template-for-your-repository
|
||||
@@ -12,41 +12,44 @@ versions:
|
||||
topics:
|
||||
- Community
|
||||
shortTitle: Create a PR template
|
||||
ms.openlocfilehash: fa4d3cf78b63af147c85b8f6d77d7cca74e3853a
|
||||
ms.sourcegitcommit: 4daa156856e651cb3854ead40e35bd918e481ad6
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/02/2022
|
||||
ms.locfileid: '148190409'
|
||||
---
|
||||
詳細については、「[Issue と pull request テンプレートについて](/articles/about-issue-and-pull-request-templates)」を参照してください。
|
||||
|
||||
For more information, see "[About issue and pull request templates](/articles/about-issue-and-pull-request-templates)."
|
||||
|
||||
You can create a *PULL_REQUEST_TEMPLATE/* subdirectory in any of the supported folders to contain multiple pull request templates, and use the `template` query parameter to specify the template that will fill the pull request body. For more information, see "[Using query parameters to create a pull request](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/using-query-parameters-to-create-a-pull-request)."
|
||||
サポートしているどのフォルダーでも *PULL_REQUEST_TEMPLATE/* サブディレクトリを作成し、pull request テンプレートを複数含めることができます。また、`template` クエリ パラメーターで pull request の本文に使用するテンプレートを指定できます。 詳細については、「[クエリ パラメーターを使用して pull request を作成する](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/using-query-parameters-to-create-a-pull-request)」を参照してください。
|
||||
|
||||
{% ifversion fpt or ghes or ghec %}
|
||||
|
||||
You can create default pull request templates for your organization{% ifversion fpt or ghes or ghec %} or personal account{% endif %}. For more information, see "[Creating a default community health file](/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file)."
|
||||
ご自分の Organization {% ifversion fpt or ghes or ghec %}または個人用アカウント{% endif %}向けに既定の pull request を作成することができます。 詳細については、「[既定のコミュニティ正常性ファイルの作成](/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file)」を参照してください。
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Adding a pull request template
|
||||
## プルリクエストテンプレートの追加
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.files.add-file %}
|
||||
3. In the file name field:
|
||||
- To make your pull request template visible in the repository's root directory, name the pull request template `pull_request_template.md`.
|
||||

|
||||
- To make your pull request template visible in the repository's `docs` directory, name the pull request template `docs/pull_request_template.md`.
|
||||

|
||||
- To store your file in a hidden directory, name the pull request template `.github/pull_request_template.md`.
|
||||

|
||||
- To create multiple pull request templates and use the `template` query parameter to specify a template to fill the pull request body, type *.github/PULL_REQUEST_TEMPLATE/*, then the name of your pull request template. For example, `.github/PULL_REQUEST_TEMPLATE/pull_request_template.md`. You can also store multiple pull request templates in a `PULL_REQUEST_TEMPLATE` subdirectory within the root or `docs/` directories. For more information, see "[Using query parameters to create a pull request](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/using-query-parameters-to-create-a-pull-request)."
|
||||

|
||||
4. In the body of the new file, add your pull request template. This could include:
|
||||
- A [reference to a related issue](/articles/basic-writing-and-formatting-syntax/#referencing-issues-and-pull-requests) in your repository.
|
||||
- A description of the changes proposed in the pull request.
|
||||
- [@mentions](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams) of the person or team responsible for reviewing proposed changes.
|
||||
{% data reusables.files.write_commit_message %}
|
||||
{% data reusables.files.choose_commit_branch %} Templates are available to collaborators when they are merged into the repository's default branch.
|
||||
{% data reusables.repositories.navigate-to-repo %} {% data reusables.files.add-file %}
|
||||
3. ファイル名フィールドで:
|
||||
- pull request テンプレートをリポジトリのルート ディレクトリで表示するには、pull request テンプレートに `pull_request_template.md` という名前を付けます。
|
||||

|
||||
- pull request テンプレートをリポジトリの `docs` ディレクトリで表示するには、pull request テンプレートに `docs/pull_request_template.md` という名前を付けます。
|
||||

|
||||
- ファイルを非表示のディレクトリに格納するには、pull request テンプレートを `.github/pull_request_template.md` という名前にします。
|
||||

|
||||
- pull request テンプレートを複数作成し、`template` クエリ パラメーターを使用して pull request の本文を埋めるテンプレートを指定するには、 *.github/PULL_REQUEST_TEMPLATE/* と入力し、続けてお使いの pull request テンプレートの名前を入力します。 たとえば、「 `.github/PULL_REQUEST_TEMPLATE/pull_request_template.md` 」のように入力します。 ルートまたは `docs/` ディレクトリ内の `PULL_REQUEST_TEMPLATE` サブディレクトリに複数の pull request テンプレートを格納することもできます。 詳細については、「[クエリ パラメーターを使用して pull request を作成する](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/using-query-parameters-to-create-a-pull-request)」を参照してください。
|
||||

|
||||
4. 新しいファイルの本文にプルリクエストテンプレートを追加します。 そこに盛り込むべき項目として、以下のようなものがあります:
|
||||
- ご自分のリポジトリ内の [関連する Issue への参照](/articles/basic-writing-and-formatting-syntax/#referencing-issues-and-pull-requests)。
|
||||
- プルリクエストで提案された変更の説明。
|
||||
- レビューを行っている提案された変更の責任を負う個人またはチームの [@mentions](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams)。
|
||||
{% data reusables.files.write_commit_message %} {% data reusables.files.choose_commit_branch %} テンプレートがリポジトリの既定のブランチにマージされると、コラボレーターがテンプレートを使用できるようになります。
|
||||
{% data reusables.files.propose_new_file %}
|
||||
|
||||
## Further reading
|
||||
## 参考資料
|
||||
|
||||
- "[About issue and pull request templates](/articles/about-issue-and-pull-request-templates)"
|
||||
- "[About automation for issues and pull requests with query parameters](/articles/about-automation-for-issues-and-pull-requests-with-query-parameters)"
|
||||
- "[Creating a pull request](/articles/creating-a-pull-request)"
|
||||
- [Issue と pull request テンプレートについて](/articles/about-issue-and-pull-request-templates)
|
||||
- [クエリ パラメーターを使用した Issue および pull request の自動化について](/articles/about-automation-for-issues-and-pull-requests-with-query-parameters)
|
||||
- [pull request の作成方法](/articles/creating-a-pull-request)
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: About apps
|
||||
intro: 'You can build integrations with the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} APIs to add flexibility and reduce friction in your own workflow.{% ifversion fpt or ghec %} You can also share integrations with others on [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace).{% endif %}'
|
||||
title: アプリケーションについて
|
||||
intro: '{% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API でインテグレーションを構築し、柔軟性を強化して自分のワークフローの摩擦を軽減できます。{% ifversion fpt or ghec %}また、[{% data variables.product.prodname_marketplace %}](https://github.com/marketplace) で他のユーザーとインテグレーションを共有することも可能です。{% endif %}'
|
||||
redirect_from:
|
||||
- /apps/building-integrationssetting-up-a-new-integration
|
||||
- /apps/building-integrations
|
||||
@@ -14,93 +14,99 @@ versions:
|
||||
ghec: '*'
|
||||
topics:
|
||||
- GitHub Apps
|
||||
ms.openlocfilehash: a66af14f6047b2aff435ac4ac8dc83d7a1181e92
|
||||
ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 10/25/2022
|
||||
ms.locfileid: '148107358'
|
||||
---
|
||||
Apps on {% data variables.product.prodname_dotcom %} allow you to automate and improve your workflow. You can build apps to improve your workflow.{% ifversion fpt or ghec %} You can also share or sell apps in [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace). To learn how to list an app on {% data variables.product.prodname_marketplace %}, see "[Getting started with GitHub Marketplace](/marketplace/getting-started/)."{% endif %}
|
||||
{% data variables.product.prodname_dotcom %} のアプリケーションを使用すると、ワークフローを自動化し改善できます。 アプリをビルドしてワークフローを改善できます。{% ifversion fpt or ghec %} また、[{% data variables.product.prodname_marketplace %}](https://github.com/marketplace) でアプリを共有または販売することもできます。 {% data variables.product.prodname_marketplace %} にアプリを掲載する方法については、[GitHub Marketplace の概要](/marketplace/getting-started/)を参照してください。{% endif %}
|
||||
|
||||
{% data reusables.marketplace.github_apps_preferred %}, but GitHub supports both {% data variables.product.prodname_oauth_apps %} and {% data variables.product.prodname_github_apps %}. For information on choosing a type of app, see "[Differences between GitHub Apps and OAuth Apps](/developers/apps/differences-between-github-apps-and-oauth-apps)."
|
||||
{% data reusables.marketplace.github_apps_preferred %}。ただし、GitHub は {% data variables.product.prodname_oauth_apps %} と {% data variables.product.prodname_github_apps %} の両方をサポートしています。 アプリの種類の選択については、「[GitHub App と OAuth App の違い](/developers/apps/differences-between-github-apps-and-oauth-apps)」を参照してください。
|
||||
|
||||
{% data reusables.apps.general-apps-restrictions %}
|
||||
|
||||
For a walkthrough of the process of building a {% data variables.product.prodname_github_app %}, see "[Building Your First {% data variables.product.prodname_github_app %}](/apps/building-your-first-github-app)."
|
||||
{% data variables.product.prodname_github_app %} をビルドする手順については、「[最初の {% data variables.product.prodname_github_app %} のビルド](/apps/building-your-first-github-app)」を参照してください。
|
||||
|
||||
## About {% data variables.product.prodname_github_apps %}
|
||||
## {% data variables.product.prodname_github_apps %} について
|
||||
|
||||
{% data variables.product.prodname_github_apps %} are first-class actors within GitHub. A {% data variables.product.prodname_github_app %} acts on its own behalf, taking actions via the API directly using its own identity, which means you don't need to maintain a bot or service account as a separate user.
|
||||
{% data variables.product.prodname_github_apps %} は GitHub の中でも主役級の存在です。 {% data variables.product.prodname_github_app %} は独自で動作し、独自の ID を使用して API 経由で直接アクションを実行します。つまり、ボットやサービスアカウントを別途維持する必要がありません。
|
||||
|
||||
{% data variables.product.prodname_github_apps %} can be installed directly on organizations and personal accounts and granted access to specific repositories. They come with built-in webhooks and narrow, specific permissions. When you set up your {% data variables.product.prodname_github_app %}, you can select the repositories you want it to access. For example, you can set up an app called `MyGitHub` that writes issues in the `octocat` repository and _only_ the `octocat` repository. To install a {% data variables.product.prodname_github_app %}, you must be an organization owner or have admin permissions in a repository.
|
||||
{% data variables.product.prodname_github_apps %} は、Organization や個人アカウントに直接インストールでき、特定のリポジトリへのアクセス権を付与できます。 精細なアクセス権限が付いており、webhook が組み込まれています。 {% data variables.product.prodname_github_app %} をセットアップする際、アクセスさせるリポジトリを選択できます。 たとえば、リポジトリに問題を書き込み、リポジトリ`MyGitHub`のみに`octocat`_書_ き込むアプリを`octocat`設定できます。 {% data variables.product.prodname_github_app %} をインストールするには、Organization のオーナーであるか、リポジトリで管理者権限を持っている必要があります。
|
||||
|
||||
{% data reusables.apps.app_manager_role %}
|
||||
|
||||
{% data variables.product.prodname_github_apps %} are applications that need to be hosted somewhere. For step-by-step instructions that cover servers and hosting, see "[Building Your First {% data variables.product.prodname_github_app %}](/apps/building-your-first-github-app)."
|
||||
{% data variables.product.prodname_github_apps %} は、どこかにホストする必要があるアプリケーションです。 サーバーとホスティングに関する詳しい手順については、「[最初の {% data variables.product.prodname_github_app %} のビルド](/apps/building-your-first-github-app)」をご覧ください。
|
||||
|
||||
To improve your workflow, you can create a {% data variables.product.prodname_github_app %} that contains multiple scripts or an entire application, and then connect that app to many other tools. For example, you can connect {% data variables.product.prodname_github_apps %} to GitHub, Slack, other in-house apps you may have, email programs, or other APIs.
|
||||
ワークフローを改善するため、複数のスクリプトまたはアプリケーション全体を含む {% data variables.product.prodname_github_app %} を作成し、それをその他の数多くのツールと接続できます。 たとえば、{% data variables.product.prodname_github_apps %} を GitHub、Slack、その他の社内アプリケーション、電子メールプログラム、その他の API などに接続できます。
|
||||
|
||||
Keep these ideas in mind when creating {% data variables.product.prodname_github_apps %}:
|
||||
{% data variables.product.prodname_github_apps %} を作成する際は、以下に気を付けてください。
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
* {% data reusables.apps.maximum-github-apps-allowed %} {% endif %}
|
||||
* A {% data variables.product.prodname_github_app %} should take actions independent of a user (unless the app is using a [user-to-server](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps#user-to-server-requests) token). {% data reusables.apps.expiring_user_authorization_tokens %}
|
||||
* {% data variables.product.prodname_github_app %} は、(アプリが[ユーザーからサーバーへの](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps#user-to-server-requests)トークンを使用している場合を除き) ユーザーに依存しないアクションを実行する必要があります。 {% data reusables.apps.expiring_user_authorization_tokens %}
|
||||
|
||||
* Make sure the {% data variables.product.prodname_github_app %} integrates with specific repositories.
|
||||
* The {% data variables.product.prodname_github_app %} should connect to a personal account or an organization.
|
||||
* Don't expect the {% data variables.product.prodname_github_app %} to know and do everything a user can.
|
||||
* Don't use a {% data variables.product.prodname_github_app %} if you just need a "Login with GitHub" service. But a {% data variables.product.prodname_github_app %} can use a [user identification flow](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/) to log users in _and_ do other things.
|
||||
* Don't build a {% data variables.product.prodname_github_app %} if you _only_ want to act as a GitHub user and do everything that user can do.{% ifversion fpt or ghec %}
|
||||
* {% data variables.product.prodname_github_app %} は、必ず特定のリポジトリと統合するようにしてください。
|
||||
* {% data variables.product.prodname_github_app %} は個人アカウントまたは Organization に接続する必要があります。
|
||||
* ユーザができる全てのことを {% data variables.product.prodname_github_app %} が知り、行えるとは思わないでください。
|
||||
* 単に「GitHub でログイン」するサービスが必要な場合は、{% data variables.product.prodname_github_app %} を使用しないでください。 ただし、{% data variables.product.prodname_github_app %} では [、ユーザー識別フロー](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/) を使用してユーザーをログイン _させ、_ 他の操作を実行できます。
|
||||
* GitHub ユーザーとして動作し、ユーザーが実行できることをすべて実行したい _だけ_ の場合は、{% data variables.product.prodname_github_app %} をビルドしないでください。{% ifversion fpt or ghec %}
|
||||
* {% data reusables.apps.general-apps-restrictions %}{% endif %}
|
||||
|
||||
To begin developing {% data variables.product.prodname_github_apps %}, start with "[Creating a {% data variables.product.prodname_github_app %}](/apps/building-github-apps/creating-a-github-app/)."{% ifversion fpt or ghec %} To learn how to use {% data variables.product.prodname_github_app %} Manifests, which allow people to create preconfigured {% data variables.product.prodname_github_apps %}, see "[Creating {% data variables.product.prodname_github_apps %} from a manifest](/apps/building-github-apps/creating-github-apps-from-a-manifest/)."{% endif %}
|
||||
{% data variables.product.prodname_github_apps %} アプリケーションの開発を始めるには、「[{% data variables.product.prodname_github_app %} の作成](/apps/building-github-apps/creating-a-github-app/)」から取りかかってください。{% ifversion fpt or ghec %}構成済みの {% data variables.product.prodname_github_apps %} を作成できる {% data variables.product.prodname_github_app %} マニフェストの使い方については、「[マニフェストからの {% data variables.product.prodname_github_apps %} の作成](/apps/building-github-apps/creating-github-apps-from-a-manifest/)」を参照してください。{% endif %}
|
||||
|
||||
## About {% data variables.product.prodname_oauth_apps %}
|
||||
## {% data variables.product.prodname_oauth_apps %} について
|
||||
|
||||
OAuth2 is a protocol that lets external applications request authorization to private details in a user's {% data variables.product.prodname_dotcom %} account without accessing their password. This is preferred over Basic Authentication because tokens can be limited to specific types of data and can be revoked by users at any time.
|
||||
OAuth2 は、外部アプリケーションがパスワードにアクセスすることなく、ユーザの {% data variables.product.prodname_dotcom %} アカウントの個人情報にアクセスする承認を要求できるようにするプロトコルです。 これは Basic 認証よりも好ましい方法です。なぜなら、トークンは特定の種類のデータに限定でき、ユーザがいつでも取り消すことができるからです。
|
||||
|
||||
{% data reusables.apps.deletes_ssh_keys %}
|
||||
|
||||
An {% data variables.product.prodname_oauth_app %} uses {% data variables.product.prodname_dotcom %} as an identity provider to authenticate as the user who grants access to the app. This means when a user grants an {% data variables.product.prodname_oauth_app %} access, they grant permissions to _all_ repositories they have access to in their account, and also to any organizations they belong to that haven't blocked third-party access.
|
||||
{% data variables.product.prodname_oauth_app %} は、アプリケーションにアクセス権を付与するユーザを認証するため、アイデンティティプロバイダとして {% data variables.product.prodname_dotcom %} を使用します。 つまり、ユーザーが {% data variables.product.prodname_oauth_app %} アクセスを許可すると、ユーザーは自分のアカウントでアクセスできる _すべての_ リポジトリにアクセス許可を付与します。また、サードパーティのアクセスをブロックしていない組織にもアクセス許可を付与します。
|
||||
|
||||
Building an {% data variables.product.prodname_oauth_app %} is a good option if you are creating more complex processes than a simple script can handle. Note that {% data variables.product.prodname_oauth_apps %} are applications that need to be hosted somewhere.
|
||||
単純なスクリプトで処理できるよりも複雑なプロセスを作成する場合、{% data variables.product.prodname_oauth_app %} を構築するのは良い選択肢です。 {% data variables.product.prodname_oauth_apps %} は、どこかにホストする必要があるアプリケーションであることに注意してください。
|
||||
|
||||
Keep these ideas in mind when creating {% data variables.product.prodname_oauth_apps %}:
|
||||
{% data variables.product.prodname_oauth_apps %} を作成する際は、以下に気を付けてください。
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
* {% data reusables.apps.maximum-oauth-apps-allowed %} {% endif %}
|
||||
* An {% data variables.product.prodname_oauth_app %} should always act as the authenticated {% data variables.product.prodname_dotcom %} user across all of {% data variables.product.prodname_dotcom %} (for example, when providing user notifications).
|
||||
* An {% data variables.product.prodname_oauth_app %} can be used as an identity provider by enabling a "Login with {% data variables.product.prodname_dotcom %}" for the authenticated user.
|
||||
* Don't build an {% data variables.product.prodname_oauth_app %} if you want your application to act on a single repository. With the `repo` OAuth scope, {% data variables.product.prodname_oauth_apps %} can act on _all_ of the authenticated user's repositories.
|
||||
* Don't build an {% data variables.product.prodname_oauth_app %} to act as an application for your team or company. {% data variables.product.prodname_oauth_apps %} authenticate as a single user, so if one person creates an {% data variables.product.prodname_oauth_app %} for a company to use, and then they leave the company, no one else will have access to it.{% ifversion fpt or ghec %}
|
||||
* {% data variables.product.prodname_oauth_app %} は、{% data variables.product.prodname_dotcom %} 全体にわたって、常に認証された {% data variables.product.prodname_dotcom %} ユーザとして振る舞う必要があります (たとえば、ユーザ通知を行う場合など)。
|
||||
* 認証されたユーザに対して「{% data variables.product.prodname_dotcom %} でログイン」を有効化することにより、{% data variables.product.prodname_oauth_app %} をアイデンティティプロバイダとして使用できます。
|
||||
* 単一のリポジトリで動作するアプリケーションが必要な場合、{% data variables.product.prodname_oauth_app %} を構築しないでください。 OAuth スコープを `repo` 使用すると、{% data variables.product.prodname_oauth_apps %} は、認証 _されたすべての_ ユーザーのリポジトリで動作できます。
|
||||
* Team や企業を代理するアプリケーションとして {% data variables.product.prodname_oauth_app %} を構築しないでください。 {% data variables.product.prodname_oauth_apps %} は単一のユーザとして認証を行うので、ある人が {% data variables.product.prodname_oauth_app %} を会社が使用するものとして作成し、その人が会社を辞めた場合は、他の人がアクセスできなくなります。{% ifversion fpt or ghec %}
|
||||
* {% data reusables.apps.oauth-apps-restrictions %}{% endif %}
|
||||
|
||||
For more on {% data variables.product.prodname_oauth_apps %}, see "[Creating an {% data variables.product.prodname_oauth_app %}](/apps/building-oauth-apps/creating-an-oauth-app/)" and "[Registering your app](/rest/guides/basics-of-authentication#registering-your-app)."
|
||||
{% data variables.product.prodname_oauth_apps %} について詳しくは、「[{% data variables.product.prodname_oauth_app %} の作成](/apps/building-oauth-apps/creating-an-oauth-app/)」および「[アプリの登録](/rest/guides/basics-of-authentication#registering-your-app)」をご覧ください。
|
||||
|
||||
## {% data variables.product.pat_generic_caps %}s
|
||||
## {% data variables.product.pat_generic_caps %}
|
||||
|
||||
A [{% data variables.product.pat_generic %}](/articles/creating-a-personal-access-token-for-the-command-line/) is a string of characters that functions similarly to an [OAuth token](/apps/building-oauth-apps/authorizing-oauth-apps/) in that you can specify its permissions via [scopes](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/). A {% data variables.product.pat_generic %} is also similar to a password, but you can have many of them and you can revoke access to each one at any time.
|
||||
[{% data variables.product.pat_generic %}](/articles/creating-a-personal-access-token-for-the-command-line/)は、[スコープ](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/)を使用してそのアクセス許可を指定できる点で [OAuth トークン](/apps/building-oauth-apps/authorizing-oauth-apps/)と同様に機能する文字の文字列です。 また、{% data variables.product.pat_generic %}はパスワードとも似ています。ただし、個人アクセストークンは複数所有でき、それぞれのアクセス権をいつでも取り消すことができます。
|
||||
|
||||
As an example, you can enable a {% data variables.product.pat_generic %} to write to your repositories. If then you run a cURL command or write a script that [creates an issue](/rest/reference/issues#create-an-issue) in your repository, you would pass the {% data variables.product.pat_generic %} to authenticate. You can store the {% data variables.product.pat_generic %} as an environment variable to avoid typing it every time you use it.
|
||||
たとえば、{% data variables.product.pat_generic %}にリポジトリへの書き込みをできるように設定できます。 そして、リポジトリで [issue を作成する](/rest/reference/issues#create-an-issue) cURL コマンドを実行するかスクリプトを記述する場合、{% data variables.product.pat_generic %}を渡して認証します。 {% data variables.product.pat_generic %}を環境変数として保存することで、使用のたびに入力することを避けることができます。
|
||||
|
||||
Keep these ideas in mind when using {% data variables.product.pat_generic %}s:
|
||||
{% data variables.product.pat_generic %}を使用する場合は、次の点に注意してください。
|
||||
|
||||
* Remember to use this token to represent yourself only.
|
||||
* You can perform one-off cURL requests.
|
||||
* You can run personal scripts.
|
||||
* Don't set up a script for your whole team or company to use.
|
||||
* Don't set up a shared personal account to act as a bot user.
|
||||
* Grant your token the minimal privileges it needs.
|
||||
* Set an expiration for your {% data variables.product.pat_generic %}s, to help keep your information secure.
|
||||
* トークンは自分自身のみを表すものとして使用してください。
|
||||
* 1 回限りの cURL リクエストを実行できます。
|
||||
* 個人用のスクリプトを実行できます。
|
||||
* Team や会社全体が使用するスクリプトは設定しないでください。
|
||||
* ボット ユーザーとして動作する共有ユーザー アカウントは設定しないでください。
|
||||
* トークンに必要な最小限の特権を付与します。
|
||||
* 情報をセキュリティで保護するために、{% data variables.product.pat_generic %}の有効期限を設定します。
|
||||
|
||||
## Determining which integration to build
|
||||
## 構築すべきインテグレーションを決定する
|
||||
|
||||
Before you get started creating integrations, you need to determine the best way to access, authenticate, and interact with the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} APIs. The following image offers some questions to ask yourself when deciding whether to use {% data variables.product.pat_generic %}s, {% data variables.product.prodname_github_apps %}, or {% data variables.product.prodname_oauth_apps %} for your integration.
|
||||
インテグレーションの作成に取りかかる前に、{% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API を使用したアクセス、認証、対話に最善の方法を見極める必要があります。 統合で{% data variables.product.pat_generic %}、{% data variables.product.prodname_github_apps %}、{% data variables.product.prodname_oauth_apps %} のどれを使用するかを決める際の考慮事項を以下の画像に示しています。
|
||||
|
||||

|
||||

|
||||
|
||||
Consider these questions about how your integration needs to behave and what it needs to access:
|
||||
インテグレーションがどう振る舞うべきか、何にアクセスできるべきかについては、以下の質問を検討してください。
|
||||
|
||||
* Will my integration act only as me, or will it act more like an application?
|
||||
* Do I want it to act independently of me as its own entity?
|
||||
* Will it access everything that I can access, or do I want to limit its access?
|
||||
* Is it simple or complex? For example, {% data variables.product.pat_generic %}s are good for simple scripts and cURLs, whereas an {% data variables.product.prodname_oauth_app %} can handle more complex scripting.
|
||||
* インテグレーションは自分自身としてのみ振る舞うのか、それともアプリケーションのように振る舞うのか?
|
||||
* 独自のエンティティとして、自分から独立して動作させるのか?
|
||||
* 自分がアクセスできるもの全てにアクセスするのか、それともアクセスを制限するのか?
|
||||
* 単純か、それとも複雑か? たとえば、{% data variables.product.pat_generic %}は単純なスクリプトや cURL に適し、{% data variables.product.prodname_oauth_app %} はより複雑なスクリプトを処理できます。
|
||||
|
||||
## Requesting support
|
||||
## サポートのリクエスト
|
||||
|
||||
{% data reusables.support.help_resources %}
|
||||
|
||||
@@ -9,6 +9,8 @@ children:
|
||||
- /managing-categories-for-discussions
|
||||
- /moderating-discussions
|
||||
- /viewing-insights-for-your-discussions
|
||||
- /creating-discussion-category-forms
|
||||
- /syntax-for-discussion-category-forms
|
||||
ms.openlocfilehash: 156460ecfbb27820f11ccad388ceaff069f835b1
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.translationtype: HT
|
||||
|
||||
@@ -1,215 +1,201 @@
|
||||
---
|
||||
title: Managing discussions
|
||||
intro: 'You can categorize, spotlight, transfer, or delete the discussions.'
|
||||
title: ディスカッションを管理する
|
||||
intro: ディスカッションを分類、スポットライト、転送、または削除できます。
|
||||
permissions: Repository administrators and people with write or greater access to a repository can manage discussions in the repository. Repository administrators and people with write or greater access to the source repository for organization discussions can manage discussions in the organization.
|
||||
versions:
|
||||
feature: discussions
|
||||
shortTitle: Manage discussions
|
||||
redirect_from:
|
||||
- /discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository
|
||||
ms.openlocfilehash: e5e1474648973c90d16e8998db18518331233aa3
|
||||
ms.sourcegitcommit: 1529de77bfcbe45519131b5f5fb3ab319758c2d2
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/14/2022
|
||||
ms.locfileid: '148164340'
|
||||
---
|
||||
## ディスカッションの管理について
|
||||
|
||||
{% data reusables.discussions.about-discussions %}詳細については、「[ディスカッションについて](/discussions/collaborating-with-your-community-using-discussions/about-discussions)」を参照してください。
|
||||
|
||||
## About management of discussions
|
||||
組織所有者は、組織が所有するリポジトリのディスカッションを作成するために必要なアクセス許可を選択できます。 同様に、組織のディスカッションを作成するために必要なアクセス許可を選ぶために、組織所有者はソース リポジトリで必要なアクセス許可を変更できます。 詳細については、「[組織内のリポジトリのディスカッション作成を管理する](/organizations/managing-organization-settings/managing-discussion-creation-for-repositories-in-your-organization)」を参照してください。
|
||||
|
||||
{% data reusables.discussions.about-discussions %} For more information about discussions, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)."
|
||||
ディスカッションのメンテナとして、コミュニティリソースを作成して、プロジェクト全体の目標に沿ったディスカッションを促し、コラボレータのための親しみやすいオープンフォーラムを維持できます。 コラボレーターが従う{% ifversion fpt or ghec %}行動規範または{% endif %}コントリビューション ガイドラインを作成することは、協力的で生産的なフォーラムを促進するのに役立ちます。 コミュニティ リソースの作成について詳しくは、{% ifversion fpt or ghec %}「[プロジェクトへの行動規範の追加](/communities/setting-up-your-project-for-healthy-contributions/adding-a-code-of-conduct-to-your-project)」と{% endif %}「[リポジトリ コントリビューターのためのガイドラインを定める](/communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors)」を参照してください。
|
||||
|
||||
Organization owners can choose the permissions required to create a discussion in repositories owned by the organization. Similarly, to choose the permissions required to create an organization discussion, organization owners can change the permissions required in the source repository. For more information, see "[Managing discussion creation for repositories in your organization](/organizations/managing-organization-settings/managing-discussion-creation-for-repositories-in-your-organization)."
|
||||
すぐに取り組むことができるアイデアやバグがディスカッションから生まれた場合は、ディスカッションから新しい issue を作成できます。 詳細については、「[Issue の作成](/issues/tracking-your-work-with-issues/creating-an-issue#creating-an-issue-from-a-discussion)」を参照してください。
|
||||
|
||||
As a discussions maintainer, you can create community resources to encourage discussions that are aligned with the overall project goal and maintain a friendly open forum for collaborators. Creating{% ifversion fpt or ghec %} a code of conduct or{% endif %} contribution guidelines for collaborators to follow will help facilitate a collaborative and productive forum. For more information on creating community resources, see{% ifversion fpt or ghec %} "[Adding a code of conduct to your project](/communities/setting-up-your-project-for-healthy-contributions/adding-a-code-of-conduct-to-your-project)," and{% endif %} "[Setting guidelines for repository contributors](/communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors)."
|
||||
リポジトリまたは組織のディスカッション一覧の先頭に、ディスカッションをピン留めできます。 {% ifversion discussions-category-specific-pins %}ディスカッションを特定のカテゴリにピン留めすることもできます。{% endif %}詳細については、「[ディスカッションをピン留めする](/discussions/managing-discussions-for-your-community/managing-discussions#pinning-a-discussion)」を参照してください。
|
||||
|
||||
When a discussion yields an idea or bug that is ready to be worked on, you can create a new issue from a discussion. For more information, see "[Creating an issue](/issues/tracking-your-work-with-issues/creating-an-issue#creating-an-issue-from-a-discussion)."
|
||||
|
||||
You can pin a discussion to the top of the list of discussions for the repository or organization. {% ifversion discussions-category-specific-pins %}You can also pin a discussion to a specific category.{% endif %} For more information, see "[Pinning a discussion](/discussions/managing-discussions-for-your-community/managing-discussions#pinning-a-discussion)."
|
||||
|
||||
For more information on facilitating a healthy discussion, see "[Moderating comments and conversations](/communities/moderating-comments-and-conversations)."
|
||||
健全なディスカッションの促進については、「[コメントおよび会話をモデレートする](/communities/moderating-comments-and-conversations)」を参照してください。
|
||||
|
||||
{% data reusables.discussions.you-can-label-discussions %}
|
||||
|
||||
## Prerequisites
|
||||
## 前提条件
|
||||
|
||||
To manage discussions in a repository, {% data variables.product.prodname_discussions %} must be enabled for the repository. For more information, see "[Enabling or disabling {% data variables.product.prodname_discussions %} for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)."
|
||||
リポジトリ内のディスカッションを管理するには、そのリポジトリに対して {% data variables.product.prodname_discussions %} を有効にする必要があります。 詳細については、「[リポジトリの {% data variables.product.prodname_discussions %} を有効化または無効化する](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)」を参照してください。
|
||||
|
||||
To manage discussions in an organization, {% data variables.product.prodname_discussions %} must be enabled for the organization. For more information, see "[Enabling or disabling {% data variables.product.prodname_discussions %} for an organization](/organizations/managing-organization-settings/enabling-or-disabling-github-discussions-for-an-organization)."
|
||||
組織内のディスカッションを管理するには、その組織に対して {% data variables.product.prodname_discussions %} を有効にする必要があります。 詳細については、「[リポジトリの {% data variables.product.prodname_discussions %} を有効化または無効化する](/organizations/managing-organization-settings/enabling-or-disabling-github-discussions-for-an-organization)」を参照してください。
|
||||
|
||||
## Changing the category for a discussion
|
||||
## ディスカッションのカテゴリを変更する
|
||||
|
||||
You can categorize discussions to help community members find related discussions. For more information, see "[Managing categories for discussions](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions)."
|
||||
ディスカッションを分類して、コミュニティメンバーが関連するディスカッションを見つけやすくすることができます。 詳細については、「[ディスカッションのカテゴリの管理](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions)」を参照してください。
|
||||
|
||||
You can also move a discussion to a different category. It's not possible to move a discussion to or from the polls category.
|
||||
ディスカッションを別のカテゴリに移動することもできます。 ディスカッションを投票カテゴリに移動する、またはそこから移動することはできません。
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.discussions.discussions-tab %}
|
||||
{% data reusables.discussions.click-discussion-in-list %}
|
||||
1. In the right sidebar, to the right of "Category", click {% octicon "gear" aria-label="The gear icon" %}.
|
||||
{% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %}
|
||||
1. 右サイドバーにある [カテゴリ] の右の {% octicon "gear" aria-label="The gear icon" %} をクリックします。
|
||||
|
||||

|
||||
![歯車アイコンが表示された [Category] のスクリーンショット](/assets/images/help/discussions/category-in-sidebar.png)
|
||||
|
||||
1. Click a category.
|
||||
1. カテゴリをクリックします。
|
||||
|
||||

|
||||
![[Change category] ドロップダウン メニューのスクリーンショット](/assets/images/help/discussions/change-category-drop-down.png)
|
||||
|
||||
## Pinning a discussion
|
||||
## ディスカッションをピン留めする
|
||||
|
||||
{% ifversion discussions-category-specific-pins %}
|
||||
You can pin a discussion above the list of discussions for the repository or organization. You can also pin a discussion to a specific category. The globally pinned discussions will be shown in addition to the discussions pinned to a specific category.
|
||||
{% ifversion discussions-category-specific-pins %}リポジトリまたは組織のディスカッション一覧の上にディスカッションをピン留めできます。 また、ディスカッションを特定のカテゴリにピン止めすることもできます。 グローバルにピン留めされたディスカッションは、特定のカテゴリにピン留めされたディスカッションに加えて表示されます。
|
||||
|
||||
This is what it looks like when you have a globally pinned discussion and a discussion pinned to the Ideas category.
|
||||
グローバルにピン留めされたディスカッションと、[Ideas] カテゴリにピン留めされたディスカッションがある場合の外観は、次のようになります。
|
||||
|
||||

|
||||
![グローバルにピン留めされたディスカッションと [Ideas] カテゴリにピン留めされたディスカッションのスクリーンショット](/assets/images/help/discussions/overview-pinned-discussions.png)
|
||||
|
||||
### Pinning a discussion globally
|
||||
### ディスカッションをグローバルにピン留めする
|
||||
{% endif %}
|
||||
|
||||
You can pin up to four important discussions above the list of discussions for the repository or organization.
|
||||
リポジトリまたは組織のディスカッション一覧の上に、最大 4 つの重要なディスカッションをピン留めできます。
|
||||
|
||||
|
||||
{% data reusables.discussions.navigate-to-repo-or-org %}
|
||||
{% data reusables.discussions.discussions-tab %}
|
||||
{% data reusables.discussions.click-discussion-in-list %}
|
||||
1. In the right sidebar, click {% octicon "pin" aria-label="The pin icon" %} **Pin discussion**.
|
||||
{% data reusables.discussions.navigate-to-repo-or-org %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %}
|
||||
1. 右サイドバーにある {% octicon "pin" aria-label="The pin icon" %} **[Pin discussion]\(ディスカッションのピン留め\)** をクリックします。
|
||||
{% ifversion discussions-category-specific-pins %}
|
||||
|
||||
{% else %}
|
||||
![ディスカッションの右側のサイド バーにある [Pin discussion] オプションのスクリーンショット](/assets/images/help/discussions/click-pin-discussion-with-category-pins.png){% else %}
|
||||
|
||||
{% endif %}
|
||||
![ディスカッションの右側のサイド バーにある [Pin discussion] オプションのスクリーンショット](/assets/images/help/discussions/click-pin-discussion.png){% endif %}
|
||||
|
||||
1. Optionally, customize the look of the pinned discussion.
|
||||
1. 必要に応じて、ピン留めされたディスカッションの外観をカスタマイズします。
|
||||
|
||||

|
||||

|
||||
|
||||
1. Click **Pin discussion**.
|
||||
1. **[Pin discussion]\(ディスカッションのピン留め\)** をクリックします。
|
||||
|
||||

|
||||
![ピン留めされたディスカッションのカスタマイズ オプションの下にある [Pin discussion] ボタンのスクリーンショット](/assets/images/help/discussions/click-pin-discussion-button.png)
|
||||
|
||||
{% ifversion discussions-category-specific-pins %}
|
||||
### Pinning a discussion to a category
|
||||
### ディスカッションをカテゴリにピン留めする
|
||||
|
||||
You can pin up to four important discussions above the list of discussions in a specific category.
|
||||
特定のカテゴリのディスカッション一覧の上に、最大 4 つの重要なディスカッションをピン留めできます。
|
||||
|
||||
{% data reusables.discussions.navigate-to-repo-or-org %}
|
||||
{% data reusables.discussions.discussions-tab %}
|
||||
{% data reusables.discussions.click-discussion-in-list %}
|
||||
1. In the right sidebar, click {% octicon "pin" aria-label="The pin icon" %} **Pin discussion to CATEGORY**.
|
||||
{% data reusables.discussions.navigate-to-repo-or-org %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %}
|
||||
1. 右側のサイド バーにある {% octicon "pin" aria-label="The pin icon" %} **[Pin discussion to CATEGORY]** をクリックします。
|
||||
|
||||

|
||||
![ディスカッションの右側のサイド バーにある [Pin discussion to CATEGORY] オプションのスクリーンショット](/assets/images/help/discussions/pin-discussion-to-category.png)
|
||||
|
||||
2. To confirm, click **Pin to CATEGORY**.
|
||||
2. 確定するには、 **[Pin to CATEGORY]** をクリックします。
|
||||
|
||||

|
||||
![[Pin discussion to CATEGORY] モーダルのスクリーンショット](/assets/images/help/discussions/pin-discussion-to-category-modal.png)
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Editing a pinned discussion
|
||||
## ピン留めされたディスカッションを編集する
|
||||
|
||||
Editing a pinned discussion will not change the discussion's category. For more information, see "[Managing categories for discussions](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions)."
|
||||
ピン留めされたディスカッションを編集しても、ディスカッションのカテゴリは変更されません。 詳細については、「[ディスカッションのカテゴリの管理](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions)」を参照してください。
|
||||
|
||||
{% data reusables.discussions.navigate-to-repo-or-org %}
|
||||
{% data reusables.discussions.discussions-tab %}
|
||||
{% data reusables.discussions.click-discussion-in-list %}
|
||||
1. In the right sidebar, click {% octicon "pencil" aria-label="The pencil icon" %} **Edit pinned discussion**.
|
||||
{% data reusables.discussions.navigate-to-repo-or-org %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %}
|
||||
1. 右サイドバーにある {% octicon "pencil" aria-label="The pencil icon" %} **[Edit pinned discussion]\(ピン留めされたディスカッションの編集\)** をクリックします。
|
||||
{% ifversion discussions-category-specific-pins %}
|
||||
|
||||
 {% else %}
|
||||
![ディスカッションの右側のサイド バーにある [Edit pinned discussion] オプションのスクリーンショット](/assets/images/help/discussions/edit-pinned-discussion-with-category-pins.png) {% else %}
|
||||
|
||||
|
||||
{% endif %}
|
||||
![ディスカッションの右側のサイド バーにある [Edit pinned discussion] オプションのスクリーンショット](/assets/images/help/discussions/click-edit-pinned-discussion.png){% endif %}
|
||||
|
||||
1. Customize the look of the pinned discussion.
|
||||
1. ピン留めされたディスカッションの外観をカスタマイズします。
|
||||
|
||||

|
||||

|
||||
|
||||
1. Click **Pin discussion**.
|
||||
1. **[Pin discussion]\(ディスカッションのピン留め\)** をクリックします。
|
||||
|
||||

|
||||
![ピン留めされたディスカッションのカスタマイズ オプションの下にある [Pin discussion] ボタンのスクリーンショット](/assets/images/help/discussions/click-pin-discussion-button.png)
|
||||
|
||||
## Unpinning a discussion
|
||||
## ディスカッションをピン留め解除する
|
||||
|
||||
{% ifversion discussions-category-specific-pins %}
|
||||
|
||||
You can unpin a discussion from the list of discussions for the repository or organization, or from the list of discussions in a specific category.
|
||||
リポジトリまたは組織のディスカッション一覧から、または特定のカテゴリのディスカッション一覧から、ディスカッションのピン留めを解除できます。
|
||||
|
||||
### Unpinning a globally pinned discussion
|
||||
### グローバルにピン留めされたディスカッションのピン留めを解除する
|
||||
|
||||
You can unpin a globally pinned discussion. This will not delete the discussion, but the discussion will no longer be displayed above the list of discussions.
|
||||
グローバルにピン留めされたディスカッションのピン留めを解除できます。 これによってディスカッションは削除されませんが、ディスカッション一覧の上には表示されなくなります。
|
||||
{% endif %}
|
||||
|
||||
{% data reusables.discussions.navigate-to-repo-or-org %}
|
||||
{% data reusables.discussions.discussions-tab %}
|
||||
{% data reusables.discussions.click-discussion-in-list %}
|
||||
1. In the right sidebar, click {% octicon "pin" aria-label="The pin icon" %} **Unpin discussion**.
|
||||
{% data reusables.discussions.navigate-to-repo-or-org %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %}
|
||||
1. 右サイドバーにある {% octicon "pin" aria-label="The pin icon" %} **[Unpin discussion]\(ディスカッションのピン留めを外す\)** をクリックします。
|
||||
|
||||

|
||||
![ディスカッションの右側のサイド バーにある [Unpin discussion] オプションのスクリーンショット](/assets/images/help/discussions/click-unpin-discussion.png)
|
||||
|
||||
1. Read the warning, then click **Unpin discussion**.
|
||||
1. 警告を読み、 **[Unpin discussion]\(ディスカッションのピン留めを外す\)** をクリックします。
|
||||
|
||||

|
||||
![モーダルの警告の下にある [Unpin discussion] ボタンのスクリーンショット](/assets/images/help/discussions/click-unpin-discussion-button.png)
|
||||
|
||||
{% ifversion discussions-category-specific-pins %}
|
||||
### Unpinning a discussion from a category
|
||||
### カテゴリからディスカッションのピン留めを解除する
|
||||
|
||||
You can unpin a discussion pinned to a specific category. This will not delete the discussion, but the discussion will no longer be displayed at the top of the category.
|
||||
特定のカテゴリにピン留めされたディスカッションのピン留めを解除できます。 これによってディスカッションは削除されませんが、カテゴリの上部には表示されなくなります。
|
||||
|
||||
{% data reusables.discussions.navigate-to-repo-or-org %}
|
||||
{% data reusables.discussions.discussions-tab %}
|
||||
{% data reusables.discussions.click-discussion-in-list %}
|
||||
1. In the right sidebar, click {% octicon "pin" aria-label="The pin icon" %} **Unpin discussion from this category**.
|
||||
{% data reusables.discussions.navigate-to-repo-or-org %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %}
|
||||
1. 右側のサイド バーにある {% octicon "pin" aria-label="The pin icon" %} **[Unpin discussion from this category]** をクリックします。
|
||||
|
||||

|
||||
![ディスカッションの右側のサイド バーにある [Unpin discussion from this category] オプションのスクリーンショット](/assets/images/help/discussions/unpin-discussion-from-category.png)
|
||||
|
||||
1. Read the warning, then click **Unpin from this category**.
|
||||
1. 警告を読んでから、 **[Unpin from this category]** をクリックします。
|
||||
|
||||

|
||||
![[Unpin this discussion from this category] モーダルの [Unpin from this category] ボタンのスクリーンショット](/assets/images/help/discussions/unpin-discussion-from-category-modal.png)
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Transferring a discussion
|
||||
## ディスカッションを移譲する
|
||||
|
||||
To transfer a discussion, you must have permissions to create discussions in the repository where you want to transfer the discussion. If you want to transfer a discussion to an organization, you must have permissions to create discussions in the source repository for the organization's discussions. You can only transfer discussions between repositories owned by the same user or organization account. You can't transfer a discussion from a private{% ifversion ghec or ghes %} or internal{% endif %} repository to a public repository.
|
||||
ディスカッションを移譲するには、ディスカッションを移譲するリポジトリにディスカッションを作成する権限が必要です。 ディスカッションを組織に移譲する場合、組織のディスカッション用ソース リポジトリ内にディスカッションを作成するアクセス許可を持っている必要があります。 ディスカッションを移譲できるのは、同じユーザーまたは組織アカウントが所有するリポジトリ間のみです。 プライベート{% ifversion ghec or ghes %}または内部{% endif %}リポジトリからパブリック リポジトリにディスカッションを移譲することはできません。
|
||||
|
||||
{% data reusables.discussions.navigate-to-repo-or-org %}
|
||||
{% data reusables.discussions.discussions-tab %}
|
||||
{% data reusables.discussions.click-discussion-in-list %}
|
||||
1. In the right sidebar, click {% octicon "arrow-right" aria-label="The right arrow icon" %} {% ifversion discussions-category-specific-pins %}**Transfer this discussion**{% else %}**Transfer discussion**{% endif %}.
|
||||
{% data reusables.discussions.navigate-to-repo-or-org %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %}
|
||||
1. 右側のサイド バーで、{% octicon "arrow-right" aria-label="The right arrow icon" %} {% ifversion discussions-category-specific-pins %} **[Transfer this discussion]** {% else %} **[Transfer discussion]** {% endif %} をクリックします。
|
||||
{% ifversion discussions-category-specific-pins %}
|
||||
|
||||
 {% else %}
|
||||
![ディスカッションの右側のサイド バーにある [Transfer discussion] オプションのスクリーンショット](/assets/images/help/discussions/transfer-discussion-with-category-pin.png) {% else %}
|
||||
|
||||
|
||||
{% endif %}
|
||||
![ディスカッションの右側のサイド バーにある [Transfer discussion] オプションのスクリーンショット](/assets/images/help/discussions/click-transfer-discussion.png){% endif %}
|
||||
|
||||
1. Select the **Choose a repository** drop-down, and click the repository you want to transfer the discussion to. If you want to transfer a discussion to an organization, choose the source repository for the organization's discussions.
|
||||
1. **[Choose a repository]\(リポジトリの選択\)** ドロップダウンを選び、ディスカッションの移譲先のリポジトリをクリックします。 組織にディスカッションを移譲する場合、組織のディスカッション用ソース リポジトリを選びます。
|
||||
|
||||

|
||||
![[Choose a repository] ドロップダウン、[Find a repository] 検索フィールド、リスト内のリポジトリのスクリーンショット](/assets/images/help/discussions/use-choose-a-repository-drop-down.png)
|
||||
|
||||
1. Click **Transfer discussion**.
|
||||
1. **[Transfer discussion]\(ディスカッションの移譲\)** をクリックします。
|
||||
|
||||

|
||||
![[Transfer discussion] ボタンのスクリーンショット](/assets/images/help/discussions/click-transfer-discussion-button.png)
|
||||
|
||||
## Deleting a discussion
|
||||
## ディスカッションを削除する
|
||||
|
||||
{% data reusables.discussions.navigate-to-repo-or-org %}
|
||||
{% data reusables.discussions.discussions-tab %}
|
||||
{% data reusables.discussions.click-discussion-in-list %}
|
||||
1. In the right sidebar, click {% octicon "trash" aria-label="The trash arrow icon" %} **Delete discussion**.
|
||||
{% data reusables.discussions.navigate-to-repo-or-org %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %}
|
||||
1. 右サイドバーにある {% octicon "trash" aria-label="The trash arrow icon" %} **[Delete discussion]\(ディスカッションの削除\)** をクリックします。
|
||||
{% ifversion discussions-category-specific-pins %}
|
||||
|
||||
{% else %}
|
||||
![ディスカッションの右側のサイド バーにある [Delete discussion] オプションのスクリーンショット](/assets/images/help/discussions/delete-discussion-with-category-pins.png){% else %}
|
||||
|
||||
|
||||
{% endif %}
|
||||
![ディスカッションの右側のサイド バーにある [Delete discussion] オプションのスクリーンショット](/assets/images/help/discussions/click-delete-discussion.png){% endif %}
|
||||
|
||||
1. Read the warning, then click **Delete this discussion**.
|
||||
1. 警告を読み、 **[Delete this discussion]\(このディスカッションを削除する\)** をクリックします。
|
||||
|
||||

|
||||
![モーダルの警告の下にある [Delete this discussion] ボタンのスクリーンショット](/assets/images/help/discussions/click-delete-this-discussion-button.png)
|
||||
|
||||
## Converting issues based on labels
|
||||
## ラベルに基づいて Issue を変換する
|
||||
|
||||
You can convert all issues with the same label to discussions in bulk. Future issues with this label will also automatically convert to the discussion and category you configure.
|
||||
同じラベルのすべての Issue をまとめてディスカッションに変換できます。 このラベルの今後の Issue も、設定したディスカッションとカテゴリに自動的に変換されます。
|
||||
|
||||
1. On {% data variables.location.product_location %}, navigate to the main page of the repository or, for organization discussions, the source repository.
|
||||
{% data reusables.repositories.sidebar-issues %}
|
||||
{% data reusables.project-management.labels %}
|
||||
1. Next to the label you want to convert to issues, click **Convert issues**.
|
||||
1. Select the **Choose a category** drop-down menu, and click a category for your discussion.
|
||||
1. Click **I understand, convert this issue to a discussion**.
|
||||
1. {% data variables.location.product_location %} 上で、リポジトリのメイン ページ (組織のディスカッションの場合はソース リポジトリ) に移動します。
|
||||
{% data reusables.repositories.sidebar-issues %} {% data reusables.project-management.labels %}
|
||||
1. issue に変換するラベルの横にある **[Convert issues]\(issue の変換\)** をクリックします。
|
||||
1. **[カテゴリの選択]** ドロップダウン メニューを選択し、ディスカッションのカテゴリをクリックします。
|
||||
1. **[わかりました、この Issue をディスカッションに変換します]** をクリックします。
|
||||
|
||||
@@ -1,78 +1,84 @@
|
||||
---
|
||||
title: Create a group assignment
|
||||
intro: You can create a collaborative assignment for teams of students who participate in your course.
|
||||
title: グループ課題の作成
|
||||
intro: コースに参加している学生のTeamのために、共同課題を作成できます。
|
||||
versions:
|
||||
fpt: '*'
|
||||
permissions: 'Organization owners who are admins for a classroom can create and manage group assignments for a classroom. {% data reusables.classroom.classroom-admins-link %}'
|
||||
redirect_from:
|
||||
- /education/manage-coursework-with-github-classroom/create-group-assignments
|
||||
- /education/manage-coursework-with-github-classroom/create-a-group-assignment
|
||||
ms.openlocfilehash: 71c5f5eaf97ba58e25921c1e2be6fc638550dfa8
|
||||
ms.sourcegitcommit: 82b1242de02ecc4bdec02a5b6d11568fb2deb1aa
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/21/2022
|
||||
ms.locfileid: '148179761'
|
||||
---
|
||||
## About group assignments
|
||||
## グループ課題について
|
||||
|
||||
{% data reusables.classroom.assignments-group-definition %} Students can work together on a group assignment in a shared repository, like a team of professional developers.
|
||||
{% data reusables.classroom.assignments-group-definition %}学生は、プロフェッショナルな開発者チームと同じように、共有リポジトリでグループ課題に協力して取り組むことができます。
|
||||
|
||||
When a student accepts a group assignment, the student can create a new team or join an existing team. {% data variables.product.prodname_classroom %} saves the teams for an assignment as a set. You can name the set of teams for a specific assignment when you create the assignment, and you can reuse that set of teams for a later assignment.
|
||||
グループ課題を受け入れた学生は、新しいTeamを作成するか、既存のTeamに参加できます。 {% data variables.product.prodname_classroom %}は、課題のためのTeamをセットとして保存します。 課題を作成する際、特定の課題に対するTeamのセットに名前を付けることができます。また、後の課題でTeamのセットを再利用できます。
|
||||
|
||||
{% data reusables.classroom.classroom-creates-group-repositories %}
|
||||
|
||||
{% data reusables.classroom.about-assignments %}
|
||||
|
||||
You can decide how many teams one assignment can have, and how many members each team can have. Each team that a student creates for an assignment is a team within your organization on {% data variables.product.product_name %}. The visibility of the team is secret. Teams that you create on {% data variables.product.product_name %} will not appear in {% data variables.product.prodname_classroom %}. For more information, see "[About teams](/organizations/organizing-members-into-teams/about-teams)."
|
||||
1つの課題に取り組むチームの数と、各Teamのメンバーの数を決めることができます。 学生が課題ために作成する各グループは、{% data variables.product.product_name %}のOrganization内のTeamです。 Teamの可視性はシークレットとなります。 {% data variables.product.product_name %}上で作成したTeamは、{% data variables.product.prodname_classroom %}では表示されません。 詳細については、「[Team について](/organizations/organizing-members-into-teams/about-teams)」を参照してください。
|
||||
|
||||
For a video demonstration of the creation of a group assignment, see "[Basics of setting up {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)."
|
||||
グループ課題の作成のビデオ デモについては、「[{% data variables.product.prodname_classroom %} のセットアップの基本](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)」を参照してください。
|
||||
|
||||
{% data reusables.classroom.reuse-assignment-link %}
|
||||
|
||||
## Prerequisites
|
||||
## 前提条件
|
||||
|
||||
{% data reusables.classroom.assignments-classroom-prerequisite %}
|
||||
|
||||
## Creating an assignment
|
||||
## 課題を作成する
|
||||
|
||||
{% data reusables.classroom.assignments-guide-create-the-assignment %}
|
||||
|
||||
## Setting up the basics for an assignment
|
||||
## 課題の基本情報をセットアップする
|
||||
|
||||
Name your assignment, decide whether to assign a deadline, define teams, and choose the visibility of assignment repositories.
|
||||
課題に名前を付け、期限を設定するか、Teamを定義するかを決定し、課題リポジトリの可視性を選択します。
|
||||
|
||||
- [Naming an assignment](#naming-an-assignment)
|
||||
- [Assigning a deadline for an assignment](#assigning-a-deadline-for-an-assignment)
|
||||
- [Choosing an assignment type](#choosing-an-assignment-type)
|
||||
- [Defining teams for an assignment](#defining-teams-for-an-assignment)
|
||||
- [Choosing a visibility for assignment repositories](#choosing-a-visibility-for-assignment-repositories)
|
||||
- [課題に名前を付ける](#naming-an-assignment)
|
||||
- [課題に期限を設定する](#assigning-a-deadline-for-an-assignment)
|
||||
- [課題のタイプを選択する](#choosing-an-assignment-type)
|
||||
- [課題の Team を定義する](#defining-teams-for-an-assignment)
|
||||
- [課題リポジトリの可視性を選択する](#choosing-a-visibility-for-assignment-repositories)
|
||||
|
||||
### Naming an assignment
|
||||
### 課題に名前を付ける
|
||||
|
||||
For a group assignment, {% data variables.product.prodname_classroom %} names repositories by the repository prefix and the name of the team. By default, the repository prefix is the assignment title. For example, if you name an assignment "assignment-1" and the team's name on {% data variables.product.product_name %} is "student-team", the name of the assignment repository for members of the team will be `assignment-1-student-team`.
|
||||
グループ課題では、{% data variables.product.prodname_classroom %}はリポジトリのプレフィックスとTeamの名前から、リポジトリに名前を付けます。 デフォルトでは、リポジトリのプレフィックスが課題のタイトルとなります。 たとえば、課題に "assignment-1" という名前を付けて、{% data variables.product.product_name %} での Team の名前名が "student-team" である場合、Team のメンバーの課題リポジトリの名前は `assignment-1-student-team` になります。
|
||||
|
||||
{% data reusables.classroom.assignments-type-a-title %}
|
||||
|
||||
### Assigning a deadline for an assignment
|
||||
### 課題に期限を設定する
|
||||
|
||||
{% data reusables.classroom.assignments-guide-assign-a-deadline %}
|
||||
|
||||
### Choosing an assignment type
|
||||
### 課題のタイプを選択する
|
||||
|
||||
Under "Individual or group assignment", select the drop-down menu, then click **Group assignment**. You can't change the assignment type after you create the assignment. If you'd rather create an individual assignment, see "[Create an individual assignment](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)."
|
||||
[個人またはグループの課題] でドロップダウン メニューを選択して、 **[グループの課題]** をクリックします。 課題の作成後は、課題タイプを変更できません。 個人の課題を作成する場合は、「[個人課題の作成](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)」を参照してください。
|
||||
|
||||
### Defining teams for an assignment
|
||||
### 課題のTeamを定義する
|
||||
|
||||
If you've already created a group assignment for the classroom, you can reuse a set of teams for the new assignment. To create a new set with the teams that your students create for the assignment, type the name for the set. Optionally, type the maximum number of team members and total teams.
|
||||
すでにクラスルームに対してグループ課題を作成している場合は、新しい課題にTeamのセットを再利用できます。 学生が課題用に作成したTeamで新しいセットを作成するには、そのセットの名前を入力します。 必要に応じて、Teamメンバーと合計チーム数の上限を入力してください。
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Tips**:
|
||||
**ヒント**:
|
||||
|
||||
- We recommend including details about the set of teams in the name for the set. For example, if you want to use the set of teams for one assignment, name the set after the assignment. If you want to reuse the set throughout a semester or course, name the set after the semester or course.
|
||||
- セットの名前には、Teamのセットについの情報を含めることをお勧めします。 たとえば、1つの課題用にTeamのセットを使う場合は、その課題にちなんだ名前を付けます。 学期またはコースを通じてセットを再利用する場合は、学期またはコースにちなんだ名前を付けます。
|
||||
|
||||
- If you'd like to assign students to a specific team, give your students a name for the team and provide a list of members.
|
||||
- 特定のTeamに学生を割り当てる場合は、学生にTeamの名前を伝え、メンバーのリストを提供します。
|
||||
|
||||
{% endtip %}
|
||||
|
||||

|
||||

|
||||
|
||||
### Choosing a visibility for assignment repositories
|
||||
### 課題リポジトリの可視性を選択する
|
||||
|
||||
{% data reusables.classroom.assignments-repository-visibility-and-permissions %}
|
||||
|
||||
@@ -80,22 +86,22 @@ If you've already created a group assignment for the classroom, you can reuse a
|
||||
|
||||
{% data reusables.classroom.assignments-guide-click-continue-after-basics %}
|
||||
|
||||
## Adding starter code and configuring a development environment
|
||||
## スターターコードを追加し、開発環境を構成する
|
||||
|
||||
{% data reusables.classroom.assignments-guide-intro-for-environment %}
|
||||
|
||||
- [Choosing a template repository](#choosing-a-template-repository)
|
||||
- [Choosing an integrated development environment (IDE)](#choosing-an-integrated-development-environment-ide)
|
||||
- [テンプレートリポジトリを作成する](#choosing-a-template-repository)
|
||||
- [統合開発環境 (IDE) を選択する](#choosing-an-integrated-development-environment-ide)
|
||||
|
||||
### Choosing a template repository
|
||||
### テンプレートリポジトリを作成する
|
||||
|
||||
By default, a new assignment will create an empty repository for each team that a student creates. {% data reusables.classroom.you-can-choose-a-template-repository %}
|
||||
デフォルトでは、新しい課題では学生が作成した各Teamに対し、空のリポジトリが作成されます。 {% data reusables.classroom.you-can-choose-a-template-repository %}
|
||||
|
||||
{% data reusables.classroom.assignments-guide-choose-template-repository %}
|
||||
|
||||
### Choosing an integrated development environment (IDE)
|
||||
### 統合開発環境 (IDE) を選択する
|
||||
|
||||
{% data reusables.classroom.about-online-ides %} For more information, see "[Integrate {% data variables.product.prodname_classroom %} with an IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)."
|
||||
{% data reusables.classroom.about-online-ides %}詳細については、「[{% data variables.product.prodname_classroom %} と IDE の統合](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)」を参照してください。
|
||||
|
||||
{% data reusables.classroom.classroom-codespaces-link %}
|
||||
|
||||
@@ -103,18 +109,18 @@ By default, a new assignment will create an empty repository for each team that
|
||||
|
||||
{% data reusables.classroom.assignments-guide-click-continue-after-starter-code-and-feedback %}
|
||||
|
||||
## Providing feedback
|
||||
## フィードバックの提供
|
||||
|
||||
Optionally, you can automatically grade assignments and create a space for discussing each submission with the team.
|
||||
必要に応じて、課題を自動的に採点し、各提出物をTeamで議論するための場を作成できます。
|
||||
|
||||
- [Testing assignments automatically](#testing-assignments-automatically)
|
||||
- [Creating a pull request for feedback](#creating-a-pull-request-for-feedback)
|
||||
- [課題を自動的にテストする](#testing-assignments-automatically)
|
||||
- [フィードバックのために pull request を作成する](#creating-a-pull-request-for-feedback)
|
||||
|
||||
### Testing assignments automatically
|
||||
### 課題を自動的にテストする
|
||||
|
||||
{% data reusables.classroom.assignments-guide-using-autograding %}
|
||||
|
||||
### Creating a pull request for feedback
|
||||
### フィードバックのためにプルリクエストを作成する
|
||||
|
||||
{% data reusables.classroom.you-can-create-a-pull-request-for-feedback %}
|
||||
|
||||
@@ -122,36 +128,36 @@ Optionally, you can automatically grade assignments and create a space for discu
|
||||
|
||||
{% data reusables.classroom.assignments-guide-click-create-assignment-button %}
|
||||
|
||||
## Inviting students to an assignment
|
||||
## 学生を課題に招待する
|
||||
|
||||
{% data reusables.classroom.assignments-guide-invite-students-to-assignment %}
|
||||
|
||||
You can see the teams that are working on or have submitted an assignment in the **Teams** tab for the assignment. {% data reusables.classroom.assignments-to-prevent-submission %}
|
||||
課題の **[チーム]** タブで、課題を作業している、または提出済みのチームを確認できます。 {% data reusables.classroom.assignments-to-prevent-submission %}
|
||||
|
||||
<div class="procedural-image-wrapper">
|
||||
<img alt="Group assignment" class="procedural-image-wrapper" src="/assets/images/help/classroom/assignment-group-hero.png">
|
||||
</div>
|
||||
|
||||
## Monitoring students' progress
|
||||
The assignment overview page displays information about your assignment acceptances and team progress. You may have different summary information based on the configurations of your assignments.
|
||||
## 学生の進捗状況を監視する
|
||||
課題の概要ページには、課題の受け入れとチームの進捗状況に関する情報が表示されます。 課題の構成に基づいて、表示される概要情報が異なる場合があります。
|
||||
|
||||
- **Total teams**: The number of teams that have been created.
|
||||
- **Rostered students**: The number of students on the Classroom's roster.
|
||||
- **Students not on a team**: The number of students on the Classroom roster who have not yet joined a team.
|
||||
- **Accepted teams**: The number of teams who have accepted this assignment.
|
||||
- **Assignment submissions**: The number of teams that have submitted the assignment. Submission is triggered at the assignment deadline.
|
||||
- **Passing teams**: The number of teams that are currently passing the autograding tests for this assignment.
|
||||
- **[チームの合計数]** : 作成されたチームの数。
|
||||
- **[名簿に登録された学生]** : Classroom の名簿に登録されている学生の数。
|
||||
- **[チームに参加していない学生]** : Classroom の名簿でチームにまだ参加していない学生の数。
|
||||
- **[承認済みチーム]** : この課題を受け入れたチームの数。
|
||||
- **[課題の提出]** : 課題を提出したチームの数。 提出は、課題の期限にトリガーされます。
|
||||
- **[合格したチーム]** : 現在、この課題の自動採点テストに合格しているチームの数。
|
||||
|
||||
## Next steps
|
||||
## 次の手順
|
||||
|
||||
- After you create the assignment and your students form teams, team members can start work on the assignment using Git and {% data variables.product.product_name %}'s features. Students can clone the repository, push commits, manage branches, create and review pull requests, address merge conflicts, and discuss changes with issues. Both you and the team can review the commit history for the repository. For more information, see "[Getting started with {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github)," "[Repositories](/repositories)," "[Using Git](/github/getting-started-with-github/using-git)," and "[Collaborating with issues and pull requests](/github/collaborating-with-issues-and-pull-requests)," and the free course on [resolving merge conflicts](https://github.com/skills/resolve-merge-conflicts) from {% data variables.product.prodname_learning %}.
|
||||
- 課題を作成し、学生がTeamを編成した後、TeamメンバーはGitと{% data variables.product.product_name %}の機能を使用して課題を開始できます。 学生はリポジトリのクローン、コミットのプッシュ、ブランチの管理、プルリクエストの作成およびレビュー、マージコンフリクトへの対処、およびIssueの変更に関するディスカッションが可能です。 あなたもTeamも、リポジトリのコミット履歴をレビューできます。 詳細については、「[{% data variables.product.prodname_dotcom %} の概要](/github/getting-started-with-github)」、「[リポジトリ](/repositories)」、「[Git を使用する](/github/getting-started-with-github/using-git)」、「[issue と pull request を使用したコラボレーション](/github/collaborating-with-issues-and-pull-requests)」、および {% data variables.product.prodname_learning %} の[マージの競合の解決](https://github.com/skills/resolve-merge-conflicts)に関する無料コースを参照してください。
|
||||
|
||||
- When a team finishes an assignment, you can review the files in the repository, or you can review the history and visualizations for the repository to better understand how the team collaborated. For more information, see "[Visualizing repository data with graphs](/github/visualizing-repository-data-with-graphs)."
|
||||
- 課題を完了したチームがある場合は、そのリポジトリにあるファイルをレビューできます。また、チームがどのように協力したかをより深く理解するため、リポジトリの履歴や視覚化されたデータを確認できます。 詳細については、[グラフを使用したリポジトリ データの視覚化](/github/visualizing-repository-data-with-graphs)に関する記事を参照してください。
|
||||
|
||||
- You can provide feedback for an assignment by commenting on individual commits or lines in a pull request. For more information, see "[Commenting on a pull request](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request)" and "[Opening an issue from code](/github/managing-your-work-on-github/opening-an-issue-from-code)." For more information about creating saved replies to provide feedback for common errors, see "[About saved replies](/github/writing-on-github/about-saved-replies)."
|
||||
- プルリクエストの内の個々のコミットや行にコメントすることで、課題にフィードバックを行うことができます。 詳細については、「[pull request へコメントする](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request)」および[コードから issue を開く方法](/github/managing-your-work-on-github/opening-an-issue-from-code)に関する記事を参照してください。 返信テンプレートを作成して一般的なエラーに関するフィードバックを提供する方法の詳細については、「[返信テンプレートについて](/github/writing-on-github/about-saved-replies)」を参照してください。
|
||||
|
||||
## Further reading
|
||||
## 参考資料
|
||||
|
||||
- [{% data variables.product.prodname_global_campus %} for teachers](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers)
|
||||
- "[Connect a learning management system course to a classroom](/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-course-to-a-classroom)"
|
||||
- [Using Existing Teams in Group Assignments?](https://education.github.community/t/using-existing-teams-in-group-assignments/6999) in the {% data variables.product.prodname_education %} Community
|
||||
- [教師向け {% data variables.product.prodname_global_campus %}](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers)
|
||||
- 「[学習管理システムのコースをクラスルームに接続する](/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-course-to-a-classroom)」
|
||||
- {% data variables.product.prodname_education %} Community の「[グループ課題における既存チームの使用](https://education.github.community/t/using-existing-teams-in-group-assignments/6999)」
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Create an individual assignment
|
||||
intro: You can create an assignment for students in your course to complete individually.
|
||||
title: 個人課題の作成
|
||||
intro: コースにおいて、個人で修了するための課題を学生のために作成できます。
|
||||
versions:
|
||||
fpt: '*'
|
||||
permissions: 'Organization owners who are admins for a classroom can create and manage individual assignments for a classroom. {% data reusables.classroom.classroom-admins-link %}'
|
||||
@@ -8,8 +8,14 @@ redirect_from:
|
||||
- /education/manage-coursework-with-github-classroom/creating-an-individual-assignment
|
||||
- /education/manage-coursework-with-github-classroom/create-an-individual-assignment
|
||||
shortTitle: Individual assignment
|
||||
ms.openlocfilehash: 1ffa725be4e42695b297545f65c998b14ed8e000
|
||||
ms.sourcegitcommit: 82b1242de02ecc4bdec02a5b6d11568fb2deb1aa
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/21/2022
|
||||
ms.locfileid: '148179749'
|
||||
---
|
||||
## About individual assignments
|
||||
## 個人課題について
|
||||
|
||||
{% data reusables.classroom.assignments-individual-definition %}
|
||||
|
||||
@@ -17,42 +23,42 @@ shortTitle: Individual assignment
|
||||
|
||||
{% data reusables.classroom.about-assignments %}
|
||||
|
||||
For a video demonstration of the creation of an individual assignment, see "[Basics of setting up {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)."
|
||||
個人課題の作成のビデオ デモについては、「[{% data variables.product.prodname_classroom %} のセットアップの基本](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)」をご覧ください。
|
||||
|
||||
{% data reusables.classroom.reuse-assignment-link %}
|
||||
|
||||
## Prerequisites
|
||||
## 前提条件
|
||||
|
||||
{% data reusables.classroom.assignments-classroom-prerequisite %}
|
||||
|
||||
## Creating an assignment
|
||||
## 課題を作成する
|
||||
|
||||
{% data reusables.classroom.assignments-guide-create-the-assignment %}
|
||||
|
||||
## Setting up the basics for an assignment
|
||||
## 課題の基本情報をセットアップする
|
||||
|
||||
Name your assignment, decide whether to assign a deadline, and choose the visibility of assignment repositories.
|
||||
課題に名前を付け、期限を設定するかを決定し、課題リポジトリの可視性を選択します。
|
||||
|
||||
- [Naming an assignment](#naming-an-assignment)
|
||||
- [Assigning a deadline for an assignment](#assigning-a-deadline-for-an-assignment)
|
||||
- [Choosing an assignment type](#choosing-an-assignment-type)
|
||||
- [Choosing a visibility for assignment repositories](#choosing-a-visibility-for-assignment-repositories)
|
||||
- [課題に名前を付ける](#naming-an-assignment)
|
||||
- [課題に期限を設定する](#assigning-a-deadline-for-an-assignment)
|
||||
- [課題のタイプを選択する](#choosing-an-assignment-type)
|
||||
- [課題リポジトリの可視性を選択する](#choosing-a-visibility-for-assignment-repositories)
|
||||
|
||||
### Naming an assignment
|
||||
### 課題に名前を付ける
|
||||
|
||||
For an individual assignment, {% data variables.product.prodname_classroom %} names repositories by the repository prefix and the student's {% data variables.product.product_name %} username. By default, the repository prefix is the assignment title. For example, if you name an assignment "assignment-1" and the student's username on {% data variables.product.product_name %} is @octocat, the name of the assignment repository for @octocat will be `assignment-1-octocat`.
|
||||
個人課題では、{% data variables.product.prodname_classroom %}はリポジトリのプレフィックスと学生の{% data variables.product.product_name %}ユーザ名から、リポジトリに名前を付けます。 デフォルトでは、リポジトリのプレフィックスが課題のタイトルとなります。 たとえば、課題に "assignment-1" という名前を付け、{% data variables.product.product_name %} での学生のユーザー名が @octocat である場合、@octocat の課題リポジトリの名前は `assignment-1-octocat` になります。
|
||||
|
||||
{% data reusables.classroom.assignments-type-a-title %}
|
||||
|
||||
### Assigning a deadline for an assignment
|
||||
### 課題に期限を設定する
|
||||
|
||||
{% data reusables.classroom.assignments-guide-assign-a-deadline %}
|
||||
|
||||
### Choosing an assignment type
|
||||
### 課題のタイプを選択する
|
||||
|
||||
Under "Individual or group assignment", select the drop-down menu, and click **Individual assignment**. You can't change the assignment type after you create the assignment. If you'd rather create a group assignment, see "[Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment)."
|
||||
[Individual or group assignment]\(個人またはグループの課題\) の下のドロップダウン メニューを選んで、 **[Individual assignment]\(個人課題\)** をクリックします。 課題の作成後は、課題タイプを変更できません。 グループ課題を作成する場合は、「[グループ課題の作成](/education/manage-coursework-with-github-classroom/create-a-group-assignment)」をご覧ください。
|
||||
|
||||
### Choosing a visibility for assignment repositories
|
||||
### 課題リポジトリの可視性を選択する
|
||||
|
||||
{% data reusables.classroom.assignments-repository-visibility-and-permissions %}
|
||||
|
||||
@@ -60,41 +66,41 @@ Under "Individual or group assignment", select the drop-down menu, and click **I
|
||||
|
||||
{% data reusables.classroom.assignments-guide-click-continue-after-basics %}
|
||||
|
||||
## Adding starter code and configuring a development environment
|
||||
## スターターコードを追加し、開発環境を構成する
|
||||
|
||||
{% data reusables.classroom.assignments-guide-intro-for-environment %}
|
||||
|
||||
- [Choosing a template repository](#choosing-a-template-repository)
|
||||
- [Choosing an integrated development environment (IDE)](#choosing-an-integrated-development-environment-ide)
|
||||
- [テンプレートリポジトリを作成する](#choosing-a-template-repository)
|
||||
- [統合開発環境 (IDE) を選択する](#choosing-an-integrated-development-environment-ide)
|
||||
|
||||
### Choosing a template repository
|
||||
### テンプレートリポジトリを作成する
|
||||
|
||||
By default, a new assignment will create an empty repository for each student on the roster for the classroom. {% data reusables.classroom.you-can-choose-a-template-repository %}
|
||||
デフォルトでは、新しい課題ではクラスルームの名簿に掲載されている各学生に対し、空のリポジトリが作成されます。 {% data reusables.classroom.you-can-choose-a-template-repository %}
|
||||
|
||||
{% data reusables.classroom.assignments-guide-choose-template-repository %}
|
||||
|
||||
{% data reusables.classroom.assignments-guide-click-continue-after-starter-code-and-feedback %}
|
||||
|
||||
### Choosing an integrated development environment (IDE)
|
||||
### 統合開発環境 (IDE) を選択する
|
||||
|
||||
{% data reusables.classroom.about-online-ides %} For more information, see "[Integrate {% data variables.product.prodname_classroom %} with an IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)."
|
||||
{% data reusables.classroom.about-online-ides %}詳細については、「[{% data variables.product.prodname_classroom %} と IDE の統合](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)」を参照してください。
|
||||
|
||||
{% data reusables.classroom.classroom-codespaces-link %}
|
||||
|
||||
{% data reusables.classroom.assignments-guide-choose-an-online-ide %}
|
||||
|
||||
## Providing feedback for an assignment
|
||||
## 課題にフィードバックを行う
|
||||
|
||||
Optionally, you can automatically grade assignments and create a space for discussing each submission with the student.
|
||||
必要に応じて、課題を自動的に採点し、各提出物を学生と議論するための場を作成できます。
|
||||
|
||||
- [Testing assignments automatically](#testing-assignments-automatically)
|
||||
- [Creating a pull request for feedback](#creating-a-pull-request-for-feedback)
|
||||
- [課題を自動的にテストする](#testing-assignments-automatically)
|
||||
- [フィードバックのために pull request を作成する](#creating-a-pull-request-for-feedback)
|
||||
|
||||
### Testing assignments automatically
|
||||
### 課題を自動的にテストする
|
||||
|
||||
{% data reusables.classroom.assignments-guide-using-autograding %}
|
||||
|
||||
### Creating a pull request for feedback
|
||||
### フィードバックのためにプルリクエストを作成する
|
||||
|
||||
{% data reusables.classroom.you-can-create-a-pull-request-for-feedback %}
|
||||
|
||||
@@ -102,34 +108,34 @@ Optionally, you can automatically grade assignments and create a space for discu
|
||||
|
||||
{% data reusables.classroom.assignments-guide-click-create-assignment-button %}
|
||||
|
||||
## Inviting students to an assignment
|
||||
## 学生を課題に招待する
|
||||
|
||||
{% data reusables.classroom.assignments-guide-invite-students-to-assignment %}
|
||||
|
||||
You can see whether a student has joined the classroom and accepted or submitted an assignment in the **Classroom roster** tab for the assignment. You can also link students' {% data variables.product.prodname_dotcom %} aliases to their associated roster identifier and vice versa in this tab. {% data reusables.classroom.assignments-to-prevent-submission %}
|
||||
課題の **[クラスルームの名簿]** タブで、学生がクラスルームに参加して課題を受け取ったか、または提出したかを確認できます。 このタブでは、学生の {% data variables.product.prodname_dotcom %} エイリアスを関連する名簿識別子にリンクしたり、その逆にリンクしたりすることもできます。{% data reusables.classroom.assignments-to-prevent-submission %}
|
||||
|
||||
<div class="procedural-image-wrapper">
|
||||
<img alt="Individual assignment" class="procedural-image-wrapper" src="/assets/images/help/classroom/assignment-individual-hero.png">
|
||||
</div>
|
||||
|
||||
## Monitoring students' progress
|
||||
The assignment overview page provides an overview of your assignment acceptances and student progress. You may have different summary information based on the configurations of your assignments.
|
||||
## 学生の進捗状況を監視する
|
||||
課題の概要ページには、課題の受け入れと学生の進捗状況の概要が表示されます。 課題の構成に基づいて、表示される概要情報が異なる場合があります。
|
||||
|
||||
- **Rostered students**: The number of students on the Classroom's roster.
|
||||
- **Added students**: The number of {% data variables.product.prodname_dotcom %} accounts that have accepted the assignment and are not associated with a roster identifier.
|
||||
- **Accepted students**: The number of accounts have accepted this assignment.
|
||||
- **Assignment submissions**: The number of students that have submitted the assignment. Submission is triggered at the assignment deadline.
|
||||
- **Passing students**: The number of students currently passing the autograding tests for this assignment.
|
||||
- **[名簿に登録された学生]** : Classroom の名簿に登録されている学生の数。
|
||||
- **[Added students]\(追加された学生\)** : 課題を受け入れていて、名簿識別子に関連付けられていない {% data variables.product.prodname_dotcom %} アカウントの数。
|
||||
- **[Accepted students]\(受け入れた学生\)** : この課題を受け入れたアカウントの数。
|
||||
- **[Assignment submissions]\(課題の提出\)** : 課題を提出した学生の数。 提出は、課題の期限にトリガーされます。
|
||||
- **[Passing students]\(合格した学生\)** : 現在、この課題の自動採点テストに合格している学生の数。
|
||||
|
||||
## Next steps
|
||||
## 次の手順
|
||||
|
||||
- Once you create the assignment, students can start work on the assignment using Git and {% data variables.product.product_name %}'s features. Students can clone the repository, push commits, manage branches, create and review pull requests, address merge conflicts, and discuss changes with issues. Both you and student can review the commit history for the repository. For more information, see "[Getting started with {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github)," "[Repositories](/repositories)," and "[Collaborating with issues and pull requests](/github/collaborating-with-issues-and-pull-requests)."
|
||||
- 課題を作成した後、学生はGitおよび{% data variables.product.product_name %}の機能を使用して課題を開始できます。 学生はリポジトリのクローン、コミットのプッシュ、ブランチの管理、プルリクエストの作成およびレビュー、マージコンフリクトへの対処、およびIssueの変更に関するディスカッションが可能です。 あなたも学生も、リポジトリのコミット履歴をレビューできます。 詳しくは、[{% data variables.product.prodname_dotcom %} の概要](/github/getting-started-with-github)、[リポジトリ](/repositories)、[issue と pull request での共同作業](/github/collaborating-with-issues-and-pull-requests)に関する記事をご覧ください。
|
||||
|
||||
- When a student finishes an assignment, you can review the files in the repository, or you can review the history and visualizations for the repository to better understand the student's work. For more information, see "[Visualizing repository data with graphs](/github/visualizing-repository-data-with-graphs)."
|
||||
- 課題を完了した学生がいる場合には、その学生のリポジトリにあるファイルをレビューできます。また、学生の作業についてをより深く理解するため、リポジトリの履歴や視覚化されたデータを確認できます。 詳細については、[グラフを使用したリポジトリ データの視覚化](/github/visualizing-repository-data-with-graphs)に関する記事を参照してください。
|
||||
|
||||
- You can provide feedback for an assignment by commenting on individual commits or lines in a pull request. For more information, see "[Commenting on a pull request](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request)" and "[Opening an issue from code](/github/managing-your-work-on-github/opening-an-issue-from-code)." For more information about creating saved replies to provide feedback for common errors, see "[About saved replies](/github/writing-on-github/about-saved-replies)."
|
||||
- プルリクエストの内の個々のコミットや行にコメントすることで、課題にフィードバックを行うことができます。 詳細については、「[pull request へコメントする](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request)」および[コードから issue を開く方法](/github/managing-your-work-on-github/opening-an-issue-from-code)に関する記事を参照してください。 返信テンプレートを作成して一般的なエラーに関するフィードバックを提供する方法の詳細については、「[返信テンプレートについて](/github/writing-on-github/about-saved-replies)」を参照してください。
|
||||
|
||||
## Further reading
|
||||
## 参考資料
|
||||
|
||||
- "[{% data variables.product.prodname_global_campus %} for teachers](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers)"
|
||||
- "[Connect a learning management system to {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-course-to-a-classroom)"
|
||||
- 「[教師向け {% data variables.product.prodname_global_campus %}](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers)」
|
||||
- [学習管理システムを {% data variables.product.prodname_classroom %} に接続する](/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-course-to-a-classroom)
|
||||
|
||||
@@ -1,83 +1,88 @@
|
||||
---
|
||||
title: Getting started with GitHub AE
|
||||
intro: 'Get started with setting up and configuring {% data variables.product.product_name %} for {% data variables.location.product_location %}.'
|
||||
title: GitHub AE の概要
|
||||
intro: '{% data variables.location.product_location %} の {% data variables.product.product_name %} の設定と構成を開始します。'
|
||||
versions:
|
||||
ghae: '*'
|
||||
ms.openlocfilehash: 957a922a2493abd8f625cdb9e9d6650283820222
|
||||
ms.sourcegitcommit: c562c85cc75ffe1eb4e9595d8adc09ec71697ab1
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/22/2022
|
||||
ms.locfileid: '148180062'
|
||||
---
|
||||
このガイドでは、Enterprise 所有者として {% data variables.product.product_name %} 上で {% data variables.location.product_location %} の設定を設定、構成、および管理を行う方法について説明します。 {% data variables.product.product_name %} について詳しくは、「[{% data variables.product.prodname_ghe_managed %} について](/admin/overview/about-github-ae)」をご覧ください。
|
||||
|
||||
This guide will walk you through setting up, configuring, and managing settings for {% data variables.location.product_location %} on {% data variables.product.product_name %} as an enterprise owner. For more information about {% data variables.product.product_name %}, see "[About {% data variables.product.prodname_ghe_managed %}](/admin/overview/about-github-ae)."
|
||||
## パート 1: {% data variables.product.product_name %} の設定
|
||||
{% data variables.product.product_name %} の使用を開始するために、Enterprise アカウントを作成し、{% data variables.product.product_name %} を初期化し、IP 許可リストを構成し、ユーザー認証とプロビジョニングを構成し、{% data variables.location.product_location %} の課金を管理できます。
|
||||
|
||||
## Part 1: Setting up {% data variables.product.product_name %}
|
||||
To get started with {% data variables.product.product_name %}, you can create your enterprise account, initialize {% data variables.product.product_name %}, configure an IP allow list, configure user authentication and provisioning, and manage billing for {% data variables.location.product_location %}.
|
||||
|
||||
### 1. Creating your {% data variables.product.product_name %} enterprise account
|
||||
You will first need to purchase {% data variables.product.product_name %}. For more information, contact [{% data variables.product.prodname_dotcom %}'s Sales team](https://enterprise.github.com/contact).
|
||||
### 1. {% data variables.product.product_name %} Enterprise アカウントの作成
|
||||
まず、{% data variables.product.product_name %} を購入する必要があります。 詳細については、[{% data variables.product.prodname_dotcom %} の営業チーム](https://enterprise.github.com/contact)にお問い合わせください。
|
||||
|
||||
{% data reusables.github-ae.initialize-enterprise %}
|
||||
|
||||
### 2. Initializing {% data variables.product.product_name %}
|
||||
After {% data variables.product.company_short %} creates the owner account for {% data variables.location.product_location %} on {% data variables.product.product_name %}, you will receive an email to sign in and complete the initialization. During initialization, you, as the enterprise owner, will name {% data variables.location.product_location %}, configure SAML SSO, create policies for all organizations in {% data variables.location.product_location %}, and configure a support contact for your enterprise members. For more information, see "[Initializing {% data variables.product.prodname_ghe_managed %}](/admin/configuration/configuring-your-enterprise/initializing-github-ae)."
|
||||
### 2. {% data variables.product.product_name %} の初期化
|
||||
{% data variables.product.company_short %} により {% data variables.product.product_name %} の {% data variables.location.product_location %} の所有者アカウントが作成された後、サインインして初期化を完了するための電子メールが届きます。 初期化中に、Enterprise 所有者は {% data variables.location.product_location %} に名前を付け、SAML SSO を構成し、{% data variables.location.product_location %} 内のすべての Organization のポリシーを作成し、Enterprise メンバーのサポート連絡先を構成します。 詳細については、「[{% data variables.product.prodname_ghe_managed %} の初期化](/admin/configuration/configuring-your-enterprise/initializing-github-ae)」を参照してください。
|
||||
|
||||
### 3. Restricting network traffic
|
||||
You can configure an allow list for specific IP addresses to restrict access to assets owned by organizations in your enterprise account. For more information, see "[Restricting network traffic to your enterprise with an IP allow list](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list)."
|
||||
### 3. ネットワーク トラフィックの制限
|
||||
特定の IP アドレスの許可リストを構成し、Enterprise アカウント内の Organization が所有する資産へのアクセスを制限できます。 詳しくは、「[IP 許可リストを使って Enterprise へのネットワーク トラフィックを制限する](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list)」をご覧ください。
|
||||
|
||||
### 4. Managing identity and access for {% data variables.location.product_location %}
|
||||
You can centrally manage access to {% data variables.location.product_location %} on {% data variables.product.product_name %} from an identity provider (IdP) using SAML single sign-on (SSO) for user authentication and System for Cross-domain Identity Management (SCIM) for user provisioning. Once you configure provisioning, you can assign or unassign users to the application from the IdP, creating or disabling user accounts in the enterprise. For more information, see "[About identity and access management for your enterprise](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-identity-and-access-management-for-your-enterprise)."
|
||||
### 4. {% data variables.location.product_location %} の ID とアクセスの管理
|
||||
ユーザー認証用の SAML シングル サインオン (SSO) とユーザー プロビジョニング用のクロスドメイン ID 管理システム (SCIM) を使用して、ID プロバイダー (IdP) から {% data variables.product.product_name %} の {% data variables.location.product_location %} へのアクセスを一元的に管理できます。 プロビジョニングを構成したら、IdP からアプリケーションにユーザーを割り当てるか、割り当て解除し、Enterprise 内のユーザー アカウントを作成または無効にすることができます。 詳細については、[Enterprise の ID およびアクセス管理](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-identity-and-access-management-for-your-enterprise)に関するページを参照してください。
|
||||
|
||||
### 5. Managing billing for {% data variables.location.product_location %}
|
||||
Owners of the subscription for {% data variables.location.product_location %} on {% data variables.product.product_name %} can view billing details for {% data variables.product.product_name %} in the Azure portal. For more information, see "[Managing billing for your enterprise](/billing/managing-billing-for-your-github-account/about-billing-for-your-enterprise)."
|
||||
### 5. {% data variables.location.product_location %} の課金の管理
|
||||
{% data variables.product.product_name %} の {% data variables.location.product_location %} のサブスクリプションの所有者は、Azure portal で {% data variables.product.product_name %} の課金を詳しく表示できます。 詳細については、[Enterprise の課金の管理](/billing/managing-billing-for-your-github-account/about-billing-for-your-enterprise)に関するページを参照してください。
|
||||
|
||||
## Part 2: Organizing and managing enterprise members
|
||||
As an enterprise owner for {% data variables.product.product_name %}, you can manage settings on user, repository, team, and organization levels. You can manage members of {% data variables.location.product_location %}, create and manage organizations, set policies for repository management, and create and manage teams.
|
||||
## パート 2: Enterprise メンバーの編成と管理
|
||||
{% data variables.product.product_name %} の Enterprise 所有者は、ユーザー、リポジトリ、チーム、および Organization レベルで設定を管理できます。 {% data variables.location.product_location %} のメンバーの管理、Organization の作成と管理、リポジトリ管理に関するポリシーの設定、チームの作成と管理を行うことができます。
|
||||
|
||||
### 1. Managing members of {% data variables.location.product_location %}
|
||||
### 1. {% data variables.location.product_location %} のメンバーの管理
|
||||
{% data reusables.getting-started.managing-enterprise-members %}
|
||||
|
||||
### 2. Creating organizations
|
||||
### 2. Organization の作成
|
||||
{% data reusables.getting-started.creating-organizations %}
|
||||
|
||||
### 3. Adding members to organizations
|
||||
### 3. Organization へのメンバーの追加
|
||||
{% data reusables.getting-started.adding-members-to-organizations %}
|
||||
|
||||
### 4. Creating teams
|
||||
### 4. チームの作成
|
||||
{% data reusables.getting-started.creating-teams %}
|
||||
|
||||
### 5. Setting organization and repository permission levels
|
||||
### 5. Organization とリポジトリのアクセス許可レベルの設定
|
||||
{% data reusables.getting-started.setting-org-and-repo-permissions %}
|
||||
|
||||
### 6. Enforcing repository management policies
|
||||
### 6. リポジトリ管理ポリシーの適用
|
||||
{% data reusables.getting-started.enforcing-repo-management-policies %}
|
||||
|
||||
## Part 3: Building securely
|
||||
To increase the security of {% data variables.location.product_location %}, you can monitor {% data variables.location.product_location %} and configure security and analysis features for your organizations.
|
||||
## パート 3: 安全なビルド
|
||||
{% data variables.location.product_location %} のセキュリティを強化するために、{% data variables.location.product_location %} を監視し、Organization のセキュリティと分析機能を構成することができます。
|
||||
|
||||
### 1. Monitoring {% data variables.location.product_location %}
|
||||
You can monitor {% data variables.location.product_location %} with your activity dashboard and audit logging. For more information, see "[Monitoring activity in your enterprise](/admin/monitoring-activity-in-your-enterprise)."
|
||||
### 1. {% data variables.location.product_location %} の監視
|
||||
アクティビティ ダッシュボードと監査ログを使用して、{% data variables.location.product_location %} を監視できます。 詳細については、「[Enterprise でアクティビティを監視する](/admin/monitoring-activity-in-your-enterprise)」を参照してください。
|
||||
|
||||
### 2. Configuring security features for your organizations
|
||||
### 2. Organization のセキュリティ機能の構成
|
||||
{% data reusables.getting-started.configuring-security-features %}
|
||||
|
||||
## Part 4: Customizing and automating work on {% data variables.location.product_location %}
|
||||
You can customize and automate work in organizations in {% data variables.location.product_location %} with the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API, {% data variables.product.prodname_actions %}, and {% data variables.product.prodname_pages %}.
|
||||
## パート 4: {% data variables.location.product_location %} での作業のカスタマイズと自動化
|
||||
{% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API、{% data variables.product.prodname_actions %}、および {% data variables.product.prodname_pages %} を使用して、{% data variables.location.product_location %} 内の Organization での作業をカスタマイズおよび自動化することができます。
|
||||
|
||||
### 1. Using the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API
|
||||
### 1. {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API の使用
|
||||
{% data reusables.getting-started.api %}
|
||||
|
||||
### 2. Building {% data variables.product.prodname_actions %}
|
||||
### 2. {% data variables.product.prodname_actions %} のビルド
|
||||
{% data reusables.getting-started.actions %}
|
||||
|
||||
For more information on enabling and configuring {% data variables.product.prodname_actions %} for {% data variables.product.product_name %}, see "[Getting started with {% data variables.product.prodname_actions %} for {% data variables.product.prodname_ghe_managed %}](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-ae)."
|
||||
{% data variables.product.product_name %} の {% data variables.product.prodname_actions %} の有効化と構成の詳細については、「[{% data variables.product.prodname_ghe_managed %} の {% data variables.product.prodname_actions %} の概要](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-ae)」を参照してください。
|
||||
|
||||
### 3. Using {% data variables.product.prodname_pages %}
|
||||
### 3. {% data variables.product.prodname_pages %} の使用
|
||||
{% data reusables.getting-started.github-pages-enterprise %}
|
||||
## Part 5: Using {% data variables.product.prodname_dotcom %}'s learning and support resources
|
||||
Your enterprise members can learn more about Git and {% data variables.product.prodname_dotcom %} with our learning resources, and you can get the support you need with {% data variables.product.prodname_dotcom %} Enterprise Support.
|
||||
## パート 5: {% data variables.product.prodname_dotcom %} の学習およびサポート リソースの使用
|
||||
Enterprise メンバーは、学習リソースを使用して Git と {% data variables.product.prodname_dotcom %} の詳細を学ぶことができます。また、{% data variables.product.prodname_dotcom %} Enterprise サポートを使用して必要なサポートを受けることができます。
|
||||
|
||||
### 1. Reading about {% data variables.product.product_name %} on {% data variables.product.prodname_docs %}
|
||||
You can read documentation that reflects the features available with {% data variables.product.prodname_ghe_managed %}. For more information, see "[About versions of {% data variables.product.prodname_docs %}](/get-started/learning-about-github/about-versions-of-github-docs)."
|
||||
### 1. {% data variables.product.prodname_docs %} で {% data variables.product.product_name %} について読む
|
||||
{% data variables.product.prodname_ghe_managed %} で使用できる機能が掲載されたドキュメントを読むことができます。 詳細については、「[{% data variables.product.prodname_docs %} のバージョンについて](/get-started/learning-about-github/about-versions-of-github-docs)」を参照してください。
|
||||
|
||||
### 2. Learning with {% data variables.product.prodname_learning %}
|
||||
### 2. {% data variables.product.prodname_learning %} による学習
|
||||
{% data reusables.getting-started.learning-enterprise %}
|
||||
|
||||
### 3. Working with {% data variables.product.prodname_dotcom %} Enterprise Support
|
||||
### 3. {% data variables.product.prodname_dotcom %} Enterprise サポートの使用
|
||||
{% data reusables.getting-started.contact-support-enterprise %}
|
||||
|
||||
@@ -1,128 +1,132 @@
|
||||
---
|
||||
title: Getting started with GitHub Enterprise Server
|
||||
intro: 'Get started with setting up and managing {% data variables.location.product_location %}.'
|
||||
title: GitHub Enterprise Serverを使い始める
|
||||
intro: '{% data variables.location.product_location %} の設定と管理を開始します。'
|
||||
versions:
|
||||
ghes: '*'
|
||||
ms.openlocfilehash: 68cd462c42ef63863750d9edc5e122dc3c325115
|
||||
ms.sourcegitcommit: c2aa10a61db44ee111c09565b6114dd5c97b6e2e
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/14/2022
|
||||
ms.locfileid: '148163417'
|
||||
---
|
||||
このガイドでは、エンタープライズ管理者として {% data variables.location.product_location %} の設定、構成、管理を行う方法について説明します。
|
||||
|
||||
This guide will walk you through setting up, configuring and managing {% data variables.location.product_location %} as an enterprise administrator.
|
||||
|
||||
{% data variables.product.company_short %} provides two ways to deploy {% data variables.product.prodname_enterprise %}.
|
||||
{% data variables.product.company_short %} には、{% data variables.product.prodname_enterprise %} をデプロイするための方法として、次の 2 つが用意されています。
|
||||
|
||||
- **{% data variables.product.prodname_ghe_cloud %}**
|
||||
- **{% data variables.product.prodname_ghe_server %}**
|
||||
|
||||
{% data variables.product.company_short %} hosts {% data variables.product.prodname_ghe_cloud %}. You can deploy and host {% data variables.product.prodname_ghe_server %} in your own datacenter or a supported cloud provider.
|
||||
{% data variables.product.prodname_ghe_cloud %} は、{% data variables.product.company_short %} でホストされます。 {% data variables.product.prodname_ghe_server %} は、自身のデータセンターまたはサポートされているクラウド プロバイダーにデプロイしてホストすることができます。
|
||||
|
||||
For more information about {% data variables.product.product_name %}, see "[About {% data variables.product.prodname_ghe_server %}](/admin/overview/about-github-enterprise-server)."
|
||||
{% data variables.product.product_name %} の詳細については、「[{% data variables.product.prodname_ghe_server %} について](/admin/overview/about-github-enterprise-server)」を参照してください。
|
||||
|
||||
## Part 1: Installing {% data variables.product.product_name %}
|
||||
To get started with {% data variables.product.product_name %}, 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 {% data variables.product.product_name %}, you can create an enterprise account on {% data variables.product.prodname_dotcom_the_website %} by contacting [{% data variables.product.prodname_dotcom %}'s Sales team](https://enterprise.github.com/contact). An enterprise account on {% data variables.product.prodname_dotcom_the_website %} is useful for billing and for shared features with {% data variables.product.prodname_dotcom_the_website %} via {% data variables.product.prodname_github_connect %}. For more information, see "[About enterprise accounts](/admin/overview/about-enterprise-accounts)."
|
||||
### 2. Installing {% data variables.product.product_name %}
|
||||
To get started with {% data variables.product.product_name %}, you will need to install the appliance on a virtualization platform of your choice. For more information, see "[Setting up a {% data variables.product.prodname_ghe_server %} instance](/admin/installation/setting-up-a-github-enterprise-server-instance)."
|
||||
## パート 1: {% data variables.product.product_name %} のインストール方法
|
||||
{% data variables.product.product_name %} を使い始めるには、Enterprise アカウントの作成とインスタンスのインストールを行い、初期設定に管理コンソールを使用し、インスタンスを構成し、支払いを管理する必要があります。
|
||||
### 1. Enterprise アカウントの作成
|
||||
{% data variables.product.product_name %} をインストールする前に、[{% data variables.product.prodname_dotcom %} の営業チーム](https://enterprise.github.com/contact) に連絡して、{% data variables.product.prodname_dotcom_the_website %} に Enterprise アカウントを作成できます。 {% data variables.product.prodname_dotcom_the_website %} の Enterprise アカウントは、支払いや、{% data variables.product.prodname_github_connect %} を介した {% data variables.product.prodname_dotcom_the_website %} での共有機能に役立ちます。 詳細については、「[Enterprise アカウントについて](/admin/overview/about-enterprise-accounts)」を参照してください。
|
||||
### 2. {% data variables.product.product_name %} のインストール
|
||||
{% data variables.product.product_name %} を使い始めるには、選択した仮想化プラットフォームにアプライアンスをインストールする必要があります。 詳細については、「[{% data variables.product.prodname_ghe_server %} インスタンスをセットアップする](/admin/installation/setting-up-a-github-enterprise-server-instance)」を参照してください。
|
||||
|
||||
### 3. Using the Management Console
|
||||
You will use the Management Console to walk through the initial setup process when first launching {% data variables.location.product_location %}. 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](/admin/configuration/configuring-your-enterprise/accessing-the-management-console)."
|
||||
### 3. 管理コンソールの使用
|
||||
{% data variables.location.product_location %} を初めて起動する場合、管理コンソールを使用して、初期設定プロセスを実行します。 また、管理コンソールを使用して、ライセンス、ドメイン、認証、TLS などのインスタンス設定を管理することもできます。 詳細については、「[Accessing the management console](/admin/configuration/configuring-your-enterprise/accessing-the-management-console)」 (管理コンソールへのアクセス) を参照してください。
|
||||
|
||||
### 4. Configuring {% data variables.location.product_location %}
|
||||
In addition to the Management Console, you can use the site admin dashboard and the administrative shell (SSH) to manage {% data variables.location.product_location %}. For example, you can configure applications and rate limits, view reports, use command-line utilities. For more information, see "[Configuring your enterprise](/admin/configuration/configuring-your-enterprise)."
|
||||
### 4. {% data variables.location.product_location %} の構成
|
||||
管理コンソールに加えて、サイト管理ダッシュボードと管理シェル (SSH) を使用して {% data variables.location.product_location %} を管理することもできます。 たとえば、アプリケーションやレート制限を構成したり、レポートを表示したり、コマンドライン ユーティリティを使用したりすることができます。 詳細については、「[Enterprise を設定する](/admin/configuration/configuring-your-enterprise)」を参照してください。
|
||||
|
||||
You can use the default network settings used by {% data variables.product.product_name %} via the dynamic host configuration protocol (DHCP), or you can also configure the network settings using the virtual machine console. You can also configure a proxy server or firewall rules. For more information, see "[Configuring network settings](/admin/configuration/configuring-network-settings)."
|
||||
動的ホスト構成プロトコル (DHCP) を介して {% data variables.product.product_name %} で使用される既定のネットワーク設定を使用することも、仮想マシン コンソールを使用してネットワーク設定を構成することもできます。 プロキシサーバあるいはファイアウォールルールを設定することもできます。 詳細については、「[ネットワークを設定する](/admin/configuration/configuring-network-settings)」を参照してください。
|
||||
|
||||
### 5. Configuring high availability
|
||||
You can configure {% data variables.location.product_location %} for high availability to minimize the impact of hardware failures and network outages. For more information, see "[Configuring high availability](/admin/enterprise-management/configuring-high-availability)."
|
||||
### 5. 高可用性の構成
|
||||
{% data variables.location.product_location %} を高可用性向けに構成して、ハードウェア障害やネットワークの停止による影響を最小限に抑えることができます。 詳細については、「[High Availability の設定](/admin/enterprise-management/configuring-high-availability)」を参照してください。
|
||||
|
||||
### 6. Setting up a staging instance
|
||||
You can set up a staging instance to test modifications, plan for disaster recovery, and try out updates before applying them to {% data variables.location.product_location %}. For more information, see "[Setting up a staging instance](/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance)."
|
||||
### 6. ステージング インスタンスのセットアップ
|
||||
ステージング インスタンスを設定して、{% data variables.location.product_location %} に適用される前に変更をテストし、ディザスター リカバリーを計画し、更新プログラムを試すことができます。 詳細については、「[ステージング インスタンスのセットアップ](/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance)」を参照してください。
|
||||
|
||||
### 7. Designating backups and disaster recovery
|
||||
To protect your production data, you can configure automated backups of {% data variables.location.product_location %} with {% data variables.product.prodname_enterprise_backup_utilities %}. For more information, see "[Configuring backups on your appliance](/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance)."
|
||||
### 7. バックアップとディザスター リカバリーの指定
|
||||
運用データを保護するには、{% data variables.product.prodname_enterprise_backup_utilities %} による {% data variables.location.product_location %} の自動バックアップを構成できます。 詳細については、「[Configuring backups on your appliance](/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance)」 (アプライアンスでのバックアップの構成) を参照してください。
|
||||
|
||||
### 8. Managing billing for your enterprise
|
||||
Billing for all the organizations and {% data variables.product.product_name %} instances connected to your enterprise account is aggregated into a single bill charge for all of your paid {% data variables.product.prodname_dotcom %}.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](/admin/overview/managing-billing-for-your-enterprise)."
|
||||
### 8. Enterprise の支払いの管理
|
||||
Enterprise アカウントに接続されているすべての Organization および {% data variables.product.product_name %} インスタンスの支払いは、有料のすべての {% data variables.product.prodname_dotcom %}.com サービスに対する単一の請求料金として集計されます。 Enterprise オーナーと支払いマネージャーは、Enterprise アカウントの支払い設定にアクセスして管理することができます。 詳細については、「[Managing billing for your enterprise](/admin/overview/managing-billing-for-your-enterprise)」 (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.
|
||||
## パート 2: Team の編成と管理
|
||||
Enterprise オーナーまたは管理者は、ユーザー、リポジトリ、Team、Organization のレベルの設定を管理できます。 Enterprise のメンバーの管理、Organization の作成と管理、リポジトリ管理に関するポリシーの設定、Team の作成と管理を行うことができます。
|
||||
|
||||
### 1. Managing members of {% data variables.location.product_location %}
|
||||
### 1. {% data variables.location.product_location %} のメンバーの管理
|
||||
{% data reusables.getting-started.managing-enterprise-members %}
|
||||
|
||||
### 2. Creating organizations
|
||||
### 2. Organization の作成
|
||||
{% data reusables.getting-started.creating-organizations %}
|
||||
|
||||
### 3. Adding members to organizations
|
||||
### 3. Organization へのメンバーの追加
|
||||
{% data reusables.getting-started.adding-members-to-organizations %}
|
||||
|
||||
### 4. Creating teams
|
||||
### 4. チームの作成
|
||||
{% data reusables.getting-started.creating-teams %}
|
||||
|
||||
### 5. Setting organization and repository permission levels
|
||||
### 5. Organization とリポジトリのアクセス許可レベルの設定
|
||||
{% data reusables.getting-started.setting-org-and-repo-permissions %}
|
||||
|
||||
### 6. Enforcing repository management policies
|
||||
### 6. リポジトリ管理ポリシーの適用
|
||||
{% data reusables.getting-started.enforcing-repo-management-policies %}
|
||||
|
||||
## Part 3: Building securely
|
||||
To increase the security of {% data variables.location.product_location %}, 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 {% data variables.product.prodname_GH_advanced_security %}.
|
||||
### 1. Authenticating enterprise members
|
||||
You can use {% data variables.product.product_name %}'s built-in authentication method, or you can choose between an external authentication provider, such as CAS, LDAP, or SAML, to integrate your existing accounts and centrally manage user access to {% data variables.location.product_location %}. For more information, see "[About authentication for your enterprise](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise)."
|
||||
## パート 3: 安全なビルド
|
||||
{% data variables.location.product_location %} のセキュリティを強化するには、エンタープライズ メンバーの認証を構成し、ツールと監査ログを使用してコンプライアンスを維持し、組織のセキュリティおよび分析機能を構成し、必要に応じて {% data variables.product.prodname_GH_advanced_security %} を有効にすることができます。
|
||||
### 1. Enterprise メンバーの認証
|
||||
{% data variables.product.product_name %} の組み込み認証方法を使用するか、CAS、LDAP、SAML などの外部の認証プロバイダーを選び、既存のアカウントを統合して、{% data variables.location.product_location %} へのユーザー アクセスを一元的に管理することができます。 詳しくは、「[Enterprise の認証について](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise)」をご覧ください。
|
||||
|
||||
You can also require two-factor authentication for each of your organizations. For more information, see "[Requiring two factor authentication for an organization](/admin/user-management/managing-organizations-in-your-enterprise/requiring-two-factor-authentication-for-an-organization)."
|
||||
また、Organization ごとに 2 要素認証を要求することもできます。 詳細については、「[Organization に 2 要素認証を要求する](/admin/user-management/managing-organizations-in-your-enterprise/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](/admin/policies/enforcing-policy-with-pre-receive-hooks)" and "[About the audit log for your enterprise](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/about-the-audit-log-for-your-enterprise)."
|
||||
### 2. コンプライアンスの維持
|
||||
必要な状態チェックとコミット検証を実装して、Organization のコンプライアンス標準を適用し、コンプライアンス ワークフローを自動化できます。 また、Organization の監査ログを使用して、Team によって実行されるアクションをレビューすることもできます。 詳細については、「[Pre-receive フックを使ってポリシーを適用する](/admin/policies/enforcing-policy-with-pre-receive-hooks)」および「[About the audit log for your enterprise](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/about-the-audit-log-for-your-enterprise)」 (Enterprise の監査ログについて) を参照してください。
|
||||
|
||||
{% ifversion ghes %}
|
||||
### 3. Configuring security features for your organizations
|
||||
{% data reusables.getting-started.configuring-security-features %}
|
||||
{% endif %}
|
||||
### 3. Organization のセキュリティ機能の構成
|
||||
{% data reusables.getting-started.configuring-security-features %} {% endif %}
|
||||
|
||||
{% ifversion ghes %}
|
||||
### 4. Enabling {% data variables.product.prodname_GH_advanced_security %} features
|
||||
You can upgrade your {% data variables.product.product_name %} license to include {% data variables.product.prodname_GH_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 "[{% data variables.product.prodname_GH_advanced_security %} for your enterprise](/admin/advanced-security/enabling-github-advanced-security-for-your-enterprise)."
|
||||
### 4. {% data variables.product.prodname_GH_advanced_security %} 機能の有効化
|
||||
{% data variables.product.product_name %} ライセンスをアップグレードして、{% data variables.product.prodname_GH_advanced_security %} を含めることができます。 これにより、コードやシークレット スキャンなど、ユーザーがコード内のセキュリティ上の問題を検出して修正するのに役立つ追加機能が提供されます。 詳細については、「[Enterprise の {% data variables.product.prodname_GH_advanced_security %}](/admin/advanced-security/enabling-github-advanced-security-for-your-enterprise)」を参照してください。
|
||||
{% endif %}
|
||||
|
||||
## Part 4: Customizing and automating your enterprise's work on {% data variables.product.prodname_dotcom %}
|
||||
You can customize and automate work in organizations in your enterprise with {% data variables.product.prodname_dotcom %} and {% data variables.product.prodname_oauth_apps %}, {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API, {% data variables.product.prodname_actions %}, {% data variables.product.prodname_registry %} , and {% data variables.product.prodname_pages %}.
|
||||
## パート 4: {% data variables.product.prodname_dotcom %} での Enterprise の作業のカスタマイズと自動化
|
||||
{% data variables.product.prodname_dotcom %} と {% data variables.product.prodname_oauth_apps %}、{% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API、{% data variables.product.prodname_actions %}、{% data variables.product.prodname_registry %}、{% data variables.product.prodname_pages %} を使用して、Enterprise 内の Organization での作業をカスタマイズおよび自動化できます。
|
||||
|
||||
### 1. Building {% data variables.product.prodname_github_apps %} and {% data variables.product.prodname_oauth_apps %}
|
||||
You can build integrations with the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API, such as {% data variables.product.prodname_github_apps %} or {% data variables.product.prodname_oauth_apps %}, for use in organizations in your enterprise to complement and extend your workflows. For more information, see "[About apps](/developers/apps/getting-started-with-apps/about-apps)."
|
||||
### 2. Using the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API
|
||||
### 1. {% data variables.product.prodname_github_apps %} と {% data variables.product.prodname_oauth_apps %} のビルド
|
||||
{% data variables.product.prodname_github_apps %} や {% data variables.product.prodname_oauth_apps %} などの {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API との統合を構築し、ワークフローを補完および拡張するために Enterprise 内の Organization で使用することができます。 詳細については、「[About apps](/developers/apps/getting-started-with-apps/about-apps)」 (アプリについて) を参照してください。
|
||||
### 2. {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API の使用
|
||||
{% data reusables.getting-started.api %}
|
||||
|
||||
{% ifversion ghes %}
|
||||
### 3. Building {% data variables.product.prodname_actions %}
|
||||
### 3. {% data variables.product.prodname_actions %} のビルド
|
||||
{% data reusables.getting-started.actions %}
|
||||
|
||||
For more information on enabling and configuring {% data variables.product.prodname_actions %} on {% data variables.product.product_name %}, see "[Getting started with {% data variables.product.prodname_actions %} for {% data variables.product.prodname_ghe_server %}](/admin/github-actions/enabling-github-actions-for-github-enterprise-server/getting-started-with-github-actions-for-github-enterprise-server)."
|
||||
{% data variables.product.product_name %} で {% data variables.product.prodname_actions %} を有効にして構成する方法の詳細については、「[{% data variables.product.prodname_ghe_server %} の {% data variables.product.prodname_actions %} を使い始める](/admin/github-actions/enabling-github-actions-for-github-enterprise-server/getting-started-with-github-actions-for-github-enterprise-server)」を参照してください。
|
||||
|
||||
### 4. Publishing and managing {% data variables.product.prodname_registry %}
|
||||
### 4. {% data variables.product.prodname_registry %} の公開と管理
|
||||
{% data reusables.getting-started.packages %}
|
||||
|
||||
For more information on enabling and configuring {% data variables.product.prodname_registry %} for {% data variables.location.product_location %}, see "[Getting started with {% data variables.product.prodname_registry %} for your enterprise](/admin/packages/getting-started-with-github-packages-for-your-enterprise)."
|
||||
{% data variables.location.product_location %} の {% data variables.product.prodname_registry %} を有効にして構成する方法の詳細については、「[エンタープライズの {% data variables.product.prodname_registry %} を使い始める](/admin/packages/getting-started-with-github-packages-for-your-enterprise)」を参照してください。
|
||||
{% endif %}
|
||||
|
||||
### 5. Using {% data variables.product.prodname_pages %}
|
||||
### 5. {% data variables.product.prodname_pages %} の使用
|
||||
{% data reusables.getting-started.github-pages-enterprise %}
|
||||
|
||||
## Part 5: Connecting with other {% data variables.product.prodname_dotcom %} resources
|
||||
You can use {% data variables.product.prodname_github_connect %} to share resources.
|
||||
## パート 5: 他の {% data variables.product.prodname_dotcom %} リソースとの接続
|
||||
{% data variables.product.prodname_github_connect %} を使用してリソースを共有することができます。
|
||||
|
||||
If you are the owner of both a {% data variables.product.product_name %} instance and a {% data variables.product.prodname_ghe_cloud %} organization or enterprise account, you can enable {% data variables.product.prodname_github_connect %}. {% data variables.product.prodname_github_connect %} allows you to share specific workflows and features between {% data variables.location.product_location %} and {% data variables.product.prodname_ghe_cloud %}, such as unified search and contributions. For more information, see "[Connecting {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_ghe_cloud %}](/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud/connecting-github-enterprise-server-to-github-enterprise-cloud)."
|
||||
{% data variables.product.product_name %} インスタンスと、{% data variables.product.prodname_ghe_cloud %} の Organization または Enterprise アカウントの両方のオーナーである場合、{% data variables.product.prodname_github_connect %} を有効にすることができます。 {% data variables.product.prodname_github_connect %} を使用すると、{% data variables.location.product_location %} と {% data variables.product.prodname_ghe_cloud %} の間で、統合検索やコントリビューションなどの特定のワークフローや機能を共有できます。 詳細については、「[{% data variables.product.prodname_ghe_cloud %} への {% data variables.product.prodname_ghe_server %} の接続](/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud/connecting-github-enterprise-server-to-github-enterprise-cloud)」を参照してください。
|
||||
|
||||
## Part 6: Using {% data variables.product.prodname_dotcom %}'s learning and support resources
|
||||
Your enterprise members can learn more about Git and {% data variables.product.prodname_dotcom %} with our learning resources, and you can get the support you need when setting up and managing {% data variables.location.product_location %} with {% data variables.product.prodname_dotcom %} Enterprise Support.
|
||||
## パート 6: {% data variables.product.prodname_dotcom %} の学習およびサポート リソースの使用
|
||||
エンタープライズ メンバーは、学習リソースを使用して Git と {% data variables.product.prodname_dotcom %} の詳細を学ぶことができます。また、{% data variables.location.product_location %} の設定および管理を行う際に、{% data variables.product.prodname_dotcom %} エンタープライズ サポートを使用して必要なサポートを受けることができます。
|
||||
|
||||
### 1. Reading about {% data variables.product.product_name %} on {% data variables.product.prodname_docs %}
|
||||
### 1. {% data variables.product.prodname_docs %} で {% data variables.product.product_name %} に関するドキュメントを読む
|
||||
|
||||
You can read documentation that reflects the features available with {% data variables.product.prodname_ghe_server %}. For more information, see "[About versions of {% data variables.product.prodname_docs %}](/get-started/learning-about-github/about-versions-of-github-docs)."
|
||||
{% data variables.product.prodname_ghe_server %} で使用できる機能が掲載されたドキュメントを読むことができます。 詳細については、「[{% data variables.product.prodname_docs %} のバージョンについて](/get-started/learning-about-github/about-versions-of-github-docs)」を参照してください。
|
||||
|
||||
{% data reusables.enterprise.best-practices %}
|
||||
|
||||
### 2. Learning with {% data variables.product.prodname_learning %}
|
||||
### 2. {% data variables.product.prodname_learning %} による学習
|
||||
{% data reusables.getting-started.learning-enterprise %}
|
||||
|
||||
### 3. Working with {% data variables.product.prodname_dotcom %} Enterprise Support
|
||||
### 3. {% data variables.product.prodname_dotcom %} Enterprise サポートの使用
|
||||
{% data reusables.getting-started.contact-support-enterprise %}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: 'Migrating from {% data variables.product.prodname_projects_v1 %}'
|
||||
intro: 'You can migrate your {% data variables.projects.projects_v1_board %} to the new {% data variables.product.prodname_projects_v2 %} experience.'
|
||||
title: '{% data variables.product.prodname_projects_v1 %} からの移行'
|
||||
intro: '{% data variables.projects.projects_v1_board %} を新しい {% data variables.product.prodname_projects_v2 %} エクスペリエンスに移行できます。'
|
||||
miniTocMaxHeadingLevel: 3
|
||||
versions:
|
||||
feature: projects-v2
|
||||
@@ -10,57 +10,53 @@ type: tutorial
|
||||
topics:
|
||||
- Projects
|
||||
allowTitleToDifferFromFilename: true
|
||||
ms.openlocfilehash: e6db4fd8c6587f413ee0e6832dbae93bbf281573
|
||||
ms.sourcegitcommit: 9bf175b190674416ad4e11b5c567409f74c00ad2
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/23/2022
|
||||
ms.locfileid: '148181222'
|
||||
---
|
||||
|
||||
|
||||
{% note %}
|
||||
|
||||
**Notes:**
|
||||
**注:**
|
||||
|
||||
- If the project you are migrating contains more than {% data variables.projects.item_limit %} items, open issues will be prioritized followed by open pull requests and then notes. Remaining space will be used for closed issues, merged pull requested, and closed pull requests. Items that cannot be migrated due to this limit will be moved to the archive. If the archive limit of {% data variables.projects.archived_item_limit %} items is reached, additional items will not be migrated.
|
||||
- Note cards are converted to draft issues, and the contents are saved to the body of the draft issue. If information appears to be missing, make any hidden fields visible. For more information, see "[Showing and hiding fields](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view#showing-and-hiding-fields)."
|
||||
- Automation will not be migrated.
|
||||
- Triage, archive, and activity will not be migrated.
|
||||
- After migration, the new migrated project and old project will not be kept in sync.
|
||||
- 移行するプロジェクトに {% data variables.projects.item_limit %} を超える項目が含まれている場合は、未解決の issue が優先され、その後に未解決の pull request、メモが続きます。 残りの領域は、解決された issue、マージされた pull request、および解決された pull request に使用されます。 この制限により移行できない項目は、アーカイブに移動されます。 アーカイブの上限である {% data variables.projects.archived_item_limit %} 項目に達した場合、追加の項目は移行されません。
|
||||
- ノート カードは下書きの issue に変換され、内容は下書きの issue の本文に保存されます。 情報が見つからないように見える場合は、非表示フィールドを表示します。 詳しくは、「[フィールドの表示と非表示](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view#showing-and-hiding-fields)」を参照してください。
|
||||
- 自動化は移行されません。
|
||||
- トリアージ、アーカイブ、アクティビティは移行されません。
|
||||
- 移行後、新しく移行されたプロジェクトと古いプロジェクトは同期されません。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
## About project migration
|
||||
## プロジェクトの移行について
|
||||
|
||||
You can migrate your project boards to the new {% data variables.product.prodname_projects_v2 %} experience and try out tables, multiple views, new automation options, and powerful field types. For more information, see "[About projects](/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects)."
|
||||
プロジェクト ボードを新しい {% data variables.product.prodname_projects_v2 %} エクスペリエンスに移行し、テーブル、複数のビュー、新しい自動化オプション、強力なフィールドの種類を試すことができます。 詳しくは、「[プロジェクトについて](/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects)」を参照してください。
|
||||
|
||||
## Migrating an organization project board
|
||||
## 組織のプロジェクト ボードの移行
|
||||
|
||||
{% data reusables.projects.enable-migration %}
|
||||
{% data reusables.profile.access_org %}
|
||||
{% data reusables.user-settings.access_org %}
|
||||
{% data reusables.organizations.organization-wide-project %}
|
||||
1. On the left, click **Projects (classic)**.
|
||||

|
||||
{% data reusables.projects.migrate-project-steps %}
|
||||
{% data reusables.projects.enable-migration %} {% data reusables.profile.access_org %} {% data reusables.user-settings.access_org %} {% data reusables.organizations.organization-wide-project %}
|
||||
1. 左側の **[プロジェクト (クラシック)]** をクリックします。
|
||||
![[プロジェクト (クラシック)] メニュー オプションを示すスクリーンショット](/assets/images/help/issues/projects-classic-org.png) {% data reusables.projects.migrate-project-steps %}
|
||||
|
||||
## Migrating a user project board
|
||||
## ユーザー プロジェクト ボードの移行
|
||||
|
||||
{% data reusables.projects.enable-migration %}
|
||||
{% data reusables.profile.access_profile %}
|
||||
1. On the top of your profile page, in the main navigation, click {% octicon "table" aria-label="The project board icon" %} **Projects**.
|
||||

|
||||
1. Above the list of projects, click **Projects (classic)**.
|
||||

|
||||
{% data reusables.projects.migrate-project-steps %}
|
||||
{% data reusables.projects.enable-migration %} {% data reusables.profile.access_profile %}
|
||||
1. プロファイル ページの上部のメイン ナビゲーションにある {% octicon "table" aria-label="The project board icon" %} **[プロジェクト]** をクリックします。
|
||||
![[プロジェクト] タブを示すスクリーンショット](/assets/images/help/projects-v2/tab-projects.png)
|
||||
1. プロジェクトの一覧の上にある **[プロジェクト (クラシック)]** をクリックします。
|
||||
![[プロジェクト (クラシック)] メニュー オプションを示すスクリーンショット](/assets/images/help/issues/projects-classic-user.png) {% data reusables.projects.migrate-project-steps %}
|
||||
|
||||
## Migrating a repository project board
|
||||
## リポジトリのプロジェクトボードの移行
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** {% data variables.projects.projects_v2_caps %} does not support repository level projects. When you migrate a repository project board, it will migrate to either the organization or personal account that owns the repository project, and the migrated project will be pinned to the original repository.
|
||||
**注:** {% data variables.projects.projects_v2_caps %} では、リポジトリ レベルのプロジェクトはサポートされていません。 リポジトリ プロジェクト ボードを移行すると、リポジトリ プロジェクトを所有する組織または個人アカウントに移行され、移行されたプロジェクトは元のリポジトリにピン留めされます。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.projects.enable-migration %}
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
1. Under your repository name, click {% octicon "table" aria-label="The project board icon" %} **Projects**.
|
||||

|
||||
1. Click **Projects (classic)**.
|
||||

|
||||
{% data reusables.projects.migrate-project-steps %}
|
||||
{% data reusables.projects.enable-migration %} {% data reusables.repositories.navigate-to-repo %}
|
||||
1. リポジトリ名の下にある {% octicon "table" aria-label="The project board icon" %} **[プロジェクト]** をクリックします。
|
||||
![[プロジェクト] タブ](/assets/images/help/projects-v2/repo-tabs-projects.png)
|
||||
1. **[プロジェクト (クラシック)]** をクリックします。
|
||||
![[プロジェクト (クラシック)] メニュー オプションを示すスクリーンショット](/assets/images/help/issues/projects-classic-org.png) {% data reusables.projects.migrate-project-steps %}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Quickstart for GitHub Packages
|
||||
intro: 'Publish to {% data variables.product.prodname_registry %} with {% data variables.product.prodname_actions %}.'
|
||||
title: GitHub Packagesのクイックスタート
|
||||
intro: '{% data variables.product.prodname_actions %}で{% data variables.product.prodname_registry %}に公開します。'
|
||||
allowTitleToDifferFromFilename: true
|
||||
versions:
|
||||
fpt: '*'
|
||||
@@ -8,29 +8,34 @@ versions:
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
shortTitle: Quickstart
|
||||
ms.openlocfilehash: 887c4ee6c5e6b3e2c391c2d5754cfcb2787e4b86
|
||||
ms.sourcegitcommit: cfe91073c844cb762131b2de9fb41f7f9db792fc
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/24/2022
|
||||
ms.locfileid: '148181257'
|
||||
---
|
||||
|
||||
{% data reusables.actions.enterprise-github-hosted-runners %}
|
||||
|
||||
## Introduction
|
||||
## はじめに
|
||||
|
||||
In this guide, you'll create a {% data variables.product.prodname_actions %} workflow to test your code and then publish it to {% data variables.product.prodname_registry %}.
|
||||
このガイドでは、コードをテストする{% data variables.product.prodname_actions %}ワークフローを作成して、それを{% data variables.product.prodname_registry %}に公開します。
|
||||
|
||||
## Publishing your package
|
||||
## パッケージを公開する
|
||||
|
||||
1. Create a new repository on {% data variables.product.prodname_dotcom %}, adding the `.gitignore` for Node. For more information, see "[Creating a new repository](/github/creating-cloning-and-archiving-repositories/creating-a-new-repository)."
|
||||
2. Clone the repository to your local machine.
|
||||
1. {% data variables.product.prodname_dotcom %} に新しいリポジトリを作成し、ノードに `.gitignore` を追加します。 詳細については、「[新しいリポジトリの作成](/github/creating-cloning-and-archiving-repositories/creating-a-new-repository)」を参照してください。
|
||||
2. ローカル コンピューターにリポジトリを複製します。
|
||||
```shell
|
||||
$ git clone https://{% ifversion ghes or ghae %}YOUR-HOSTNAME{% else %}github.com{% endif %}/YOUR-USERNAME/YOUR-REPOSITORY.git
|
||||
$ cd YOUR-REPOSITORY
|
||||
```
|
||||
3. Create an `index.js` file and add a basic alert to say "Hello world!"
|
||||
3. `index.js` ファイルを作成し、「Hello world!」を表示する基本的なアラートを作成します。
|
||||
{% raw %}
|
||||
```javascript{:copy}
|
||||
console.log("Hello, World!");
|
||||
```
|
||||
{% endraw %}
|
||||
4. Initialize an npm package with `npm init`. In the package initialization wizard, enter your package with the name: _`@YOUR-USERNAME/YOUR-REPOSITORY`_, and set the test script to `exit 0`. This will generate a `package.json` file with information about your package.
|
||||
4. npm パッケージを `npm init` で初期化します。 パッケージ初期化ウィザードで、 _`@YOUR-USERNAME/YOUR-REPOSITORY`_ の形式で名前を入力し、テスト スクリプトを `exit 0` に設定します。 これにより、パッケージの情報が付いた `package.json` ファイルが生成されます。
|
||||
{% raw %}
|
||||
```shell
|
||||
$ npm init
|
||||
@@ -41,15 +46,15 @@ In this guide, you'll create a {% data variables.product.prodname_actions %} wor
|
||||
...
|
||||
```
|
||||
{% endraw %}
|
||||
5. Run `npm install` to generate the `package-lock.json` file, then commit and push your changes to {% data variables.product.prodname_dotcom %}.
|
||||
5. `npm install` を実行して `package-lock.json` ファイルを生成し、変更をコミットして {% data variables.product.prodname_dotcom %} にプッシュします。
|
||||
```shell
|
||||
$ npm install
|
||||
$ git add index.js package.json package-lock.json
|
||||
$ git commit -m "initialize npm package"
|
||||
$ git push
|
||||
```
|
||||
6. Create a `.github/workflows` directory. In that directory, create a file named `release-package.yml`.
|
||||
7. Copy the following YAML content into the `release-package.yml` file{% ifversion ghes or ghae %}, replacing `YOUR-HOSTNAME` with the name of your enterprise{% endif %}.
|
||||
6. `.github/workflows` ディレクトリを作成します。 そのディレクトリ内に、`release-package.yml` という名前のファイルを作成します。
|
||||
7. 以下の内容の YAML を `release-package.yml` ファイルにコピーします。{% ifversion ghes or ghae %}`YOUR-HOSTNAME` をエンタープライズの名前に置き換えてください。{% endif %}
|
||||
```yaml{:copy}
|
||||
name: Node.js Package
|
||||
|
||||
@@ -85,22 +90,20 @@ In this guide, you'll create a {% data variables.product.prodname_actions %} wor
|
||||
env:
|
||||
NODE_AUTH_TOKEN: ${% raw %}{{secrets.GITHUB_TOKEN}}{% endraw %}
|
||||
```
|
||||
8. Tell NPM which scope and registry to publish packages to using one of the following methods:
|
||||
- Add an NPM configuration file for the repository by creating a `.npmrc` file in the root directory with the contents:
|
||||
{% raw %}
|
||||
8. NPMに、以下のいずれかの方法を使ってどのスコープ及びリポジトリにパッケージを公開するかを伝えます。
|
||||
- `.npmrc` ファイルを作成することによって、リポジトリのための NPM 設定ファイルを以下の内容でルート ディレクトリに追加する: {% raw %}
|
||||
```shell
|
||||
@YOUR-USERNAME:registry=https://npm.pkg.github.com
|
||||
```
|
||||
{% endraw %}
|
||||
- Edit the `package.json` file and specify the `publishConfig` key:
|
||||
{% raw %}
|
||||
- `package.json` ファイルを編集し、`publishConfig` キーを次のように指定する: {% raw %}
|
||||
```shell
|
||||
"publishConfig": {
|
||||
"@<em>YOUR-USERNAME</em>:registry": "https://npm.pkg.github.com"
|
||||
}
|
||||
```
|
||||
{% endraw %}
|
||||
9. Commit and push your changes to {% data variables.product.prodname_dotcom %}.
|
||||
9. コミットして変更を{% data variables.product.prodname_dotcom %}にプッシュします。
|
||||
```shell
|
||||
$ git add .github/workflows/release-package.yml
|
||||
# Also add the file you created or edited in the previous step.
|
||||
@@ -108,28 +111,26 @@ In this guide, you'll create a {% data variables.product.prodname_actions %} wor
|
||||
$ git commit -m "workflow to publish package"
|
||||
$ git push
|
||||
```
|
||||
10. The workflow that you created will run whenever a new release is created in your repository. If the tests pass, then the package will be published to {% data variables.product.prodname_registry %}.
|
||||
10. 作成したワークフローは、リポジトリに新しいリリースが作成されるたびに実行されます。 テストにパスすると、パッケージは{% data variables.product.prodname_registry %}に公開されます。
|
||||
|
||||
To test this out, navigate to the **Code** tab in your repository and create a new release. For more information, see "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository#creating-a-release)."
|
||||
これを試すには、リポジトリの **[Code]** タブに移動し、新しいリリースを作成します。 詳細については、「[リポジトリのリリースを管理する](/github/administering-a-repository/managing-releases-in-a-repository#creating-a-release)」を参照してください。
|
||||
|
||||
## Viewing your published package
|
||||
## 公開したパッケージを表示する
|
||||
|
||||
You can view all of the packages you have published.
|
||||
公開したすべてのパッケージは、見ることができます。
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.package_registry.packages-from-code-tab %}
|
||||
{% data reusables.package_registry.navigate-to-packages %}
|
||||
{% data reusables.repositories.navigate-to-repo %} {% data reusables.package_registry.packages-from-code-tab %} {% data reusables.package_registry.navigate-to-packages %}
|
||||
|
||||
## Installing a published package
|
||||
## 公開したパッケージをインストールする
|
||||
|
||||
Now that you've published the package, you'll want to use it as a dependency across your projects. For more information, see "[Working with the npm registry](/packages/working-with-a-github-packages-registry/working-with-the-npm-registry#installing-a-package)."
|
||||
これでパッケージを公開できたので、プロジェクト全体で依存関係として利用できます。 詳細については、「[npm レジストリの利用](/packages/working-with-a-github-packages-registry/working-with-the-npm-registry#installing-a-package)」を参照してください。
|
||||
|
||||
## Next steps
|
||||
## 次の手順
|
||||
|
||||
The basic workflow you just added runs any time a new release is created in your repository. But this is only the beginning of what you can do with {% data variables.product.prodname_registry %}. You can publish your package to multiple registries with a single workflow, trigger the workflow to run on different events such as a merged pull request, manage containers, and more.
|
||||
ここで追加した基本的なワークフローは、リポジトリ内に新しいリリースが作成されるたびに実行されます。 ただしこれは、{% data variables.product.prodname_registry %}でできることの手始めにすぎません。 単一のワークフローで複数のレジストリにパッケージを公開する、ワークフローをトリガーしてマージされたプルリクエストなどさまざまなイベントで実行する、コンテナを管理するなど、いろいろなことができます。
|
||||
|
||||
Combining {% data variables.product.prodname_registry %} and {% data variables.product.prodname_actions %} can help you automate nearly every aspect of your application development processes. Ready to get started? Here are some helpful resources for taking your next steps with {% data variables.product.prodname_registry %} and {% data variables.product.prodname_actions %}:
|
||||
{% data variables.product.prodname_registry %}と{% data variables.product.prodname_actions %}を組み合わせることで、プリケーション開発プロセスのほぼすべての要素を自動化するために役立ちます。 使い始める準備はできていますか。 以下は、{% data variables.product.prodname_registry %}および{% data variables.product.prodname_actions %}で次のステップへ進むために役立つリソースです。
|
||||
|
||||
- "[Learn {% data variables.product.prodname_registry %}](/packages/learn-github-packages)" for an in-depth tutorial on GitHub Packages
|
||||
- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)" for an in-depth tutorial on GitHub Actions
|
||||
- "[Working with a {% data variables.product.prodname_registry %} registry](/packages/working-with-a-github-packages-registry)" for specific uses cases and examples
|
||||
- GitHub Packages についての詳細なチュートリアル、「[{% data variables.product.prodname_registry %} を学ぶ](/packages/learn-github-packages)」
|
||||
- GitHub Actions の詳細なチュートリアル、「[{% data variables.product.prodname_actions %} を学ぶ](/actions/learn-github-actions)」
|
||||
- 特定のユース ケースと例のための「[{% data variables.product.prodname_registry %} レジストリの利用](/packages/working-with-a-github-packages-registry)」
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Creating a repository from a template
|
||||
intro: You can generate a new repository with the same directory structure and files as an existing repository.
|
||||
title: テンプレートからリポジトリを作成する
|
||||
intro: 既存のリポジトリと同じディレクトリ構造およびファイルで、新しいリポジトリを作成できます。
|
||||
redirect_from:
|
||||
- /articles/creating-a-repository-from-a-template
|
||||
- /github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template
|
||||
@@ -13,45 +13,46 @@ versions:
|
||||
topics:
|
||||
- Repositories
|
||||
shortTitle: Create from a template
|
||||
ms.openlocfilehash: 16d124431426e19cf95c768e8a4cdaa5f4da2e17
|
||||
ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/09/2022
|
||||
ms.locfileid: '148160244'
|
||||
---
|
||||
## About repository templates
|
||||
## リポジトリテンプレートついて
|
||||
|
||||
Anyone with read permissions to a template repository can create a repository from that template. For more information, see "[Creating a template repository](/articles/creating-a-template-repository)."
|
||||
リポジトリに対する読み取り権限があるユーザなら誰でも、テンプレートからリポジトリを作成できます。 詳細については、「[テンプレート リポジトリの作成](/articles/creating-a-template-repository)」を参照してください。
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Tip**: You can also create a repository from a template using the {% data variables.product.prodname_cli %}. For more information, see "[`gh repo create`](https://cli.github.com/manual/gh_repo_create)" in the {% data variables.product.prodname_cli %} documentation.
|
||||
**ヒント**: {% data variables.product.prodname_cli %} を使用してリポジトリをテンプレートから作成することもできます。 詳細については、{% data variables.product.prodname_cli %} ドキュメントの "[`gh repo create`](https://cli.github.com/manual/gh_repo_create)" を参照してください。
|
||||
|
||||
{% endtip %}
|
||||
|
||||
You can choose to include the directory structure and files from only the default branch of the template repository or to include all branches. Branches created from a template have unrelated histories, which means you cannot create pull requests or merge between the branches.
|
||||
テンプレートリポジトリのデフォルトブランチのみからディレクトリ構造とファイルを含めるか、すべてのブランチを含めるかを選択できます。 テンプレートから作成されたブランチには関連のない履歴があるため、pull request を作成したり、ブランチ間でマージしたりすることはできません。
|
||||
|
||||
Creating a repository from a template is similar to forking a repository, but there are important differences:
|
||||
- A new fork includes the entire commit history of the parent repository, while a repository created from a template starts with a single commit.
|
||||
- Commits to a fork don't appear in your contributions graph, while commits to a repository created from a template do appear in your contribution graph.
|
||||
- A fork can be a temporary way to contribute code to an existing project, while creating a repository from a template starts a new project quickly.
|
||||
テンプレートからリポジトリを作成することは、リポジトリをフォークすることに似ていますが、以下の点で異なります:
|
||||
- 新しいフォークは、親リポジトリのコミット履歴すべてを含んでいますが、テンプレートから作成されたリポジトリには、最初は 1 つのコミットしかありません。
|
||||
- フォークへのコミットはコントリビューショングラフに表示されませんが、テンプレートから作成されたリポジトリへのコミットはコントリビューショングラフに表示されます。
|
||||
- フォークは、既存のプロジェクトにコードをコントリビュートするための一時的な方法となります。テンプレートからリポジトリを作成することは、新しいプロジェクトを素早く始める方法です。
|
||||
|
||||
For more information about forks, see "[About forks](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)."
|
||||
フォークについて詳しくは、「[フォークについて](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)」をご覧ください。
|
||||
|
||||
## Creating a repository from a template
|
||||
## テンプレートからリポジトリを作成する
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
1. Above the file list, click **Use this template**.
|
||||
1. ファイルの一覧の上にある **[Use this template]\(このテンプレートを使用する\)** をクリックします。
|
||||
{% ifversion fpt or ghec %}
|
||||
1. Select **Create a new repository**.
|
||||
1. **[新しいリポジトリの作成]** を選びます。
|
||||
|
||||

|
||||
![[このテンプレートを使用する] ボタン](/assets/images/help/repository/use-this-template-button.png)
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** Alternatively, you can open the template in a codespace and publish your work to a new repository later. For more information, see "[Creating a codespace from a template](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)."
|
||||
**注:** または、codespace でテンプレートを開き、後で作業内容を新しいリポジトリに発行することもできます。 詳しくは、「[テンプレートから codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)」をご覧ください。
|
||||
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
{% data reusables.repositories.owner-drop-down %}
|
||||
{% data reusables.repositories.repo-name %}
|
||||
{% data reusables.repositories.choose-repo-visibility %}
|
||||
1. Optionally, to include the directory structure and files from all branches in the template, and not just the default branch, select **Include all branches**.
|
||||

|
||||
{% data reusables.repositories.select-marketplace-apps %}
|
||||
8. Click **Create repository from template**.
|
||||
{% endnote %} {% endif %} {% data reusables.repositories.owner-drop-down %} {% data reusables.repositories.repo-name %} {% data reusables.repositories.choose-repo-visibility %}
|
||||
1. 必要に応じて、既定のブランチだけでなく、テンプレートのすべてのブランチからディレクトリ構造とファイルを含めるには、 **[すべてのブランチを含める]** を選びます。
|
||||
![[すべてのブランチを含める] チェック ボックス](/assets/images/help/repository/include-all-branches.png) {% data reusables.repositories.select-marketplace-apps %}
|
||||
8. **[Create repository from template]\(テンプレートからリポジトリを作成する\)** をクリックします。
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Automatically generated release notes
|
||||
intro: You can automatically generate release notes for your GitHub releases
|
||||
title: 自動生成リリース ノート
|
||||
intro: GitHub リリースのリリース ノートを自動的に生成できます
|
||||
permissions: Repository collaborators and people with write access to a repository can generate and customize automated release notes for a release.
|
||||
versions:
|
||||
fpt: '*'
|
||||
@@ -13,71 +13,63 @@ shortTitle: Automated release notes
|
||||
communityRedirect:
|
||||
name: Provide GitHub Feedback
|
||||
href: 'https://github.com/orgs/community/discussions/categories/general'
|
||||
ms.openlocfilehash: aee951e6f57492240b5baf8870578409945aefdc
|
||||
ms.sourcegitcommit: 1a77ceb9e20c002173dda983db9405bcd5be254a
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/29/2022
|
||||
ms.locfileid: '148185195'
|
||||
---
|
||||
## 自動生成リリース ノートについて
|
||||
|
||||
## About automatically generated release notes
|
||||
自動生成リリース ノートは、{% data variables.product.prodname_dotcom %} リリースのリリース ノートを手作業で記述する代わりに、自動的に生成する機能です。 自動生成リリース ノートを使うと、リリースの内容の概要をすばやく生成できます。 自動生成されたリリース ノートには、マージされた pull request の一覧、リリースの共同作成者の一覧、完全な変更ログへのリンクが含まれます。
|
||||
|
||||
Automatically generated release notes provide an automated alternative to manually writing release notes for your {% data variables.product.prodname_dotcom %} releases. With automatically generated release notes, you can quickly generate an overview of the contents of a release. Automatically generated release notes include a list of merged pull requests, a list of contributors to the release, and a link to a full changelog.
|
||||
また、自動リリース ノートをカスタマイズし、ラベルを使ってカスタム カテゴリを作成して、含める pull request をまとめたり、特定のラベルとユーザーを出力に表示しないように除外したりすることもできます。
|
||||
|
||||
You can also customize your automated release notes, using labels to create custom categories to organize pull requests you want to include, and exclude certain labels and users from appearing in the output.
|
||||
## 新しいリリースの自動生成リリース ノートを作成する
|
||||
|
||||
## Creating automatically generated release notes for a new release
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.releases %}
|
||||
3. Click **Draft a new release**.
|
||||

|
||||
4. {% ifversion fpt or ghec %}Click **Choose a tag** and type{% else %}Type{% endif %} a version number for your release. Alternatively, select an existing tag.
|
||||
{% ifversion fpt or ghec %}
|
||||

|
||||
5. If you are creating a new tag, click **Create new tag**.
|
||||

|
||||
{% else %}
|
||||

|
||||
{% endif %}
|
||||
6. If you have created a new tag, use the drop-down menu to select the branch that contains the project you want to release.
|
||||
{% ifversion fpt or ghec %}
|
||||
{% else %}
|
||||
{% endif %}
|
||||
{%- data reusables.releases.previous-release-tag %}
|
||||
7. To the top right of the description text box, click {% ifversion previous-release-tag %}**Generate release notes**{% else %}**Auto-generate release notes**{% endif %}.{% ifversion previous-release-tag %}
|
||||
{% else %}
|
||||
{% endif %}
|
||||
8. Check the generated notes to ensure they include all (and only) the information you want to include.
|
||||
9. Optionally, to include binary files such as compiled programs in your release, drag and drop or manually select files in the binaries box.
|
||||

|
||||
10. To notify users that the release is not ready for production and may be unstable, select **This is a pre-release**.
|
||||

|
||||
{%- ifversion fpt or ghec %}
|
||||
11. Optionally, select **Create a discussion for this release**, then select the **Category** drop-down menu and click a category for the release discussion.
|
||||

|
||||
{%- endif %}
|
||||
12. If you're ready to publicize your release, click **Publish release**. To work on the release later, click **Save draft**.
|
||||

|
||||
{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.releases %}
|
||||
3. **[新しいリリースの下書き]** をクリックします。
|
||||

|
||||
4. {% ifversion fpt or ghec %} **[タグの選択]** をクリックして、{% else %}{% endif %}リリースのバージョン番号を入力します。 または、既存のタグを選びます。
|
||||
{% ifversion fpt or ghec %} 
|
||||
5. 新しいタグを作成する場合は、 **[新しいタグの作成]** をクリックします。
|
||||
{% else %}{% endif %}
|
||||
6. 新しいタグを作成した場合は、ドロップダウン メニューを使ってリリース対象のプロジェクトを含むブランチを選択します。
|
||||
{% ifversion fpt or ghec %} {% else %} {% endif %} {%- data reusables.releases.previous-release-tag %}
|
||||
7. 説明テキスト ボックスの右上で、{% ifversion previous-release-tag %} **[リリース ノートの生成]** {% else %} **[リリース ノートの自動生成]** {% endif %}.{% ifversion previous-release-tag %} ![[リリース ノートの生成]](/assets/images/help/releases/generate-release-notes.png){% else %} ![[リリース ノートの自動生成]](/assets/images/enterprise/3.5/releases/auto-generate-release-notes.png){% endif %}をクリックします
|
||||
8. 生成されたノートをチェックし、含めたい情報がすべて (そしてそれだけが) 含まれることを確認します。
|
||||
9. オプションで、コンパイルされたプログラムなどのバイナリファイルをリリースに含めるには、ドラッグアンドドロップするかバイナリボックスで手動で選択します。
|
||||

|
||||
10. リリースが不安定であり、運用の準備ができていないことをユーザーに通知するには、 **[これはプレリリースです]** を選択します。
|
||||
{%- ifversion fpt or ghec %}
|
||||
11. 必要に応じて、 **[このリリースのディスカッションを作成する]** を選び、 **[カテゴリ]** ドロップダウン メニューを選んでリリース ディスカッションのカテゴリをクリックします。
|
||||
{%- endif %}
|
||||
12. リリースを公開する準備ができている場合は、 **[リリースの公開]** をクリックします。 リリースの作業を後でする場合は、 **[下書きの保存]** をクリックします。
|
||||
![[リリースの公開] と [下書きの保存] ボタン](/assets/images/help/releases/release_buttons.png)
|
||||
|
||||
|
||||
## Configuring automatically generated release notes
|
||||
## 自動生成リリース ノートを構成する
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.files.add-file %}
|
||||
3. In the file name field, type `.github/release.yml` to create the `release.yml` file in the `.github` directory.
|
||||

|
||||
4. In the file, using the configuration options below, specify in YAML the pull request labels and authors you want to exclude from this release. You can also create new categories and list the pull request labels to be included in each of them.
|
||||
{% data reusables.repositories.navigate-to-repo %} {% data reusables.files.add-file %}
|
||||
3. ファイル名フィールドに「`.github/release.yml`」と入力して、`.github` ディレクトリに `release.yml` ファイルを作成します。
|
||||
![[新しいファイルの作成]](/assets/images/help/releases/release-yml.png)
|
||||
4. このファイルでは、以下の構成オプションを使って、このリリースから除外する pull request ラベルと作成者を YAML で指定します。 新しいカテゴリを作成し、それぞれに含める pull request ラベルを列記することもできます。
|
||||
|
||||
### Configuration options
|
||||
### 構成オプション
|
||||
|
||||
| Parameter | Description |
|
||||
| パラメーター | 説明 |
|
||||
| :- | :- |
|
||||
| `changelog.exclude.labels` | A list of labels that exclude a pull request from appearing in release notes. |
|
||||
| `changelog.exclude.authors` | A list of user or bot login handles whose pull requests are to be excluded from release notes. |
|
||||
| `changelog.categories[*].title` | **Required.** The title of a category of changes in release notes. |
|
||||
| `changelog.categories[*].labels`| **Required.** Labels that qualify a pull request for this category. Use `*` as a catch-all for pull requests that didn't match any of the previous categories. |
|
||||
| `changelog.categories[*].exclude.labels` | A list of labels that exclude a pull request from appearing in this category. |
|
||||
| `changelog.categories[*].exclude.authors` | A list of user or bot login handles whose pull requests are to be excluded from this category. |
|
||||
| `changelog.exclude.labels` | リリース ノートに表示しない pull request のラベルの一覧。 |
|
||||
| `changelog.exclude.authors` | pull request をリリース ノートから除外するユーザーまたはボット ログイン ハンドルの一覧。 |
|
||||
| `changelog.categories[*].title` | **必須。** リリース ノートでの変更のカテゴリのタイトル。 |
|
||||
| `changelog.categories[*].labels`| **必須。** このカテゴリの pull request を修飾するラベル。 前のカテゴリのいずれにも一致しなかった pull request のキャッチオールとして `*` を使います。 |
|
||||
| `changelog.categories[*].exclude.labels` | このカテゴリに表示しない pull request のラベルの一覧。 |
|
||||
| `changelog.categories[*].exclude.authors` | pull request をこのカテゴリから除外するユーザーまたはボット ログイン ハンドルの一覧。 |
|
||||
|
||||
### Example configurations
|
||||
### 構成例
|
||||
|
||||
A configuration for a repository that labels semver releases
|
||||
semver リリースにラベルを付けるリポジトリの構成
|
||||
|
||||
{% raw %}
|
||||
```yaml{:copy}
|
||||
@@ -104,7 +96,7 @@ changelog:
|
||||
```
|
||||
{% endraw %}
|
||||
|
||||
A configuration for a repository that doesn't tag pull requests but where we want to separate out {% data variables.product.prodname_dependabot %} automated pull requests in release notes (`labels: '*'` is required to display a catchall category)
|
||||
pull request にはタグを付けないが、{% data variables.product.prodname_dependabot %} の自動 pull request はリリース ノートで分離する必要があるリポジトリの構成 (汎用カテゴリを表示するために `labels: '*'` が必要です)
|
||||
|
||||
{% raw %}
|
||||
```yaml{:copy}
|
||||
@@ -124,6 +116,6 @@ changelog:
|
||||
```
|
||||
{% endraw %}
|
||||
|
||||
## Further reading
|
||||
## 参考資料
|
||||
|
||||
- "[Managing labels](/issues/using-labels-and-milestones-to-track-work/managing-labels)"
|
||||
- [ラベルを管理する](/issues/using-labels-and-milestones-to-track-work/managing-labels)
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Understanding connections between repositories
|
||||
intro: Use the network graph and forks list to understand fork networks.
|
||||
title: リポジトリ間の接続を理解する
|
||||
intro: ネットワーク グラフとフォークの一覧を使用して、フォークのネットワークを理解します。
|
||||
product: '{% data reusables.gated-features.repository-insights %}'
|
||||
redirect_from:
|
||||
- /articles/viewing-a-repository-s-network
|
||||
@@ -22,57 +22,60 @@ versions:
|
||||
topics:
|
||||
- Repositories
|
||||
shortTitle: Connections between repositories
|
||||
ms.openlocfilehash: 46cc440093c3ca8dc0952933847a6f04b0446661
|
||||
ms.sourcegitcommit: 468a0323fa636517985a3e08e2772dbb0545cab8
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/03/2022
|
||||
ms.locfileid: '148191359'
|
||||
---
|
||||
## リポジトリのネットワークを表示する
|
||||
|
||||
## Viewing a repository's network
|
||||
|
||||
The network graph displays the branch history of the entire repository network, including fork branches. This graph is a timeline of the most recent commits, and shows up to 100 of the most recently pushed-to branches. The first row references the date and the first column references the branch owner. Use arrow keys or other keyboard shortcuts to more easily navigate the graph. They are provided in the “Keyboard shortcuts available” pop up under the graph.
|
||||
ネットワーク グラフには、フォーク ブランチを含む、リポジトリ ネットワーク全体のブランチ履歴が表示されます。 このグラフは最新のコミットのタイムラインであり、最近ブランチにプッシュされたものが最大 100 個まで表示されます。 最初の行は日付を参照し、最初の列はブランチ所有者を参照します。 方向キーやその他のキーボード ショートカットを使用して、グラフをより簡単に移動できます。 それらは、グラフの下の [Keyboard shortcuts available] ポップアップに表示されます。
|
||||
|
||||
|
||||

|
||||

|
||||
|
||||
{% tip %}
|
||||
|
||||
**Tip:** To see older branches, click and drag within the graph.
|
||||
**参考:** 古いブランチを表示するには、グラフ内をクリックしてドラッグします。
|
||||
|
||||
{% endtip %}
|
||||
|
||||
## Accessing the network graph
|
||||
## ネットワークグラフにアクセスする
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.accessing-repository-graphs %}
|
||||
3. In the left sidebar, click **Network**.
|
||||

|
||||
{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.accessing-repository-graphs %}
|
||||
3. 左側のサイドバーで、 **[ネットワーク]** をクリックします。
|
||||
![[ネットワーク] タブ](/assets/images/help/graphs/network_tab.png)
|
||||
|
||||
## Listing the forks of a repository
|
||||
## リポジトリのフォークをリストする
|
||||
|
||||
The Members graph displays all the forks of a repository.
|
||||
メンバーグラフには、リポジトリのすべてのフォークが表示されます。
|
||||
|
||||
Forks are listed alphabetically by the organization or username of the person who forked the repository. You can click on the organization or username to be redirected to the organization or user's {% data variables.product.product_name %} profile page or click on the fork name to be redirected to the specific fork of the repository.
|
||||
フォークは、リポジトリをフォークしたユーザーの組織または名前のアルファベット順に表示されます。 組織またはユーザー名をクリックして、その組織またはユーザーの {% data variables.product.product_name %} プロファイル ページに移動したり、またはフォーク名をクリックして、リポジトリの特定のフォークに移動したりできます。
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
|
||||

|
||||

|
||||
|
||||
{% else %}
|
||||
|
||||

|
||||

|
||||
|
||||
{% endif %}
|
||||
|
||||
### Accessing the Members graph
|
||||
### メンバーグラフにアクセスする
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.accessing-repository-graphs %}
|
||||
3. In the left sidebar, click **Forks**.
|
||||

|
||||
{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.accessing-repository-graphs %}
|
||||
3. 左側のサイドバーで、 **[フォーク]** をクリックします。
|
||||
![[フォーク] タブ](/assets/images/help/graphs/graphs-sidebar-forks-tab.png)
|
||||
|
||||
## Viewing the dependencies of a repository
|
||||
## リポジトリの依存関係を表示する
|
||||
|
||||
You can use the dependency graph to explore the code your repository depends on.
|
||||
依存関係グラフを使用して、リポジトリが依存するコードを調べることができます。
|
||||
|
||||
Almost all software relies on code developed and maintained by other developers, often known as a supply chain. For example, utilities, libraries, and frameworks. These dependencies are an integral part of your code and any bugs or vulnerabilities in them may affect your code. It's important to review and maintain these dependencies.
|
||||
ほとんどすべてのソフトウェアは、他の開発者 (サプライチェーンとして知られる) によって開発および保守されているコードに依存しています。 たとえば、ユーティリティ、ライブラリ、フレームワークなどです。 これらの依存関係はコードの不可欠な部分であり、それらのバグや脆弱性がコードに影響を与える可能性があります。 これらの依存関係をレビューして維持することが重要です。
|
||||
|
||||
The dependency graph provides a great way to visualize and explore the dependencies for a repository. For more information, see "[About the dependency graph](/code-security/supply-chain-security/about-the-dependency-graph)" and "[Exploring the dependencies of a repository](/code-security/supply-chain-security/exploring-the-dependencies-of-a-repository)."
|
||||
依存関係グラフは、リポジトリの依存関係を視覚化して調査するために最適な方法を提供しています。 詳しくは、「[依存関係グラフについて](/code-security/supply-chain-security/about-the-dependency-graph)」と「[リポジトリの依存関係を調べる](/code-security/supply-chain-security/exploring-the-dependencies-of-a-repository)」を参照してください。
|
||||
|
||||
You can also set up your repository so that {% data variables.product.company_short %} alerts you automatically whenever a security vulnerability is found in one of your dependencies. For more information, see "[About {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)."
|
||||
依存関係の 1 つにセキュリティの脆弱性が見つかった場合は、{% data variables.product.company_short %} が自動的に警告するようにリポジトリを設定することもできます。 詳細については、「[{% data variables.product.prodname_dependabot_alerts %} について](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)」を参照してください。
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Viewing a file
|
||||
intro: You can view raw file content or trace changes to lines in a file and discover how parts of the file evolved over time.
|
||||
title: ファイルの表示
|
||||
intro: 生ファイルの内容を表示するか、ファイルの行に対する変更を追跡し、時間の経過とともにファイルの各部分がどのように変化したかを確認できます。
|
||||
redirect_from:
|
||||
- /articles/using-git-blame-to-trace-changes-in-a-file
|
||||
- /articles/tracing-changes-in-a-file
|
||||
@@ -16,48 +16,54 @@ versions:
|
||||
topics:
|
||||
- Repositories
|
||||
shortTitle: View files and track file changes
|
||||
ms.openlocfilehash: 7d34e776cb1747ee749531e49abf6f0e3d052b3b
|
||||
ms.sourcegitcommit: 82b1242de02ecc4bdec02a5b6d11568fb2deb1aa
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/21/2022
|
||||
ms.locfileid: '148179864'
|
||||
---
|
||||
## Viewing or copying the raw file content
|
||||
## 生ファイルの内容を表示またはコピーする
|
||||
|
||||
With the raw view, you can view or copy the raw content of a file without any styling.
|
||||
生のビューを使用すると、スタイルを設定せずにファイルの生のコンテンツを表示またはコピーできます。
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
1. Click the file that you want to view.
|
||||
2. In the upper-right corner of the file view, click **Raw**.
|
||||

|
||||
3. Optionally, to copy the raw file content, in the upper-right corner of the file view, click **{% octicon "copy" aria-label="The copy icon" %}**.
|
||||
1. 表示するファイルをクリックします。
|
||||
2. ファイル ビューの右上隅にある **[未加工]** をクリックします。
|
||||
![ファイル ヘッダーの [未加工] ボタンのスクリーンショット](/assets/images/help/repository/raw-file-button.png)
|
||||
3. 必要に応じて、生ファイルの内容をコピーするには、ファイル ビューの右上隅にある **{% octicon "copy" aria-label="The copy icon" %}** をクリックします。
|
||||
|
||||
## Viewing the line-by-line revision history for a file
|
||||
## ファイルの行ごとのリビジョン履歴の表示
|
||||
|
||||
With the blame view, you can view the line-by-line revision history for an entire file, or view the revision history of a single line within a file by clicking {% octicon "versions" aria-label="The prior blame icon" %}. Each time you click {% octicon "versions" aria-label="The prior blame icon" %}, you'll see the previous revision information for that line, including who committed the change and when.
|
||||
[変更履歴] ビューでは、{% octicon "versions" aria-label="The prior blame icon" %} をクリックすることで、ファイル全体の行ごとのリビジョン履歴やファイル内の 1 つの行のリビジョン履歴を表示することができます。 {% octicon "versions" aria-label="The prior blame icon" %} をクリックするたびに、変更をコミットした者と時間を含む、その行の過去のリビジョン情報が表示されます。
|
||||
|
||||

|
||||

|
||||
|
||||
In a file or pull request, you can also use the {% octicon "kebab-horizontal" aria-label="The horizontal kebab octicon" %} menu to view Git blame for a selected line or range of lines.
|
||||
ファイルや pull request では、{% octicon "kebab-horizontal" aria-label="The horizontal kebab octicon" %} メニューを使って、選択した行または行の範囲の Git blame を表示することもできます。
|
||||
|
||||

|
||||

|
||||
|
||||
{% tip %}
|
||||
|
||||
**Tip:** On the command line, you can also use `git blame` to view the revision history of lines within a file. For more information, see [Git's `git blame` documentation](https://git-scm.com/docs/git-blame).
|
||||
**ヒント:** コマンド ラインでは、`git blame` を使用してファイル内の行のリビジョン履歴を表示することもできます。 詳細については、[Git`git blame` のドキュメント](https://git-scm.com/docs/git-blame)を参照してください。
|
||||
|
||||
{% endtip %}
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
2. Click to open the file whose line history you want to view.
|
||||
3. In the upper-right corner of the file view, click **Blame** to open the blame view.
|
||||

|
||||
4. To see earlier revisions of a specific line, or reblame, click {% octicon "versions" aria-label="The prior blame icon" %} until you've found the changes you're interested in viewing.
|
||||

|
||||
2. クリックして、表示したい行の履歴のファイルを開きます。
|
||||
3. ファイル ビューの右上隅で **[変更履歴]** をクリックして [変更履歴] ビューを開きます。
|
||||
![[変更履歴]](/assets/images/help/repository/blame-button.png) ボタン
|
||||
4. 特定の行の過去のリビジョンを表示、または変更履歴の変更を行うには、見てみたい変更が見つかるまで {% octicon "versions" aria-label="The prior blame icon" %} をクリックします。
|
||||

|
||||
|
||||
{% ifversion blame-ignore-revs %}
|
||||
|
||||
## Ignore commits in the blame view
|
||||
## [変更履歴] ビューのコミットを無視する
|
||||
|
||||
All revisions specified in the `.git-blame-ignore-revs` file, which must be in the root directory of your repository, are hidden from the blame view using Git's `git blame --ignore-revs-file` configuration setting. For more information, see [`git blame --ignore-revs-file`](https://git-scm.com/docs/git-blame#Documentation/git-blame.txt---ignore-revs-fileltfilegt) in the Git documentation.
|
||||
リポジトリのルート ディレクトリ内に存在しなければならない、`.git-blame-ignore-revs` ファイルで指定されたリビジョンはすべて、Git `git blame --ignore-revs-file` の構成設定を使用して、[変更履歴] ビューに表示されなくなります。 詳細については、Git ドキュメントにある「[`git blame --ignore-revs-file`](https://git-scm.com/docs/git-blame#Documentation/git-blame.txt---ignore-revs-fileltfilegt)」を参照してください。
|
||||
|
||||
1. In the root directory of your repository, create a file named `.git-blame-ignore-revs`.
|
||||
2. Add the commit hashes you want to exclude from the blame view to that file. We recommend the file to be structured as follows, including comments:
|
||||
1. リポジトリのルート ディレクトリに `.git-blame-ignore-revs` という名前のフォルダーを作成します。
|
||||
2. [変更履歴] ビューから除外するコミット ハッシュをそのファイルに追加します。 コメントを含め、次のようにファイルを構成することをお勧めします。
|
||||
|
||||
```ini
|
||||
# .git-blame-ignore-revs
|
||||
@@ -67,19 +73,19 @@ All revisions specified in the `.git-blame-ignore-revs` file, which must be in t
|
||||
69d029cec8337c616552756310748c4a507bd75a
|
||||
```
|
||||
|
||||
3. Commit and push the changes.
|
||||
3. 変更をコミットしてプッシュします。
|
||||
|
||||
Now when you visit the blame view, the listed revisions will not be included in the blame. You'll see an **Ignoring revisions in .git-blame-ignore-revs** banner indicating that some commits may be hidden:
|
||||
ここで、[変更履歴] ビューにアクセスしても、一覧表示されたリビジョンは変更履歴に含まれません。 **[.git-blame-ignore-revs でのリビジョンの無視]** バナーが表示され、一部のコミットが非表示になっている可能性があることが示されます。
|
||||
|
||||

|
||||
![.git-blame-ignore-revs ファイルにリンクしている [変更履歴] ビューのバナーのスクリーンショット](/assets/images/help/repository/blame-ignore-revs-file.png)
|
||||
|
||||
This can be useful when a few commits make extensive changes to your code. You can use the file when running `git blame` locally as well:
|
||||
これは、いくつかのコミットがコードに広範な変更を加える場合に役立ちます。 このファイルは、ローカルで `git blame` を実行する場合にも使用できます。
|
||||
|
||||
```shell
|
||||
git blame --ignore-revs-file .git-blame-ignore-revs
|
||||
```
|
||||
|
||||
You can also configure your local git so it always ignores the revs in that file:
|
||||
ローカル Git を構成して、そのファイルのリビジョンを常に無視することもできます。
|
||||
|
||||
```shell
|
||||
git config blame.ignoreRevsFile .git-blame-ignore-revs
|
||||
@@ -87,6 +93,6 @@ git config blame.ignoreRevsFile .git-blame-ignore-revs
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Bypassing `.git-blame-ignore-revs` in the blame view
|
||||
## [変更履歴] ビューで `.git-blame-ignore-revs` をバイパスする
|
||||
|
||||
If the blame view for a file shows **Ignoring revisions in .git-blame-ignore-revs**, you can still bypass `.git-blame-ignore-revs` and see the normal blame view. In the URL, append a `~` to the SHA and the **Ignoring revisions in .git-blame-ignore-revs** will disappear.
|
||||
ファイルの [変更履歴] ビューに **[Ignoring revisions in .git-blame-ignore-revs]\(.git-blame-ignore-revs でリビジョンを無視する\)** と表示されている場合でも、`.git-blame-ignore-revs` をバイパスして通常の [変更履歴] ビューを表示できます。 URL で `~` を SHA に追加すると、 **[Ignoring revisions in .git-blame-ignore-revs]\(.git-blame-ignore-revs でリビジョンを無視する\)** が消えます。
|
||||
|
||||
@@ -11,12 +11,12 @@ versions:
|
||||
ghec: '*'
|
||||
topics:
|
||||
- API
|
||||
ms.openlocfilehash: ab880cef09b936bb573d783373f048395d0a2f58
|
||||
ms.sourcegitcommit: 16548aa24259e37cc0ac4900ca8fefc46dc84cdb
|
||||
ms.openlocfilehash: 5f633132edddb17ae129a3feba791ab8ec780366
|
||||
ms.sourcegitcommit: 9af8891fea10039b3374c76818634e05410e349d
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/01/2022
|
||||
ms.locfileid: '148190062'
|
||||
ms.lasthandoff: 12/06/2022
|
||||
ms.locfileid: '148191879'
|
||||
---
|
||||

|
||||
|
||||
@@ -26,7 +26,7 @@ ms.locfileid: '148190062'
|
||||
|
||||
- **Ruby** → [octokit.rb](https://github.com/octokit/octokit.rb)
|
||||
- **.NET** → [octokit.net](https://github.com/octokit/octokit.net)
|
||||
- **JavaScript** → [octokit/octokit.js](https://github.com/octokit/octokit.js)
|
||||
- **JavaScript** → [octokit.js](https://github.com/octokit/octokit.js)
|
||||
|
||||
## サードパーティ製ライブラリ
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: サポート チケットの表示と更新
|
||||
intro: '{% data variables.contact.support_portal %} を使って、サポート チケットを表示したり、{% ifversion ghes or ghec %}同僚と共同でチケットの作業を行ったり、{% endif %}{% data variables.contact.github_support %} に応答したりできます。'
|
||||
title: Viewing and updating support tickets
|
||||
intro: 'You can view your support tickets{% ifversion ghes or ghec %}, collaborate with colleagues on tickets,{% endif %} and respond to {% data variables.contact.github_support %} using the {% data variables.contact.support_portal %}.'
|
||||
shortTitle: Managing your tickets
|
||||
versions:
|
||||
fpt: '*'
|
||||
@@ -8,62 +8,64 @@ versions:
|
||||
ghes: '*'
|
||||
topics:
|
||||
- Support
|
||||
ms.openlocfilehash: 35c7b28232c0d11170ea9585480b2cfb1785ebd0
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147051981'
|
||||
---
|
||||
## チケット管理について
|
||||
|
||||
## About ticket management
|
||||
|
||||
{% data reusables.support.zendesk-old-tickets %}
|
||||
|
||||
[GitHub Support ポータル](https://support.github.com/)を使用して、現在および過去のサポート チケットを表示し、{% data variables.contact.github_support %} に応答できます。 120 日を過ぎると、解決されたチケットはアーカイブされ{% ifversion ghec or ghes or ghae %}、アーカイブされたチケットは Enterprise アカウントについてのみ表示でき{% endif %}ます。
|
||||
You can use the [GitHub Support Portal](https://support.github.com/) to view current and past support tickets and respond to {% data variables.contact.github_support %}. After 120 days, resolved tickets are archived{% ifversion ghec or ghes or ghae %}, and archived tickets can only be viewed for enterprise accounts{% endif %}.
|
||||
|
||||
{% ifversion ghes or ghec %} {% data reusables.enterprise-accounts.support-entitlements %} {% endif %}
|
||||
{% ifversion ghes or ghec %}
|
||||
{% data reusables.enterprise-accounts.support-entitlements %}
|
||||
{% endif %}
|
||||
|
||||
## 最近のサポート チケットを表示する
|
||||
## Viewing your recent support tickets
|
||||
|
||||
{% data reusables.support.view-open-tickets %}
|
||||
1. テキスト ボックスの下で、コメント履歴を読むことができます。 最新の応答は一番上にあります。
|
||||

|
||||
1. Under the text box, you can read the comment history. The most recent response is at the top.
|
||||
|
||||

|
||||
|
||||
1. Optionally, to translate the ticket comment, click {% octicon "globe" aria-label="The globe icon" %} and choose your preferred language from the dropdown menu. You can translate your support ticket into Chinese (Simplified), French, German, Japanese, Portuguese (Brazil), or Spanish.
|
||||
|
||||

|
||||
|
||||
{% ifversion ghec or ghes or ghae %}
|
||||
|
||||
## アーカイブされたサポート チケットを表示する
|
||||
## Viewing your archived support tickets
|
||||
|
||||
Enterprise アカウントのアーカイブ済みチケットのみを表示できます。
|
||||
You can only view archived tickets for an enterprise account.
|
||||
|
||||
{% data reusables.support.navigate-to-my-tickets %}
|
||||
1. **[マイ チケット]** ドロップダウン メニューを選んで、Enterprise アカウントの名前をクリックします。
|
||||
1. Select the **My Tickets** drop-down menu and click the name of the enterprise account.
|
||||
|
||||
{% indented_data_reference reusables.support.entitlements-note spaces=3 %}
|
||||
|
||||
![[マイ チケット] ドロップダウン メニューのスクリーンショット。](/assets/images/help/support/ticket-context.png)
|
||||
1. [マイ チケット] テーブルで **[アーカイブ済みチケットの表示]** をクリックします。
|
||||

|
||||
1. Under the "My tickets" table, click **View archived tickets**.
|
||||
|
||||
{% endif %}
|
||||
|
||||
## サポート チケットの更新
|
||||
## Updating support tickets
|
||||
|
||||
{% data reusables.support.view-open-tickets %}
|
||||
1. 必要に応じて、Issue が解決した場合は、テキスト ボックスの下にある **[チケットを閉じる]** をクリックします。
|
||||
![[チケットを閉じる] ボタンの場所を示すスクリーンショット。](/assets/images/help/support/close-ticket.png)
|
||||
1. GitHub Support に返信し、チケットに新しいコメントを追加するには、テキスト ボックスに返信を入力します。
|
||||
![[コメントの追加] テキスト フィールドのスクリーンショット。](/assets/images/help/support/new-comment-field.png)
|
||||
1. チケットにコメントを追加するには、 **[コメント]** をクリックします。
|
||||
![[コメント] ボタンのスクリーンショット。](/assets/images/help/support/add-comment.png)
|
||||
1. Optionally, if the issue is resolved, under the text box, click **Close ticket**.
|
||||

|
||||
1. To respond to GitHub Support and add a new comment to the ticket, type your response in the text box.
|
||||

|
||||
1. To add your comment to the ticket, click **Comment**.
|
||||

|
||||
|
||||
{% ifversion ghec or ghes %}
|
||||
## サポート チケットでの共同作業
|
||||
## Collaborating on support tickets
|
||||
|
||||
サポート ポータルを使用して、サポート チケットについて同僚と共同作業を行うことができます。 所有者、課金マネージャー、サポート資格を持つその他のエンタープライズ メンバーは、エンタープライズ アカウントまたはエンタープライズ アカウントによって管理されている Organization に関連付けられているチケットを表示できます。 詳細については、「[Managing support entitlements for your enterprise (エンタープライズのサポート エンタイトルメントの管理)](/enterprise-cloud@latest/admin/user-management/managing-users-in-your-enterprise/managing-support-entitlements-for-your-enterprise)」を参照してください。
|
||||
You can collaborate with your colleagues on support tickets using the support portal. Owners, billing managers, and other enterprise members with support entitlements can view tickets associated with an enterprise account or an organization managed by an enterprise account. For more information, see "[Managing support entitlements for your enterprise](/enterprise-cloud@latest/admin/user-management/managing-users-in-your-enterprise/managing-support-entitlements-for-your-enterprise)."
|
||||
|
||||
チケットの表示に加えて、チケットに自分のメール アドレスがコピーされている場合や、チケットを開いた人がエンタープライズ アカウントまたはエンタープライズ アカウントで管理されている Organization で確認済みのドメインを持つメール アドレスを使用した場合は、サポート チケットにコメントを追加することもできます。 ドメインの確認の詳細については、「[企業のドメインの確認または承認](/enterprise-cloud@latest/admin/configuration/configuring-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise)」および「[Organization のドメインの確認または承認](/enterprise-cloud@latest/organizations/managing-organization-settings/verifying-or-approving-a-domain-for-your-organization)」を参照してください。
|
||||
In addition to viewing tickets, you can also add comments to support tickets if your email address is copied on the ticket or if the person who opened the ticket used an email address with a domain that is verified for the enterprise account or organization managed by an enterprise account. For more information about verifying a domain, see "[Verifying or approving a domain for your enterprise](/enterprise-cloud@latest/admin/configuration/configuring-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise)" and "[Verifying or approving a domain for your organization](/enterprise-cloud@latest/organizations/managing-organization-settings/verifying-or-approving-a-domain-for-your-organization)."
|
||||
|
||||
{% endif %}
|
||||
|
||||
## 参考資料
|
||||
## Further reading
|
||||
|
||||
- "[GitHub サポートについて](/support/learning-about-github-support/about-github-support)"
|
||||
- "[About GitHub Support](/support/learning-about-github-support/about-github-support)"
|
||||
|
||||
@@ -83,6 +83,10 @@ If you have any paid product or are a member of an organization with a paid prod
|
||||
With {% data variables.product.product_name %}, you have access to support in English and Japanese.
|
||||
{% endif %}
|
||||
|
||||
{% ifversion fpt or ghec or ghes %}
|
||||
{% data reusables.support.support-ticket-translation-option %}
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghes or ghec %}
|
||||
|
||||
To contact {% data variables.contact.github_support %}, visit the {% data variables.contact.contact_support_portal %}. For more information, see "[Creating a support ticket](/support/contacting-github-support/creating-a-support-ticket)."
|
||||
|
||||
@@ -29,4 +29,5 @@ sections:
|
||||
- Actions services need to be restarted after restoring an appliance from a backup taken on a different host.
|
||||
- '{% data reusables.release-notes.ghas-3.4-secret-scanning-known-issue %}'
|
||||
- |
|
||||
GitHub Pages builds may time out on instances in AWS that are configured for high availability. [Updated: 2022-11-28]
|
||||
GitHub Pages builds may time out on instances in AWS that are configured for high availability. [Updated: 2022-11-28]
|
||||
- '{% data reusables.release-notes.babeld-max-threads-performance-issue %}'
|
||||