New translation batch for ja (#33551)
This commit is contained in:
@@ -1,5 +1,6 @@
|
||||
---
|
||||
title: JavaScript アクションを作成する
|
||||
shortTitle: Create a JavaScript action
|
||||
intro: このガイドでは、アクションツールキットを使って JavaScript アクションをビルドする方法について学びます。
|
||||
redirect_from:
|
||||
- /articles/creating-a-javascript-action
|
||||
@@ -15,13 +16,12 @@ type: tutorial
|
||||
topics:
|
||||
- Action development
|
||||
- JavaScript
|
||||
shortTitle: JavaScript action
|
||||
ms.openlocfilehash: c42dca4205519f6799d7f92b254b75696853b7f9
|
||||
ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d
|
||||
ms.openlocfilehash: 60fd562df55756afd081c395d9cffee89c2c04d6
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/10/2022
|
||||
ms.locfileid: '145088655'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192746'
|
||||
---
|
||||
{% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %}
|
||||
|
||||
@@ -41,11 +41,11 @@ ms.locfileid: '145088655'
|
||||
|
||||
開始する前に、Node.jsをダウンロードし、パブリック {% data variables.product.prodname_dotcom %} リポジトリを作成する必要があります。
|
||||
|
||||
1. npm を含む Node.js {% ifversion fpt or ghes > 3.3 or ghae-issue-5504 or ghec %}16.x{% else %}12.x{% endif %} をダウンロードしてインストールします。
|
||||
1. npm を含む Node.js {% ifversion fpt or ghes > 3.3 or ghae > 3.3 or ghec %}16.x{% else %}12.x{% endif %} をダウンロードしてインストールします。
|
||||
|
||||
{% ifversion fpt or ghes > 3.3 or ghae-issue-5504 or ghec %} https://nodejs.org/en/download/{% else %} https://nodejs.org/en/download/releases/{% endif %}
|
||||
{% ifversion fpt or ghes > 3.3 or ghae > 3.3 or ghec %} https://nodejs.org/en/download/{% else %} https://nodejs.org/en/download/releases/{% endif %}
|
||||
|
||||
1. {% data variables.product.product_location %} 上に新しいパブリック リポジトリを作成し、それを "hello-world-javascript-action" と呼びます。 詳細については、「[新しいリポジトリの作成](/articles/creating-a-new-repository)」を参照してください。
|
||||
1. {% data variables.location.product_location %} 上に新しいパブリック リポジトリを作成し、それを "hello-world-javascript-action" と呼びます。 詳細については、「[新しいリポジトリの作成](/articles/creating-a-new-repository)」を参照してください。
|
||||
|
||||
1. リポジトリをお手元のコンピューターにクローンします。 詳細については、「[リポジトリをクローンする](/articles/cloning-a-repository)」を参照してください。
|
||||
|
||||
@@ -77,7 +77,7 @@ outputs:
|
||||
time: # id of output
|
||||
description: 'The time we greeted you'
|
||||
runs:
|
||||
using: {% ifversion fpt or ghes > 3.3 or ghae-issue-5504 or ghec %}'node16'{% else %}'node12'{% endif %}
|
||||
using: {% ifversion fpt or ghes > 3.3 or ghae > 3.3 or ghec %}'node16'{% else %}'node12'{% endif %}
|
||||
main: 'index.js'
|
||||
```
|
||||
|
||||
@@ -145,29 +145,31 @@ try {
|
||||
- アクションで使用される環境変数。
|
||||
- ワークフローでのアクションの使用方法の例。
|
||||
|
||||
```markdown{:copy}
|
||||
````markdown{:copy}
|
||||
# Hello world javascript action
|
||||
|
||||
This action prints "Hello World" or "Hello" + the name of a person to greet to the log.
|
||||
|
||||
## Inputs
|
||||
|
||||
## `who-to-greet`
|
||||
### `who-to-greet`
|
||||
|
||||
**Required** The name of the person to greet. Default `"World"`.
|
||||
|
||||
## Outputs
|
||||
|
||||
## `time`
|
||||
### `time`
|
||||
|
||||
The time we greeted you.
|
||||
|
||||
## Example usage
|
||||
|
||||
```yaml
|
||||
uses: actions/hello-world-javascript-action@v1.1
|
||||
with:
|
||||
who-to-greet: 'Mona the Octocat'
|
||||
```
|
||||
````
|
||||
|
||||
## アクションの GitHub へのコミットとタグ、プッシュ
|
||||
|
||||
@@ -273,3 +275,10 @@ jobs:
|
||||
リポジトリから **[アクション]** タブをクリックして、最新のワークフロー実行を選択します。 **[ジョブ]** または視覚化グラフで、"**A job to say hello**" をクリックします。 "Hello Mona the Octocat" または `who-to-greet` 入力に使用した名前と、ログに出力されたタイムスタンプが表示されます。
|
||||
|
||||

|
||||
|
||||
## JavaScript アクションを作成するためのテンプレート リポジトリ
|
||||
|
||||
{% data variables.product.prodname_dotcom %} には、JavaScript および TypeScript アクションを作成するためのテンプレート リポジトリが用意されています。 これらのテンプレートを使い、テスト、リンティング、その他の推奨プラクティスなど、新しいアクションの作成をすぐに始められます。
|
||||
|
||||
* [`javascript-action` テンプレート リポジトリ](https://github.com/actions/javascript-action)
|
||||
* [`typescript-action` テンプレート リポジトリ](https://github.com/actions/typescript-action)
|
||||
|
||||
@@ -16,12 +16,12 @@ topics:
|
||||
- Networking
|
||||
- Security
|
||||
shortTitle: Enable subdomain isolation
|
||||
ms.openlocfilehash: e48b6d474bf4d930836047343eab267731e67823
|
||||
ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110
|
||||
ms.openlocfilehash: 6ce23de3646d3ca3f4523ec7716907f8b5430564
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 10/25/2022
|
||||
ms.locfileid: '148107134'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193098'
|
||||
---
|
||||
## Subdomain Isolationについて
|
||||
|
||||
@@ -29,19 +29,21 @@ Subdomain Isolationは、クロスサイトスクリプティングや関連す
|
||||
|
||||
Subdomain Isolation が有効な場合、{% data variables.product.prodname_ghe_server %} はいくつかのパスをサブドメインで置き換えます。 Subdomain Isolation を有効にした後は、ユーザーが提供した何らかのコンテンツに対する以前のパス (`http(s)://HOSTNAME/raw/` など) にアクセスしようとすると、`404` エラーが返される場合があります。
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.3-7-new-subdomains %}
|
||||
|
||||
| Subdomain Isolationなしのパス | 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/` |
|
||||
{%- 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/` | {%- 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 %} | 非サポート | `https://containers.HOSTNAME/` |{% endif %}
|
||||
| `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/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 %} | 非サポート | `https://containers.HOSTNAME/` | {%- endif %}
|
||||
|
||||
## 前提条件
|
||||
|
||||
|
||||
@@ -13,12 +13,12 @@ topics:
|
||||
- High availability
|
||||
- Infrastructure
|
||||
shortTitle: Initiate failover to appliance
|
||||
ms.openlocfilehash: d1e9c579d431e03154040392a2b58405fef8ab42
|
||||
ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794
|
||||
ms.openlocfilehash: e2c15dab0a812fe6031f78e7edbccaff6a2503c0
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/09/2022
|
||||
ms.locfileid: '147770890'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192994'
|
||||
---
|
||||
フェイルオーバーに必要な時間は、レプリカを手動で昇格させてトラフィックをリダイレクトするのにかかる時間によって異なります。 平均時間は、20 から 30 分の範囲です。
|
||||
|
||||
@@ -53,6 +53,13 @@ ms.locfileid: '147770890'
|
||||
```shell
|
||||
$ ghe-repl-promote
|
||||
```
|
||||
|
||||
{% note %}
|
||||
|
||||
**注:** プライマリ ノードが使用できない場合、警告とタイムアウトが発生する可能性がありますが、無視して構いません。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
5. レプリカの IP アドレスを指すように DNS レコードを更新します。 TTL 期間が経過すると、トラフィックはレプリカに転送されます。 ロードバランサを使用している場合は、トラフィックがレプリカに送信されるように設定されていることを確認します。
|
||||
6. 通常の操作が再開できることをユーザーに通知します。
|
||||
7. 必要に応じて、新しいプライマリから既存のアプライアンスや以前のプライマリへのレプリケーションをセットアップします。 詳細については、「[About high availability configuration](/enterprise/admin/guides/installation/about-high-availability-configuration/#utilities-for-replication-management)」 (High Availability 設定について) を参照してください。
|
||||
@@ -63,7 +70,7 @@ ms.locfileid: '147770890'
|
||||
```
|
||||
- 新しいプライマリでは、`ghe-repl-teardown` を使用して、UUID を削除します。 *`UUID`* は、前の手順で取得した UUID に置き換えてください。
|
||||
```shell
|
||||
$ ghe-repl-teardown -u <em>UUID</em>
|
||||
$ ghe-repl-teardown -u UUID
|
||||
```
|
||||
|
||||
## 参考資料
|
||||
|
||||
@@ -13,13 +13,15 @@ topics:
|
||||
redirect_from:
|
||||
- /admin/github-actions/enabling-github-actions-with-amazon-s3-storage
|
||||
shortTitle: Amazon S3 storage
|
||||
ms.openlocfilehash: 23fd8eabe502a6a29610de451cae72542ceca53f
|
||||
ms.sourcegitcommit: 8f7c8d52755cc3af0f366cc74c6db9e9be4d2ecd
|
||||
ms.openlocfilehash: dd0f4c7135def456212de3355d6f6af17076c40c
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/04/2022
|
||||
ms.locfileid: '148132649'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192986'
|
||||
---
|
||||
{% data reusables.actions.enterprise-storage-about %}
|
||||
|
||||
## 前提条件
|
||||
|
||||
{% note %}
|
||||
|
||||
@@ -13,13 +13,15 @@ topics:
|
||||
redirect_from:
|
||||
- /admin/github-actions/enabling-github-actions-with-azure-blob-storage
|
||||
shortTitle: Azure Blob storage
|
||||
ms.openlocfilehash: b6abccdfea0d33b387fc3ec6df563fcbaf57f861
|
||||
ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110
|
||||
ms.openlocfilehash: 856748a3219be7789f0339c43210ca204fe56d91
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 10/25/2022
|
||||
ms.locfileid: '148109540'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192978'
|
||||
---
|
||||
{% data reusables.actions.enterprise-storage-about %}
|
||||
|
||||
## 前提条件
|
||||
|
||||
{% data variables.product.prodname_actions %} を有効化する前に、次のステップを完了していることを確認してください。
|
||||
|
||||
@@ -11,12 +11,12 @@ topics:
|
||||
- Infrastructure
|
||||
- Storage
|
||||
shortTitle: Google Cloud Storage
|
||||
ms.openlocfilehash: abbac860ed3f6f1caaec1152b426762535b8fba4
|
||||
ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110
|
||||
ms.openlocfilehash: 33ecb0adfb0786a4308bba80ecc6467fc7adb4e5
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 10/25/2022
|
||||
ms.locfileid: '148109722'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192954'
|
||||
---
|
||||
{% note %}
|
||||
|
||||
@@ -24,6 +24,8 @@ ms.locfileid: '148109722'
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.actions.enterprise-storage-about %}
|
||||
|
||||
## 前提条件
|
||||
|
||||
{% data variables.product.prodname_actions %} を有効化する前に、次のステップを完了していることを確認してください。
|
||||
|
||||
@@ -14,13 +14,15 @@ 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.openlocfilehash: fec0720c8779ba643735156e6413005ae35f5d85
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/16/2022
|
||||
ms.locfileid: '148166570'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192963'
|
||||
---
|
||||
{% data reusables.actions.enterprise-storage-about %}
|
||||
|
||||
## 前提条件
|
||||
|
||||
{% data variables.product.prodname_actions %} を有効化する前に、次のステップを完了していることを確認してください。
|
||||
|
||||
@@ -14,12 +14,12 @@ type: how_to
|
||||
topics:
|
||||
- Actions
|
||||
- Enterprise
|
||||
ms.openlocfilehash: 6bfcb7cc2a14a70a6ba4397c12effaf0a8d8be3f
|
||||
ms.sourcegitcommit: 8f1801040a84ca9353899a2d1e6782c702aaed0d
|
||||
ms.openlocfilehash: a48e562898eb4c82b9027ee56ed52b71e7c5ebc7
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/16/2022
|
||||
ms.locfileid: '148166562'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192970'
|
||||
---
|
||||
{% data reusables.actions.enterprise-beta %}
|
||||
|
||||
@@ -127,7 +127,9 @@ ms.locfileid: '148166562'
|
||||
|
||||
{% data variables.product.prodname_ghe_server %} で {% data variables.product.prodname_actions %} を有効にするには、外部 Blob ストレージにアクセスできる必要があります。
|
||||
|
||||
{% data variables.product.prodname_actions %} は、BLOB ストレージを使って、ワークフロー ログ{% ifversion actions-caching %}、キャッシュ{% endif %}、ユーザーがアップロードしたビルド成果物など、ワークフロー実行によって生成されたデータを保存します。 必要なストレージ容量は、{% data variables.product.prodname_actions %} の使用状況により異なります。 単一の外部ストレージ設定のみがサポートされており、複数のストレージプロバイダを同時に使用することはできません。
|
||||
{% data reusables.actions.enterprise-storage-contents %} 必要なストレージ容量は、{% data variables.product.prodname_actions %} の使用状況により異なります。 単一の外部ストレージ設定のみがサポートされており、複数のストレージプロバイダを同時に使用することはできません。
|
||||
|
||||
リポジトリのファイル構造のワークフロー ファイルなど、その他の {% data variables.product.prodname_actions %} データはすべて、{% data variables.location.product_location %} のデータ ストレージ ボリュームに保存されます。
|
||||
|
||||
{% data variables.product.prodname_actions %} は、次のストレージプロバイダをサポートしています。
|
||||
|
||||
|
||||
@@ -22,12 +22,12 @@ redirect_from:
|
||||
- /admin/authentication/managing-identity-and-access-for-your-enterprise/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
|
||||
- /admin/identity-and-access-management/using-saml-for-enterprise-iam/about-identity-and-access-management-for-your-enterprise
|
||||
ms.openlocfilehash: d719ef81948cef75018b0976fc97ef45c267469f
|
||||
ms.sourcegitcommit: c562c85cc75ffe1eb4e9595d8adc09ec71697ab1
|
||||
ms.openlocfilehash: ea9db1269f389bdc126c8693ffeeb4b11dc42f99
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/22/2022
|
||||
ms.locfileid: '148180030'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192690'
|
||||
---
|
||||
## {% ifversion ghec or ghes %}{% data variables.location.product_location %}{% elsif ghae %}{% data variables.product.product_name %}{% endif %}{% ifversion ghec or ghae %} 上のエンタープライズ{% endif %}の SAML SSO について
|
||||
|
||||
@@ -45,11 +45,11 @@ Enterprise メンバーが {% data variables.location.product_location %} 上で
|
||||
|
||||
SAML SSO を有効にした後、使用する IdP によっては、追加のアイデンティおよびアクセス管理機能を有効にできる場合があります。
|
||||
|
||||
IdP として Azure AD を使用している場合は、Team 同期を使用して、各 Organization 内の Team メンバーシップを管理できます。 {% data reusables.identity-and-permissions.about-team-sync %} 詳細については、[エンタープライズ アカウントでの組織のチーム同期の管理](/admin/authentication/managing-identity-and-access-for-your-enterprise/managing-team-synchronization-for-organizations-in-your-enterprise)に関するページを参照してください。
|
||||
IdP として Azure AD を使用している場合は、Team 同期を使用して、各 Organization 内の Team メンバーシップを管理できます。 {% data reusables.identity-and-permissions.about-team-sync %}
|
||||
|
||||
{% note %}
|
||||
|
||||
**注:** {% data variables.product.prodname_emus %} に対してエンタープライズが有効ではない場合、エンタープライズ レベルでは SCIM を使用できません。
|
||||
**注:** {% data variables.product.prodname_emus %} を使用する目的でアカウントが作成されたのでなければ、エンタープライズ アカウントに SCIM を構成できません。 詳細については、「[{% data variables.product.prodname_emus %} について](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users)」を参照してください。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
@@ -61,23 +61,37 @@ SAML SSO を使用すると、ユーザーは ID 管理のために外部シス
|
||||
|
||||
SAML は、認証と認可のための XML ベースの標準です。 {% data variables.location.product_location %} の SAML を構成する場合、認証用の外部システムは ID プロバイダー (IdP) と呼ばれます。 インスタンスは SAML サービス プロバイダー (SP) として機能します。 SAML 標準の詳細については、Wikipedia の「[Security Assertion Markup Language](https://en.wikipedia.org/wiki/Security_Assertion_Markup_Language)」を参照してください。
|
||||
|
||||
{% data variables.product.product_name %} 上の SAML SSO の構成については、「[エンタープライズ向けの SAML シングル サインオンの構成](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise)」を参照してください。
|
||||
{% elsif ghae %}
|
||||
|
||||
{% data reusables.saml.saml-ghes-account-revocation %}
|
||||
{% data reusables.saml.ae-uses-saml-sso %} {% data reusables.saml.ae-enable-saml-sso-during-bootstrapping %}
|
||||
|
||||
ID プロバイダー (IdP) で {% data variables.product.product_name %} 用にアプリケーションを構成した後は、IdP でユーザーとグループをアプリケーションに割り当てることによって、{% data variables.location.product_location %} へのアクセスをプロビジョニングできます。 {% data variables.product.product_name %} の SAML SSO の詳細については、「[エンタープライズ向けの SAML シングル サインオンの構成](/admin/authentication/configuring-saml-single-sign-on-for-your-enterprise)」を参照してください。
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghes < 3.6 %}
|
||||
|
||||
アプリケーションを割り当てあるいは割り当て解除したときに、IdP は{% data variables.product.product_name %} と自動的に通信はしません。 誰かが初めて {% data variables.product.product_name %} に移動し、あなたの IdP を使って認証してサインインしたときに、{% data variables.product.product_name %} により、SAML Just-in-Time (JIT) プロビジョニングを使ってユーザー アカウントが作成されます。 {% data variables.product.product_name %} へのアクセスを付与するとき、場合によっては、手動でユーザーに通知する必要があります。
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghes %}
|
||||
|
||||
{% data reusables.enterprise_user_management.external_auth_disables_2fa %}
|
||||
|
||||
{% data reusables.enterprise_user_management.built-in-authentication %}
|
||||
|
||||
{% elsif ghae %}
|
||||
{% endif %}
|
||||
|
||||
{% data reusables.saml.ae-uses-saml-sso %} {% data reusables.saml.ae-enable-saml-sso-during-bootstrapping %}
|
||||
{% data variables.product.product_name %} で SAML SSO を構成する方法に関する詳細については、「[Enterprise 向けの SAML シングルサインオンを設定する](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise)」を参照してください。 {% ifversion ghec or ghae or scim-for-ghes %} 認証と {% data variables.location.product_location %} の {% ifversion ghae or ghes %}ユーザー{% endif %} プロビジョニングの両方を特定の IdP で構成する方法については、「[Enterprise IAM での SAML の使用](/admin/identity-and-access-management/using-saml-for-enterprise-iam)」の個人 IdP に関する記事を参照してください。 "{% endif %}
|
||||
|
||||
ID プロバイダー (IdP) で {% data variables.product.product_name %} 用にアプリケーションを構成した後は、IdP でユーザーとグループにアプリケーションを割り当てることによって、{% data variables.location.product_location %} へのアクセスをプロビジョニングできます。 {% data variables.product.product_name %} の SAML SSO の詳細については、「[エンタープライズ向けの SAML シングル サインオンの構成](/admin/authentication/configuring-saml-single-sign-on-for-your-enterprise)」を参照してください。
|
||||
{% ifversion ghae or scim-for-ghes %}
|
||||
|
||||
## ユーザー アカウントの作成について
|
||||
|
||||
{% data reusables.scim.after-you-configure-saml %} 詳細については、「[エンタープライズ向けのユーザー プロビジョニングの構成](/admin/authentication/configuring-user-provisioning-for-your-enterprise)」を参照してください。
|
||||
|
||||
特定の IdP で {% data variables.location.product_location %} 用に認証とユーザー プロビジョニングの両方を構成する方法については、「[ID プロバイダーでの認証とプロビジョニングの構成](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider)」をご覧ください。
|
||||
{% data reusables.saml.saml-ghes-account-revocation %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
@@ -128,6 +142,6 @@ IdP として Okta を使う場合は、Okta グループを {% data variables.p
|
||||
|
||||
## 参考資料
|
||||
|
||||
- OASIS の Web サイトの [SAML Wiki](https://wiki.oasis-open.org/security)
|
||||
- IETF の Web サイトの[クロスドメイン ID 管理のためのシステム: プロトコル (RFC 7644)](https://tools.ietf.org/html/rfc7644) に関する説明{%- ifversion ghae %}
|
||||
- OASIS Web サイトの [SAML Wiki](https://wiki.oasis-open.org/security) {%- ifversion ghae or scim-for-ghes %}
|
||||
- IETF の Web サイトの[クロスドメイン ID 管理のためのシステム: プロトコル (RFC 7644)](https://tools.ietf.org/html/rfc7644) に関する説明 {%- endif %} {%- ifversion ghae %}
|
||||
- [IP 許可リストを使用してエンタープライズへのネットワーク トラフィックを制限する](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list){%- endif %}
|
||||
|
||||
@@ -17,18 +17,18 @@ redirect_from:
|
||||
- /admin/authentication/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad
|
||||
- /admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad
|
||||
- /admin/identity-and-access-management/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad
|
||||
ms.openlocfilehash: bfd93814b11066d6da2d87a2e1f0a8bd5461e93f
|
||||
ms.sourcegitcommit: ced661bdffebd0f96f6f76db109fbe31983448ba
|
||||
ms.openlocfilehash: c0291aab00df0139b0b54eda8ec34b6e20deb19f
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/16/2022
|
||||
ms.locfileid: '148167061'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192682'
|
||||
---
|
||||
## Azure AD を使用した認証とユーザプロビジョニングについて
|
||||
|
||||
Azure Active Directory (Azure AD) は、ユーザアカウントと Web アプリケーションへのアクセスを一元管理できる Microsoft のサービスです。 詳細については、Microsoft Docs の「[Azure Active Directory とは](https://docs.microsoft.com/azure/active-directory/fundamentals/active-directory-whatis)」を参照してください。
|
||||
|
||||
{% data variables.product.product_name %} のアイデンティティとアクセスを管理するために、Azure AD テナントを認証用の SAML IdP として使用できます。 アカウントを自動的にプロビジョニングし、SCIM でメンバーシップにアクセスするように、Azure AD を構成することもできます。これにより、{% data variables.product.product_name %} のユーザーを作成し、Azure AD テナントから Team と Organization のメンバーシップを管理できます。
|
||||
{% data reusables.saml.idp-saml-and-scim-explanation %}
|
||||
|
||||
{% data reusables.scim.ghes-beta-note %}
|
||||
|
||||
@@ -39,7 +39,7 @@ Azure AD を使って {% data variables.product.product_name %} に対して SAM
|
||||
* {% data variables.product.product_name %} アプリケーションを Azure AD の IdP グループに割り当てて、IdP グループのすべてのメンバーに対する {% data variables.product.product_name %} 上のユーザー アカウントを自動的に作成して、アクセスを許可します。 さらに、Team とその親 Organization に接続するために、{% data variables.product.product_name %} で IdP グループを利用できます。
|
||||
* IdP グループから {% data variables.product.product_name %} アプリケーションの割り当てを解除すると、その IdP グループを介してのみアクセスしていたすべての IdP ユーザーの {% data variables.product.product_name %} ユーザー アカウントが非アクティブ化され、親 Organization からユーザーが削除されます。 IdP グループは {% data variables.product.product_name %} のどの Team からも切断されます
|
||||
|
||||
{% data variables.location.product_location %} での Enterprise の ID とアクセスの管理について詳しくは、「[Enterprise の ID とアクセスを管理する](/admin/authentication/managing-identity-and-access-for-your-enterprise)」をご覧ください。 IdP グループとのチームの同期の詳細については、「[チームを ID プロバイダー グループと同期する](/organizations/organizing-members-into-teams/synchronizing-a-team-with-an-identity-provider-group)」を参照してください。
|
||||
{% data variables.location.product_location %} での Enterprise の ID とアクセスの管理について詳しくは、「[Enterprise の ID とアクセスを管理する](/admin/authentication/managing-identity-and-access-for-your-enterprise)」をご覧ください。
|
||||
|
||||
## 前提条件
|
||||
|
||||
@@ -52,10 +52,10 @@ Azure AD を使って {% data variables.product.product_name %} に対して SAM
|
||||
|
||||
## Azure AD を使用して認証とユーザプロビジョニングを設定する
|
||||
|
||||
Azure AD テナントで、{% data variables.product.product_name %} 用のアプリケーションを追加してから、プロビジョニングを構成します。
|
||||
|
||||
{% ifversion ghae %}
|
||||
|
||||
Azure AD テナントで、{% data variables.product.product_name %} 用のアプリケーションを追加してから、プロビジョニングを構成します。
|
||||
|
||||
1. Azure AD で、{% data variables.enterprise.ae_azure_ad_app_link %} をテナントに追加し、シングル サインオンを構成します。 詳しくは、Microsoft Docs の[チュートリアル: Azure Active Directory シングル サインオン (SSO) と {% data variables.product.product_name %} の統合](https://docs.microsoft.com/azure/active-directory/saas-apps/github-ae-tutorial)に関する記事をご覧ください。
|
||||
|
||||
1. {% data variables.product.product_name %} で、Azure AD テナントの詳細を入力します。
|
||||
@@ -68,18 +68,15 @@ Azure AD テナントで、{% data variables.product.product_name %} 用のア
|
||||
|
||||
{% elsif scim-for-ghes %}
|
||||
|
||||
1. Azure AD テナントの左側のサイドバーで、 **[プロビジョニング]** をクリックします。
|
||||
|
||||
1. [テナント URL] に、{% data variables.location.product_location %} での SCIM の完全なエンドポイント URL を入力します。 詳しくは、REST API のドキュメントの「[SCIM](/rest/enterprise-admin/scim#scim-endpoint-urls)」をご覧ください。
|
||||
|
||||
1. [シークレット トークン] に、「[Enterprise 用の SCIM を使用したユーザーのプロビジョニングを構成する](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-with-scim-for-your-enterprise#enabling-user-provisioning-for-your-enterprise)」のステップ 4 で作成した {% data variables.product.pat_v1 %} を入力します。
|
||||
|
||||
1. Azure AD から {% data variables.location.product_location %} への正常な接続を確認するには、 **[テスト接続]** をクリックします。
|
||||
|
||||
1. 接続が成功したことを確認したら、ページの上部にある **[保存]** をクリックします。
|
||||
1. {% data variables.location.product_location %} 用に SAML SSO を構成します。 詳細については、「[エンタープライズ向けの SAML シングル サインオンの構成](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise#configuring-saml-sso)」を参照してください。
|
||||
1. インスタンス用の SCIM を使用したユーザーのプロビジョニングを構成する 詳しくは、「[Enterprise 用の SCIM を使用したユーザーのプロビジョニングを構成する](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-with-scim-for-your-enterprise)」を参照してください。
|
||||
|
||||
{% endif %}
|
||||
|
||||
1. Azure AD で {% data variables.product.product_name %} のエンタープライズ所有者を割り当てます。 従う必要があるプロセスは、プロビジョニングを構成したかどうかによって異なります。 Enterprise 所有者の詳細については、「[Enterprise におけるロール](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise#enterprise-owners)」を参照してください。
|
||||
- プロビジョニングを構成した場合、{% data variables.product.product_name %} でユーザーにエンタープライズ所有権を付与するには、Azure AD のユーザーにエンタープライズ所有者ロールを割り当てます。
|
||||
- プロビジョニングを構成しなかった場合は、{% data variables.product.product_name %} でユーザーにエンタープライズ所有権を付与するには、IdP のユーザー アカウントに対して、SAML アサーションの `administrator` 属性を、`true` の値を指定して含めます。 Azure AD からの SAML 要求に `administrator` 属性を含める方法の詳細については、Microsoft Docs の「[エンタープライズ アプリケーションの SAML トークンで発行された要求のカスタマイズ](https://docs.microsoft.com/azure/active-directory/develop/active-directory-saml-claims-customization)」を参照してください。
|
||||
## エンタープライズ所有者の管理
|
||||
|
||||
エンタープライズ所有者にユーザーを指定する手順は、SAML だけを使用するか、SCIM も使用するかによって変わります。 Enterprise 所有者の詳細については、「[Enterprise におけるロール](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise)」を参照してください。
|
||||
|
||||
プロビジョニングを構成した場合、{% data variables.product.product_name %} でユーザーにエンタープライズ所有権を付与するには、Azure AD のユーザーにエンタープライズ所有者ロールを割り当てます。
|
||||
|
||||
プロビジョニングを構成しなかった場合は、{% data variables.product.product_name %} でユーザーにエンタープライズ所有権を付与するには、IdP のユーザー アカウントに対して、SAML アサーションの `administrator` 属性を、`true` の値を指定して含めます。 Azure AD からの SAML 要求に `administrator` 属性を含める方法の詳細については、Microsoft Docs の「[エンタープライズ アプリケーションの SAML トークンで発行された要求のカスタマイズ](https://docs.microsoft.com/azure/active-directory/develop/active-directory-saml-claims-customization)」を参照してください。
|
||||
|
||||
@@ -16,12 +16,12 @@ topics:
|
||||
- Identity
|
||||
- SSO
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: 1655ca7f800b94c150455a077b867e7e08fa924b
|
||||
ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110
|
||||
ms.openlocfilehash: 62a1436fcedc4d90f767d0c612e70810132aff58
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 10/25/2022
|
||||
ms.locfileid: '148107517'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192674'
|
||||
---
|
||||
{% data reusables.saml.okta-ae-sso-beta %}
|
||||
|
||||
@@ -31,6 +31,11 @@ ms.locfileid: '148107517'
|
||||
|
||||
{% data variables.product.product_name %} の IdP として Okta を使用するために、Okta に {% data variables.product.product_name %} アプリを追加し、{% data variables.product.product_name %} で Okta を IdP として構成し、Okta ユーザーとグループのアクセス権をプロビジョニングできます。
|
||||
|
||||
{% data reusables.saml.idp-saml-and-scim-explanation %}
|
||||
- "[チームへの Okta グループのマッピング](/admin/identity-and-access-management/using-saml-for-enterprise-iam/mapping-okta-groups-to-teams)"
|
||||
|
||||
SCIM を有効にすると、Okta で {% data variables.product.product_name %} アプリケーションを割り当てる任意のユーザーが次のプロビジョニング機能を使えるようになります。
|
||||
|
||||
{% data reusables.scim.ghes-beta-note %}
|
||||
|
||||
次のプロビジョニング機能は、{% data variables.product.product_name %} アプリケーションに割り当てられたすべての Okta ユーザーが使用できます。
|
||||
@@ -42,6 +47,8 @@ ms.locfileid: '148107517'
|
||||
| プロフィール更新のプッシュ | Okta でユーザーのプロファイルを更新すると、{% data variables.product.product_name %} で Enterprise 内のユーザーのメンバーシップのメタデータが更新されます。 |
|
||||
| ユーザの再アクティブ化 | Okta でユーザーを再アクティブ化すると、{% data variables.product.product_name %} で Enterprise 内のユーザーの停止が解除されます。 |
|
||||
|
||||
{% data variables.location.product_location %} での Enterprise の ID とアクセスの管理について詳しくは、「[Enterprise の ID とアクセスを管理する](/admin/authentication/managing-identity-and-access-for-your-enterprise)」をご覧ください。
|
||||
|
||||
## 前提条件
|
||||
|
||||
- Okta を使用して {% data variables.product.product_name %} の認証とユーザー プロビジョニングを設定するには、Okta アカウントとテナントが必要です。
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Enterprise 用の SCIM を使用したユーザーのプロビジョニングを構成する
|
||||
shortTitle: Configure user provisioning
|
||||
shortTitle: Configure SCIM user provisioning
|
||||
intro: '{% ifversion scim-for-ghes %}{% data variables.location.product_location %}{% elsif ghae %}{% data variables.product.product_name %}{% endif %} 用のクロスドメイン ID 管理システム (SCIM) を構成できます。これにより、{% ifversion scim-for-ghes %}インスタンス{% elsif ghae %}{% data variables.product.product_name %}{% endif %}用のアプリケーションを ID プロバイダー (IdP) のユーザーに割り当てる場合、ユーザー アカウントが自動的にプロビジョニングされます。'
|
||||
permissions: '{% ifversion scim-for-ghes %}Site administrators{% elsif ghae %}Enterprise owners{% endif %} can configure user provisioning for {% ifversion scim-for-ghes %}a {% data variables.product.product_name %} instance{% elsif ghae %}an enterprise on {% data variables.product.product_name %}{% endif %}.'
|
||||
versions:
|
||||
@@ -17,12 +17,12 @@ redirect_from:
|
||||
- /admin/authentication/configuring-user-provisioning-for-your-enterprise
|
||||
- /admin/identity-and-access-management/managing-iam-for-your-enterprise/configuring-user-provisioning-for-your-enterprise
|
||||
- /admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-for-your-enterprise
|
||||
ms.openlocfilehash: c330d8e375522901d2738b581a897d42d30d628e
|
||||
ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110
|
||||
ms.openlocfilehash: ded93a01d14d1a5e26cdf35efed4f13afc832ca1
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 10/25/2022
|
||||
ms.locfileid: '148109120'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192666'
|
||||
---
|
||||
{% data reusables.scim.ghes-beta-note %}
|
||||
|
||||
@@ -54,18 +54,28 @@ IdP 管理者がユーザーに {% data variables.location.product_location %}
|
||||
|
||||
認証中、{% ifversion scim-for-ghes %}インスタンス{% elsif ghae %}{% data variables.product.product_name %}{% endif %}は、ユーザーを SAML ID に関連付けようとします。 既定では、{% ifversion scim-for-ghes %}インスタンス{% elsif ghae %}{% data variables.product.product_name %}{% endif %}は、IdP からの `NameID` クレームをアカウントのユーザー名と比較します。 {% data variables.product.product_name %} は、比較のために `NameID` の値を正規化します。 ユーザー名の正規化の詳しい情報については、「[外部認証のためのユーザー名に関する考慮事項](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication#about-username-normalization)」を参照してください。
|
||||
|
||||
インスタンス上に一致するユーザー名がない場合、インスタンスによってユーザーの新しいアカウントが作成されます。 インスタンス上にユーザー名が一致するアカウントがある場合、ユーザーはアカウントにサインインします。{% ifversion scim-for-ghes %} {% data variables.product.product_name %} では、アカウントが組み込みの認証を使用するか、またはアカウントが既に SAML ID と関連付けられているかに関係なく、Idp からのクレームをインスタンス上のすべてのアカウントと比較します。{% endif %}
|
||||
インスタンス上に一致するユーザー名を持つ既存のアカウントがない場合、ユーザーはサインインに失敗します。{% ifversion scim-for-ghes %} この一致を確認するために、{% data variables.product.product_name %} では、IdP からの SAML `NameId` クレームを、インスタンス上で SCIM によってプロビジョニングされた各ユーザー アカウントの `username` クレームと比較します。{% endif %}
|
||||
|
||||
{% ifversion scim-for-ghes %}
|
||||
|
||||
SAML SSO を使用する場合、サイト管理者は、インスタンスのカスタム ユーザー属性を構成できます。 カスタム ユーザー名属性を使用すると、インスタンスで、IdP の `NameID` 以外の値を使用できます。 SCIM が構成されている場合、{% data variables.product.product_name %} では、このマッピングが考慮されます。 ユーザー属性のマッピングの詳しい情報については、「[Enterprise 向けの SAML シングル サインオンの構成](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise#configuring-saml-sso)」を参照してください。
|
||||
{% note %}
|
||||
|
||||
**注**: SAML 認証中に、一部の環境では、一意の識別クレームとして `NameID` 以外の値を使用する場合があります。 現時点では、SCIM プロビジョニングを使用する場合、SAML ユーザー属性用のカスタム マッピングはサポートされていません。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% data variables.product.product_name %} によって IdP のユーザーが正常に識別されたが、メール アドレスや姓名などのアカウントの詳細が一致しない場合、インスタンスによって詳細が IdP の値で更新されます。
|
||||
{% data variables.product.product_name %} によって IdP のユーザーが正常に識別されたが、メール アドレスや姓名などのアカウントの詳しい内容が一致しない場合、インスタンスによって詳しい内容が IdP の値で上書きされます。 SCIM によってプロビジョニングされたプライマリ メール以外のメール アドレスも、ユーザー アカウントから削除されます。
|
||||
|
||||
## サポートされているアイデンティティプロバイダ
|
||||
|
||||
{% ifversion ghes %}
|
||||
|
||||
プライベート ベータ期間中は、担当のアカウント チームが、サポートされている IdP 上の {% data variables.product.product_name %} に対して SCIM の構成に関するドキュメントを提供します。
|
||||
|
||||
{% elsif ghae %}
|
||||
|
||||
次の IdP では、{% data variables.product.product_name %} 用の SCIM を使用したユーザーのプロビジョニングがサポートされています。
|
||||
|
||||
{% data reusables.saml.okta-ae-sso-beta %}
|
||||
@@ -76,7 +86,8 @@ SAML SSO を使用する場合、サイト管理者は、インスタンスの
|
||||
|
||||
{% data reusables.scim.ghes-scim-idp-table %}
|
||||
|
||||
{% ifversion ghae %} チーム マッピングをサポートする IdP の場合、IdP 内のユーザーのグループに {% data variables.product.product_name %} のアプリケーションを割り当てるか、割り当てを解除できます。 これらのグループは、{% data variables.location.product_location %} の Organization オーナーおよびチーム メンテナが使用して {% data variables.product.product_name %} チームにマッピングできます。 詳細については、[Okta グループのチームへのマッピング](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/mapping-okta-groups-to-teams)に関する記事を参照してください。
|
||||
チーム マッピングをサポートする IdP の場合、IdP 内のユーザーのグループに {% data variables.product.product_name %} のアプリケーションを割り当てるか、割り当てを解除できます。 これらのグループは、{% data variables.location.product_location %} の Organization オーナーおよびチーム メンテナが使用して {% data variables.product.product_name %} チームにマッピングできます。 詳細については、[Okta グループのチームへのマッピング](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/mapping-okta-groups-to-teams)に関する記事を参照してください。
|
||||
|
||||
{% endif %}
|
||||
|
||||
## 前提条件
|
||||
@@ -101,9 +112,9 @@ SAML SSO を使用する場合、サイト管理者は、インスタンスの
|
||||
|
||||
{% ifversion scim-for-ghes %}
|
||||
|
||||
インスタンスに対してプロビジョニング アクションを実行するには、専用のマシン ユーザー アカウントを作成し、そのアカウントを Enterprise オーナーに昇格します。
|
||||
ご利用のインスタンス上でプロビジョニング操作を行うには、組み込みのユーザー アカウントを作成し、そのアカウントを Enterprise オーナーに昇格させます。
|
||||
|
||||
{% data variables.product.product_name %} インスタンスで SCIM を有効にすると、すべてのユーザー アカウントが一時停止されます。 IdP からインスタンスへのユーザー アクセスを許可し、ユーザーが正常に認証されると、ユーザーのアカウントは停止解除されます。
|
||||
{% data variables.product.product_name %} インスタンスで SCIM を有効にすると、すべてのユーザー アカウントが一時停止されます。 組み込みのユーザー アカウントでは、引き続きプロビジョニング操作を行います。 IdP からインスタンスへのアクセス権をユーザーに付与すると、IdP では SCIM を使用してインスタンスと通信し、ユーザーのアカウントの停止解除を行います。
|
||||
|
||||
{% endif %}
|
||||
|
||||
@@ -120,12 +131,16 @@ SAML SSO を使用する場合、サイト管理者は、インスタンスの
|
||||
**警告**: {% data variables.product.pat_generic %}を作成する Enterprise オーナーのユーザー アカウントが非アクティブ化またはプロビジョニング解除された場合、IdP によって Enterprise のユーザー アカウントが自動的にプロビジョニングおよびプロビジョニング解除されなくなります。 別の Enterprise オーナーは、新しい{% data variables.product.pat_generic %} を作成し、IdP でプロビジョニングを再構成する必要があります。
|
||||
|
||||
{% endwarning %} {%- elsif scim-for-ghes %}
|
||||
1. インスタンに対してプロビジョニング アクションを実行するための専用のマシン ユーザー アカウントを作成します。 詳しくは、「[プロバイダー外のユーザーのためのビルトイン認証の許可](/admin/identity-and-access-management/managing-iam-for-your-enterprise/allowing-built-in-authentication-for-users-outside-your-provider#inviting-users-outside-your-provider-to-authenticate-to-your-instance)」を参照してください。
|
||||
1. ご利用のインスタンに対してプロビジョニング操作を行うための組み込みのユーザー アカウントを作成します。 詳しくは、「[プロバイダー外のユーザーのためのビルトイン認証の許可](/admin/identity-and-access-management/managing-iam-for-your-enterprise/allowing-built-in-authentication-for-users-outside-your-provider#inviting-users-outside-your-provider-to-authenticate-to-your-instance)」を参照してください。
|
||||
1. 専用のユーザー アカウントを Enterprise オーナーに昇格します。 詳細については、「[Enterprise を管理するようユーザーを招待する](/admin/user-management/managing-users-in-your-enterprise/inviting-people-to-manage-your-enterprise#adding-an-enterprise-administrator-to-your-enterprise-account)」を参照してください。
|
||||
1. 新しい Enterprise オーナーとしてインスタンスにサインインします。
|
||||
1. **admin:enterprise** スコープで{% data variables.product.pat_v1 %}を作成します。 詳しい情報については、「[{% data variables.product.pat_generic %}の作成](/github/authenticating-to-github/creating-a-personal-access-token)」を参照してください。
|
||||
1. **admin:enterprise** スコープで{% data variables.product.pat_v1 %}を作成します。 {% data variables.product.pat_v1 %} に対しては、有効期限を指定しないでください。 詳しい情報については、「[{% data variables.product.pat_generic %}の作成](/github/authenticating-to-github/creating-a-personal-access-token)」を参照してください。
|
||||
|
||||
{% note %}
|
||||
{% warning %}
|
||||
|
||||
**警告**: {% data variables.product.pat_v1 %} の有効期限は決して指定しないでください。 有効期限を指定した場合、有効期限が過ぎると SCIM は機能しなくなります。
|
||||
|
||||
{% endwarning %} {% note %}
|
||||
|
||||
**注**: SCIM 構成をテストするため、および IdP で SCIM 用にアプリケーションを構成するためには、この{% data variables.product.pat_generic %}が必要です。 手順の後半でトークンが再び必要になるまで、トークンをパスワードマネージャーに安全に保管してください。
|
||||
|
||||
@@ -148,19 +163,19 @@ SAML SSO を使用する場合、サイト管理者は、インスタンスの
|
||||
![エンタープライズ セキュリティ設定内の [SCIM ユーザー プロビジョニングを必須にする] のチェック ボックス](/assets/images/help/enterprises/settings-require-scim-user-provisioning.png)
|
||||
1. **[保存]** をクリックします。
|
||||
![Enterprise のセキュリティ設定内の [SCIM ユーザー プロビジョニングを必須にする] の下にある [保存] ボタン](/assets/images/help/enterprises/settings-scim-save.png) {%- endif %}
|
||||
1. IdP の {% data variables.product.product_name %} のアプリケーションでユーザプロビジョニングを設定します。
|
||||
1. ご利用の IdP 上で {% data variables.product.product_name %} 用のアプリケーションでユーザー プロビジョニングを構成します。{% ifversion scim-for-ghes %} サポートされている IdP のドキュメントを要求するには、{% data variables.contact.contact_enterprise_sales %} でアカウント マネージャーにお問い合わせください。 ご利用の IdP がサポートされていない場合は、アプリケーションを作成し、SCIM を手動で構成する必要があります。{% elsif ghae %}
|
||||
|
||||
{%- ifversion ghae %} 次の IdP は、{% data variables.product.product_name %} のプロビジョニングの構成に関するドキュメントを提供しています。 IdP がリストにない場合は、IdP に問い合わせて、{% data variables.product.product_name %} のサポートをご依頼ください。
|
||||
{%- elsif scim-for-ghes %} {% data variables.product.company_short %} では、次の IdP 用のプロビジョニングの構成に関するドキュメントを提供しています。{% endif %}
|
||||
次の IdP では、{% data variables.product.product_name %} のプロビジョニングの設定に関するドキュメントを提供しています。 IdP がリストにない場合は、IdP に問い合わせて、{% data variables.product.product_name %} のサポートをご依頼ください。
|
||||
|
||||
| IdP | 詳細情報 |
|
||||
| :- | :- |
|
||||
| Azure AD | {% ifversion ghae %}Microsoft Docs の「[チュートリアル: {% data variables.product.prodname_ghe_managed %} を構成し、自動ユーザー プロビジョニングに対応させる](https://docs.microsoft.com/azure/active-directory/saas-apps/github-ae-provisioning-tutorial)」。{% endif %}{% data variables.product.product_name %} 用に Azure AD を構成するには、「[Azure AD を使用して Enterprise の認証とプロビジョニングを構成する](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad)」を参照してください。 |
|
||||
| Okta | {% ifversion ghae %}(beta){% endif %} {% data variables.product.product_name %} 用に Okta を構成するには、「[Okta を使用して Enterprise の認証とプロビジョニングを構成する](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-okta)」を参照してください。 |
|
||||
| Azure AD | Microsoft Docs の「[チュートリアル: {% data variables.product.prodname_ghe_managed %} を構成し、自動ユーザー プロビジョニングに対応させる](https://docs.microsoft.com/azure/active-directory/saas-apps/github-ae-provisioning-tutorial)」。{% data variables.product.product_name %} に Azure AD を設定するには、「[Azure AD を使用して Enterprise の認証とプロビジョニングを設定する](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad)」を参照してください。 |
|
||||
| Okta | (ベータ版) {% data variables.product.product_name %} に Okta を設定するには、「[Okta を使用して Enterprise の認証とプロビジョニングを設定する](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-okta)」を参照してください。 |
|
||||
|
||||
IdP のアプリケーションでは、{% data variables.location.product_location %} でユーザー アカウントをプロビジョニングまたはプロビジョニング解除するために次の 2 つの値が必要です。
|
||||
|
||||
| 値 | その他の名前 | 説明 | 例 |
|
||||
| :- | :- | :- | :- |
|
||||
| URL | テナントの URL | {% data variables.product.prodname_ghe_managed %} にある Enterprise の SCIM プロビジョニング API への URL | <nobr><code>{% data variables.product.api_url_pre %}/scim/v2</nobr></code> |
|
||||
| 共有シークレット | {% data variables.product.pat_generic_caps %}、シークレット トークン | Enterprise オーナーに代わってプロビジョニングタスクを実行するための IdP 上のアプリケーションのトークン | 手順 {% ifversion ghae %}1{% elsif scim-for-ghes %}4{% endif %} で作成した{% data variables.product.pat_generic_caps %} |
|
||||
| URL | テナントの URL | {% data variables.product.product_name %} にある Enterprise の SCIM プロビジョニング API への URL | <nobr><code>{% data variables.product.api_url_pre %}/scim/v2</nobr></code> |
|
||||
| 共有シークレット | {% data variables.product.pat_generic_caps %}、シークレット トークン | Enterprise オーナーに代わってプロビジョニングタスクを実行するための IdP 上のアプリケーションのトークン | 手順 1 で作成した {% data variables.product.pat_generic_caps %} |
|
||||
{%- endif %}
|
||||
|
||||
@@ -14,12 +14,12 @@ topics:
|
||||
- Enterprise
|
||||
- Logging
|
||||
- API
|
||||
ms.openlocfilehash: b3c0f2756873494effd0a7fa3e65d4c87e24c01a
|
||||
ms.sourcegitcommit: d2f0b59ed096b9e68ef8f6fa019cd925165762ec
|
||||
ms.openlocfilehash: f5dd0a3dcca1e7fd60361f0cb7c8ecf84296e036
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/29/2022
|
||||
ms.locfileid: '148184254'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192658'
|
||||
---
|
||||
## Audit log API を使用する
|
||||
|
||||
@@ -120,11 +120,11 @@ GraphQL API は、クエリごとに最大 100 個のノードを返します。
|
||||
|
||||
### 例 1: 特定の日付を対象としたエンタープライズ内のすべてのイベント (ページ分割あり)
|
||||
|
||||
ページベースまたはカーソル ベースのページネーションを使用できます。 詳しい情報については、「[ページネーションを使用したトラバース](/rest/guides/traversing-with-pagination)」を参照してください。
|
||||
ページベースまたはカーソル ベースのページネーションを使用できます。 ページネーションの詳細については、「[REST API でページネーションを使用する](/rest/guides/using-pagination-in-the-rest-api)」を参照してください。
|
||||
|
||||
#### ページベースのページネーションの例
|
||||
|
||||
次のクエリは、`avocado-corp` エンタープライズで 2022 年 1 月 1 日に作成された監査ログ イベントを検索し、[REST API のページ分割](/rest/overview/resources-in-the-rest-api#pagination)を使って、1 ページあたり最大 100 件の項目で最初のページを返します。
|
||||
次のクエリは、`avocado-corp` エンタープライズで 2022 年 1 月 1 日に作成された監査ログ イベントを検索し、ページネーションを使用して 1 ページあたり最大 100 件の項目で最初のページを返します。 ページネーションの詳細については、「[REST API でページネーションを使用する](/rest/guides/using-pagination-in-the-rest-api)」を参照してください。
|
||||
|
||||
```shell
|
||||
curl -H "Authorization: Bearer TOKEN" \
|
||||
@@ -134,7 +134,7 @@ curl -H "Authorization: Bearer TOKEN" \
|
||||
|
||||
#### カーソルベースのページネーションの例
|
||||
|
||||
次のクエリは、`avocado-corp` Enterprise で 2022 年 1 月 1 日に作成された監査ログ イベントを検索し、[REST API のページネーション](/rest/overview/resources-in-the-rest-api#pagination)を使って、1 ページあたり最大 100 件の項目で最初のページを返します。 `--include` フラグを指定すると、応答と共にヘッダーが返されます。
|
||||
次のクエリは、`avocado-corp` エンタープライズで 2022 年 1 月 1 日に作成された監査ログ イベントを検索し、ページネーションを使用して 1 ページあたり最大 100 件の項目で最初のページを返します。 ページネーションの詳細については、「[REST API でページネーションを使用する](/rest/guides/using-pagination-in-the-rest-api)」を参照してください。 `--include` フラグを指定すると、応答と共にヘッダーが返されます。
|
||||
|
||||
```
|
||||
curl --include -H "Authorization: Bearer TOKEN" \
|
||||
|
||||
@@ -0,0 +1,65 @@
|
||||
---
|
||||
title: エンタープライズで GitHub Copilot のポリシーを適用する
|
||||
intro: 'エンタープライズの Organization 内で {% data variables.product.prodname_copilot_for_business %} に対してポリシーを適用したり、各 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
|
||||
ms.openlocfilehash: f87fa318a6390c9e254c3c115638325b8bfc474a
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193439'
|
||||
---
|
||||
## エンタープライズの {% data variables.product.prodname_copilot %} のポリシーについて
|
||||
|
||||
{% data reusables.copilot.about-copilot %}
|
||||
|
||||
エンタープライズの Organization 内で {% data variables.product.prodname_copilot_for_business %} に対してポリシーを適用したり、各 Organization でポリシーを設定したりできます。
|
||||
|
||||
{% data variables.product.prodname_copilot_for_business %} のサブスクリプションを設定する場合は、エンタープライズ内の Organization の {% data variables.product.prodname_copilot %} へのアクセスを許可および取り消すことができます。 {% data variables.product.prodname_copilot %} へのアクセスを Organization に許可すると、その Organization の管理者は個人とチームにアクセスを許可できます。 詳しくは、「[Organization で {% data variables.product.prodname_copilot %} の設定を構成する](/copilot/configuring-github-copilot/configuring-github-copilot-settings-in-your-organization)」を参照してください。
|
||||
|
||||
{% data variables.product.prodname_copilot_for_business %} サブスクリプションは、エンタープライズ内のユーザーに割り当てられた {% data variables.product.prodname_copilot %} シートの数に基づいて月単位で課金されます。 詳しくは、「[{% data variables.product.prodname_copilot %} の {% 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 %} には、{% data variables.product.prodname_dotcom %} のパブリック コードと一致するコード候補を検出するフィルターが含まれています。 {% data variables.product.prodname_copilot_for_business %} を使用すると、エンタープライズ レベルでフィルターを有効または無効にするか、Organization の管理者が Organization レベルで決定するかを選べます。 フィルターが有効になっていると、{% data variables.product.prodname_copilot %} によって、周囲の約 150 文字のコードに関するコード候補が、{% data variables.product.prodname_dotcom %} でのパブリック コードに対してチェックされます。 一致または近い一致がある場合、候補は表示されません。
|
||||
|
||||
## エンタープライズで {% data variables.product.prodname_copilot_for_business %} の使用を管理するポリシーを適用する
|
||||
|
||||
{% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.copilot-tab %}
|
||||
1. [{% data variables.product.prodname_copilot %} への Organization のアクセスを管理する] で、{% data variables.product.prodname_copilot %} サブスクリプションのアクセスを構成します。
|
||||
- エンタープライズ内のすべての Organization に対して {% data variables.product.prodname_copilot %} を無効にするには、 **[無効]** を選びます。
|
||||
- 現在と将来の両方で、エンタープライズ内のすべての Organization に対して {% data variables.product.prodname_copilot %} を有効にするには、 **[すべての Organization に許可する]** を選びます。
|
||||
- 特定の Organization に対して {% data variables.product.prodname_copilot %} を有効にするには、 **[特定の Organization に許可する]** を選びます。
|
||||
|
||||

|
||||
|
||||
1. **[特定の Organization に許可する]** を選んだ場合は、{% data variables.product.prodname_copilot %} を有効にする Organization を選びます。 または、{% data variables.product.prodname_copilot %} へのアクセスを無効にする Organization を選ぶこともできます。
|
||||
- **[Organization のアクセス許可の設定]** をクリックし、 **[有効]** または **[無効]** を選び、指定した Organization の {% data variables.product.prodname_copilot %} へのアクセスを許可または拒否します。
|
||||
|
||||

|
||||
|
||||
1. **[変更を保存]** をクリックします。
|
||||
|
||||

|
||||
|
||||
## エンタープライズ内のパブリック コードに一致する {% data variables.product.prodname_copilot %} の提案の使用を管理するためのポリシーを適用する
|
||||
|
||||
{% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.copilot-tab %}
|
||||
1. [パブリック コードに一致する候補] で、ドロップダウン メニューをクリックし、適用するポリシーを選びます。
|
||||
- パブリック コードに一致する {% data variables.product.prodname_copilot %} の提案を許可するには、 **[許可]** を選びます。
|
||||
- パブリック コードに一致する {% data variables.product.prodname_copilot %} の提案をブロックするには、 **[ブロック]** を選びます。
|
||||
- パブリック コードに一致する {% data variables.product.prodname_copilot %} の提案の使用について各 Organization が独自のポリシーを設定できるようにするには、 **[ポリシーなし (各 Organization が決定できるようにする)]** を選びます。
|
||||
|
||||

|
||||
|
||||
## 参考資料
|
||||
|
||||
- 「[{% data variables.product.prodname_copilot_for_business %} プライバシーに関する声明](/free-pro-team@latest/site-policy/privacy-policies/github-copilot-for-business-privacy-statement)」
|
||||
@@ -44,12 +44,12 @@ topics:
|
||||
- Repositories
|
||||
- Security
|
||||
shortTitle: Repository management policies
|
||||
ms.openlocfilehash: 4abffb820c09b8d5896598fa1d233143e3872955
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 10b34ef1d0049ca68e1b0ec655f9d6351c06d396
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147683712'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192642'
|
||||
---
|
||||
## Enterprise でのリポジトリ管理のポリシーについて
|
||||
|
||||
@@ -61,7 +61,7 @@ ms.locfileid: '147683712'
|
||||
|
||||
ユーザーが Enterprise 内に新しいリポジトリを作成するたびに、そのユーザーはリポジトリの可視性を選ぶ必要があります。 その Enterprise のデフォルトの可視性の設定をする際には、デフォルトで選択される可視性を選択します。 リポジトリの可視性の詳細については、「[リポジトリについて](/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility)」を参照してください。
|
||||
|
||||
Enterprise オーナーがメンバーによる特定のタイプのリポジトリの作成を禁止している場合、可視性設定がデフォルトでそのタイプに設定されていても、メンバーはそのタイプのリポジトリを作成できません。 詳しい情報については、「[リポジトリ作成のためのポリシーの設定](#setting-a-policy-for-repository-creation)」を参照してください。
|
||||
Enterprise オーナーがメンバーによる特定のタイプのリポジトリの作成を禁止している場合、可視性設定がデフォルトでそのタイプに設定されていても、メンバーはそのタイプのリポジトリを作成できません。 詳細については、「[リポジトリ作成のためのポリシーの適用](#enforcing-a-policy-for-repository-creation)」を参照してください。
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %} {% ifversion ghes or ghae %} {% data reusables.enterprise-accounts.policies-tab %} {% else %} {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %}
|
||||
1. "Default repository visibility(デフォルトのリポジトリの可視性)"の下で、ドロップダウンメニューを使ってデフォルトの可視性を選択してください。
|
||||
@@ -100,9 +100,11 @@ Enterprise で所有しているすべての Organization 全体で、メンバ
|
||||
{% endif %}
|
||||
|
||||
## プライベートまたは内部リポジトリのフォークに関するポリシーを適用する
|
||||
|
||||
Enterprise が所有しているすべての Organization 全体で、ユーザーにリポジトリのフォーク用にプライベートまたは内部リポジトリへのアクセスを許可したり、プライベートまたは内部リポジトリのフォークを一切禁止したり、オーナーが Organization レベルで設定を管理できるようにしたりすることができます。
|
||||
|
||||
{% ifversion org-owners-limit-forks-creation %} 管理者アクセス許可を持つ人はフォーク ポリシーをさらに細かく設定できます。 詳細については、「[Organization のフォーク ポリシーを管理する](/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization)」を参照してください。
|
||||
{% endif %}
|
||||
|
||||
{% ifversion enterprise-namespace-repo-setting %} {% note %}
|
||||
|
||||
**メモ:** {% ifversion ghec %}Enterprise で {% data variables.product.prodname_emus %} を使っており、{% endif %}"リポジトリ作成" ポリシーによって Enterprise のメンバーが自分のユーザー アカウントで所有しているリポジトリを作成できない場合は、"リポジトリ作成" ポリシーにかかわらず、メンバーが自分のユーザー アカウントでリポジトリをフォークすることはできません。
|
||||
@@ -110,8 +112,8 @@ Enterprise が所有しているすべての Organization 全体で、ユーザ
|
||||
{% endnote %} {% endif %}
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.repositories-tab %}
|
||||
3. [リポジトリのフォーク] で、設定変更についての情報を確認します。 {% data reusables.enterprise-accounts.view-current-policy-config-orgs %}
|
||||
4. [Repository forking] で、ドロップダウンメニューを使用してポリシーを選択します。
|
||||
1. [リポジトリのフォーク] で、設定変更についての情報を確認します。 {% data reusables.enterprise-accounts.view-current-policy-config-orgs %}
|
||||
2. [Repository forking] で、ドロップダウンメニューを使用してポリシーを選択します。
|
||||
|
||||
{% ifversion innersource-fork-policies %}
|
||||
5. フォークが有効な場合、リポジトリのフォークをユーザーに許可する場所を指定できます。 設定の変更に関する情報を確認し、ポリシーを選びます。
|
||||
@@ -145,7 +147,7 @@ Enterprise で所有しているすべての Organization 全体で、メンバ
|
||||
|
||||
Enterprise で所有しているすべての Organization 全体で、管理者アクセス権を持つメンバーがリポジトリの可視性を変更できるようにしたり、リポジトリの可視性の変更を Organization 所有者に限定したり、所有者が Organization レベルで設定を管理できるようにしたりできます。 メンバーがリポジトリの可視性を変更できないようにした場合、Enterprise のオーナーのみがリポジトリの可視性を変更できます。
|
||||
|
||||
Enterprise のオーナーがリポジトリの作成を Organization のオーナーのみに制限している場合、メンバーはリポジトリの可視性を変更できません。 Enterprise のオーナーがメンバーリポジトリの作成をプライベートリポジトリのみに制限している場合、メンバーはリポジトリの可視性をプライベートにのみ変更できます。 詳しい情報については、「[リポジトリ作成のためのポリシーの設定](#setting-a-policy-for-repository-creation)」を参照してください。
|
||||
Enterprise のオーナーがリポジトリの作成を Organization のオーナーのみに制限している場合、メンバーはリポジトリの可視性を変更できません。 Enterprise のオーナーがメンバーリポジトリの作成をプライベートリポジトリのみに制限している場合、メンバーはリポジトリの可視性をプライベートにのみ変更できます。 詳細については、「[リポジトリ作成のためのポリシーの適用](#enforcing-a-policy-for-repository-creation)」を参照してください。
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.repositories-tab %}
|
||||
1. [Repository visibility change] で、設定変更についての情報を確認します。 {% data reusables.enterprise-accounts.view-current-policy-config-orgs %}
|
||||
@@ -256,7 +258,7 @@ Enterprise で所有しているすべての Organization 全体で、メンバ
|
||||
|
||||
{% data reusables.enterprise_user_management.disclaimer-for-git-read-access %}
|
||||
|
||||
{% data variables.product.product_location %}に対して[プライベート モードを有効にしている](/enterprise/admin/configuration/enabling-private-mode)場合、リポジトリ管理者にパブリック リポジトリへの匿名 Git 読み取りアクセスの有効化を許可できます。
|
||||
{% data variables.location.product_location %} に対して[プライベート モードを有効にしている](/enterprise/admin/configuration/enabling-private-mode)場合、リポジトリ管理者にパブリック リポジトリへの匿名 Git 読み取りアクセスの有効化を許可できます。
|
||||
|
||||
匿名 Git 読み取りアクセスを有効化すると、ユーザは Enterprise 上のカスタムツールの認証をバイパスできるようになります。 ユーザーまたはリポジトリ管理者がリポジトリに対してこのアクセス設定を有効にすると、認証されていない Git 操作 (そして {% data variables.product.product_name %} へのネットワーク アクセスができる人は誰でも) が、認証なしでリポジトリに読み取りアクセスできることになります。
|
||||
|
||||
@@ -266,7 +268,18 @@ Enterprise で所有しているすべての Organization 全体で、メンバ
|
||||
The unauthenticated git protocol on port 9418 is no longer supported.
|
||||
```
|
||||
|
||||
環境内で認証されていない Git プロトコルをサポートする場合は、この機能を手動で再度有効にする必要があります。 {% data variables.product.company_short %} では、Git プロトコルの代わりに SSH を使用することが推奨されています。 詳しくは、[{% data variables.product.prodname_blog %}](https://github.blog/2022-06-28-improving-git-protocol-security-on-github-enterprise-server)を参照してください。
|
||||
{% ifversion ghes > 3.5 %}
|
||||
|
||||
環境内で認証されていない Git プロトコルをサポートする場合は、この機能を手動で再度有効にする必要があります。 アップグレード後に次のコマンドを実行します。
|
||||
|
||||
```ShellSession
|
||||
$ sudo ghe-config app.gitauth.git-protocol true
|
||||
$ sudo ghe-config-apply
|
||||
```
|
||||
|
||||
{% endif %}
|
||||
|
||||
匿名 Git 読み取りアクセスは {% data variables.product.prodname_ghe_server %} の今後のリリースで完全に削除される予定です。 {% data variables.product.company_short %} では、Git プロトコルの代わりに SSH を使用することが推奨されています。 この変更の詳細については、「[{% data variables.product.prodname_blog %}](https://github.blog/2022-06-28-improving-git-protocol-security-on-github-enterprise-server)」をご覧ください。
|
||||
|
||||
{% endif %}
|
||||
|
||||
|
||||
@@ -1,26 +1,45 @@
|
||||
---
|
||||
title: GitHub Copilot の課金について
|
||||
intro: '{% data variables.product.prodname_copilot %} を使用する場合は、{% data variables.product.prodname_dotcom %} アカウントのサブスクリプションが必要です。'
|
||||
intro: '{% data variables.product.prodname_copilot %} を使用する場合は、個人アカウントで {% data variables.product.prodname_copilot_for_individuals %} のサブスクリプションが必要です。または、{% data variables.product.prodname_copilot_for_business %} のサブスクリプションを持つ {% data variables.product.prodname_ghe_cloud %} の Organization によってシートが割り当てられている必要があります。'
|
||||
product: '{% data reusables.gated-features.copilot-billing %}'
|
||||
versions:
|
||||
feature: copilot
|
||||
topics:
|
||||
- Copilot
|
||||
shortTitle: Billing for GitHub Copilot
|
||||
ms.openlocfilehash: 38bdf5dcef235faef0c04fa207e3dca8a4420105
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: f82f284ac2bdb8a4bc56587ff17826ae7ca96585
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147573789'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193436'
|
||||
---
|
||||
## {% data variables.product.prodname_copilot %} の課金について
|
||||
|
||||
{% data variables.product.prodname_copilot %} を使用する場合は、{% data variables.product.prodname_dotcom %} 個人アカウントのサブスクリプションが必要です。 {% data variables.product.prodname_copilot %} の詳しい情報については、「[{% data variables.product.prodname_copilot %} について](/en/copilot/overview-of-github-copilot/about-github-copilot)」をご覧ください。
|
||||
{% data variables.product.prodname_copilot %} を使用する場合は、{% data variables.product.prodname_dotcom %} の個人アカウントのサブスクリプションが必要です。または、{% data variables.product.prodname_copilot_business_short %} のサブスクリプションを持つ {% data variables.product.prodname_ghe_cloud %} Organization のメンバーである場合は、組織管理者によってシートが割り当てられている必要があります。{% data variables.product.prodname_copilot %} について詳しくは、「[{% data variables.product.prodname_copilot %} について](/en/copilot/overview-of-github-copilot/about-github-copilot)」を参照してください。
|
||||
|
||||
有料サブスクリプションを開始する前に、{% data variables.product.prodname_copilot %} を評価するための 60 日間の 1 回限りの試用版を設定できます。 試用版を開始するには、月単位または年単位の請求期間を選び、支払い方法を指定する必要があります。 60 日以内に試用版をキャンセルしない場合、試用版は自動的に有料サブスクリプションに変換されます。 {% data variables.product.prodname_copilot %} 試用版は、60 日間いつでもキャンセルすることができます。料金は発生しません。 試用期間が終了する前にキャンセルした場合、60 日間の試用期間が終了するまで、{% data variables.product.prodname_copilot %} に引き続きアクセスできます。 詳しくは、「[GitHub Copilot サブスクリプションの管理](/en/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription)」を参照してください。
|
||||
{% data variables.product.prodname_ghe_cloud %} を使用した {% data variables.product.prodname_copilot %} の管理について詳しくは、{% data variables.product.prodname_ghe_cloud %} ドキュメントの「[Enterprise で {% data variables.product.prodname_copilot %} のポリシーを適用する](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise){% ifversion ghec %}.{% endif %}」{% ifversion fpt %}を参照してください。{% endif %}
|
||||
|
||||
個人アカウントで有料サブスクリプションを開始する前に、{% data variables.product.prodname_copilot %} を評価するための 60 日間の 1 回限りの試用版を設定できます。 試用版を開始するには、月単位または年単位の請求期間を選び、支払い方法を指定する必要があります。 60 日以内に試用版をキャンセルしない場合、試用版は自動的に有料サブスクリプションに変換されます。 {% data variables.product.prodname_copilot %} 試用版は、60 日間いつでもキャンセルすることができます。料金は発生しません。 試用期間が終了する前にキャンセルした場合、60 日間の試用期間が終了するまで、{% data variables.product.prodname_copilot %} に引き続きアクセスできます。 詳しくは、「[{% data variables.product.prodname_copilot_for_individuals %} のサブスクリプションを管理する](/en/billing/managing-billing-for-github-copilot/managing-your-github-copilot-for-individuals-subscription)」を参照してください。
|
||||
|
||||
## {% data variables.product.prodname_copilot_for_individuals %} の価格
|
||||
|
||||
## {% data variables.product.prodname_copilot %} の価格
|
||||
|
||||
{% data variables.product.prodname_copilot %} サブスクリプションは、月単位または年単位のサイクルで利用できます。 月単位の請求期間を選ぶと、1 か月あたり 10 ドルが課金されます。 年単位の請求期間を選ぶと、1 年あたり 100 ドルが課金されます。 請求期間はいつでも変更でき、変更は次の請求期間の開始時から反映されます。
|
||||
|
||||
{% data variables.product.prodname_copilot %} の無料サブスクリプションは、検証済みの学生、および {% data variables.product.company_short %} の一般的なオープンソース リポジトリの保守担当者が利用できます。 オープンソースの保守担当者として条件を満たしている場合、{% data variables.product.prodname_copilot %} サブスクリプション ページにアクセスすると、自動的に通知されます。 学生として、現在 {% data variables.product.prodname_student_pack %} を受け取っている場合は、{% data variables.product.prodname_copilot %} サブスクリプション ページにアクセスすると、無料のサブスクリプションも提供されます。 {% data variables.product.prodname_student_pack %} について詳しくは、「[学生として {% data variables.product.prodname_global_campus %} に応募する](/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)」を参照してください。
|
||||
アクティブな {% data variables.product.prodname_copilot %} のサブスクリプションがあり、{% data variables.product.prodname_ghe_cloud %} の {% data variables.product.prodname_copilot_for_business %} サブスクリプションの一部としてシートが割り当てられている場合、個人の {% data variables.product.prodname_copilot %} サブスクリプションは自動的に取り消されます。 個人サブスクリプションの現在の請求期間の残りの部分に対しては、日割り計算での返金があります。 その後、Enterprise または Organization レベルで設定されたポリシーに従って、{% data variables.product.prodname_copilot %} を引き続き使用できます。
|
||||
|
||||
{% data variables.product.prodname_copilot %} の無料サブスクリプションは、検証済みの学生、教師、および {% data variables.product.company_short %} の一般的なオープンソース リポジトリの保守担当者が利用できます。 オープンソースの保守担当者として条件を満たしている場合、{% data variables.product.prodname_copilot %} サブスクリプション ページにアクセスすると、自動的に通知されます。 学生として、現在 {% data variables.product.prodname_student_pack %} を受け取っている場合は、{% data variables.product.prodname_copilot %} サブスクリプション ページにアクセスすると、無料のサブスクリプションも提供されます。 {% data variables.product.prodname_student_pack %} について詳しくは、「[学生として {% data variables.product.prodname_global_campus %} に応募する](/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 %}
|
||||
## {% data variables.product.prodname_copilot_for_business %} の価格
|
||||
|
||||
{% data variables.product.prodname_copilot_for_business %} のサブスクリプションは月単位の期間で利用でき、ユーザーあたり 1 か月 $19 が請求されます。 {% data variables.product.prodname_ghe_cloud %} の {% data variables.product.prodname_copilot %} の請求は、各請求期間の終了時に処理されます。
|
||||
|
||||
請求対象ユーザーは、請求期間の開始時に割り当てられた、または請求期間中に割り当てられた {% data variables.product.prodname_copilot %} シートの数に基づいて計算されます。 請求期間の途中で割り当てられたシートは、期間の残りの日数に基づいて日割り計算されます。 請求期間中に削除されたシートの割り当ては、次の期間の初めから有効になります。
|
||||
|
||||
{% data variables.product.prodname_ghe_cloud %} の {% data variables.product.prodname_copilot %} のシート割り当ては、Enterprise レベルで {% data variables.product.prodname_copilot %} へのアクセスが許可されている Organization の管理者によって管理されます。 同じ Enterprise の複数の Organization のメンバーである場合は、複数の Organization に {% data variables.product.prodname_copilot %} シートを割り当てることができますが、Enterprise の請求は 1 回だけです。 詳しくは、「[Organization で {% data variables.product.prodname_copilot %} の設定を構成する](/enterprise-cloud@latest/copilot/configuring-github-copilot/configuring-github-copilot-settings-in-your-organization)」を参照してください。
|
||||
|
||||
{% data variables.product.prodname_ghe_cloud %} の {% data variables.product.prodname_copilot %} のポリシー設定と使用状況の概要は、Enterprise レベルで確認できます。 詳しくは、「[Enterprise で {% data variables.product.prodname_copilot %} のポリシーを適用する](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise)」および「[{% data variables.product.prodname_copilot %} の使用状況を表示する](/enterprise-cloud@latest/billing/managing-billing-for-github-copilot/viewing-your-github-copilot-usage)」を参照してください。
|
||||
|
||||
{% endif %}
|
||||
|
||||
@@ -1,18 +1,18 @@
|
||||
---
|
||||
title: GitHub Copilot の課金の管理
|
||||
shortTitle: GitHub Copilot
|
||||
intro: 'サブスクリプションを開始する前に無料試用版で {% data variables.product.prodname_copilot %} を試し、サブスクリプションをいつでも変更または取り消すことができます。'
|
||||
intro: 'サブスクリプションを開始する前に {% data variables.product.prodname_copilot_for_individuals %} を無料試用版で試してから、いつでもサブスクリプションを変更または取り消すことができます。 また、{% data variables.product.prodname_copilot_for_business %} の使用状況を確認して、コストがどのように計算されるかを理解することもできます。'
|
||||
versions:
|
||||
feature: copilot
|
||||
children:
|
||||
- /about-billing-for-github-copilot
|
||||
- /managing-your-github-copilot-for-individuals-subscription
|
||||
- /viewing-your-github-copilot-usage
|
||||
ms.openlocfilehash: 96947819762933ad78544da4b8347cbc5efef646
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: a3d7ca504b8990078b63b28ffb4a13ad7e0fcaef
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147080359'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193431'
|
||||
---
|
||||
|
||||
|
||||
@@ -0,0 +1,61 @@
|
||||
---
|
||||
title: 個人向け GitHub Copilot サブスクリプションの管理
|
||||
intro: '個人アカウントで {% data variables.product.prodname_copilot %} の無料試用版を設定し、サブスクリプションを管理できます。'
|
||||
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
|
||||
topics:
|
||||
- Copilot
|
||||
shortTitle: Your GitHub Copilot subscription
|
||||
ms.openlocfilehash: 1f8b6f9581925faacae7f5ba5f2653ab713617ed
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193428'
|
||||
---
|
||||
## 個人アカウントでの {% data variables.product.prodname_copilot %} の試用版の設定
|
||||
|
||||
{% data variables.product.prodname_copilot %} の使用を開始する前に、無料試用版またはサブスクリプションを設定する必要があります。
|
||||
|
||||
{% data reusables.copilot.signup-procedure %}
|
||||
|
||||
## {% data variables.product.prodname_copilot %} サブスクリプションの変更
|
||||
|
||||
{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.billing_plans %}
|
||||
1. [{% data variables.product.prodname_copilot %}] セクションで、 **[編集]** ドロップダウンを選びます。
|
||||
- 月単位の請求サイクルを使用している場合は、 **[年間の支払いへの変更]** を選びます。
|
||||
- 年単位の請求サイクルを使用している場合は、 **[月間の支払いへの変更]** を選びます。
|
||||
|
||||
![[編集] ドロップダウンが強調された、課金ページの {% data variables.product.prodname_copilot %} セクションのスクリーンショット](/assets/images/help/copilot/copilot-settings-edit-dropdown.png)
|
||||
|
||||
|
||||
## {% data variables.product.prodname_copilot %} サブスクリプションの取り消し
|
||||
|
||||
{% data variables.product.prodname_copilot %} サブスクリプションはいつでも取り消すことができます。 60 日間の試用期間中に取り消す場合は、課金されません。 60 日間の試用期間が終了する前に {% data variables.product.prodname_copilot %} サブスクリプションを取り消さない場合は、試用版の設定時に選んだ請求サイクルに従って課金されます。
|
||||
|
||||
{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.billing_plans %}
|
||||
1. [{% data variables.product.prodname_copilot %}] セクションで、 **[編集]** ドロップダウンを選びます。
|
||||
- 有料サブスクリプションをお持ちの場合は、 **[{% data variables.product.prodname_copilot %} の取り消し]** をクリックします。
|
||||
|
||||

|
||||
|
||||
- 60 日の試用期間内の場合は、 **[試用版の取り消し]** をクリックします。
|
||||
|
||||

|
||||
|
||||
2. [{% data variables.product.prodname_copilot %} の取り消し] モーダルで、 **[わかりました。{% data variables.product.prodname_copilot %} を取り消します]** をクリックします
|
||||
|
||||
![[わかりました。{% data variables.product.prodname_copilot %} を取り消します] ボタンが強調された、[{% data variables.product.prodname_copilot %} の取り消し] モーダルのスクリーンショット](/assets/images/help/copilot/copilot-cancel-modal.png)
|
||||
|
||||
- 60 日の試用期間内の場合は、 **[わかりました。{% data variables.product.prodname_copilot %} 試用版を取り消します]** をクリックします。
|
||||
|
||||
![[わかりました。{% data variables.product.prodname_copilot %} を取り消します] ボタンが強調された試用版の取り消しモーダルのスクリーンショット](/assets/images/help/copilot/copilot-trial-cancel-modal.png)
|
||||
|
||||
## 参考資料
|
||||
|
||||
- [{% data variables.product.prodname_copilot %} について](/copilot/overview-of-github-copilot/about-github-copilot)
|
||||
- [{% data variables.product.prodname_copilot %} の概要](/copilot/getting-started-with-github-copilot)
|
||||
@@ -0,0 +1,45 @@
|
||||
---
|
||||
title: GitHub Copilot の使用状況の表示
|
||||
intro: 'Enterprise 内のすべての Organization で {% data variables.product.prodname_copilot %} にアクセスできるユーザーの数を確認できます。'
|
||||
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
|
||||
ms.openlocfilehash: 9b481cfd11a3c96ce98175d3b30e3b26889c4148
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193423'
|
||||
---
|
||||
## {% data variables.product.prodname_copilot %} の使用状況について
|
||||
|
||||
Enterprise 内の {% data variables.product.prodname_copilot %} の使用状況情報は、Organization 別に分類したり、Organization 内でシート割り当て状態別に分類したりして表示できます。 Enterprise レベルでは、この情報には、各 Organization で割り当てられているシートの数や、現在の請求期間において各 Organization に関連付けられている合計支出が含まれます。 Organization レベルでは、この情報には、シートの合計数、前の請求期間から引き継がれたシート、現在の期間中に追加された新しいシート、および現在の期間の終了時に削除されるシートが含まれます。
|
||||
|
||||
Organization の管理者が現在の請求期間の途中で 1 つまたは複数のシートを割り当てた場合、Enterprise レベルの情報にはシート数が 10 進数で表示されます。 たとえば、Organization が 3 つのシートを割り当てて請求期間を開始し、その期間の途中で追加のシートを割り当てた場合に、シートの使用状況情報に表示されるシート数が 3.5 となるとします。 "3" は期間の開始時に割り当てられたシート数を表し、"0.5" は期間の途中で割り当てられた追加のシート数を表します。
|
||||
|
||||
支出情報には、現在の請求期間における各 Organization の合計支出が表示されます。 現在の期間での Organization の合計支出は、通常、割り当てられたシート数に、シートあたりのコスト (1 シートあたり月額 19 ドル) を掛けたものになります。 ただし、同じ Organization メンバーに複数の Organization のシートが割り当てられている場合、そのシートの使用状況は各 Organization に反映されます。ただし、Enterprise が課金されるのは 1 回だけであるため、その支出は、最初にシートが割り当てられた Organization にのみ反映されます。
|
||||
|
||||
## {% data variables.product.prodname_copilot_for_business %} の使用状況の表示
|
||||
|
||||
### Enterpriseレベル
|
||||
|
||||
{% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %}
|
||||
1. [{% data variables.product.prodname_copilot_short %} の月次使用状況] の下で、{% data variables.product.prodname_copilot %} の使用状況の内訳を確認できます。
|
||||
- [シートの使用状況] の下に、Organization ごとに現在割り当てられているシートの総数が表示されます。10 進数は、現在の請求期間の途中で割り当てられたシート数を表します。
|
||||
- [支出] では、Organization ごとに現在の請求期間での {% data variables.product.prodname_copilot_for_business %} の合計コストを確認できます。
|
||||
|
||||
![[{% data variables.product.prodname_copilot %} 使用状況] ページのスクリーンショット](/assets/images/help/copilot/monthly-usage-enterprise.png)
|
||||
|
||||
### Organizationレベル
|
||||
|
||||
{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %}
|
||||
1. サイドバーの [アクセス] セクションで、 **[{% octicon "credit-card" aria-label="The credit card icon" %} 課金とプラン]** をクリックします。
|
||||
1. [{% data variables.product.prodname_copilot_short %}] の下で、{% data variables.product.prodname_copilot %} の使用状況の内訳と、Organization における今後の変更を確認できます。
|
||||
|
||||

|
||||
@@ -18,6 +18,7 @@ children:
|
||||
- /automating-dependabot-with-github-actions
|
||||
- /keeping-your-actions-up-to-date-with-dependabot
|
||||
- /managing-encrypted-secrets-for-dependabot
|
||||
- /configuring-dependabot-to-only-access-private-registries
|
||||
- /troubleshooting-the-detection-of-vulnerable-dependencies
|
||||
- /troubleshooting-dependabot-errors
|
||||
ms.openlocfilehash: efab6caf0c9384c9e72cc5ed1fe64bd500cede45
|
||||
|
||||
@@ -17,12 +17,12 @@ type: overview
|
||||
topics:
|
||||
- Secret scanning
|
||||
- Advanced Security
|
||||
ms.openlocfilehash: d681dc66dfbf62f87e720a04e89d84b696efb859
|
||||
ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8
|
||||
ms.openlocfilehash: 18c77c929bcbe770fd44bfe5bec7e32143a2e604
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/09/2022
|
||||
ms.locfileid: '148158846'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192946'
|
||||
---
|
||||
{% data reusables.secret-scanning.beta %} {% data reusables.secret-scanning.enterprise-enable-secret-scanning %}
|
||||
|
||||
@@ -30,7 +30,7 @@ ms.locfileid: '148158846'
|
||||
|
||||
プロジェクトを外部サービスと通信させる場合、認証にトークンまたは秘密鍵を使用できます。 トークンや秘密鍵は、サービスプロバイダが発行できるシークレットです。 リポジトリにシークレットをチェックインする場合、リポジトリへの読み取りアクセスを持つすべてのユーザがシークレットを使用して、自分の権限で外部サービスにアクセスできます。 シークレットは、プロジェクトのリポジトリの外の、安全な専用の場所に保存することをお勧めします。
|
||||
|
||||
{% data variables.product.prodname_secret_scanning_caps %}では、シークレットの {% data variables.product.prodname_dotcom %} リポジトリ{% ifversion ghec or ghes > 3.4 or ghae > 3.4 %} (リポジトリがアーカイブされている場合も含む) {% endif %}に存在するすべてのブランチ上の Git 履歴全体がスキャンされます。
|
||||
{% data variables.product.prodname_secret_scanning_caps %}では、シークレットの {% data variables.product.prodname_dotcom %} リポジトリ{% ifversion ghec or ghes > 3.4 or ghae > 3.4 %} (リポジトリがアーカイブされている場合も含む) {% endif %}に存在するすべてのブランチ上の Git 履歴全体がスキャンされます。 {% ifversion secret-scanning-issue-body-comments %}{% data reusables.secret-scanning.scan-issue-description-and-comments %}{% endif %}
|
||||
|
||||
{% ifversion fpt or ghec %} {% data variables.product.prodname_secret_scanning_caps %}は、{% data variables.product.prodname_dotcom_the_website %} で次の 2 つの形式で使用できます。
|
||||
|
||||
@@ -49,7 +49,7 @@ ms.locfileid: '148158846'
|
||||
{% ifversion fpt or ghec %}
|
||||
## {% data variables.product.prodname_secret_scanning_partner %}について
|
||||
|
||||
リポジトリをパブリックにするか、パブリック リポジトリに変更をプッシュすると、{% data variables.product.product_name %} では常にコードがスキャンされて、パートナー パターンと一致するシークレットがないか確認されます。 {% data variables.product.prodname_secret_scanning %}で潜在的なシークレットが検出された場合は、そのシークレットを発行したサービス プロバイダーに通知します。 サービス プロバイダーは文字列を検証してから、シークレットを取り消すか、新しいシークレットを発行するか、または直接連絡するかを決定します。 その対応は、ユーザーまたはプロバイダーに関連するリスクによって決まります。 詳細については、「[Supported secrets for partner patterns](/code-security/secret-scanning/secret-scanning-patterns#supported-secrets-for-partner-patterns)」(パートナー パターンでサポートされるシークレット) を参照してください。
|
||||
リポジトリをパブリックにするか、パブリック リポジトリに変更をプッシュすると、{% data variables.product.product_name %} では常にコードがスキャンされて、パートナー パターンと一致するシークレットがないか確認されます。 {% ifversion secret-scanning-issue-body-comments %}{% data reusables.secret-scanning.scan-issue-description-and-comments %}{% endif %} {% data variables.product.prodname_secret_scanning %} によって潜在的シークレットが検出された場合、シークレットを発行したサービス プロバイダーに通知します。 サービス プロバイダーは文字列を検証してから、シークレットを取り消すか、新しいシークレットを発行するか、または直接連絡するかを決定します。 その対応は、ユーザーまたはプロバイダーに関連するリスクによって決まります。 詳細については、「[Supported secrets for partner patterns](/code-security/secret-scanning/secret-scanning-patterns#supported-secrets-for-partner-patterns)」(パートナー パターンでサポートされるシークレット) を参照してください。
|
||||
|
||||
パブリック リポジトリの{% data variables.product.prodname_secret_scanning %}の構成を変更することはできません。
|
||||
|
||||
@@ -69,7 +69,13 @@ ms.locfileid: '148158846'
|
||||
## {% data variables.product.product_name %} の {% data variables.product.prodname_secret_scanning %} について
|
||||
{% endif %}
|
||||
|
||||
{% data variables.product.prodname_secret_scanning_GHAS_caps %}は、{% data variables.product.prodname_GH_advanced_security %} の一環として、組織が所有するすべてのリポジトリで使用できます。 ユーザ所有のリポジトリでは使用できません。 リポジトリに対して{% data variables.product.prodname_secret_scanning %}を有効にすると、{% data variables.product.prodname_dotcom %} ではコードがスキャンされて、多くのサービス プロバイダーによって使用されるシークレットと一致するパターンがないか確認されます。 {% ifversion secret-scanning-backfills %}{% data variables.product.prodname_dotcom %} では、{% data variables.product.prodname_secret_scanning %} が有効になっている {% data variables.product.prodname_GH_advanced_security %} リポジトリ内の既存のコンテンツの完全な Git 履歴スキャンも定期的に実行され、{% data variables.product.prodname_secret_scanning %} アラート通知設定に従ってアラート通知が送信されます。 {% endif %}詳細については、{% ifversion ghec %}「[高度なセキュリティに対してサポートされているシークレット](/code-security/secret-scanning/secret-scanning-patterns#supported-secrets-for-advanced-security)」{% else %}「[{% data variables.product.prodname_secret_scanning_caps %} パターン](/code-security/secret-scanning/secret-scanning-patterns)」{% endif %} を参照してください。
|
||||
{% data variables.product.prodname_secret_scanning_GHAS_caps %}は、{% data variables.product.prodname_GH_advanced_security %} の一環として、組織が所有するすべてのリポジトリで使用できます。 ユーザ所有のリポジトリでは使用できません。 リポジトリに対して{% data variables.product.prodname_secret_scanning %}を有効にすると、{% data variables.product.prodname_dotcom %} ではコードがスキャンされて、多くのサービス プロバイダーによって使用されるシークレットと一致するパターンがないか確認されます。 {% ifversion secret-scanning-issue-body-comments %}{% data reusables.secret-scanning.scan-issue-description-and-comments %}{% endif %} {% ifversion secret-scanning-backfills %}{% data variables.product.prodname_dotcom %} では、{% data variables.product.prodname_secret_scanning %} が有効になっている {% data variables.product.prodname_GH_advanced_security %} リポジトリ内の既存のコンテンツの完全な Git 履歴スキャンも定期的に実行され、{% data variables.product.prodname_secret_scanning %} アラート通知設定に従ってアラート通知が送信されます。 {% endif %}詳細については、{% ifversion ghec %}「[高度なセキュリティに対してサポートされているシークレット](/code-security/secret-scanning/secret-scanning-patterns#supported-secrets-for-advanced-security)」{% else %}「[{% data variables.product.prodname_secret_scanning_caps %} パターン](/code-security/secret-scanning/secret-scanning-patterns)」{% endif %} を参照してください。
|
||||
|
||||
{% ifversion secret-scanning-issue-body-comments %} {% note %}
|
||||
|
||||
**注:** Issue の説明とコメントの {% data variables.product.prodname_secret_scanning_caps %} はパブリック ベータ版であり、変更される可能性があります。
|
||||
|
||||
{% endnote %} {% endif %}
|
||||
|
||||
リポジトリ管理者は、任意のリポジトリ{% ifversion ghec or ghes > 3.4 or ghae > 3.4 %} (アーカイブされたリポジトリを含む) {% endif %}に対して{% data variables.product.prodname_secret_scanning_GHAS %}を有効にすることができます。 組織の所有者は、すべてのリポジトリまたは組織内のすべての新しいリポジトリに対して{% data variables.product.prodname_secret_scanning_GHAS %}を有効にすることもできます。 詳細については、「[リポジトリのセキュリティと分析設定を管理する](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)」および「[Managing security and analysis settings for your organization](/organizations/keeping-your-organization-secure/managing-security-and-analysis-settings-for-your-organization)」(組織のセキュリティと分析設定を管理する) を参照してください。
|
||||
|
||||
@@ -80,7 +86,7 @@ ms.locfileid: '148158846'
|
||||
|
||||
### {% data variables.product.prodname_secret_scanning %} アラートについて
|
||||
|
||||
リポジトリの {% data variables.product.prodname_secret_scanning %}を有効にする、または {% data variables.product.prodname_secret_scanning %}が有効になっているリポジトリにコミットをプッシュすると、{% data variables.product.prodname_dotcom %} によってそれらのコミットの内容がスキャンされて、サービス プロバイダーで定義されているパターン{% ifversion ghes or ghae or ghec %}、および Enterprise、Organization、またはリポジトリで定義されているカスタム パターン{% endif %}と一致するシークレットが確認されます。 {% ifversion secret-scanning-backfills %}{% data variables.product.prodname_dotcom %} では、{% data variables.product.prodname_secret_scanning %}が有効になっているリポジトリ内のすべての履歴コンテンツのスキャンも定期的に実行されます。{% endif%}
|
||||
リポジトリの {% data variables.product.prodname_secret_scanning %}を有効にする、または {% data variables.product.prodname_secret_scanning %}が有効になっているリポジトリにコミットをプッシュすると、{% data variables.product.prodname_dotcom %} によってそれらのコミットの内容がスキャンされて、サービス プロバイダーで定義されているパターン{% ifversion ghes or ghae or ghec %}、および Enterprise、Organization、またはリポジトリで定義されているカスタム パターン{% endif %}と一致するシークレットが確認されます。 {% ifversion secret-scanning-issue-body-comments %}{% data reusables.secret-scanning.scan-issue-description-and-comments %}{% endif %} {% ifversion secret-scanning-backfills %}{% data variables.product.prodname_dotcom %} では、{% data variables.product.prodname_secret_scanning %}が有効になっているリポジトリ内のすべての履歴コンテンツのスキャンも定期的に実行されます。{% endif%}
|
||||
|
||||
{% data variables.product.prodname_secret_scanning %}でシークレットが検出されると、{% data variables.product.prodname_dotcom %} によってアラートが送信されます。
|
||||
|
||||
@@ -94,7 +100,7 @@ ms.locfileid: '148158846'
|
||||
|
||||
リポジトリ管理者と Organization のオーナーは、ユーザおよび Team に {% data variables.product.prodname_secret_scanning %} アラートへのアクセスを許可できます。 詳細については、「[リポジトリのセキュリティと分析の設定を管理する](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-security-alerts)」を参照してください。
|
||||
|
||||
{% ifversion ghec or ghes or ghae > 3.4 %} セキュリティの概要を使用して、{% data variables.product.prodname_secret_scanning %} が有効になっているリポジトリと検出されたアラートの組織レベルのビューを表示できます。 詳細については、「[セキュリティの概要の表示](/code-security/security-overview/viewing-the-security-overview)」を参照してください。
|
||||
{% ifversion ghec or ghes or ghae > 3.4 %} セキュリティの概要を使用して、{% data variables.product.prodname_secret_scanning %} が有効になっているリポジトリと検出されたアラートの組織レベルのビューを表示できます。 詳細については、「[Viewing the security overview](/code-security/security-overview/viewing-the-security-overview)」(セキュリティの概要の表示) を参照してください。
|
||||
{% endif %}
|
||||
|
||||
{%- ifversion ghec or ghes or ghae %}また、REST API を使って、{% ifversion ghec %}プライベート {% endif %}リポジトリ{% ifversion ghes %}または Organization {% endif %}全体で{% data variables.product.prodname_secret_scanning %}からの結果を監視できます。 API エンドポイントの詳細については、「[{% data variables.product.prodname_secret_scanning_caps %}](/rest/reference/secret-scanning)」を参照してください。{% endif %}
|
||||
|
||||
@@ -17,26 +17,38 @@ topics:
|
||||
- Advanced Security
|
||||
- Repositories
|
||||
shortTitle: Configure secret scans
|
||||
ms.openlocfilehash: 00983398e326997b6472da319d342ab0758018d3
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 7739cca195f46043945f39f48aad8bf88aa97fed
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147062003'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192938'
|
||||
---
|
||||
{% data reusables.secret-scanning.beta %} {% data reusables.secret-scanning.enterprise-enable-secret-scanning %}
|
||||
|
||||
## {% data variables.product.prodname_secret_scanning_GHAS %}の有効化
|
||||
|
||||
{% data variables.product.prodname_secret_scanning_GHAS %}は、組織が所有する任意のリポジトリで有効化できます。 有効にすると、{% data reusables.secret-scanning.secret-scanning-process %}
|
||||
{% data variables.product.prodname_secret_scanning_GHAS %}は、組織が所有する任意のリポジトリで有効化できます。 有効にすると、{% data reusables.secret-scanning.secret-scanning-process %} {% ifversion secret-scanning-issue-body-comments %}{% data reusables.secret-scanning.scan-issue-description-and-comments %}
|
||||
|
||||
{% note %}
|
||||
|
||||
**注:** Issue の説明とコメントの {% data variables.product.prodname_secret_scanning_caps %} はパブリック ベータ版であり、変更される可能性があります。
|
||||
|
||||
{% endnote %} {% endif %}
|
||||
|
||||
{% ifversion secret-scanning-enterprise-level %} {% note %}
|
||||
|
||||
**注:** 組織がエンタープライズ アカウントの所有になっている場合、エンタープライズ所有者はエンタープライズ レベルで {% data variables.product.prodname_secret_scanning %} を有効にすることもできます。 詳しくは、「[Enterprise での {% data variables.product.prodname_GH_advanced_security %} 機能の管理](/admin/code-security/managing-github-advanced-security-for-your-enterprise/managing-github-advanced-security-features-for-your-enterprise)」を参照してください。
|
||||
|
||||
{% endnote %} {% endif %}
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.repositories.navigate-to-code-security-and-analysis %}
|
||||
4. {% data variables.product.prodname_advanced_security %} がまだリポジトリで有効化されていなければ、[{% data variables.product.prodname_GH_advanced_security %}] の右側で **[有効化]** をクリックしてください。
|
||||
1. {% data variables.product.prodname_advanced_security %} がまだリポジトリで有効化されていなければ、[{% data variables.product.prodname_GH_advanced_security %}] の右側で **[有効化]** をクリックしてください。
|
||||
{% ifversion fpt or ghec %} {% elsif ghes or ghae %}{% endif %}
|
||||
5. {% data variables.product.prodname_advanced_security %}の有効化の影響をレビューしてから、 **[このリポジトリで {% data variables.product.prodname_GH_advanced_security %} を有効化]** をクリックしてください。
|
||||
6. {% data variables.product.prodname_advanced_security %}を有効化すると、Organizationの設定によってはリポジトリで{% data variables.product.prodname_secret_scanning %}が自動的に有効化されることがあります。 "{% data variables.product.prodname_secret_scanning_caps %}" が **[有効]** ボタンと共に表示されている場合でも、 **[有効]** をクリックして{% data variables.product.prodname_secret_scanning %}を有効にする必要があります。 **[無効]** ボタンが表示された場合、{% data variables.product.prodname_secret_scanning %}は既に有効になっています。
|
||||
2. {% data variables.product.prodname_advanced_security %}の有効化の影響をレビューしてから、 **[このリポジトリで {% data variables.product.prodname_GH_advanced_security %} を有効化]** をクリックしてください。
|
||||
3. {% data variables.product.prodname_advanced_security %}を有効化すると、Organizationの設定によってはリポジトリで{% data variables.product.prodname_secret_scanning %}が自動的に有効化されることがあります。 "{% data variables.product.prodname_secret_scanning_caps %}" が **[有効]** ボタンと共に表示されている場合でも、 **[有効]** をクリックして{% data variables.product.prodname_secret_scanning %}を有効にする必要があります。 **[無効]** ボタンが表示された場合、{% data variables.product.prodname_secret_scanning %}は既に有効になっています。
|
||||
 {% ifversion secret-scanning-push-protection %}
|
||||
7. 必要に応じて、プッシュ保護を有効にする場合は、[プッシュ保護] の右側にある **[有効]** をクリックします。 {% data reusables.secret-scanning.push-protection-overview %} 詳細については、「[ {% data variables.product.prodname_secret_scanning %}を使用したプッシュの保護](/code-security/secret-scanning/protecting-pushes-with-secret-scanning)」を参照してください。
|
||||
1. 必要に応じて、プッシュ保護を有効にする場合は、[プッシュ保護] の右側にある **[有効]** をクリックします。 {% data reusables.secret-scanning.push-protection-overview %} 詳細については、「[ {% data variables.product.prodname_secret_scanning %}を使用したプッシュの保護](/code-security/secret-scanning/protecting-pushes-with-secret-scanning)」を参照してください。
|
||||
 {% endif %} {% ifversion ghae %}
|
||||
1. {% data variables.product.prodname_secret_scanning %} を有効化する前に、まず {% data variables.product.prodname_GH_advanced_security %} を有効化する必要があります。 [{% data variables.product.prodname_GH_advanced_security %}] の右側にある **[有効]** をクリックします。
|
||||

|
||||
|
||||
@@ -0,0 +1,129 @@
|
||||
---
|
||||
title: codespace がプライベート イメージ レジストリにアクセスできるようにする
|
||||
intro: '{% data variables.product.prodname_github_codespaces %} がプライベート レジストリ内のコンテナー イメージまたはその他のパッケージにアクセスできるようにすることができます。'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Codespaces
|
||||
redirect_from:
|
||||
- /codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry
|
||||
shortTitle: Access a private registry
|
||||
ms.openlocfilehash: 2957fe914e620b63a7ba0e2c38b6a949bd632fd6
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193636'
|
||||
---
|
||||
## プライベート レジストリと {% data variables.product.prodname_github_codespaces %} について
|
||||
|
||||
レジストリは、コンテナー イメージまたはその他のパッケージを格納、管理、フェッチするためのセキュリティで保護された領域です。 レジストリには次のような多くの例があります。
|
||||
- {% data variables.product.company_short %} の {% data variables.product.prodname_container_registry %}、Azure Container Registry、コンテナー イメージ用の DockerHub
|
||||
- Node.js パッケージの {% data variables.product.prodname_npm_registry %}。
|
||||
|
||||
{% data variables.product.prodname_container_registry %} を含む特定の {% data variables.product.prodname_registry %} は、認証資格情報を指定する必要なく、codespace の作成時にパッケージを {% data variables.product.prodname_github_codespaces %} にシームレスにプルできるように構成できます。
|
||||
|
||||
その他のコンテナー イメージ レジストリにアクセスする場合は、アクセスの詳細を格納するために、{% data variables.product.prodname_dotcom %} にシークレットを作成することができます。これにより、{% data variables.product.prodname_github_codespaces %} はそのレジストリに格納されているイメージにアクセスできるようになります。
|
||||
|
||||
## 詳細なアクセス許可を持つレジストリに格納されているパッケージへのアクセス
|
||||
|
||||
{% data variables.product.prodname_container_registry %} を含む詳細なアクセス許可をサポートする {% data variables.product.prodname_registry %} レジストリでは、{% data variables.product.prodname_github_codespaces %} がパッケージを使用するための最も簡単な方法が提供されます。 詳細なアクセス許可とシームレスな {% data variables.product.prodname_github_codespaces %} のアクセスをサポートする {% data variables.product.prodname_registry %} レジストリのリストについては、「[{% data variables.product.prodname_registry %} のアクセス許可について](/packages/learn-github-packages/about-permissions-for-github-packages#granular-permissions-for-userorganization-scoped-packages)」をご覧ください。
|
||||
|
||||
### codespace と同じリポジトリに公開されたパッケージへのアクセス
|
||||
|
||||
codespace が起動されたのと同じリポジトリ内のパッケージを公開すると、codespace の作成時にそのパッケージを自動的にフェッチできるようになります。 パッケージの公開時に **[リポジトリからアクセス権を継承する]** オプションの選択を解除していない限り、追加の資格情報を指定する必要はありません。
|
||||
|
||||
#### パッケージ公開元リポジトリからのアクセス権の継承
|
||||
|
||||
既定では、パッケージにより公開元のリポジトリのアクセス設定が継承されます。 たとえば、リポジトリがパブリックの場合、パッケージもパブリックになります。 リポジトリがプライベートの場合、パッケージもプライベートですが、リポジトリからアクセスできます。
|
||||
|
||||
この動作は、 **[リポジトリからアクセス権を継承する]** オプションによって制御されます。 **[リポジトリからアクセス権を継承する]** は、{% data variables.product.prodname_actions %} を介して公開する場合は既定で選択されますが、{% data variables.product.pat_generic %} を使用してレジストリに直接公開する場合は選択されません。
|
||||
|
||||
パッケージの公開時に **[リポジトリからアクセス権を継承する]** オプションを選択しなかった場合は、公開されたパッケージのアクセス制御にリポジトリを手動で追加できます。 詳細については、「[パッケージのアクセス制御と可視性の設定](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#inheriting-access-for-a-container-image-from-a-repository)」を参照してください。
|
||||
|
||||
### codespace が起動される Organization に公開されたパッケージへのアクセス
|
||||
|
||||
Organization 内のすべての codespace からパッケージにアクセスできるようにする場合は、内部可視性を設定したパッケージを公開することをお勧めします。 これにより、codespace を起動するリポジトリがパブリックである場合以外は、Organization 内のすべての codespace にパッケージが自動的に表示されます。
|
||||
|
||||
内部またはプライベートのパッケージを参照するパブリック リポジトリから codespace を起動する場合は、パブリック リポジトリに内部パッケージへのアクセスを手動で許可する必要があります。 これにより、内部パッケージが誤って公開されるのを防ぐことができます。 詳細については、「[パッケージへの Codespaces アクセスの確保](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-codespaces-access-to-your-package)」を参照してください。
|
||||
|
||||
### Organization 内のリポジトリのサブセットからプライベート パッケージへのアクセス
|
||||
|
||||
Organization のリポジトリのサブセットがパッケージにアクセスできるようにする場合、またはパブリック リポジトリで起動された codespace から内部またはプライベートのパッケージへのアクセスを許可する場合は、パッケージのアクセス設定にリポジトリを手動で追加できます。 詳細については、「[パッケージへの Codespaces アクセスの確保](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-codespaces-access-to-your-package)」を参照してください。
|
||||
|
||||
### codespace からのパッケージの公開
|
||||
|
||||
codespace からレジストリへのシームレスなアクセスは、パッケージのプルに限定されます。 codespace 内からパッケージを公開する場合は、`write:packages` スコープの {% data variables.product.pat_v1 %} を使用する必要があります。
|
||||
|
||||
{% data variables.product.prodname_actions %} を使用してパッケージを公開することをお勧めします。 詳しくは、「[Docker イメージの発行](/actions/publishing-packages/publishing-docker-images)」と「[Node.js パッケージの発行](/actions/publishing-packages/publishing-nodejs-packages)」をご覧ください。
|
||||
|
||||
## 他のレジストリに格納されているイメージへのアクセス
|
||||
|
||||
シークレットを定義して、{% data variables.product.prodname_github_codespaces %} が {% data variables.product.company_short %} の {% data variables.product.prodname_container_registry %} 以外のコンテナー イメージ レジストリにアクセスできるようにすることができます。 シームレスなアクセスがサポートされていないレジストリからコンテナー イメージにアクセスする場合、{% data variables.product.prodname_github_codespaces %} で、レジストリのサーバー名、ユーザー名、{% data variables.product.pat_generic %} を定義する 3 つのシークレットが存在するかどうかが確認されます。 これらのシークレットが見つかった場合、{% data variables.product.prodname_github_codespaces %} はレジストリを codespace 内で使用できるようにします。
|
||||
|
||||
- `<*>_CONTAINER_REGISTRY_SERVER`
|
||||
- `<*>_CONTAINER_REGISTRY_USER`
|
||||
- `<*>_CONTAINER_REGISTRY_PASSWORD`
|
||||
|
||||
シークレットは、ユーザ、リポジトリ、または Organization レベルで保存できるため、異なる Codespaces 間で安全に共有できます。 プライベート イメージ レジストリのシークレットのセットを作成するときは、名前の "<*>" を一貫した識別子に置き換える必要があります。 詳しくは、「[codespaces の暗号化されたシークレットを管理する](/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces)」および「[リポジトリの暗号化されたシークレットと {% data variables.product.prodname_github_codespaces %} の Organization を管理する](/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces)」をご覧ください。
|
||||
|
||||
ユーザーまたは Organization のレベルでシークレットを設定する場合は、ドロップダウン リストからアクセス ポリシーを選択して、codespace を作成するリポジトリにシークレットを割り当てるようにしてください。
|
||||
|
||||

|
||||
|
||||
### シークレットの例
|
||||
|
||||
Azure のプライベート イメージ レジストリの場合は、次のシークレットを作成できます。
|
||||
|
||||
```
|
||||
ACR_CONTAINER_REGISTRY_SERVER = mycompany.azurecr.io
|
||||
ACR_CONTAINER_REGISTRY_USER = acr-user-here
|
||||
ACR_CONTAINER_REGISTRY_PASSWORD = <PERSONAL_ACCESS_TOKEN>
|
||||
```
|
||||
|
||||
一般的なイメージ レジストリの詳細については、「[一般的なイメージ レジストリ サーバー](#common-image-registry-servers)」を参照してください。 AWS Elastic Container Registry (ECR) へのアクセスは異なることに注意してください。
|
||||
|
||||

|
||||
|
||||
シークレットを追加したら、新しい環境変数をコンテナーに渡すために、現在の codespace を停止してから開始することが必要になる場合があります。 詳細については、「[codespace の一時停止または停止](/codespaces/codespaces-reference/using-the-command-palette-in-codespaces#suspending-or-stopping-a-codespace)」を参照してください。
|
||||
|
||||
#### AWS Elastic Container Registry へのアクセス
|
||||
|
||||
AWS Elastic Container Registry (ECR) にアクセスするには、AWS アクセス キー ID と秘密鍵を指定することで、{% data variables.product.prodname_dotcom %} がユーザーに代わってアクセス トークンを取得してログインできるようになります。
|
||||
|
||||
```
|
||||
*_CONTAINER_REGISTRY_SERVER = <ECR_URL>
|
||||
*_CONTAINER_REGISTRY_USER = <AWS_ACCESS_KEY_ID>
|
||||
*_CONTAINER_REGISTRY_PASSWORD = <AWS_SECRET_KEY>
|
||||
```
|
||||
|
||||
また、資格情報のスワップ (例: `sts:GetServiceBearerToken`) と ECR 読み取り操作 (`AmazonEC2ContainerRegistryFullAccess` または `ReadOnlyAccess`) を実行するための適切な AWS IAM アクセス許可があることを確認する必要があります。
|
||||
|
||||
または、GitHub でユーザーに代わって資格情報のスワップが実行されないようにする場合は、AWS の API または CLI を使用してフェッチされた承認トークンを指定できます。
|
||||
|
||||
```
|
||||
*_CONTAINER_REGISTRY_SERVER = <ECR_URL>
|
||||
*_CONTAINER_REGISTRY_USER = AWS
|
||||
*_CONTAINER_REGISTRY_PASSWORD = <TOKEN>
|
||||
```
|
||||
|
||||
これらのトークンは有効期間が短く、定期的に更新する必要があるため、アクセス キー ID とシークレットを指定することをお勧めします。
|
||||
|
||||
`*_CONTAINER_REGISTRY_SERVER` が ECR URL である限り、これらのシークレットには任意の名前を付けることができますが、複数の ECR レジストリを扱う場合を除き、`ECR_CONTAINER_REGISTRY_*` を使用することをお勧めします。
|
||||
|
||||
詳細については、AWS ECR の[プライベート レジストリの認証に関するドキュメント](https://docs.aws.amazon.com/AmazonECR/latest/userguide/registry_auth.html)を参照してください。
|
||||
|
||||
### 一般的なイメージ レジストリ サーバー
|
||||
|
||||
一般的なイメージ レジストリ サーバーの一部を次に示します。
|
||||
|
||||
- [DockerHub](https://docs.docker.com/engine/reference/commandline/info/) - `https://index.docker.io/v1/`
|
||||
- [GitHub Container Registry](/packages/working-with-a-github-packages-registry/working-with-the-container-registry) - `ghcr.io`
|
||||
- [Azure Container Registry](https://docs.microsoft.com/azure/container-registry/) - `<registry name>.azurecr.io`
|
||||
- [AWS Elastic Container Registry](https://docs.aws.amazon.com/AmazonECR/latest/userguide/Registries.html) - `<aws_account_id>.dkr.ecr.<region>.amazonaws.com`
|
||||
- [Google Cloud Container Registry](https://cloud.google.com/container-registry/docs/overview#registries) - `gcr.io` (米国)、`eu.gcr.io` (ヨーロッパ)、`asia.gcr.io` (アジア)
|
||||
|
||||
## プライベート イメージ レジストリ アクセスのデバッグ
|
||||
|
||||
プライベート イメージ レジストリからイメージをプルするときに問題が発生した場合は、上記で定義したシークレットの値を使用して、`docker login -u <user> -p <password> <server>` を実行できることを確認してください。 ログインに失敗した場合は、ログイン資格情報が有効であること、およびコンテナー イメージをフェッチするためのサーバーに対する適切なアクセス許可があることを確かめます。 ログインに成功した場合は、ユーザー、リポジトリ、または組織のレベルで、これらの値が正しい {% data variables.product.prodname_github_codespaces %} シークレットに適切にコピーされていることを確認し、もう一度やり直してください。
|
||||
@@ -14,12 +14,12 @@ topics:
|
||||
- Security
|
||||
- Secret store
|
||||
shortTitle: Encrypted secrets
|
||||
ms.openlocfilehash: f2ef60c9311a81ea59ec4f71cb7c1a432102b063
|
||||
ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8
|
||||
ms.openlocfilehash: a1ea1c87581feccd737314db0d7bf237f983357a
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/09/2022
|
||||
ms.locfileid: '148160443'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192810'
|
||||
---
|
||||
## {% data variables.product.prodname_github_codespaces %} の暗号化されたシークレットについて
|
||||
|
||||
@@ -28,7 +28,7 @@ ms.locfileid: '148160443'
|
||||
- クラウド サービスへのアクセス トークン
|
||||
- サービス プリンシパル
|
||||
- プラン識別子
|
||||
- [プライベート イメージ レジストリの資格情報](/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry)
|
||||
- プライベート イメージ レジストリの資格情報 (詳しくは「[プライベート レジストリへのアクセスを codespace に許可する](/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-registry)」を参照してください)
|
||||
|
||||
各シークレットにアクセスできるリポジトリを選択できます。 そして、シークレットへのアクセス権があるリポジトリ用に作成した任意のコードスペースでそのシークレットを使用できます。 テンプレートから作成された codespace とシークレットを共有するには、{% data variables.product.prodname_dotcom %} 上のリポジトリに codespace を発行し、そのリポジトリにシークレットへのアクセス権を付与する必要があります。
|
||||
|
||||
|
||||
@@ -12,12 +12,12 @@ versions:
|
||||
topics:
|
||||
- Community
|
||||
shortTitle: Community health file
|
||||
ms.openlocfilehash: 762af2fcbbc16e0bfc671df2409fede9ea6e2c67
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 85a672d0cc0991a5325df8a107737da47c7b81d3
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '145117637'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193631'
|
||||
---
|
||||
## デフォルトのコミュニティ健全性ファイルについて
|
||||
|
||||
@@ -36,7 +36,7 @@ ms.locfileid: '145117637'
|
||||
|
||||
次のコミュニティ正常性ファイルの既定のものを、Organization {% ifversion fpt or ghes or ghec %} または個人アカウント {% endif %} に作成できます。
|
||||
|
||||
コミュニティ正常性ファイル | 説明 --- | ---{% 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/)」を参照してください。
|
||||
コミュニティ正常性ファイル | 説明 --- | ---{% 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 discussion-category-forms %} ディスカッション カテゴリ フォーム | ディスカッション カテゴリ フォームを使うと、コミュニティ メンバーがあなたのリポジトリを開くと使うことができるテンプレートをカスタマイズできます。 詳しくは、「[ディスカッション カテゴリ フォームの作成](/discussions/managing-discussions-for-your-community/creating-discussion-category-forms)」をご覧ください。{% endif %}{% 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/)」を参照してください。
|
||||
|
||||
デフォルトのライセンスファイルを作成することはできません。 ライセンスファイルは、プロジェクトのクローン時、パッケージ時、またはダウンロード時に含められるよう、個々のリポジトリに追加する必要があります。
|
||||
|
||||
|
||||
@@ -7,16 +7,18 @@ topics:
|
||||
versions:
|
||||
feature: copilot
|
||||
shortTitle: JetBrains
|
||||
ms.openlocfilehash: 845f9306f519391f165dd00d3eefebed67bd409a
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 9f0f35bf5aebbf1899bd3991b0bca9e62f1da6ed
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147080287'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193575'
|
||||
---
|
||||
## JetBrains IDE の {% data variables.product.prodname_copilot %} について
|
||||
|
||||
Jetbrains IDE を使う場合、{% data variables.product.prodname_copilot %} は、入力時にコードをオートコンプリートできます。 インストール後、{% data variables.product.prodname_copilot %} を有効または無効にしたり、IDE または {% data variables.product.prodname_dotcom_the_website %} で詳細設定を構成したりできます。
|
||||
Jetbrains IDE を使う場合、{% data variables.product.prodname_copilot %} は、入力時にコードをオートコンプリートできます。 インストール後、{% data variables.product.prodname_copilot %} を有効または無効にしたり、IDE または {% data variables.product.prodname_dotcom_the_website %} で詳細設定を構成したりできます。 この記事では、IntelliJ IDE で {% data variables.product.prodname_copilot %} を構成する方法について説明しますが、他の Jetbrains IDE のユーザー インターフェイスは異なる場合があります。
|
||||
|
||||
{% data reusables.copilot.dotcom-settings %}
|
||||
|
||||
## 前提条件
|
||||
|
||||
@@ -83,6 +85,21 @@ JetBrains IDE では、コードの入力候補の表示方法や、{% data vari
|
||||
1. 自分の好みに合わせて設定を編集します。
|
||||
- コード候補の動作と外観、および更新を自動的に確認するかどうかを調整するには、対応するチェックボックスを選択または選択解除してください。
|
||||
- 自動更新を受信するように選んだ場合、安定版の更新プログラム (ただし頻度は低い) か、または夜間版の更新プログラム (安定性が低い場合がある) を受け取るかを選択できます。 **[Update channel]\(更新プログラム チャネル\)** ドロップダウンをクリックして、安定版の更新を受け取る場合は **[Stable]\(安定版\)** を、夜間版の更新を受け取る場合は **[Nightly]\(夜間版\)** を選びます。
|
||||
- [Disabled languages]\(無効になっている言語\) にあるチェックボックスで、{% data variables.product.prodname_copilot %} を無効にする言語の選択と解除を行います。
|
||||
- [無効になっている言語] にあるチェックボックスで、{% data variables.product.prodname_copilot %} を無効にする言語をオンまたはオフにします。
|
||||
|
||||
## {% data variables.product.prodname_copilot %} のプロキシ設定を構成する
|
||||
|
||||
Jetbrains IDE で HTTP プロキシ サーバー経由で接続するように {% data variables.product.prodname_copilot %} を構成できます。 {% data variables.product.prodname_copilot %} では、基本認証の有無にかかわらず、基本的な HTTP プロキシ設定がサポートされています。
|
||||
|
||||
1. JetBrains IDE で、 **[File]\(ファイル\)** メニューをクリックし、 **[Settings]\(設定\)** をクリックします。
|
||||
1. **[外観と動作]** で、 **[システム設定]** をクリックし、 **[HTTP プロキシ]** をクリックします。
|
||||
1. **[手動プロキシ構成]** チェック ボックスをオンにし、 **[HTTP]** チェック ボックスをオンにします。
|
||||
1. [ホスト名] フィールドにプロキシ サーバーのホスト名を入力し、[ポート番号] フィールドにプロキシ サーバーのポート番号を入力します。
|
||||
|
||||

|
||||
|
||||
1. 必要に応じて、左側のサイドバーで **[ツール]** をクリックし、 **[サーバー証明書]** をクリックします。 次に、信頼されていない証明書を自動的に受け入れるかどうかに応じて、[信頼されていない証明書を自動的に受け入れる] チェック ボックスをオンまたはオフにします。
|
||||
|
||||

|
||||
|
||||
{% data reusables.copilot.dotcom-settings %}
|
||||
|
||||
@@ -7,12 +7,12 @@ versions:
|
||||
shortTitle: Visual Studio Code
|
||||
topics:
|
||||
- Copilot
|
||||
ms.openlocfilehash: 0c91f9c11f98669ba6bcbf84113a629ae6d53044
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: ab043d4eeca2003deaf77aa80be46fc79acf8649
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147080182'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193572'
|
||||
---
|
||||
## {% data variables.product.prodname_vscode %} の{% data variables.product.prodname_copilot %} について
|
||||
|
||||
@@ -88,17 +88,16 @@ ms.locfileid: '147080182'
|
||||
|
||||
{% data variables.product.prodname_vscode %} で {% data variables.product.prodname_copilot %} のインライン候補を有効にするか無効にするかを選択できます。
|
||||
|
||||
1. **[File]\(ファイル\)** メニューで **[Preferences]\(基本設定\)** に移動し、 **[Settings]\(設定\)** をクリックします。
|
||||

|
||||
1. [Settings]\(設定\) タブの左側のパネルで、 **[Extensions]\(拡張機能\)** をクリックし **[Copilot]** を選びます。
|
||||
1. [Inline Suggest:Enable]\(インライン候補:有効\) の下にあるチェックボックスをオンまたはオフにして、インライン候補の有効または無効を設定します。
|
||||
{% data reusables.copilot.vscode-settings %}
|
||||
1. [設定] タブの左側のパネルで、 **[拡張機能]** をクリックし **[{% data variables.product.prodname_copilot_short %}]** を選びます。
|
||||
1. [インライン候補:有効] の下にあるチェックボックスをオンまたはオフにして、インライン候補の有効または無効を設定します。
|
||||
|
||||
## 特定の言語に対する {% data variables.product.prodname_copilot %} の有効化または無効化
|
||||
|
||||
どの言語に対して {% data variables.product.prodname_copilot %} を有効にするか無効にするかを指定できます。
|
||||
|
||||
1. {% data variables.product.prodname_vscode %} から **[Extensions]\(拡張機能\)** タブをクリックし、 **[Copilot]** セクションに移動します。 詳細については、[インライン候補の有効化と無効化](#enabling-and-disabling-inline-suggestions)に関するページを参照してください。
|
||||
1. [指定した言語に対して Copilot を有効または無効にする] で、 **[settings.json で編集]** をクリックします。
|
||||
1. [指定した言語に対して {% data variables.product.prodname_copilot_short %} を有効または無効にする] で、 **[settings.json で編集]** をクリックします。
|
||||
1. _settings.json_ ファイルで、{% data variables.product.prodname_copilot %} を有効または無効にする言語を、追加または削除します。 たとえば、{% data variables.product.prodname_copilot %}で Python を有効にするには、リストに `"python": true` を追加し、最後以外のすべてのリスト項目の末尾にコンマがあることを確認します。
|
||||
|
||||
```json
|
||||
@@ -115,4 +114,22 @@ ms.locfileid: '147080182'
|
||||
}
|
||||
```
|
||||
|
||||
## {% data variables.product.prodname_copilot %} のプロキシ設定を構成する
|
||||
|
||||
{% data variables.product.prodname_vscode %} で HTTP プロキシ サーバー経由で接続するように {% data variables.product.prodname_copilot %} を構成できます。 {% data variables.product.prodname_copilot %} では、基本認証の有無にかかわらず、基本的な HTTP プロキシ設定がサポートされています。
|
||||
|
||||
{% data reusables.copilot.vscode-settings %}
|
||||
1. [設定] タブの左側のパネルで、 **[アプリケーション]** をクリックし **[プロキシ]** を選びます。
|
||||
1. [プロキシ] の下のテキスト ボックスに、プロキシ サーバーのアドレスを入力します (例: `http://localhost:3128`)。 または、{% data variables.product.prodname_copilot %} では、お使いの環境の `http_proxy` 変数と `https_proxy` 変数を使用します。
|
||||
|
||||

|
||||
|
||||
1. 必要に応じて、[Http: プロキシ承認] で **[settings.json で編集]** をクリックし、すべてのネットワーク要求の `Proxy-Authorization` ヘッダーとして送信する必須の値を追加します。
|
||||
|
||||

|
||||
|
||||
1. 必要に応じて、[Http: Proxy Strict SSL] の下で、チェック ボックスをオンまたはオフにして、厳密な SSL を有効または無効にします。
|
||||
|
||||

|
||||
|
||||
{% data reusables.copilot.dotcom-settings %}
|
||||
|
||||
@@ -7,12 +7,12 @@ versions:
|
||||
shortTitle: Visual Studio
|
||||
topics:
|
||||
- Copilot
|
||||
ms.openlocfilehash: cb24557b15eafd4a5be8ef1a991ae3c43f376c67
|
||||
ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794
|
||||
ms.openlocfilehash: 05ac86405caadf3085b15a2aed9b54acb84f91f1
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/09/2022
|
||||
ms.locfileid: '147786030'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193471'
|
||||
---
|
||||
## {% data variables.product.prodname_vs %} の {% data variables.product.prodname_copilot %} について
|
||||
|
||||
@@ -37,13 +37,20 @@ ms.locfileid: '147786030'
|
||||
{% data variables.product.prodname_copilot %} を使用するときに {% data variables.product.prodname_vs %} の既定のキーボード ショートカットを使用しない場合は、特定のコマンドごとに任意のキーボード ショートカットを使用してキーボード エディターでショートカットを再バインドできます。
|
||||
|
||||
1. {% data variables.product.prodname_vs %} ツール バーの **[ツール]** で、 **[オプション]** をクリックします。
|
||||
|
||||
![{% data variables.product.prodname_vs %} ツール バーの [オプション] オプションのスクリーンショット](/assets/images/help/copilot/vs-toolbar-options.png)
|
||||
|
||||
1. [オプション] ダイアログの **[環境]** で、 **[キーボード]** をクリックします。
|
||||
|
||||
![[オプション] ダイアログの [キーボード] オプションのスクリーンショット](/assets/images/help/copilot/vs-options-dialogue.png)
|
||||
|
||||
1. [以下の文字列を含むコマンドを表示] で、再バインドするコマンドを検索します。
|
||||
|
||||
![[以下の文字列を含むコマンドを表示] 検索バーのスクリーンショット](/assets/images/help/copilot/vs-show-commands-containing.png)
|
||||
|
||||
1. [ショートカット キー] で、コマンドに割り当てるショートカットを入力し、 **[割り当て]** をクリックします。
|
||||

|
||||
|
||||
```
|
||||
|
||||
{% data reusables.copilot.enabling-or-disabling-vs %}
|
||||
|
||||
|
||||
@@ -0,0 +1,143 @@
|
||||
---
|
||||
title: Organization での GitHub Copilot 設定の構成
|
||||
intro: 'Organization で {% data variables.product.prodname_copilot %} を構成し、個人とチームへのアクセスの許可と取り消しを行うことや、パブリック コードに一致する候補をブロックするかどうかを決定することができます。'
|
||||
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
|
||||
ms.openlocfilehash: 345d0a48aa3f48e453fd8455027f683ee78a7640
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193567'
|
||||
---
|
||||
## Organization での {% data variables.product.prodname_copilot %} 設定について
|
||||
|
||||
{% data reusables.copilot.about-copilot %}
|
||||
|
||||
Organization での {% data variables.product.prodname_copilot %} の使用を構成するには、Organization が {% data variables.product.prodname_ghe_cloud %} アカウントによって所有されている必要があり、最初にエンタープライズ管理者が Organization に対して {% data variables.product.prodname_copilot_business_short %} を有効にする必要があります。 そうすると、Organization 管理者が Organization 内のシート割り当てを管理できるようになります。
|
||||
|
||||
エンタープライズ レベルで構成されたポリシー設定に応じて、Organization 管理者は、パブリック コードに一致する {% data variables.product.prodname_copilot %} の提案を許可するかブロックするかを決定することもできます。 詳しくは、「[エンタープライズでの {% data variables.product.prodname_copilot %} のポリシーの適用](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise)」を参照してください。
|
||||
|
||||
## Organization での {% data variables.product.prodname_copilot %} へのアクセスの構成
|
||||
|
||||
{% data variables.product.prodname_ghe_cloud %} 管理者が Organization での {% data variables.product.prodname_copilot_business_short %} サブスクリプションを有効にすると、{% data variables.product.prodname_copilot %} シートを Organization 内の個人とチームに割り当てることができるようになります。
|
||||
|
||||
### Organization 内の現在および将来のユーザーすべてに対して {% data variables.product.prodname_copilot %} へのアクセスを有効にする
|
||||
|
||||
{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %}
|
||||
1. サイドバーの [コード、計画、自動化] セクションで、 **[{% octicon "copilot" aria-label="The copilot icon" %} {% data variables.product.prodname_copilot_short %}]** をクリックしてから、 **[アクセス]** をクリックします。
|
||||
1. [ユーザーのアクセス許可] で、Organization 内の現在および将来のユーザーすべてに対して {% data variables.product.prodname_copilot %} を有効にするには、 **[すべてのメンバーに許可する]** を選びます。
|
||||
|
||||

|
||||
|
||||
1. [シートの割り当ての確認] ダイアログで、Organization 内の現在および将来のユーザーすべてに対して {% data variables.product.prodname_copilot %} を有効にすることを確認するには、 **[確認]** をクリックします。
|
||||
|
||||

|
||||
|
||||
1. 変更を保存するには、 **[保存]** をクリックします。
|
||||
|
||||

|
||||
|
||||
### Organization 内の特定のユーザーに対して {% data variables.product.prodname_copilot %} へのアクセスを有効にする
|
||||
|
||||
{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %}
|
||||
1. サイドバーの [コード、計画、自動化] セクションで、 **[{% octicon "copilot" aria-label="The copilot icon" %} {% data variables.product.prodname_copilot_short %}]** をクリックしてから、 **[アクセス]** をクリックします。
|
||||
1. [ユーザーのアクセス許可] で、Organization 内の選択したチームまたはユーザーに対して {% data variables.product.prodname_copilot %} を有効にするには、 **[選択したチームとユーザー]** を選び、 **[保存]** をクリックします。
|
||||
|
||||

|
||||
|
||||
1. **[すべてのメンバーに許可する]** の設定でユーザーのアクセス許可を更新する場合は、[シート割り当ての確認] ダイアログで、アクセス権の割り当てを開始する方法を選びます。
|
||||
- すべてのメンバーの割り当てを解除してからアクセス権を持つユーザーを選ぶには、 **[最初から始める]** を選びます。
|
||||
- 現在アクセス権を持つすべてのメンバーをそのままにし、アクセス権を持たないメンバーを選ぶには、 **[すべてのユーザーを保持する]** を選びます。
|
||||
|
||||

|
||||
|
||||
1. **[最初から始める]** を選んだ場合は、 **[ユーザーの追加]** または **[チームの追加]** をクリックして、個々のユーザーまたはチーム全体を追加します。
|
||||
|
||||
![[ユーザーの追加] または [チームの追加] ボタンのスクリーンショット](/assets/images/help/copilot/add-people-add-teams.png)
|
||||
|
||||
1. **[ユーザーの追加]** を選んだ場合は、[ORGANIZATION の選択したメンバーに対して GitHub Copilot アクセスを有効にする] ダイアログで、個々のメンバーを検索するか、CSV ファイルをアップロードしてメンバーを一括で追加できます。
|
||||
|
||||

|
||||
|
||||
- メンバーを検索するには、検索バーにメンバーのユーザー名、フル ネーム、またはメール アドレスを入力します。
|
||||
- メンバーを一括で追加するには、 **[CSV のアップロード]** をクリックし、追加する各メンバーのコンマで区切ったユーザー名またはメール アドレスを含む CSV ファイルをアップロードします。
|
||||
|
||||
{% warning %}
|
||||
|
||||
**警告:** CSV ファイルをアップロードすると、{% data variables.product.prodname_copilot %} で {% data variables.product.prodname_dotcom_the_website %} 上のすべてのユーザーを対象に一致が検索されます。 CSV に Organization のメンバーではないユーザーが含まれている場合、 **[XX メンバーの追加]** をクリックすると、そのユーザーは Organization に参加するように招待されます。
|
||||
|
||||
{% endwarning %}
|
||||
|
||||
- CSV ファイルから生成されたユーザーのリストを確認します。 リストされたユーザーにアクセスを許可することを確認するには、 **[アクセス リストに XX メンバーを追加する]** をクリックします。または、リストを拒否するには、 **[キャンセル]** をクリックします。
|
||||
|
||||

|
||||
|
||||
1. **[チームの追加]** を選んだ場合は、[ORGANIZATION の選択したチームに対して GitHub Copilot アクセスを有効にする] ダイアログで、検索バーにチーム名を数文字入力し、追加するチームを選び、 **[上記のチームを選択する]** をクリックします。
|
||||
|
||||

|
||||
|
||||
1. **[すべてのユーザーを保持する]** を選んだ場合は、Organization のメンバーの完全なリストを確認し、{% data variables.product.prodname_copilot %} へのアクセス権を取り消す対象の個人を選びます。
|
||||
|
||||

|
||||
|
||||
1. **[選択した XX メンバー]** のドロップダウンをクリックし、 **[削除]** をクリックします。
|
||||
|
||||

|
||||
|
||||
### Organization 全体の {% data variables.product.prodname_copilot %} へのアクセスを無効にする
|
||||
|
||||
{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %}
|
||||
1. サイドバーの [コード、計画、自動化] セクションで、 **[{% octicon "copilot" aria-label="The copilot icon" %} {% data variables.product.prodname_copilot_short %}]** をクリックしてから、 **[アクセス]** をクリックします。
|
||||
1. [ユーザーのアクセス許可] で、Organization 内のすべてのユーザーに対して {% data variables.product.prodname_copilot %} を無効にするには、 **[無効]** を選びます。
|
||||
|
||||

|
||||
|
||||
1. 変更を保存するには、 **[保存]** をクリックします。
|
||||
|
||||

|
||||
|
||||
### Organization 内の特定のユーザーに対して {% data variables.product.prodname_copilot %} へのアクセスを無効にする
|
||||
|
||||
{% data variables.product.prodname_copilot %} シートを割り当てたユーザーを Organization から削除すると、自動的にシートの割り当てが解除されます。 または、メンバーシップを維持しながら、メンバーの {% data variables.product.prodname_copilot %} シートの割り当てを解除することもできます。 これらの変更は、次の課金サイクルの開始時から有効になります。
|
||||
|
||||
{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %}
|
||||
1. サイドバーの [コード、計画、自動化] セクションで、 **[{% octicon "copilot" aria-label="The copilot icon" %} {% data variables.product.prodname_copilot_short %}]** をクリックしてから、 **[アクセス]** をクリックします。
|
||||
1. [ユーザーのアクセス許可] で、 **[選択したチームとユーザー]** を選び、 **[保存]** をクリックします。
|
||||
|
||||

|
||||
|
||||
- [シートの割り当ての確認] ポップアップ ダイアログで、 **[すべてのユーザーを保持する]** を選びます。
|
||||
|
||||

|
||||
|
||||
1. [アクセスの管理] で、検索バーにメンバーのユーザー名、フル ネーム、またはメール アドレスを入力します。
|
||||
|
||||

|
||||
|
||||
1. {% data variables.product.prodname_copilot %} にアクセスできるユーザーのリストからメンバーを削除するには、 **[削除]** をクリックします。
|
||||
|
||||

|
||||
|
||||
## Organization での {% data variables.product.prodname_copilot %} の候補一致ポリシーの構成
|
||||
|
||||
{% data variables.product.prodname_copilot %} には、{% data variables.product.prodname_dotcom %} のパブリック コードと一致するコード候補を検出するフィルターが含まれています。 フィルターが有効になっていると、{% data variables.product.prodname_copilot %} によって、周囲の約 150 文字のコードに関するコード候補が、{% data variables.product.prodname_dotcom %} でのパブリック コードに対してチェックされます。 一致または近い一致がある場合、候補は表示されません。
|
||||
|
||||
候補の一致に関してエンタープライズ管理者によってエンタープライズ レベルで **[ポリシーなし (各 Organization が決定できるようにする)]** が選ばれている場合は、Organization に候補一致ポリシーを設定できます。 Organization のあるメンバーに、同じエンタープライズで候補一致ポリシーが異なる複数の Organization によってシートが割り当てられている場合は、最も制限の厳しいポリシーが {% data variables.product.prodname_copilot %} で使用されます。
|
||||
|
||||
|
||||
{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %}
|
||||
1. サイドバーの [コード、計画、自動化] セクションで、 **[{% octicon "copilot" aria-label="The copilot icon" %} {% data variables.product.prodname_copilot_short %}]** をクリックしてから、 **[アクセス]** をクリックします。
|
||||
1. [パブリック コードに一致する候補] ドロップダウンで **[許可]** または **[ブロック]** を選び、パブリック コードに一致する候補を許可またはブロックします。
|
||||
|
||||

|
||||
|
||||
## 参考資料
|
||||
|
||||
- 「[{% data variables.product.prodname_copilot_for_business %} プライバシーに関する声明](/free-pro-team@latest/site-policy/privacy-policies/github-copilot-for-business-privacy-statement)」
|
||||
@@ -7,12 +7,12 @@ versions:
|
||||
feature: copilot
|
||||
topics:
|
||||
- Copilot
|
||||
ms.openlocfilehash: ae879b5834007a34ab0e3a7a45dcae4c1e31bc4f
|
||||
ms.sourcegitcommit: 7fb7ec2e665856fc5f7cd209b53bd0fb1c9bbc67
|
||||
ms.openlocfilehash: f5b90fb18645b69f86e9e45e08ba47e534678ae4
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/29/2022
|
||||
ms.locfileid: '148185060'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192784'
|
||||
---
|
||||
{% data reusables.copilot.copilot-cta-button %}
|
||||
|
||||
@@ -24,6 +24,8 @@ JetBrains IDE を使用すると、{% data variables.product.prodname_copilot %}
|
||||
|
||||
## 前提条件
|
||||
|
||||
{% data reusables.copilot.subscription-prerequisite %}
|
||||
|
||||
{% data reusables.copilot.jetbrains-ides %}
|
||||
|
||||
## JetBrains IDE での {% data variables.product.prodname_copilot %} 拡張機能のインストール
|
||||
|
||||
@@ -7,12 +7,12 @@ versions:
|
||||
feature: copilot
|
||||
topics:
|
||||
- Copilot
|
||||
ms.openlocfilehash: 6296ff5b89e86b4b51cbb04bd9ac4ba91863a1ac
|
||||
ms.sourcegitcommit: 7fb7ec2e665856fc5f7cd209b53bd0fb1c9bbc67
|
||||
ms.openlocfilehash: 2eab3d278453ad283337d8e8dd6e66f7d39364e8
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/29/2022
|
||||
ms.locfileid: '148185068'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193034'
|
||||
---
|
||||
{% data reusables.copilot.copilot-cta-button %}
|
||||
|
||||
@@ -24,7 +24,7 @@ Neovim を使用すると、{% data variables.product.prodname_copilot %} から
|
||||
|
||||
## 前提条件
|
||||
|
||||
- {% data variables.product.prodname_copilot %} を使用するには、アクティブな {% data variables.product.prodname_copilot %} サブスクリプションが必要です。 詳しくは、「[{% data variables.product.prodname_copilot %} の課金について](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)」をご覧ください。
|
||||
{% data reusables.copilot.subscription-prerequisite %}
|
||||
|
||||
- Neovim で {% data variables.product.prodname_copilot %} を使うには、Neovim と Node.js バージョン 17 以降をインストールする必要があります。 詳細については、[Neovim のドキュメント](https://neovim.io/doc/)と [Node.js の Web サイト](https://nodejs.org/en/)を参照してください。
|
||||
|
||||
|
||||
@@ -7,12 +7,12 @@ versions:
|
||||
feature: copilot
|
||||
topics:
|
||||
- Copilot
|
||||
ms.openlocfilehash: 63c670a7cd5263057f79b7761a960854ecac2dd6
|
||||
ms.sourcegitcommit: 7fb7ec2e665856fc5f7cd209b53bd0fb1c9bbc67
|
||||
ms.openlocfilehash: ec117cce02fab8917aef958c69077c521d9c1974
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/29/2022
|
||||
ms.locfileid: '148185143'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192770'
|
||||
---
|
||||
{% data reusables.copilot.copilot-cta-button %}
|
||||
|
||||
@@ -24,7 +24,9 @@ ms.locfileid: '148185143'
|
||||
|
||||
## 前提条件
|
||||
|
||||
{% data variables.product.prodname_vscode %} で {% data variables.product.prodname_copilot %} を使うには、{% data variables.product.prodname_vscode %} がインストールされている必要があります。 詳細については、[{% data variables.product.prodname_vscode %} のダウンロード ページ](https://code.visualstudio.com/Download)を参照してください。
|
||||
{% data reusables.copilot.subscription-prerequisite %}
|
||||
|
||||
- {% data variables.product.prodname_vscode %} で {% data variables.product.prodname_copilot %} を使うには、{% data variables.product.prodname_vscode %} がインストールされている必要があります。 詳細については、[{% data variables.product.prodname_vscode %} のダウンロード ページ](https://code.visualstudio.com/Download)を参照してください。
|
||||
|
||||
## {% data variables.product.prodname_vscode %} 拡張機能をインストールする
|
||||
|
||||
|
||||
@@ -7,12 +7,12 @@ versions:
|
||||
feature: copilot
|
||||
topics:
|
||||
- Copilot
|
||||
ms.openlocfilehash: 353095b0b0490cd12da8d853754b524431605819
|
||||
ms.sourcegitcommit: 7fb7ec2e665856fc5f7cd209b53bd0fb1c9bbc67
|
||||
ms.openlocfilehash: 65384a5cafae1c739b52847d1a826c0138e91fd9
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/29/2022
|
||||
ms.locfileid: '148185129'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193018'
|
||||
---
|
||||
{% data reusables.copilot.copilot-cta-button %}
|
||||
|
||||
@@ -24,7 +24,9 @@ ms.locfileid: '148185129'
|
||||
|
||||
## 前提条件
|
||||
|
||||
{% data variables.product.prodname_vs %} で {% data variables.product.prodname_copilot %} を使うには、{% data variables.product.prodname_vs %} 2022 17.2 以降がインストールされている必要があります。 詳しい情報については、[Visual Studio IDE](https://visualstudio.microsoft.com/vs/) のドキュメントをご覧ください。
|
||||
{% data reusables.copilot.subscription-prerequisite %}
|
||||
|
||||
- {% data variables.product.prodname_vs %} で {% data variables.product.prodname_copilot %} を使うには、{% data variables.product.prodname_vs %} 2022 17.2 以降がインストールされている必要があります。 詳しい情報については、[Visual Studio IDE](https://visualstudio.microsoft.com/vs/) のドキュメントをご覧ください。
|
||||
|
||||
{% note %}
|
||||
|
||||
|
||||
@@ -1,17 +1,17 @@
|
||||
---
|
||||
title: GitHub Copilot について
|
||||
intro: '{% data variables.product.prodname_copilot %} はオートコンプリート スタイルの候補を提示することでコーディングを支援します。 {% data variables.product.prodname_copilot %} を使うための注意点や、{% data variables.product.prodname_copilot %} のしくみについて説明します。'
|
||||
intro: '{% data variables.product.prodname_copilot %} はオートコンプリート スタイルの候補を提示することでコーディングを支援します。 {% data variables.product.prodname_copilot %} のしくみと、{% data variables.product.prodname_copilot %} の使用時の考慮事項がわかります。'
|
||||
versions:
|
||||
feature: copilot
|
||||
topics:
|
||||
- Copilot
|
||||
shortTitle: About GitHub Copilot
|
||||
ms.openlocfilehash: dd4538cb4cf6fc9dd84bb3f0d05bf8a85559d5ec
|
||||
ms.sourcegitcommit: d82f268a6f0236d1f4d2bf3d049974ada0170402
|
||||
ms.openlocfilehash: 4ff4c73e61c10c2c3f75d9581bf426266122550b
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/10/2022
|
||||
ms.locfileid: '148160641'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192779'
|
||||
---
|
||||
## {% data variables.product.prodname_copilot %} について
|
||||
|
||||
@@ -25,17 +25,17 @@ ms.locfileid: '148160641'
|
||||
|
||||
{% data variables.product.prodname_copilot %} の動作する実際の例を確認することができます。 詳しくは、[{% data variables.product.prodname_copilot %}](https://copilot.github.com/) の Web サイトを参照してください。
|
||||
|
||||
GitHub Copilot は、OpenAI が何十億行ものオープンソース コードにより構築されたモデルから候補を提示します。 その結果、{% data variables.product.prodname_copilot %} のトレーニング セットには、安全でないコーディング パターン、バグ、または古い API やイディオムへの参照が含まれている可能性があります。 {% data variables.product.prodname_copilot %} がこのトレーニング データに基づいて候補を生成する場合、それらの候補にも望ましくないパターンが含まれる場合があります。
|
||||
{% data variables.product.prodname_copilot %} からは、無数のオープン ソース コード行から OpenAI によって構築されたモデルからの提案が提供されます。 その結果、{% data variables.product.prodname_copilot %} のトレーニング セットには、安全でないコーディング パターン、バグ、または古い API やイディオムへの参照が含まれている可能性があります。 {% data variables.product.prodname_copilot %} がこのトレーニング データに基づいて候補を生成する場合、それらの候補にも望ましくないパターンが含まれる場合があります。
|
||||
|
||||
コードのセキュリティと品質を確保するのは、ご自分の責任です。 {% data variables.product.prodname_copilot %} で生成されたコードを使うときは、自分自身で書いていないコードを使うときと同じ予防措置を講じることをお勧めします。 これらの予防措置には、厳密なテスト、IP スキャン、セキュリティの脆弱性の追跡などが含まれます。 {% data variables.product.company_short %} には、{% data variables.product.prodname_actions %}、{% data variables.product.prodname_dependabot %}、{% data variables.product.prodname_codeql %}、{% data variables.product.prodname_code_scanning %} など、コード品質を監視および改善できる多数の機能が用意されています。 これらの機能はすべて、パブリック リポジトリで自由に使用できます。 詳しくは、「[{% data variables.product.prodname_actions %} について](/actions/learn-github-actions/understanding-github-actions)」と「[{% data variables.product.company_short %} のセキュリティ機能](/code-security/getting-started/github-security-features)」を参照してください。
|
||||
|
||||
{% data variables.product.prodname_copilot %} では、プロンプト内の不快な単語をブロックし、機密性の高いコンテキストにある候補を生成しないようにフィルターを使っています。 私たちは、{% data variables.product.prodname_copilot %} によって生成された不快な候補 (偏った、差別的、または虐待的な出力など) をよりインテリジェントに検出して削除するため、フィルター システムを常に改善することに取り組んでいます。 {% data variables.product.prodname_copilot %} によって生成された不快な候補が表示される場合は、安全対策を改善できるように、その候補を copilot-safety@github.com に直接報告してください。
|
||||
|
||||
{% data reusables.copilot.emus-cannot-use-copilot %}
|
||||
|
||||
## {% data variables.product.prodname_copilot %} の課金について
|
||||
|
||||
{% data variables.product.prodname_copilot %} は有料機能であり、月単位または年単位のサブスクリプションが必要です。 確認が取れている学生、教師、および {% data variables.product.prodname_dotcom %} 上のオープン ソース プロジェクトのメンテナンス担当者は、{% data variables.product.prodname_copilot %} を無料で使うことができます。 無料の {% data variables.product.prodname_copilot %} サブスクリプションの条件を満たしている場合は、{% data variables.product.prodname_copilot %} サブスクリプション ページにアクセスしたときに、自動的に通知されます。 無料の {% data variables.product.prodname_copilot %} サブスクリプションの条件を満たしていない場合、60 日間の無料試用版が提供され、その後継続して使うには有料のサブスクリプションが必要になります。 詳細については、「[{% data variables.product.prodname_copilot %} の課金について](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)」を参照してください。
|
||||
{% data variables.product.prodname_copilot %} は有料機能であり、月単位または年単位のサブスクリプションが必要です。 {% data variables.product.prodname_copilot %} サブスクリプションの支払いと管理は、{% data variables.product.prodname_copilot_for_individuals %} の {% data variables.product.prodname_dotcom_the_website %} の個人アカウントから可能です。あるいは、{% data variables.product.prodname_copilot_for_business %} の {% data variables.product.prodname_ghe_cloud %} のエンタープライズ アカウントからまとめて支払い、管理できます。
|
||||
|
||||
確認が取れている学生、教師、および {% data variables.product.prodname_dotcom %} 上のオープン ソース プロジェクトのメンテナンス担当者は、{% data variables.product.prodname_copilot_individuals_short %} を無料で使うことができます。 無料の {% data variables.product.prodname_copilot_individuals_short %} サブスクリプションの条件を満たしている場合は、{% data variables.product.prodname_copilot %} サブスクリプション ページにアクセスしたときに、自動的に通知されます。 無料の {% data variables.product.prodname_copilot_individuals_short %} サブスクリプションの条件を満たしていない場合、60 日間の無料試用版が提供され、その後継続して使うには有料のサブスクリプションが必要になります。 {% data variables.product.prodname_copilot_for_business %} には無料試用版は含まれていません。 詳細については、「[{% data variables.product.prodname_copilot %} の課金について](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)」を参照してください。
|
||||
|
||||
## JetBrains IDE での {% data variables.product.prodname_copilot %} プラグインのライセンスについて
|
||||
|
||||
@@ -43,4 +43,5 @@ GitHub Copilot は、OpenAI が何十億行ものオープンソース コード
|
||||
|
||||
## 参考資料
|
||||
|
||||
- 「[{% data variables.product.company_short %} 追加製品および機能の利用規約](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot)」
|
||||
- "[{% data variables.product.company_short %} 追加製品および機能の利用規約](/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 %} プライバシーに関する声明](/free-pro-team@latest/site-policy/privacy-policies/github-copilot-for-business-privacy-statement)"{% endif %}
|
||||
|
||||
@@ -8,18 +8,18 @@ versions:
|
||||
shortTitle: Quickstart
|
||||
topics:
|
||||
- Copilot
|
||||
ms.openlocfilehash: 5aa3071cddc2bf83e7ee7082eabea00f79a66ea5
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: d2131a506990a959f803b13353b794a9dd347174
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147080245'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193476'
|
||||
---
|
||||
## はじめに
|
||||
|
||||
{% data variables.product.prodname_copilot %} は AI ペア プログラマーです。 {% data variables.product.prodname_copilot %} を使うと、エディター内で行全体または関数全体の候補を得ることができます。
|
||||
|
||||
このガイドでは、{% data variables.product.prodname_copilot %} にサインアップし、{% data variables.product.prodname_vscode %} に {% data variables.product.prodname_copilot %} 拡張機能をインストールして、最初の候補を得る方法について説明します。 {% data variables.product.prodname_copilot %} の詳しい情報については、「[{% data variables.product.prodname_copilot %}について](/copilot/overview-of-github-copilot/about-github-copilot)」をご覧ください。 さまざまな環境で {% data variables.product.prodname_copilot %} を使う方法の詳しい情報については、「[使用を開始する](/copilot/getting-started-with-github-copilot)」をご覧ください。
|
||||
このガイドでは、個人アカウントで {% data variables.product.prodname_copilot %} にサインアップし、{% data variables.product.prodname_vscode %} に {% data variables.product.prodname_copilot %} 拡張機能をインストールして、最初の候補を得る方法について説明します。 {% data variables.product.prodname_copilot %} の詳しい情報については、「[{% data variables.product.prodname_copilot %}について](/copilot/overview-of-github-copilot/about-github-copilot)」をご覧ください。 さまざまな環境で {% data variables.product.prodname_copilot %} を使う方法の詳しい情報については、「[使用を開始する](/copilot/getting-started-with-github-copilot)」をご覧ください。
|
||||
|
||||
## 前提条件
|
||||
|
||||
@@ -28,6 +28,14 @@ ms.locfileid: '147080245'
|
||||
|
||||
## {% data variables.product.prodname_copilot %} にサインアップする
|
||||
|
||||
{% data variables.product.prodname_copilot %} を使い始める前に、個人アカウント用の無料試用版またはサブスクリプションを設定する必要があります。
|
||||
|
||||
{% note %}
|
||||
|
||||
**注:** {% data variables.product.prodname_ghe_cloud %} アカウントが所有する Organization のメンバーで、{% data variables.product.prodname_copilot %} サブスクリプションを持っていて、Organization から {% data variables.product.prodname_copilot %} シートが割り当てられている場合、「[{% data variables.product.prodname_vscode %} 用の {% data variables.product.prodname_copilot %} の拡張機能をインストールする](/copilot/quickstart#installing-the-github-copilot-extension-for-visual-studio-code)」に進むことができます。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.copilot.signup-procedure %}
|
||||
|
||||
## {% data variables.product.prodname_vscode %} 用の {% data variables.product.prodname_copilot %} 拡張機能をインストールする
|
||||
@@ -47,6 +55,8 @@ ms.locfileid: '147080245'
|
||||
|
||||
## 最初の候補を得る
|
||||
|
||||
{% data reusables.copilot.code-examples-limitations %}
|
||||
|
||||
{% data reusables.copilot.supported-languages %} 次のサンプルは JavaScript で記述されていますが、他の言語も同様に動作します。
|
||||
|
||||
1. {% data variables.product.prodname_vscode %} を開きます。
|
||||
|
||||
@@ -0,0 +1,39 @@
|
||||
---
|
||||
title: ディスカッション カテゴリ フォームの作成
|
||||
shortTitle: Create discussion category forms
|
||||
intro: コミュニティのメンバーがリポジトリで新しいディスカッションを開くときに使えるテンプレートをカスタマイズできます。
|
||||
versions:
|
||||
feature: discussion-category-forms
|
||||
ms.openlocfilehash: f87bd6369bcb4f1b6e2e47fe11cd61626b1fbe7d
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193484'
|
||||
---
|
||||
{% data reusables.discussions.discussion-category-forms-beta %}
|
||||
|
||||
## ディスカッション カテゴリ フォームについて
|
||||
|
||||
リポジトリ内でディスカッション フォームを使って、コミュニティ メンバーがディスカッションに特定の構造化された情報を含めるよう促すことができます。 ディスカッション カテゴリ フォームを使うと、カスタマイズできる Web フォーム フィールドがあるディスカッション テンプレートを作成できます。 ディスカッション フォームは、{% data variables.product.prodname_dotcom %} フォーム スキーマを使って YAML で記述します。 詳細については、「[{% data variables.product.prodname_dotcom %} のフォーム スキーマの構文](/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema)」を参照してください。
|
||||
|
||||
{% data reusables.actions.learn-more-about-yaml %}
|
||||
|
||||
リポジトリでディスカッション カテゴリ フォームを使うには、新しいファイルを作成して、それをお使いのリポジトリの `/.github/DISCUSSION_TEMPLATE/` フォルダーに追加する必要があります。
|
||||
|
||||
Organization 用にディスカッション カテゴリ フォームを作成することもできます。 詳細については、「[既定のコミュニティ正常性ファイルの作成](/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file)」を参照してください。
|
||||
|
||||
ディスカッション カテゴリ フォームは、投票ではサポートされていません。 投票について詳しくは、「[投票について](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-polls)」をご覧ください。
|
||||
|
||||
Issueフォームのレンダリングバージョンは次のとおりです。
|
||||
|
||||

|
||||
|
||||
## ディスカッション カテゴリ フォームの作成
|
||||
|
||||
ディスカッション カテゴリ フォームは、リポジトリへの書き込みアクセス権を持つユーザーが作成できます。
|
||||
|
||||
1. ディスカッション カテゴリ フォームを作成するリポジトリに移動します。
|
||||
2. リポジトリで、`FORM-NAME` をディスカッション カテゴリ フォーム フォームの名前に置き換えて、`/.github/DISCUSSION_TEMPLATE/FORM-NAME.yml` という名前のファイルを作成します。 {% data reusables.discussions.discussion-category-forms-name %} GitHub で新しいファイルを作成する方法について詳しくは、「[新しいファイルの作成](/github/managing-files-in-a-repository/creating-new-files)」をご覧ください。
|
||||
3. 新しいファイルの本文に、ディスカッション カテゴリ フォームの内容を入力します。 詳しくは、[ディスカッション カテゴリ フォームの構文](/discussions/managing-discussions-for-your-community/syntax-for-discussion-category-forms)に関する説明をご覧ください。
|
||||
4. ファイルをリポジトリのデフォルトブランチにコミットします。 詳細については、「[新しいファイルの作成](/github/managing-files-in-a-repository/creating-new-files)」を参照してください。
|
||||
@@ -0,0 +1,54 @@
|
||||
---
|
||||
title: ディスカッション カテゴリ フォームの構文
|
||||
shortTitle: Syntax for discussion category forms
|
||||
intro: YAML 構文を使用すると、ディスカッション カテゴリ フォームのフィールドを定義できます。
|
||||
versions:
|
||||
feature: discussion-category-forms
|
||||
ms.openlocfilehash: 73bb77967d5a7db3452e067c35d567a8279a0cb2
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193564'
|
||||
---
|
||||
{% data reusables.discussions.discussion-category-forms-beta %}
|
||||
|
||||
## ディスカッション カテゴリ フォームの YAML 構文について
|
||||
|
||||
YAML フォーム定義ファイルをリポジトリの `/.github/DISCUSSION_TEMPLATE/` フォルダーに追加することで、カスタム ディスカッション カテゴリ フォームを作成できます。 {% data reusables.actions.learn-more-about-yaml %}
|
||||
|
||||
{% data reusables.discussions.discussion-category-forms-name %}
|
||||
|
||||
フィールドごとに、入力の種類、検証、および既定のラベルを定義できます。
|
||||
|
||||
コミュニティ メンバーがディスカッション フォームに入力すると、それぞれの入力に対する回答が Markdown に変換され、ディスカッションの本文に追加されます。 コミュニティ メンバーは、ディスカッション フォームで作成されたディスカッションを編集でき、他のユーザーは、他の方法で作成されたディスカッションのようにディスカッションとやり取りできます。
|
||||
|
||||
この YAML 構成ファイルの例では、一般的なディスカッション カテゴリ フォームを定義します。
|
||||
|
||||
{% data reusables.discussions.discussion-category-forms-sample %}
|
||||
|
||||
## 最上位の構文
|
||||
|
||||
ディスカッション カテゴリ フォームの構成ファイルには `body` キーが含まれている必要があり、`body` には少なくとも 1 つの Markdown 以外のフィールドが含まれている必要があります。
|
||||
|
||||
```YAML{:copy}
|
||||
body:
|
||||
- type: input
|
||||
id: suggestion
|
||||
attributes:
|
||||
label: Suggestion
|
||||
description: "How might we make this project better?"
|
||||
placeholder: "Adding a CODE_OF_CONDUCT.md file would be a great idea."
|
||||
validations:
|
||||
required: true
|
||||
```
|
||||
|
||||
各 Issue フォームに次の最上位のキーを設定できます。
|
||||
|
||||
| Key | 説明 | 必須 | 型 |
|
||||
| :-- | :-- | :-- | :-- | :-- |
|
||||
| `body` | ディスカッション フォームでの入力の種類の定義。 | 必須 | Array |
|
||||
| `labels` | このテンプレートで作成されたディスカッションに自動的に追加されるラベル。 | オプション | 配列またはコンマ区切りの文字列 |
|
||||
| `title` | ディスカッション送信フォームに事前に設定される既定のタイトル。 | オプション | String |
|
||||
|
||||
フォームにフィールドを追加するには、フォーム要素の配列を `body` キーに含めます。 使用可能な要素とその構文の一覧については、「[{% data variables.product.prodname_dotcom %} のフォーム スキーマの構文](/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema)」を参照してください。
|
||||
@@ -10,12 +10,12 @@ redirect_from:
|
||||
versions:
|
||||
fpt: '*'
|
||||
shortTitle: For students
|
||||
ms.openlocfilehash: 198f0354e63721a4763e8fa32f832a19b2dac9d9
|
||||
ms.sourcegitcommit: 3abdbdbb47a9319f20e11845e9c2d8a7fce63422
|
||||
ms.openlocfilehash: b5d1d75e8c93bc147bc5185106ecef8c00a67c05
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/15/2022
|
||||
ms.locfileid: '148165098'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193138'
|
||||
---
|
||||
学校のプロジェクトで{% data variables.product.prodname_dotcom %}を利用することは、他者とコラボレーションして実世界の体験を見てもらうためのポートフォリオを構築するための実際的な方法です。
|
||||
|
||||
@@ -40,7 +40,7 @@ Global Campus に申請する前に、ご自分の学習コミュニティが既
|
||||
- GitHub Community Exchange から学生が作成したリポジトリを見つける。 詳しくは、「[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 %} の学生は、次の {% data variables.product.prodname_dotcom %} 特典も受け取ります。
|
||||
- **{% data variables.product.prodname_copilot %}** : 検証済みの学生は、{% data variables.product.prodname_copilot %} の無料サブスクリプションを受け取ります。 アカウント設定で {% data variables.product.prodname_copilot %} サブスクリプション ページにアクセスすると、無料サブスクリプションに関して自動的に通知されます。 {% data variables.product.prodname_copilot %} のサブスクライブと使用について詳しくは、「[{% data variables.product.prodname_copilot %} サブスクリプションの管理](/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription#setting-up-a-trial-of-github-copilot)」と「[{% data variables.product.prodname_copilot %} について](/copilot/overview-of-github-copilot/about-github-copilot)」を参照してください。
|
||||
- **{% data variables.product.prodname_copilot %}** : 検証済みの学生は、{% data variables.product.prodname_copilot %} の無料サブスクリプションを受け取ります。 アカウント設定で {% data variables.product.prodname_copilot %} サブスクリプション ページにアクセスすると、無料サブスクリプションに関して自動的に通知されます。 {% data variables.product.prodname_copilot %} のサブスクライブと使用について詳しくは、「[{% data variables.product.prodname_copilot_for_individuals %} サブスクリプションの管理](/billing/managing-billing-for-github-copilot/managing-your-github-copilot-for-individuals-subscription#setting-up-a-trial-of-github-copilot)」と「[{% 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 %} {% data variables.product.prodname_github_codespaces %} の使用を始める方法について詳しくは、「[{% data variables.product.prodname_github_codespaces %} の概要](/codespaces/overview)」を参照してください。
|
||||
|
||||
{% note %}
|
||||
|
||||
@@ -10,12 +10,12 @@ redirect_from:
|
||||
versions:
|
||||
fpt: '*'
|
||||
shortTitle: For teachers
|
||||
ms.openlocfilehash: 2a93f87df67d1694bd93888d29a582afa9c749e4
|
||||
ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8
|
||||
ms.openlocfilehash: 3e7dea02ec468109fbfa865f2d84224f8381cc39
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/09/2022
|
||||
ms.locfileid: '148158966'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192802'
|
||||
---
|
||||
認定教育機関の学生または教職員は、{% data variables.product.prodname_education %} 特典とリソースが含まれている {% data variables.product.prodname_global_campus %} を申し込むことができます。 詳しくは、「[教師として {% data variables.product.prodname_global_campus %} に応募する](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/apply-to-github-global-campus-as-a-teacher)」を参照してください。
|
||||
|
||||
@@ -34,7 +34,7 @@ ms.locfileid: '148158966'
|
||||
- [Campus TV](https://www.twitch.tv/githubeducation) の最近のエピソードをもう一度観て、学生コミュニティで関心が持たれている事柄を常に把握しておく。 Campus TV は、{% data variables.product.prodname_dotcom %} と学生コミュニティのリーダーによって作成されます。ライブまたはオンデマンドでの視聴が可能です。
|
||||
- 学生の教育のための素材が入った {% data variables.product.prodname_dotcom %} のスワッグ バッグを要求する。
|
||||
|
||||
{% data variables.product.prodname_education %} に登録している認定講師には、{% data variables.product.prodname_copilot %} の無料サブスクリプションが用意されています。 アカウント設定で {% data variables.product.prodname_copilot %} サブスクリプション ページにアクセスすると、無料サブスクリプションに関して自動的に通知されます。 {% data variables.product.prodname_copilot %} のサブスクライブと使用について詳しくは、「[{% data variables.product.prodname_copilot %} サブスクリプションの管理](/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription#setting-up-a-trial-of-github-copilot)」と「[{% data variables.product.prodname_copilot %} について](/copilot/overview-of-github-copilot/about-github-copilot)」を参照してください。
|
||||
{% data variables.product.prodname_education %} に登録している認定講師には、{% data variables.product.prodname_copilot %} の無料サブスクリプションが用意されています。 アカウント設定で {% data variables.product.prodname_copilot %} サブスクリプション ページにアクセスすると、無料サブスクリプションに関して自動的に通知されます。 {% data variables.product.prodname_copilot %} のサブスクライブと使用について詳しくは、「[{% data variables.product.prodname_copilot_for_individuals %} サブスクリプションの管理](/billing/managing-billing-for-github-copilot/managing-your-github-copilot-for-individuals-subscription#setting-up-a-trial-of-github-copilot)」と「[{% data variables.product.prodname_copilot %} について](/copilot/overview-of-github-copilot/about-github-copilot)」を参照してください。
|
||||
|
||||
## 関連項目
|
||||
|
||||
|
||||
@@ -5,16 +5,16 @@ miniTocMaxHeadingLevel: 3
|
||||
versions:
|
||||
feature: projects-v2
|
||||
redirect_from:
|
||||
- /issues/trying-out-the-new-projects-experience/customizing-your-project-views
|
||||
- /issues/trying-out-the-new-projects-experience/customizing-your-project-views
|
||||
type: tutorial
|
||||
topics:
|
||||
- Projects
|
||||
- Projects
|
||||
ms.openlocfilehash: 0a7d1076fcf1a9d7f20b65a5e0a75b7d8029f834
|
||||
ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 10/25/2022
|
||||
ms.locfileid: '148106774'
|
||||
ms.locfileid: "148106774"
|
||||
---
|
||||
## プロジェクトレイアウトの変更
|
||||
|
||||
|
||||
@@ -8,7 +8,10 @@ topics:
|
||||
- Issues
|
||||
- Projects
|
||||
children:
|
||||
- /customizing-a-view
|
||||
- /changing-the-layout-of-a-view
|
||||
- /customizing-the-table-layout
|
||||
- /customizing-the-board-layout
|
||||
- /customizing-the-roadmap-layout
|
||||
- /filtering-projects
|
||||
- /managing-your-views
|
||||
allowTitleToDifferFromFilename: true
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Okta を使う SAML シングルサインオンおよび SCIM を設定する
|
||||
intro: 'Okta を使う Security Assertion Markup Language (SAML) シングル サインオン (SSO) およびクロスドメイン ID 管理システム (SCIM) を使用すると、{% data variables.product.product_location %} で Organization へのアクセスを自動的に管理することができます。'
|
||||
intro: 'Okta を使う Security Assertion Markup Language (SAML) シングル サインオン (SSO) およびクロスドメイン ID 管理システム (SCIM) を使用すると、{% data variables.location.product_location %} で Organization へのアクセスを自動的に管理することができます。'
|
||||
redirect_from:
|
||||
- /github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta
|
||||
permissions: Organization owners can configure SAML SSO and SCIM using Okta for an organization.
|
||||
@@ -10,35 +10,37 @@ topics:
|
||||
- Organizations
|
||||
- Teams
|
||||
shortTitle: Configure SAML & SCIM with Okta
|
||||
ms.openlocfilehash: 3b1083e0ec9d792de9e9c1e83cd5b000e8261905
|
||||
ms.sourcegitcommit: fb047f9450b41b24afc43d9512a5db2a2b750a2a
|
||||
ms.openlocfilehash: c1b6ab48122c97cb1f805399430cc181ed3f30d1
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/11/2022
|
||||
ms.locfileid: '147883280'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192738'
|
||||
---
|
||||
## Okta での SAML と SCIM について
|
||||
|
||||
{% data variables.product.product_location %}上のOrganizationやその他のWebアプリケーションへのアクセスは、SAML SSO及びSCIMをアイデンティティプロバイダ(IdP)であるOktaとともに使うようOrganizationを設定することで、1つの集中インターフェースから制御できます。
|
||||
{% data variables.location.product_location %} 上の Organization やその他の Web アプリケーションへのアクセスは、SAML SSO および SCIM をアイデンティティプロバイダ (IdP) である Okta とともに使用するよう Organization を設定することで、1 つの集中インターフェイスから制御できます。
|
||||
|
||||
{% data reusables.saml.ghec-only %}
|
||||
|
||||
SAML SSO は、リポジトリや Issue、Pull Requestといった Organization のリソースに対するアクセスを制御し、保護します。 SCIMは、Oktaで変更があった場合に{% data variables.product.product_location %}上のOrganizationへのメンバーアクセスを自動的に追加、管理、削除します。 詳しくは、「[SAML シングル サインオンを使うアイデンティティおよびアクセス管理について](/organizations/managing-saml-single-sign-on-for-your-organization/about-identity-and-access-management-with-saml-single-sign-on)」と「[Organization の SCIM について](/organizations/managing-saml-single-sign-on-for-your-organization/about-scim-for-organizations)」をご覧ください。
|
||||
SAML SSO は、リポジトリや Issue、Pull Requestといった Organization のリソースに対するアクセスを制御し、保護します。 SCIM は、Okta で変更があった場合に {% data variables.location.product_location %} 上の Organization へのメンバーアクセスを自動的に追加、管理、削除します。 詳しくは、「[SAML シングル サインオンを使うアイデンティティおよびアクセス管理について](/organizations/managing-saml-single-sign-on-for-your-organization/about-identity-and-access-management-with-saml-single-sign-on)」と「[Organization の SCIM について](/organizations/managing-saml-single-sign-on-for-your-organization/about-scim-for-organizations)」をご覧ください。
|
||||
|
||||
SCIM を有効にすると、Okta で {% data variables.product.prodname_ghe_cloud %} アプリケーションを割り当てる任意のユーザが次のプロビジョニング機能を使えるようになります。
|
||||
|
||||
| 機能 | 説明 |
|
||||
| --- | --- |
|
||||
| 新しいユーザのプッシュ | Oktaで新しいユーザを作成すると、そのユーザは{% data variables.product.product_location %}上のOrganizationに参加するためのメールを受け取ります。 |
|
||||
| ユーザ無効化のプッシュ | ユーザをOktaで無効化すると、Oktaはそのユーザを{% data variables.product.product_location %}のOrganizationから削除します。 |
|
||||
| プロフィール更新のプッシュ | Oktaでユーザのプロフィールを更新すると、Oktaは{% data variables.product.product_location %}のOrganizationのそのデータのメンバーシップメタデータを更新します。 |
|
||||
| ユーザの再アクティブ化 | Oktaでユーザを再有効化すると、Oktaは{% data variables.product.product_location %}のOrganizationに再参加するための招待メールを送信します。 |
|
||||
| 新しいユーザのプッシュ | Okta で新しいユーザーを作成すると、そのユーザーは {% data variables.location.product_location %} 上の Organization に参加するためのメールを受け取ります。 |
|
||||
| ユーザ無効化のプッシュ | ユーザーを Okta で無効化すると、Okta はそのユーザーを {% data variables.location.product_location %} の Organization から削除します。 |
|
||||
| プロフィール更新のプッシュ | Okta でユーザーのプロフィールを更新すると、Okta は {% data variables.location.product_location %} の Organization のそのデータのメンバーシップ メタデータを更新します。 |
|
||||
| ユーザの再アクティブ化 | Okta でユーザーを再有効化すると、Okta は {% data variables.location.product_location %} の Organization に再参加するための招待メールを送信します。 |
|
||||
|
||||
あるいは、EnterpriseでOktaを使うSAML SSOを設定することもできます。 Enterpriseアカウント用のSCIMは、Enterprise管理のユーザでのみ利用できます。 詳細については、「[Okta を使用した企業の SAML シングル サインオンの構成](/admin/identity-and-access-management/managing-iam-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise-using-okta)」および「[Okta でのエンタープライズ マネージド ユーザーの SCIM プロビジョニングの構成](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-scim-provisioning-for-enterprise-managed-users-with-okta)」を参照してください。
|
||||
|
||||
## Okta で {% data variables.product.prodname_ghe_cloud %} アプリケーションを追加する
|
||||
## Okta で SAML を構成する
|
||||
|
||||
{% data reusables.saml.okta-sign-on-tab %} {% data reusables.saml.okta-view-setup-instructions %}
|
||||
{% data reusables.saml.okta-ae-applications-menu %} {% data reusables.saml.okta-browse-app-catalog %} {% data reusables.saml.okta-add-ghec-org-integration %}
|
||||
1. フォームに入力します。{% data variables.product.prodname_dotcom %} の組織の名前と OAuth アプリ統合アプリケーションの一意の名前を入力してください。
|
||||
{% data reusables.saml.assign-yourself-to-okta %} {% data reusables.saml.okta-sign-on-tab %} {% data reusables.saml.okta-view-setup-instructions %}
|
||||
1. SAML 2.0 の設定方法に関するガイドから、サインオン URL、発行者 URL、公開の証明書を使用して、{% data variables.product.prodname_dotcom %} での SAML SSO を有効化してテストします。 詳細については、「[Organization 向けの SAML シングル サインオンを有効化してテストする](/organizations/managing-saml-single-sign-on-for-your-organization/enabling-and-testing-saml-single-sign-on-for-your-organization#enabling-and-testing-saml-single-sign-on-for-your-organization)」を参照してください。
|
||||
|
||||
## Okta で SCIM を使ってアクセスのプロビジョニングを設定する
|
||||
|
||||
@@ -8,36 +8,41 @@ versions:
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
shortTitle: About permissions
|
||||
ms.openlocfilehash: 1663fa3bfc8fd6149e43fd9cf09a8362739c7341
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 0159cee64d6faaeffe6257c9dc589f9fcda7a0ba
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147704940'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193082'
|
||||
---
|
||||
{% ifversion fpt or ghec %} パッケージの権限は、リポジトリ スコープかユーザー/組織スコープです。
|
||||
{% endif %}
|
||||
{% ifversion packages-registries-v2 %} パッケージに対する権限のスコープは、ユーザーまたは Organization に、あるいはリポジトリに設定できます。
|
||||
|
||||
## リポジトリスコープのパッケージの権限
|
||||
|
||||
リポジトリスコープのパッケージは、パッケージを所有するリポジトリの権限と可視性を継承します。 リポジトリをスコープとするパッケージは、リポジトリのメインページにアクセスし、ページ右にある **パッケージ** リンクをクリックすれば見つかります。 {% ifversion fpt or ghec %}詳細については、「[リポジトリのパッケージへの接続](/packages/learn-github-packages/connecting-a-repository-to-a-package)」を参照してください。{% endif %}
|
||||
|
||||
以下の {% data variables.product.prodname_registry %} レジストリでは、リポジトリ スコープのアクセス許可 **のみ** を使います。
|
||||
|
||||
{% ifversion not fpt or ghec %}- Docker レジストリ (`docker.pkg.github.com`){% endif %} {% ifversion packages-npm-v2 %}{% else %}- npm レジストリ{% endif %}
|
||||
- RubyGemsレジストリ
|
||||
- Apache Mavenレジストリ
|
||||
- NuGetレジストリ
|
||||
|
||||
{% ifversion packages-npm-v2 %}{% data variables.product.prodname_ghcr_and_npm_registry %}の場合、パッケージのスコープをユーザー、組織に設定、またはリポジトリにリンクすることを許可できます。{% endif %}
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
## ユーザ/Organizationスコープのパッケージの詳細な権限
|
||||
|
||||
詳細な権限を持つパッケージは、個人ユーザもしくはOrganizationアカウントをスコープとします。 パッケージのアクセス制御と可視性は、パッケージに接続された(あるいはリンクされた)リポジトリは別個に変更できます。
|
||||
|
||||
現在のところ、{% data variables.product.prodname_ghcr_and_npm_registry %}でコンテナ イメージ パッケージに関する細かいアクセス許可を提供しています。
|
||||
次の {% data variables.product.prodname_registry %} レジストリでは、細かな権限がサポートされています。
|
||||
|
||||
- {% data variables.product.prodname_container_registry %} {% ifversion packages-npm-v2 %}- npm レジストリ{% endif %} {% ifversion packages-nuget-v2 %}- NuGet レジストリ{% endif %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
## {% ifversion packages-registries-v2 %}リポジトリスコープの{% endif %}パッケージに対する権限
|
||||
|
||||
{% ifversion packages-registries-v2 %}リポジトリスコープの{% endif %}パッケージでは、そのパッケージを所有するリポジトリの権限と可視性を継承します。 リポジトリをスコープとするパッケージは、リポジトリのメインページにアクセスし、ページ右にある **パッケージ** リンクをクリックすれば見つかります。 {% ifversion fpt or ghec %}詳細については、「[リポジトリのパッケージへの接続](/packages/learn-github-packages/connecting-a-repository-to-a-package)」を参照してください。{% endif %}
|
||||
|
||||
{% ifversion packages-registries-v2 %} 次の {% data variables.product.prodname_registry %} レジストリでは、リポジトリ スコープの権限 **のみ** がサポートされています。
|
||||
|
||||
{% ifversion not fpt or ghec %}- Docker レジストリ (`docker.pkg.github.com`){% endif %} {% ifversion packages-npm-v2 %}{% else %}- npm レジストリ{% endif %}
|
||||
- RubyGemsレジストリ
|
||||
- Apache Mavenレジストリ
|
||||
- Gradle レジストリ {% ifversion packages-nuget-v2 %}{% else %}- NuGet レジストリ{% endif %}
|
||||
|
||||
{% ifversion ghes %}{% data variables.product.prodname_container_registry %}{% else %}他のレジストリ{% endif %}の場合、パッケージのスコープをユーザーまたは Organization に限定することも、パッケージをリポジトリにリンクさせることも選べます。 {% ifversion docker-ghcr-enterprise-migration %}{% data variables.product.prodname_container_registry %} への移行については、「[Docker レジストリからの {% data variables.product.prodname_container_registry %} への移行](/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry)」をご覧ください。{% endif %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion packages-registries-v2 %}
|
||||
## コンテナイメージの可視性とアクセス権限
|
||||
|
||||
{% data reusables.package_registry.visibility-and-access-permissions %}
|
||||
@@ -48,11 +53,13 @@ ms.locfileid: '147704940'
|
||||
|
||||
## パッケージの管理
|
||||
|
||||
パッケージ レジストリでホストされているパッケージを使用もしくは管理するためには、適切なスコープを持つトークンを使わなければならず、個人用アカウントが適切な権限を持っていなければなりません。
|
||||
{% data reusables.package_registry.packages-classic-pat-only %}
|
||||
|
||||
次に例を示します。
|
||||
- リポジトリからパッケージをダウンロードしてインストールするには、トークンに `read:packages` スコープが設定されていなければならず、ユーザー アカウントには読み取り権限が設定されていなければなりません。
|
||||
- {% ifversion fpt or ghes or ghec %}{% data variables.product.product_name %} 上のパッケージを削除するには、ご利用のトークンに少なくとも `delete:packages` および `read:packages` スコープが設定されている必要があります。 リポジトリをスコープとするパッケージには、`repo` スコープも必要です。 詳細については、「[パッケージを削除および復元する](/packages/learn-github-packages/deleting-and-restoring-a-package)」を参照してください。{% elsif ghae %}{% data variables.product.product_name %} で指定したバージョンのパッケージを削除するには、ご利用のトークンに `delete:packages` および `repo` スコープが設定されている必要があります。 詳細については、「[パッケージを削除および復元する](/packages/learn-github-packages/deleting-and-restoring-a-package)」を参照してください。{% endif %}
|
||||
パッケージ レジストリでホストされているパッケージを使用もしくは管理するためには、適切なスコープを持つ{% data variables.product.pat_v1 %}を使わなければならず、個人用アカウントが適切な権限を持っていなければなりません。
|
||||
|
||||
たとえば、次のように入力します。
|
||||
- リポジトリからパッケージをダウンロードしてインストールするには、{% data variables.product.pat_v1 %}に `read:packages` スコープが設定されていなければならず、ユーザー アカウントには読み取り権限が設定されていなければなりません。
|
||||
- {% ifversion fpt or ghes or ghec %}{% data variables.product.product_name %} 上のパッケージを削除するには、ご利用の{% data variables.product.pat_v1 %}に少なくとも `delete:packages` および `read:packages` スコープが設定されている必要があります。 リポジトリをスコープとするパッケージには、`repo` スコープも必要です。 詳しくは、「[パッケージを削除および復元する](/packages/learn-github-packages/deleting-and-restoring-a-package)」を参照してください。{% elsif ghae %}{% data variables.product.product_name %} で指定したバージョンのパッケージを削除するには、ご利用の{% data variables.product.pat_v1 %}に `delete:packages` および `repo` スコープが設定されている必要があります。 詳細については、「[パッケージを削除および復元する](/packages/learn-github-packages/deleting-and-restoring-a-package)」を参照してください。{% endif %}
|
||||
|
||||
| Scope | 説明 | 必要な権限 |
|
||||
| --- | --- | --- |
|
||||
@@ -61,12 +68,12 @@ ms.locfileid: '147704940'
|
||||
| `delete:packages` | {% ifversion fpt or ghes or ghec %} {% data variables.product.prodname_registry %}からのパッケージの削除{% elsif ghae %}{% data variables.product.prodname_registry %}からの指定したバージョンのパッケージの削除{% endif %} | admin |
|
||||
| `repo` | パッケージをアップロードおよび削除する (`write:packages` または `delete:packages` と一緒に) | 書き込みもしくは読み取り |
|
||||
|
||||
{% data variables.product.prodname_actions %} ワークフローを作成する際には、`GITHUB_TOKEN` を使って {% data variables.product.prodname_registry %} にパッケージを公開してインストールでき、個人用アクセス トークンを保存して管理する必要はありません。
|
||||
{% data variables.product.prodname_actions %} ワークフローを作成する際には、`GITHUB_TOKEN` を使って {% data variables.product.prodname_registry %} にパッケージを公開してインストールでき、{% data variables.product.pat_generic %}を保存して管理する必要はありません。
|
||||
|
||||
詳細については、以下を参照してください: {% ifversion fpt or ghec %}
|
||||
- "[パッケージのアクセス制御と可視性の設定](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)"{% endif %}
|
||||
- "[{% data variables.product.prodname_actions %} を使用したパッケージの発行とインストール](/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions)"
|
||||
- 「[個人用アクセス トークンを作成する](/github/authenticating-to-github/creating-a-personal-access-token/)」
|
||||
- [{% data variables.product.pat_generic %}の作成](/github/authenticating-to-github/creating-a-personal-access-token/)
|
||||
- "[利用できるスコープ](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)"
|
||||
|
||||
## {% data variables.product.prodname_actions %}ワークフローでのパッケージへのアクセスのメンテナンス
|
||||
@@ -78,7 +85,7 @@ ms.locfileid: '147704940'
|
||||
### アクセス トークン
|
||||
|
||||
- ワークフロー リポジトリに関連付けられているパッケージを発行するには、`GITHUB_TOKEN` を使用します。
|
||||
- `GITHUB_TOKEN`がアクセスできない他のプライベート リポジトリに関連するパッケージをインストールするには、個人用アクセス トークンを使用してください。
|
||||
- `GITHUB_TOKEN`がアクセスできない他のプライベート リポジトリに関連するパッケージをインストールするには、{% data variables.product.pat_v1 %}を使用してください
|
||||
|
||||
{% data variables.product.prodname_actions %} ワークフローで使用される `GITHUB_TOKEN` の詳細については、「[ワークフローで認証する](/actions/reference/authentication-in-a-workflow#using-the-github_token-in-a-workflow)」を参照してください。
|
||||
|
||||
|
||||
@@ -10,25 +10,29 @@ versions:
|
||||
ghec: '*'
|
||||
ghes: '*'
|
||||
shortTitle: Access control & visibility
|
||||
ms.openlocfilehash: 0988c332a341d379e21e540b74f7ee4dd5a26749
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 8ef541f45fd6568db7c8510bc860d81d504494c5
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147704916'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193058'
|
||||
---
|
||||
{% data reusables.package_registry.container-registry-ghes-beta %}
|
||||
{% data reusables.package_registry.container-registry-ghes-beta %}{% ifversion packages-registries-v2 %}
|
||||
|
||||
詳細な権限を持つパッケージは、個人ユーザもしくはOrganizationアカウントをスコープとします。 パッケージのアクセス制御と可視性は、パッケージに接続された(あるいはリンクされた)リポジトリは別個に変更できます。
|
||||
|
||||
現在は、{% data variables.product.prodname_ghcr_and_npm_registry %}でのみ細かいアクセス許可を使うことができます。 細かいアクセス許可は、RubyGems レジストリなどの、他のパッケージ レジストリではサポートされていません。{% ifversion docker-ghcr-enterprise-migration %} {% data variables.product.prodname_container_registry %}への移行について詳しくは、「[Docker レジストリからの {% data variables.product.prodname_container_registry %}への移行](/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry)」をご覧ください。{% endif %}
|
||||
一部のレジストリは、リポジトリがスコープ指定されたアクセス許可のみをサポートします。 そのようなレジストリの一覧については、「[{% data variables.product.prodname_registry %} のアクセス許可について](/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages)」をご覧ください。
|
||||
|
||||
リポジトリをスコープとするパッケージのアクセス許可、PAT のパッケージ関連のスコープ、アクション ワークフローのアクセス許可の管理の詳細については、「[GitHub パッケージのアクセス許可について](/packages/learn-github-packages/about-permissions-for-github-packages)」を参照してください。
|
||||
{% else %}パッケージは、パッケージを所有するリポジトリのアクセス許可と可視性を継承します。{% endif %}パッケージのアクセス許可、PAT のパッケージ関連のスコープ、またはアクション ワークフローのアクセス許可の管理について詳しくは、「[GitHub Packages のアクセス許可について](/packages/learn-github-packages/about-permissions-for-github-packages)」をご覧ください。
|
||||
|
||||
{% ifversion packages-registries-v2 %}
|
||||
|
||||
## コンテナイメージの可視性とアクセス権限
|
||||
|
||||
{% data reusables.package_registry.visibility-and-access-permissions %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
## 個人アカウントにコンテナイメージへのアクセス権限を設定する
|
||||
|
||||
個人アカウントが所有するコンテナー イメージに対する管理者権限がある場合には、他のユーザーに読み取り、書き込み、管理者ロールを割り当てることができます。 これらのアクセス許可ロールの詳細については、「[コンテナー イメージの可視性とアクセス許可](#visibility-and-access-permissions-for-container-images)」を参照してください。
|
||||
@@ -106,9 +110,9 @@ Organization が所有するコンテナイメージに対する管理者権限
|
||||
コンテナー イメージへのアクセスをさらにカスタマイズするには、「[組織のコンテナー イメージへのアクセス権を設定する](#configuring-access-to-container-images-for-an-organization)」を参照してください。
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
## パッケージへの{% data variables.product.prodname_codespaces %}アクセスの確保
|
||||
## パッケージへの {% data variables.product.prodname_github_codespaces %} アクセスの確保
|
||||
|
||||
既定では、 **[アクセスの継承]** オプションが選択された同じリポジトリ内で公開されたパッケージなど、{% data variables.product.prodname_ghcr_and_npm_registry %}内の特定のパッケージに codespace からシームレスにアクセスできます。 自動的に構成されるアクセスについて詳しくは、「[codespace がプライベート イメージ レジストリにアクセスできるようにする](/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry#accessing-images-stored-in-container-registry-and-npm-registry)」をご覧ください。
|
||||
既定では、 **[アクセスの継承]** オプションが選択された同じリポジトリ内で公開されたパッケージなど、詳細なアクセス許可をサポートするレジストリ内の特定のパッケージに codespace からシームレスにアクセスできます。 詳細なアクセス許可とシームレスな {% data variables.product.prodname_github_codespaces %} アクセスをサポートする {% data variables.product.prodname_registry %} レジストリの一覧については、「[{% data variables.product.prodname_registry %} のアクセス許可について](/packages/learn-github-packages/about-permissions-for-github-packages#granular-permissions-for-userorganization-scoped-packages)」をご覧ください。
|
||||
|
||||
あるいは、codespaceがパッケージに確実にアクセスできるようにするには、codespaceが起動されたリポジトリへのアクセスを許可しなければなりません。
|
||||
|
||||
|
||||
@@ -13,12 +13,12 @@ versions:
|
||||
ghec: '*'
|
||||
ghae: '*'
|
||||
shortTitle: Delete & restore a package
|
||||
ms.openlocfilehash: 4491e7cd25fbec2a19abb06c552ba0e0d3ac7b24
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 57f90bb6dbcda759e90444a40c7deef84d907b9c
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147704988'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193074'
|
||||
---
|
||||
{% data reusables.package_registry.packages-ghes-release-stage %}
|
||||
|
||||
@@ -40,45 +40,41 @@ ms.locfileid: '147704988'
|
||||
|
||||
{% data variables.product.prodname_dotcom %}では、以下の場合にパッケージ全体またはパッケージバージョンを復元できます。
|
||||
- 削除後30日以内にパッケージを復元する。
|
||||
- 同一のパッケージ名前空間が使用可能であり、新しいパッケージで使用されていない。
|
||||
- 同じパッケージ名前空間が現在も使用可能であり、新しいパッケージに使用されていない場合。
|
||||
|
||||
{% ifversion fpt or ghec or ghes %}
|
||||
## パッケージAPIのサポート
|
||||
|
||||
{% data reusables.package_registry.packages-classic-pat-only %}
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
|
||||
REST APIを使用してパッケージを管理できます。 詳しくは、[{% data variables.product.prodname_registry %} API](/rest/reference/packages) に関するページをご覧ください。
|
||||
|
||||
{% endif %}
|
||||
|
||||
リポジトリからアクセス許可とアクセス権を継承するパッケージの場合は、GraphQL を使用して特定のパッケージ バージョンを削除できます。{% data reusables.package_registry.no-graphql-to-delete-packages %} GraphQL のサポートについて詳しくは、「[GraphQL を使用してリポジトリ スコープ パッケージのバージョンを削除する](#deleting-a-version-of-a-repository-scoped-package-with-graphql)」をご覧ください。
|
||||
|
||||
{% endif %}
|
||||
{% data reusables.package_registry.about-graphql-support %}
|
||||
|
||||
## パッケージの削除や復元に必要な権限
|
||||
|
||||
リポジトリからアクセス権限を継承しているパッケージの場合、そのリポジトリに対する管理者権限がある場合はパッケージを削除できます。
|
||||
{% ifversion packages-registries-v2 %} 詳細なアクセス許可をサポートするレジストリでは、パッケージをユーザーまたは組織にスコープ指定するか、リポジトリにリンクすることを許可できます。
|
||||
|
||||
以下の {% data variables.product.prodname_registry %} レジストリでは、リポジトリ スコープのアクセス許可 **のみ** を使います。
|
||||
{% ifversion ghes %}`https://containers.HOSTNAME/OWNER/PACKAGE-NAME`{% else %}`https://ghcr.io/OWNER/PACKAGE-NAME`{% endif %}{% ifversion packages-npm-v2 %} または `https://npm.pkg.github.com/OWNER/PACKAGE-NAME` に保存されたパッケージ{% endif %}に保存されているコンテナー イメージなど、リポジトリとは別の詳細なアクセス許可を持つパッケージを削除するには、パッケージへの管理者アクセス権が必要です。 詳細については、「[{% data variables.product.prodname_registry %} のアクセス許可について](/packages/learn-github-packages/about-permissions-for-github-packages)」を参照してください。
|
||||
|
||||
{% ifversion not fpt or ghec %}- `docker.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME` の Docker イメージ{% endif %} {% ifversion packages-npm-v2 %}{% else %}- npm{% endif %}
|
||||
- RubyGemsレジストリ
|
||||
- Apache Mavenレジストリ
|
||||
- NuGetレジストリ
|
||||
リポジトリからアクセス許可を継承するパッケージの場合、リポジトリに対する管理者アクセス許可があれば、パッケージを削除できます。
|
||||
|
||||
{% ifversion packages-npm-v2 %}{% data variables.product.prodname_ghcr_and_npm_registry %}の場合、パッケージのスコープをユーザー、組織に設定、またはリポジトリにリンクすることを許可できます。{% endif %}
|
||||
一部のレジストリは、リポジトリがスコープ指定されたパッケージ **のみ** をサポートします。 そのようなレジストリの一覧については、「[{% data variables.product.prodname_registry %} のアクセス許可について](/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages)」をご覧ください。
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
{% else %}
|
||||
|
||||
`https://ghcr.io/OWNER/PACKAGE-NAME` または `https://npm.pkg.github.com/OWNER/PACKAGE-NAME` に保存されたコンテナー イメージなど、リポジトリとは別に細かいアクセス許可を持つパッケージを削除する場合は、そのパッケージに対する管理者アクセス権が必要です。 詳細については、「[About permissions for {% data variables.product.prodname_registry %}](/packages/learn-github-packages/about-permissions-for-github-packages)」 ({% data variables.product.prodname_registry %} へのアクセス許可) を参照してください。
|
||||
パッケージが発行されるリポジトリに対する管理者アクセス許可がある場合は、パッケージを削除できます。
|
||||
|
||||
{% endif %}
|
||||
|
||||
## パッケージのバージョンを削除する
|
||||
|
||||
### {% data variables.product.prodname_dotcom %}上でリポジトリのスコープが付いたバージョンを削除する
|
||||
### {% data variables.product.prodname_dotcom %} 上の{% ifversion packages-registries-v2 %}リポジトリがスコープ指定された{% endif %}パッケージのバージョンを削除する
|
||||
|
||||
リポジトリのスコープが付いたパッケージのバージョンを削除するには、パッケージを所有するリポジトリの管理者権限が必要です。 詳細については、「[必要なアクセス許可](#required-permissions-to-delete-or-restore-a-package)」を参照してください。
|
||||
{% ifversion packages-registries-v2 %}リポジトリがスコープ指定された{% endif %}パッケージのバージョンを削除するには、パッケージを所有するリポジトリに対する管理者アクセス許可が必要です。 詳細については、「[必要なアクセス許可](#required-permissions-to-delete-or-restore-a-package)」を参照してください。
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %} {% data reusables.package_registry.packages-from-code-tab %} {% data reusables.package_registry.package-settings-option %}
|
||||
5. 左側の **[バージョンの管理]** をクリックします。
|
||||
@@ -88,13 +84,11 @@ REST APIを使用してパッケージを管理できます。 詳しくは、[{
|
||||

|
||||
|
||||
{% ifversion fpt or ghec or ghes %}
|
||||
### GraphQLでリポジトリのスコープが付いたパッケージのバージョンを削除する
|
||||
### GraphQL を使用して{% ifversion packages-registries-v2 %}リポジトリがスコープ指定された{% endif %}パッケージのバージョンを削除する
|
||||
|
||||
リポジトリから権限とアクセスを継承しているパッケージの場合、GraphQLを使用して特定のパッケージバージョンを削除できます。
|
||||
{% data reusables.package_registry.about-graphql-support %}{% ifversion fpt or ghec %} 代わりに REST API を使用する方法については、「[{% data variables.product.prodname_registry %} API](/rest/reference/packages)」をご覧ください。{% endif %}
|
||||
|
||||
{% data reusables.package_registry.no-graphql-to-delete-packages %}{% ifversion fpt or ghec %} ただし、REST API は使用できます。 詳しくは、[{% data variables.product.prodname_registry %} API](/rest/reference/packages) に関するページをご覧ください。{% endif %}
|
||||
|
||||
GraphQL API の `deletePackageVersion` ミューテーションを使ってください。 `read:packages`、`delete:packages`、`repo` スコープを持つトークンを使わなければなりません。 トークンについて詳しくは、「[{% data variables.product.prodname_registry %} について](/packages/publishing-and-managing-packages/about-github-packages#authenticating-to-github-packages)」をご覧ください。
|
||||
GraphQL API の `deletePackageVersion` ミューテーションを使ってください。 `read:packages`、`delete:packages`、`repo` のスコープとともに {% data variables.product.pat_v1 %} を使う必要があります。 {% data variables.product.pat_v1_plural %} について詳しくは、「[{% data variables.product.prodname_registry %} について](/packages/publishing-and-managing-packages/about-github-packages#authenticating-to-github-packages)」をご覧ください。
|
||||
|
||||
以下の例では、`MDIyOlJlZ2lzdHJ5UGFja2FnZVZlcnNpb243MTExNg` の `packageVersionId` を使用して、パッケージ バージョンを削除する方法を示します。
|
||||
|
||||
@@ -106,7 +100,7 @@ curl -X POST \
|
||||
HOSTNAME/graphql
|
||||
```
|
||||
|
||||
{% data variables.product.prodname_registry %} に公開したすべてのプライベート パッケージをバージョン ID と併せて見つけるには、`repository` オブジェクトを通じて `packages` コネクションを使うことができます。 `read:packages` および `repo` のスコープを持つトークンが必要です。 詳細については、[`packages`](/graphql/reference/objects#repository) コネクションまたは [`PackageOwner`](/graphql/reference/interfaces#packageowner) インターフェイスを参照してください。
|
||||
{% data variables.product.prodname_registry %} に公開したすべてのプライベート パッケージをバージョン ID と併せて見つけるには、`repository` オブジェクトを通じて `packages` コネクションを使うことができます。 `read:packages` と `repo` スコープを含む {% data variables.product.pat_v1 %} が必要になります。 詳細については、[`packages`](/graphql/reference/objects#repository) コネクションまたは [`PackageOwner`](/graphql/reference/interfaces#packageowner) インターフェイスを参照してください。
|
||||
|
||||
`deletePackageVersion` ミューテーションの詳細については、「[`deletePackageVersion`](/graphql/reference/mutations#deletepackageversion)」を参照してください。
|
||||
|
||||
|
||||
@@ -16,12 +16,12 @@ versions:
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
shortTitle: Introduction
|
||||
ms.openlocfilehash: a141c93378f836eebf5ff33b0ced482409d6e577
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 1ad319ead16f10186b330f876ccaa83bc44bdbcd
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147704948'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193026'
|
||||
---
|
||||
{% data reusables.package_registry.packages-ghes-release-stage %} {% data reusables.package_registry.packages-ghae-release-stage %}
|
||||
|
||||
@@ -55,11 +55,9 @@ ms.locfileid: '147704948'
|
||||
|
||||
| | |
|
||||
|--------------------|--------------------|
|
||||
| アクセス許可 | {% ifversion fpt or ghec %}パッケージの権限は、パッケージがホストされているリポジトリから継承したり、{% data variables.product.prodname_ghcr_and_npm_registry %}内のパッケージの場合は特定のユーザーまたは Organization アカウントに対して定義したりできます。 詳しくは、「[パッケージのアクセス制御と可視性の設定](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)」を参照してください。 {% else %}それぞれのパッケージは、ホストされているリポジトリの権限を継承します。 <br> <br> たとえば、リポジトリの読み取り権限を持つ人であれば、プロジェクトに依存関係としてパッケージをインストールでき、書き込み権限を持つ人であれば、新しいパッケージバージョンを公開できます。{% endif %} |
|
||||
| アクセス許可 | {% ifversion packages-registries-v2 %}パッケージのアクセス許可は、パッケージがホストされているリポジトリから継承することも、特定のユーザーや組織アカウント用に定義することもできます。 一部のレジストリでは、リポジトリから継承されたアクセス許可のみがサポートされます。 そのようなレジストリの一覧については、「[{% data variables.product.prodname_registry %} のアクセス許可について](/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages)」をご覧ください。 パッケージのアクセスについて詳しくは、「[パッケージのアクセス制御と可視性の設定](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)」をご覧ください。 {% else %}それぞれのパッケージは、ホストされているリポジトリの権限を継承します。 <br> <br> たとえば、リポジトリの読み取り権限を持つ人であれば、プロジェクトに依存関係としてパッケージをインストールでき、書き込み権限を持つ人であれば、新しいパッケージバージョンを公開できます。{% endif %} |
|
||||
| 視程 | {% data reusables.package_registry.public-or-private-packages %} |
|
||||
|
||||
詳細については、「[{% data variables.product.prodname_registry %} のアクセス許可について](/packages/learn-github-packages/about-permissions-for-github-packages)」を参照してください。
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
## {% data variables.product.prodname_registry %} の請求について
|
||||
|
||||
@@ -102,17 +100,9 @@ ms.locfileid: '147704948'
|
||||
|
||||
## パッケージを管理する
|
||||
|
||||
{% ifversion fpt or ghec %}{% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} ユーザー インターフェイスまたは REST API を使用して、パッケージを削除できます。 詳しくは、「[パッケージを削除および復元する](/packages/learn-github-packages/deleting-and-restoring-a-package)」および [{% data variables.product.prodname_registry %} API](/rest/reference/packages) に関するページをご覧ください。
|
||||
パッケージの削除は、{% data variables.product.product_name %} のユーザー インターフェイス{% ifversion fpt or ghec %} から、もしくは REST API を使って行うことができます。 詳しくは、「[パッケージの削除と復元](/packages/learn-github-packages/deleting-and-restoring-a-package)」と「[{% data variables.product.prodname_registry %} API](/rest/reference/packages)」をご覧ください。{% else %} {% endif %} {% data reusables.package_registry.about-graphql-support %}
|
||||
|
||||
{% data reusables.package_registry.no-graphql-to-delete-packages %} {% endif %}
|
||||
|
||||
{% ifversion ghes %} {% data variables.product.product_name %} のユーザー インターフェイスでは、非公開あるいはパブリック パッケージを削除できます。 また、repoスコープのパッケージでは、GraphQLを使用してプライベートパッケージのバージョンを削除できます。
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghae %} パッケージのバージョンは、{% data variables.product.product_name %} ユーザー インターフェイス内で、または GraphQL API を使って削除できます。
|
||||
{% endif %}
|
||||
|
||||
GraphQL APIを使ってプライベートパッケージに対するクエリや削除を行う場合、{% data variables.product.prodname_registry %}の認証に使うのと同じトークンを使わなければなりません。
|
||||
GraphQL API を使ってプライベート パッケージに対するクエリや削除を行う場合、{% data variables.product.prodname_registry %} の認証に使うのと同じ {% data variables.product.pat_v1 %} を使わなければなりません。
|
||||
|
||||
詳しくは、{% ifversion ghes or ghae %}「[パッケージを削除および復元する](/packages/learn-github-packages/deleting-and-restoring-a-package)」および{% endif %}「[GraphQL での呼び出しの作成](/graphql/guides/forming-calls-with-graphql)」をご覧ください。
|
||||
|
||||
|
||||
@@ -14,12 +14,12 @@ versions:
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
ms.openlocfilehash: 75e3d0a69a06274e803fc59affc959b2cb5abee3
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 4fe01f80ec64f8029b1b2bce1d776da4eddfbd75
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147704996'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192842'
|
||||
---
|
||||
{% data reusables.package_registry.packages-ghes-release-stage %} {% data reusables.package_registry.packages-ghae-release-stage %}
|
||||
|
||||
@@ -27,17 +27,16 @@ ms.locfileid: '147704996'
|
||||
|
||||
パッケージを見ることができるかどうかは、いくつかの要素に依存します。 デフォルトでは、公開したパッケージはすべて見ることができます。
|
||||
|
||||
リポジトリをスコープとするパッケージは、そのパッケージを所有するリポジトリから権限と可視性を継承します。 以下のレジストリでは、この種類のアクセス許可 **のみ** が使用されます。{% ifversion not fpt or ghec %}
|
||||
- Docker レジストリ (`docker.pkg.github.com`){% endif %} {% ifversion packages-npm-v2 %}{% else %}- npm レジストリ{% endif %}
|
||||
- RubyGemsレジストリ
|
||||
- Apache Mavenレジストリ
|
||||
- NuGetレジストリ
|
||||
{% ifversion packages-registries-v2 %} リポジトリを範囲とするパッケージは、そのパッケージを所有するリポジトリから権限と表示の有無を継承します。 リポジトリを範囲とするアクセス許可 **のみ** をサポートするレジストリもあります。 そのようなレジストリの一覧については、「[{% data variables.product.prodname_registry %} のアクセス許可について](/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages)」を参照してください。
|
||||
|
||||
その他のレジストリは、個人ユーザーもしくは Organization アカウントが所有する各パッケージごとにカスタマイズできる、詳細な権限および表示の有無の設定のオプションを提供します。 細かなアクセス許可を利用することも、パッケージをリポジトリに接続し、そのリポジトリのアクセス許可を継承することもできます。 詳しくは、「[リポジトリのパッケージへの接続](/packages/learn-github-packages/connecting-a-repository-to-a-package)」と「[パッケージのアクセス制御と可視性の設定](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)」を参照してください。
|
||||
|
||||
{% else %}
|
||||
|
||||
パッケージは、それがホストされているリポジトリのアクセス許可と表示の有無を継承します。 詳細については、「[About permissions for {% data variables.product.prodname_registry %}](/packages/learn-github-packages/about-permissions-for-github-packages)」 ({% data variables.product.prodname_registry %} へのアクセス許可) を参照してください。
|
||||
|
||||
{% ifversion fpt or ghec %} {% data variables.product.prodname_ghcr_and_npm_registry %}では、個人ユーザーまたは組織アカウントが所有する各パッケージごとにカスタマイズできる、細かいアクセス許可と可視性設定のオプションが提供されます。 詳細な権限を利用することも、パッケージをレジストリに接続してその権限を継承することもできます。 詳細については、「[リポジトリのパッケージへの接続](/packages/learn-github-packages/connecting-a-repository-to-a-package)」を参照してください。
|
||||
{% endif %}
|
||||
|
||||
詳細については、「[GitHub Packages の権限について](/packages/learn-github-packages/about-permissions-for-github-packages){% ifversion fpt or ghec %}」および「[パッケージのアクセス制御と可視性の設定](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility){% endif %}」を参照してください。
|
||||
|
||||
{% data reusables.package_registry.package-page-info %}
|
||||
|
||||
## リポジトリのパッケージを表示する
|
||||
|
||||
@@ -12,12 +12,12 @@ versions:
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
shortTitle: Publish & install with Actions
|
||||
ms.openlocfilehash: 4996d6c180b3e54608184ce4c40b8e0595f60d3e
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 80516eb55e9ffc8f2de3f92cf24a7d7f230b8407
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147705044'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193123'
|
||||
---
|
||||
{% data reusables.package_registry.packages-ghes-release-stage %} {% data reusables.package_registry.packages-ghae-release-stage %}
|
||||
|
||||
@@ -27,37 +27,40 @@ ms.locfileid: '147705044'
|
||||
|
||||
ワークフローの一部としてパッケージの公開やインストールを行うことで、リポジトリのCI及びCDの機能を拡張できます。
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
### {% data variables.product.prodname_ghcr_and_npm_registry %} に対する認証
|
||||
{% ifversion packages-registries-v2 %}
|
||||
### 詳細なアクセス許可を持つパッケージ レジストリに対する認証
|
||||
|
||||
{% data reusables.package_registry.authenticate_with_pat_for_v2_registry %}
|
||||
|
||||
### リポジトリがスコープ指定されたアクセス許可を持つパッケージ レジストリに対する認証
|
||||
|
||||
{% endif %}
|
||||
|
||||
### {% data variables.product.prodname_dotcom %} 上のパッケージレジストリを認証する
|
||||
{% ifversion packages-registries-v2 %}一部の {% data variables.product.prodname_registry %} レジストリでは、リポジトリがスコープ指定されたアクセス許可のみがサポートされ、詳細なアクセス許可はサポートされていません。 そのようなレジストリの一覧については、「[{% data variables.product.prodname_registry %} のアクセス許可について](/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages)」をご覧ください。
|
||||
|
||||
{% ifversion fpt or ghec %}ワークフローが {% data variables.product.prodname_registry %} に対して認証されるようにして、{% data variables.product.product_location %} 上の {% data variables.product.prodname_container_registry %} 以外のパッケージ レジストリにアクセスできるようにしたい場合は、{% else %}{% data variables.product.product_name %} 上のパッケージ レジストリに対して認証を行いたい場合は、{% endif %}、認証用の個人用アクセス トークンではなく、{% data variables.product.prodname_actions %} を有効化する際に {% data variables.product.product_name %} でリポジトリに対して自動的に作成される、`GITHUB_TOKEN` を使用することをお勧めします。 ワークフロー ファイルでこのアクセス トークンにアクセス許可を設定して、`contents` スコープに対する読み取りアクセス権と、`packages` スコープに対する書き込みアクセス権を付与する必要があります。 フォークの場合、`GITHUB_TOKEN` には親リポジトリの読み取りアクセス権が付与されます。 詳細については、「[GITHUB_TOKEN を使用した認証](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)」を参照してください。
|
||||
詳細なアクセス許可がサポートされていない {% data variables.product.prodname_registry %} レジストリにアクセスするワークフローが必要な場合{% else %}{% data variables.product.product_name %} のパッケージ レジストリの認証を受けるには、{% endif %}{% data variables.product.prodname_actions %} を有効にするときに、{% data variables.product.product_name %} によってレポジトリに対して自動的に作成される `GITHUB_TOKEN` を使うことをお勧めします。 ワークフロー ファイルでこのアクセス トークンにアクセス許可を設定して、`contents` スコープに対する読み取りアクセス権と、`packages` スコープに対する書き込みアクセス権を付与する必要があります。 フォークの場合、`GITHUB_TOKEN` には親リポジトリの読み取りアクセス権が付与されます。 詳細については、「[GITHUB_TOKEN を使用した認証](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)」を参照してください。
|
||||
|
||||
ワークフロー ファイル内の `GITHUB_TOKEN` は、{% raw %}`{{secrets.GITHUB_TOKEN}}`{% endraw %} コンテキストを使って参照できます。 詳細については、「[GITHUB_TOKEN を使用した認証](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)」を参照してください。
|
||||
|
||||
## リポジトリが所有するパッケージに対する権限とパッケージアクセスについて
|
||||
## アクセス許可とパッケージのアクセスについて
|
||||
|
||||
{% note %}
|
||||
{% ifversion packages-registries-v2 %}
|
||||
|
||||
**注:** RubyGems、{% ifversion packages-npm-v2 %}{% else %}npm、{% endif %}Apache Maven、NuGet、{% ifversion fpt or ghec %}、Gradle{% else %}Gradle、名前空間 `docker.pkg.github.com` を使用する Docker パッケージ{% endif %}などの一部のレジストリでは、レポジトリ所有のパッケージのみが許可されます。 {% data variables.product.prodname_ghcr_and_npm_registry_full %} を使用すると、ユーザーまたは Organization がパッケージを所有できるようにするか、リポジトリにリンクできるようにするかを選択できます。
|
||||
### ユーザーまたは Organization にスコープ指定されたパッケージ
|
||||
|
||||
{% endnote %}
|
||||
詳細なアクセス許可をサポートするレジストリを使うと、ユーザーは Organization レベルで独立したリソースとしてパッケージを作成および管理できます。 Organization または個人アカウントがパッケージを所有でき、それぞれのパッケージへのアクセスはリポジトリ権限とは別にカスタマイズできます。
|
||||
|
||||
詳細なアクセス許可をサポートするレジストリにアクセスするすべてのワークフローで、{% data variables.product.pat_generic %} の代わりに `GITHUB_TOKEN` を使う必要があります。 セキュリティのベスト プラクティスについて詳しくは、「[GitHub Actions のセキュリティ強化](/actions/learn-github-actions/security-hardening-for-github-actions#using-secrets)」を参照してください。
|
||||
|
||||
### リポジトリにスコープ指定されたパッケージ
|
||||
|
||||
{% endif %}
|
||||
|
||||
GitHub Actionsを有効化すると、GitHubはリポジトリにGitHub Appをインストールします。 `GITHUB_TOKEN` シークレットは、GitHub App インストール アクセス トークンです。 このインストールアクセストークンは、リポジトリにインストールされたGitHub Appの代わりに認証を受けるために使うことができます。 このトークンの権限は、ワークフローを含むリポジトリに限定されます。 詳細については、「[GITHUB_TOKEN のアクセス許可](/actions/reference/authentication-in-a-workflow#about-the-github_token-secret)」を参照してください。
|
||||
|
||||
{% data variables.product.prodname_registry %} を使用すると、{% data variables.product.prodname_actions %} ワークフローで利用できる `GITHUB_TOKEN` を通じてパッケージをプッシュしたりプルしたりできます。
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
## {% data variables.product.prodname_ghcr_and_npm_registry %} の権限とパッケージ アクセスについて
|
||||
|
||||
{% data variables.product.prodname_ghcr_and_npm_registry_full %} を使うと、ユーザーは Organization レベルの自立リソースとしてパッケージを作成し、管理できます。 Organization または個人アカウントがパッケージを所有でき、それぞれのパッケージへのアクセスはリポジトリ権限とは別にカスタマイズできます。
|
||||
|
||||
{% data variables.product.prodname_ghcr_and_npm_registry %} にアクセスするすべてのワークフローは、個人用アクセス トークンではなく `GITHUB_TOKEN` を使う必要があります。 セキュリティのベスト プラクティスについて詳しくは、「[GitHub Actions のセキュリティ強化](/actions/learn-github-actions/security-hardening-for-github-actions#using-secrets)」を参照してください。
|
||||
{% ifversion packages-registries-v2 %}
|
||||
|
||||
## ワークフローを通じて変更されたコンテナに対するデフォルトの権限及びアクセス設定
|
||||
|
||||
@@ -469,14 +472,14 @@ docker.pkg.github.com/${{ github.repository }}/octo-image:${{ github.sha }}
|
||||
|
||||
{% data reusables.package_registry.actions-configuration %}
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
## PAT を使用してレジストリにアクセスするワークフローのアップグレード
|
||||
{% ifversion packages-registries-v2 %}
|
||||
## {% data variables.product.pat_generic %} を使ってレジストリにアクセスするワークフローのアップグレード
|
||||
|
||||
{% data variables.product.prodname_ghcr_and_npm_registry %} は、ワークフロー内での、簡単でセキュリティで保護された認証のために `GITHUB_TOKEN` をサポートしています。 お使いのワークフローで個人アクセス トークン (PAT) を使用してレジストリの認証を受ける場合、`GITHUB_TOKEN` を使用するようにワークフローを更新することを強くお勧めします。
|
||||
{% data variables.product.prodname_registry %} は、ワークフロー内での容易でセキュリティで保護された認証のために `GITHUB_TOKEN` をサポートしています。 詳細なアクセス許可をサポートするレジストリを使っており、お使いのワークフローで {% data variables.product.pat_generic %} を使ってレジストリの認証を受ける場合、`GITHUB_TOKEN` を使うようにワークフローを更新することを強くお勧めします。
|
||||
|
||||
`GITHUB_TOKEN` の詳細については「[ワークフローで認証する](/actions/reference/authentication-in-a-workflow#using-the-github_token-in-a-workflow)」を参照してください。
|
||||
|
||||
PAT の代わりに `repo` スコープを含む `GITHUB_TOKEN` を使えば、ワークフローが実行されるリポジトリへの不要なアクセスを提供する長期間有効な PAT を使う必要がなくなるので、リポジトリのセキュリティが向上します。 セキュリティのベスト プラクティスについて詳しくは、「[GitHub Actions のセキュリティ強化](/actions/learn-github-actions/security-hardening-for-github-actions#using-secrets)」を参照してください。
|
||||
{% data variables.product.pat_v1 %} の代わりに `repo` スコープを含む `GITHUB_TOKEN` を使えば、ワークフローが実行されるリポジトリへの不要なアクセスを提供する長期間有効な {% data variables.product.pat_generic %} を使う必要がなくなるので、リポジトリのセキュリティが向上します。 セキュリティのベスト プラクティスについて詳しくは、「[GitHub Actions のセキュリティ強化](/actions/learn-github-actions/security-hardening-for-github-actions#using-secrets)」を参照してください。
|
||||
|
||||
1. パッケージのランディングページにアクセスしてください。
|
||||
1. 左側のサイドバーで、 **[アクションのアクセス]** をクリックします。
|
||||
@@ -489,7 +492,7 @@ PAT の代わりに `repo` スコープを含む `GITHUB_TOKEN` を使えば、
|
||||
{% endnote %}
|
||||
1. あるいは"role(ロール)"ドロップダウンメニューを使い、コンテナイメージに対してリポジトリに持たせたいデフォルトのアクセスレベルを選択してください。
|
||||

|
||||
1. ワークフローファイルを開いてください。 レジストリへのログインの行で、お使いの PAT を {% raw %}`${{ secrets.GITHUB_TOKEN }}`{% endraw %} に置き換えてください。
|
||||
1. ワークフローファイルを開いてください。 レジストリへのログインの行で、お使いの {% data variables.product.pat_generic %} を {% raw %}`${{ secrets.GITHUB_TOKEN }}`{% endraw %} に置き換えてください。
|
||||
|
||||
たとえば、このワークフローでは、Docker イメージを {% data variables.product.prodname_container_registry %} に公開し、{% raw %}`${{ secrets.GITHUB_TOKEN }}`{% endraw %} を使って認証します。
|
||||
|
||||
@@ -529,7 +532,7 @@ jobs:
|
||||
run: docker build . --file Dockerfile --tag $IMAGE_NAME --label "runnumber=${GITHUB_RUN_ID}"
|
||||
|
||||
- name: Log in to registry
|
||||
# This is where you will update the PAT to GITHUB_TOKEN
|
||||
# This is where you will update the {% data variables.product.pat_generic %} to GITHUB_TOKEN
|
||||
run: echo "{% raw %}${{ secrets.GITHUB_TOKEN }}{% endraw %}" | docker login ghcr.io -u ${{ github.actor }} --password-stdin
|
||||
|
||||
- name: Push image
|
||||
|
||||
@@ -14,12 +14,12 @@ versions:
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
shortTitle: npm registry
|
||||
ms.openlocfilehash: 608841099aff8fd75a9a342444060fa9e8c860ce
|
||||
ms.sourcegitcommit: 34d500fe45b362043b4b4685d6705a7bfb484d11
|
||||
ms.openlocfilehash: 11b1ab58cd57c6cecdeb2366b83696166cdc6245
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/15/2022
|
||||
ms.locfileid: '148164491'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193130'
|
||||
---
|
||||
{% data reusables.package_registry.packages-ghes-release-stage %} {% data reusables.package_registry.packages-ghae-release-stage %}
|
||||
|
||||
@@ -98,20 +98,15 @@ $ npm login --scope=@OWNER --registry=https://HOSTNAME/_registry/npm/
|
||||
{% endnote %}
|
||||
|
||||
{% ifversion packages-npm-v2 %}{% data variables.product.prodname_registry %} レジストリは、Organization 内または個人アカウント内に npm パッケージを格納し、パッケージをリポジトリに関連付けることができます。 権限をリポジトリから継承するか、リポジトリとは別に細かい権限を設定するかを選ぶことができます。
|
||||
{% endif %}
|
||||
|
||||
{% data reusables.package_registry.publishing-user-scoped-packages %} {% endif %}
|
||||
|
||||
既定では、{% data variables.product.prodname_registry %} は *package.json* ファイルの name フィールドで指定された {% data variables.product.prodname_dotcom %} リポジトリにパッケージを公開します。 たとえば、`@my-org/test` という名前のパッケージは、`my-org/test` {% data variables.product.prodname_dotcom %} リポジトリに公開することになります。 [npm v8.5.3](https://github.com/npm/cli/releases/tag/v8.5.3) 以降を実行している場合は、パッケージ ディレクトリに *README.md* ファイルを含めることで、パッケージのリスト ページの概要を追加できます。 詳しくは、[package.json の利用](https://docs.npmjs.com/getting-started/using-a-package.json)と [Node.js モジュールの作成方法](https://docs.npmjs.com/getting-started/creating-node-modules)に関する npm のドキュメントをご覧ください。
|
||||
|
||||
`URL` フィールドを *package.json* ファイルに含めることで、同じ {% data variables.product.prodname_dotcom %} リポジトリに複数のパッケージを公開できます。 詳しくは、「[同じリポジトリへの複数パッケージの公開](#publishing-multiple-packages-to-the-same-repository)」をご覧ください。
|
||||
|
||||
{% ifversion fpt or ghec %}パッケージが公開されても、リポジトリに自動的にリンクされることはありません。 ただし、ユーザー インターフェイスまたはコマンド ラインを使用して、公開済みのパッケージをリポジトリにリンクすることはできます。 詳細については、「[リポジトリのパッケージへの接続](/packages/learn-github-packages/connecting-a-repository-to-a-package)」を参照してください。
|
||||
{% endif %}
|
||||
|
||||
プロジェクト内にあるローカルの *.npmrc* ファイルか、*package.json* の `publishConfig` オプションを使用して、プロジェクトのスコープのマッピングを設定できます。 {% data variables.product.prodname_registry %}はスコープ付きのnpmパッケージのみをサポートしています。 スコープ付きのパッケージには、`@owner/name` 形式の名前が付いています。 スコープ付きのパッケージの先頭には常に `@` 記号が付いています。 スコープ付きの名前を使うには、*package.json* で名前を更新する必要がある場合があります。 たとえば、`"name": "@codertocat/hello-world-npm"` のようにします。
|
||||
|
||||
{% ifversion packages-npm-v2 %} パッケージを最初に公開する場合、既定の可視性はプライベートです。 パッケージがリポジトリにリンクされている場合、パッケージの可視性はリポジトリの可視性に依存します。 可視性を変更したりアクセス権限を設定するには、「[パッケージのアクセス制御と可視性の設定](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)」を参照してください。
|
||||
{% endif %}
|
||||
|
||||
{% data reusables.package_registry.viewing-packages %}
|
||||
|
||||
### ローカルの *.npmrc* ファイルを使用したパッケージの公開
|
||||
|
||||
@@ -15,12 +15,12 @@ versions:
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
shortTitle: NuGet registry
|
||||
ms.openlocfilehash: d97a5645a3d945bb79cf6d3b9e8e09eb6b5d7a42
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: cb9e190bb6cfa86ce1bdb31581de6e7d14e9dac8
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147580512'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192922'
|
||||
---
|
||||
{% data reusables.package_registry.packages-ghes-release-stage %} {% data reusables.package_registry.packages-ghae-release-stage %}
|
||||
|
||||
@@ -30,9 +30,12 @@ ms.locfileid: '147580512'
|
||||
|
||||
{% data reusables.package_registry.authenticate-packages %}
|
||||
|
||||
{% ifversion packages-nuget-v2 %} {% data variables.product.prodname_github_codespaces %} と {% data variables.product.prodname_actions %} に対して、パッケージに権限を個別に付与することもできます。 詳しくは、「[パッケージへの Codespaces のアクセスの確保](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-codespaces-access-to-your-package)」と、「[パッケージへのワークフロー アクセスの確認](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-workflow-access-to-your-package)」をご覧ください。
|
||||
{% endif %}
|
||||
|
||||
### {% data variables.product.prodname_actions %} における `GITHUB_TOKEN` での認証
|
||||
|
||||
リポジトリ内の nuget.config ファイルでトークンをハードコーディングする代わりに、`GITHUB_TOKEN` を使用して {% data variables.product.prodname_actions %} ワークフローで {% data variables.product.prodname_registry %} に対して認証を行うには、以下のコマンドを使用してください。
|
||||
リポジトリ内の nuget.config ファイルで{% data variables.product.pat_generic %}をハードコーディングするのでなく、`GITHUB_TOKEN` を使用して {% data variables.product.prodname_actions %} ワークフローで {% data variables.product.prodname_registry %} に対して認証を行うには、以下のコマンドを使用してください。
|
||||
|
||||
```shell
|
||||
dotnet nuget add source --username USERNAME --password {%raw%}${{ secrets.GITHUB_TOKEN }}{% endraw %} --store-password-in-clear-text --name github "https://{% ifversion fpt or ghec %}nuget.pkg.github.com{% else %}nuget.HOSTNAME{% endif %}/OWNER/index.json"
|
||||
@@ -40,7 +43,7 @@ dotnet nuget add source --username USERNAME --password {%raw%}${{ secrets.GITHUB
|
||||
|
||||
{% data reusables.package_registry.authenticate-packages-github-token %}
|
||||
|
||||
### 個人アクセストークンでの認証
|
||||
### {% data variables.product.pat_generic %} で認証を行う
|
||||
|
||||
{% data reusables.package_registry.required-scopes %}
|
||||
|
||||
@@ -48,9 +51,9 @@ dotnet nuget add source --username USERNAME --password {%raw%}${{ secrets.GITHUB
|
||||
|
||||
以下のように置き換えてください。
|
||||
- `USERNAME` を {% data variables.product.prodname_dotcom %} の個人アカウントの名前に。
|
||||
- `TOKEN` を個人用アクセス トークンに。
|
||||
- `OWNER` を、プロジェクトを含むリポジトリを所有しているユーザーまたは Organization アカウントの名前に。{% ifversion ghes or ghae %}
|
||||
- `HOSTNAME` を {% data variables.product.product_location %} のホスト名に。{% endif %}
|
||||
- `TOKEN` を{% data variables.product.pat_v1 %} に。
|
||||
- `OWNER` を、インストールする{% ifversion packages-nuget-v2 %}パッケージを所有するユーザーまたは Organization のアカウントの名前、パッケージの公開先とするユーザーまたは Organization のアカウントの名前、{% else %}ご利用のプロジェクトを含むリポジトリの名前に{% endif %}。{% ifversion ghes or ghae %}
|
||||
- `HOSTNAME` を {% data variables.location.product_location %} のホスト名に。{% endif %}
|
||||
|
||||
{% ifversion ghes %}インスタンスで Subdomain Isolation が有効になっている場合:{% endif %}
|
||||
|
||||
@@ -91,11 +94,21 @@ dotnet nuget add source --username USERNAME --password {%raw%}${{ secrets.GITHUB
|
||||
|
||||
## パッケージの公開
|
||||
|
||||
*nuget.config* ファイルを使用して認証を行うか、コマンド ライン オプションの `--api-key` と {% data variables.product.prodname_dotcom %} 個人用アクセス トークン (PAT) を使うことで、パッケージを {% data variables.product.prodname_registry %} に公開できます。
|
||||
*nuget.config* ファイルを使用して認証を行うか、コマンド ライン オプションの `--api-key` と {% data variables.product.prodname_dotcom %} {% data variables.product.pat_v1 %} を使うことで、パッケージを {% data variables.product.prodname_registry %} に公開できます。
|
||||
|
||||
### GitHub PATをAPIキーとして使用してパッケージを公開する
|
||||
{% ifversion packages-nuget-v2 %}
|
||||
|
||||
{% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} のアカウントで使う PAT がまだない場合は、「[個人アクセス トークンを作成する](/github/authenticating-to-github/creating-a-personal-access-token)」をご覧ください。
|
||||
NuGet レジストリを使用すると、Organization または個人のアカウント内にパッケージを格納し、パッケージをリポジトリに関連付けることができます。 権限をリポジトリから継承するか、リポジトリとは別に細かい権限を設定するかを選ぶことができます。
|
||||
|
||||
{% data reusables.package_registry.publishing-user-scoped-packages %}
|
||||
|
||||
`nuget.config` ファイルで `RepositoryURL` を指定すると、公開されたパッケージは指定されたリポジトリに自動的に接続されます。 詳しくは、「[`nuget.config` ファイルを使用してパッケージを公開する](/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry#publishing-a-package-using-a-nugetconfig-file)」をご覧ください。 既に公開されているパッケージをリポジトリにリンクする方法については、「[パッケージへのリポジトリの接続](/packages/learn-github-packages/connecting-a-repository-to-a-package)」を参照してください。
|
||||
|
||||
{% endif %}
|
||||
|
||||
### GitHub {% data variables.product.pat_generic %} を API キーとして使用してパッケージを公開する
|
||||
|
||||
{% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %} のアカウントで使う PAT がまだない場合は、「[{% data variables.product.pat_generic %}を作成する](/github/authenticating-to-github/creating-a-personal-access-token)」をご覧ください。
|
||||
|
||||
1. 新しいプロジェクトを作成します。
|
||||
```shell
|
||||
@@ -106,9 +119,9 @@ dotnet nuget add source --username USERNAME --password {%raw%}${{ secrets.GITHUB
|
||||
dotnet pack --configuration Release
|
||||
```
|
||||
|
||||
3. PATをAPIキーとして使用して、パッケージを公開します。
|
||||
3. {% data variables.product.pat_generic %} を API キーとして使用してパッケージを発行します。
|
||||
```shell
|
||||
dotnet nuget push "bin/Release/OctocatApp.1.0.0.nupkg" --api-key <em>YOUR_GITHUB_PAT</em> --source "github"
|
||||
dotnet nuget push "bin/Release/OctocatApp.1.0.0.nupkg" --api-key YOUR_GITHUB_PAT --source "github"
|
||||
```
|
||||
|
||||
{% data reusables.package_registry.viewing-packages %}
|
||||
@@ -123,10 +136,10 @@ dotnet nuget add source --username USERNAME --password {%raw%}${{ secrets.GITHUB
|
||||
dotnet new console --name OctocatApp
|
||||
```
|
||||
3. プロジェクト固有の情報をプロジェクト ファイル (末尾が *.csproj* のファイル) に追加します。 以下のように置き換えてください。
|
||||
- `OWNER` を、プロジェクトを含むリポジトリを所有しているユーザーまたは Organization アカウントの名前に。
|
||||
- `REPOSITORY` を、公開したいパッケージを含むリポジトリの名前に。
|
||||
- `OWNER` を、パッケージを接続するリポジトリを所有するユーザーまたは Organization アカウントの名前に。
|
||||
- `REPOSITORY` を、パッケージを接続するリポジトリの名前に。
|
||||
- `1.0.0` をパッケージのバージョン番号に。{% ifversion ghes or ghae %}
|
||||
- `HOSTNAME` を {% data variables.product.product_location %} のホスト名に。{% endif %}
|
||||
- `HOSTNAME` を {% data variables.location.product_location %} のホスト名に。{% endif %}
|
||||
``` xml
|
||||
<Project Sdk="Microsoft.NET.Sdk">
|
||||
|
||||
@@ -157,7 +170,7 @@ dotnet nuget add source --username USERNAME --password {%raw%}${{ secrets.GITHUB
|
||||
|
||||
## 同じリポジトリへの複数パッケージの公開
|
||||
|
||||
複数のパッケージを同じリポジトリに公開するには、同じ {% data variables.product.prodname_dotcom %} リポジトリの URL をすべての *.csproj* プロジェクト ファイルの `RepositoryURL` フィールドに含めることができます。 {% data variables.product.prodname_dotcom %}は、そのフィールドに基づいてリポジトリをマッチします。
|
||||
複数のパッケージを同じリポジトリに接続するには、同じ {% data variables.product.prodname_dotcom %} リポジトリの URL をすべての *.csproj* プロジェクト ファイルの `RepositoryURL` フィールドに含めることができます。 {% data variables.product.prodname_dotcom %}は、そのフィールドに基づいてリポジトリをマッチします。
|
||||
|
||||
たとえば、以下の *OctodogApp* と *OctocatApp* プロジェクトは同じリポジトリに公開されます。
|
||||
|
||||
@@ -234,7 +247,7 @@ dotnet nuget add source --username USERNAME --password {%raw%}${{ secrets.GITHUB
|
||||
|
||||
nuspec ファイルを使用している場合は、`repository` 要素と必須の `type` および `url` 属性が含まれていることを確認してください。
|
||||
|
||||
`GITHUB_TOKEN` を使って {% data variables.product.prodname_actions %} ワークフロー内の {% data variables.product.prodname_registry %} レジストリの認証を受けている場合、そのトークンからは、ワークフローの実行場所とは異なるリポジトリ内にあるプライベート リポジトリベースのパッケージにアクセスできません。 他のリポジトリに関連付けられたパッケージにアクセスするには、代わりにスコープが `read:packages` の PAT を生成し、このトークンをシークレットとして渡します。
|
||||
`GITHUB_TOKEN` を使って {% data variables.product.prodname_actions %} ワークフロー内の {% data variables.product.prodname_registry %} レジストリの認証を受けている場合、そのトークンからは、ワークフローの実行場所とは異なるリポジトリ内にあるプライベート リポジトリベースのパッケージにアクセスできません。 他のリポジトリに関連付けられたパッケージにアクセスするには、代わりにスコープが `read:packages` の {% data variables.product.pat_v1 %} を生成し、このトークンをシークレットとして渡します。
|
||||
|
||||
## 参考資料
|
||||
|
||||
|
||||
@@ -1,19 +1,19 @@
|
||||
---
|
||||
title: Codespaces
|
||||
intro: Codespaces API を使用すると、REST API を使用して codespace を管理できます。
|
||||
intro: 'REST API を使用し、{% data variables.product.prodname_github_codespaces %} を管理します。'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- API
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: 0108e8ac59714ecea24e1f19d5adf3f2d0371f15
|
||||
ms.sourcegitcommit: 76b840f45ba85fb79a7f0c1eb43bc663b3eadf2b
|
||||
ms.openlocfilehash: 17be7c400c2db08bf55cf23229a9dcb978e01b7f
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/12/2022
|
||||
ms.locfileid: '147110572'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193114'
|
||||
---
|
||||
## Codespaces API について
|
||||
## {% data variables.product.prodname_github_codespaces %} について
|
||||
|
||||
{% data variables.product.prodname_github_codespaces %} API を使用すると、REST API を使用して {% data variables.product.prodname_codespaces %} を管理することができます。 この API は、認証されたユーザー、OAuth Apps に使用できますが、GitHub Apps には使用できません。 詳細については、「[{% data variables.product.prodname_codespaces %}](/codespaces)」を参照してください。
|
||||
REST API を使用して {% data variables.product.prodname_codespaces %} を管理できます。 このエンドポイントは、認証されたユーザー、{% data variables.product.prodname_oauth_apps %}、{% data variables.product.prodname_github_apps %} で使用できます。 詳細については、「[{% data variables.product.prodname_codespaces %}](/codespaces)」を参照してください。
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Codespaces
|
||||
intro: '{% data variables.product.prodname_github_codespaces %} API を使うと、REST API を利用して codespace を管理できます。'
|
||||
intro: 'REST API を使用し、{% data variables.product.prodname_github_codespaces %} を管理します。'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
@@ -16,11 +16,11 @@ children:
|
||||
- /secrets
|
||||
redirect_from:
|
||||
- /rest/reference/codespaces
|
||||
ms.openlocfilehash: c632b85d7e44e225a7dea2669a28a79a220f90a7
|
||||
ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8
|
||||
ms.openlocfilehash: 9e872a046905bde962b2e0fe767534ef51cc3a5e
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/09/2022
|
||||
ms.locfileid: '148160243'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193010'
|
||||
---
|
||||
|
||||
|
||||
@@ -2,22 +2,22 @@
|
||||
title: Codespaces マシン
|
||||
allowTitleToDifferFromFilename: true
|
||||
shortTitle: Machines
|
||||
intro: Codespaces マシン API を使うと、ユーザーは、特定のリポジトリまたは認証済みユーザーとして、codespace の作成に使えるマシン タイプを判断することができます。
|
||||
intro: REST API を使って、codespace 用に使えるマシン タイプを管理できます。
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- API
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: 4ef510cd054696025d885bec854f5360cae17e96
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 5b53ceb3fb7cf137f61285b1f9ed0aa7838a9179
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147067979'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193548'
|
||||
---
|
||||
## Codespaces マシン API について
|
||||
## {% data variables.product.prodname_codespaces %} マシンについて
|
||||
|
||||
Codespaces マシン API を使うと、ユーザーは、特定のリポジトリまたは認証済みユーザーとして、codespace の作成に使えるマシン タイプを判断することができます。 詳細については、「[マシン タイプについて](/codespaces/developing-in-codespaces/changing-the-machine-type-for-your-codespace#about-machine-types)」を参照してください。
|
||||
特定のリポジトリに、または認証済みユーザーとして、codespace の作成に使えるマシン タイプを決めることができます。 詳細については、「[マシン タイプについて](/codespaces/developing-in-codespaces/changing-the-machine-type-for-your-codespace#about-machine-types)」を参照してください。
|
||||
|
||||
また、この情報は、既存の codespace のマシンを、その `machine` プロパティを更新することで変更する場合にも、参照することができます。 マシンの更新は、次回 codepace が起動するときに実行されます。 詳細については、「[codespace に合わせたコンピューターの種類の変更](/codespaces/developing-in-codespaces/changing-the-machine-type-for-your-codespace)」を参照してください。
|
||||
|
||||
@@ -0,0 +1,23 @@
|
||||
---
|
||||
title: Codespaces での Organization のシークレット
|
||||
allowTitleToDifferFromFilename: true
|
||||
shortTitle: Organization secrets
|
||||
intro: 'Organization レベルの {% data variables.product.prodname_codespaces %} シークレットを管理するには、REST API を使います。'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- API
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: 228dc62cdd610737e30fb1627f86047b3f2b5867
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193452'
|
||||
---
|
||||
{% note %}
|
||||
|
||||
**注:** これらのエンドポイントは現在パブリック ベータであり、変更される可能性があります。
|
||||
|
||||
{% endnote %}
|
||||
@@ -2,20 +2,20 @@
|
||||
title: Codespaces Organizations
|
||||
allowTitleToDifferFromFilename: true
|
||||
shortTitle: Organizations
|
||||
intro: Codespaces Organizations API を使用すると、REST API を使って Organization メンバーの Codespaces を管理できます。
|
||||
intro: REST API を使用して、Organization メンバーの codespace を管理します。
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- API
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: 0daf0d24f839c92d8eea6b221346b2df312071cf
|
||||
ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8
|
||||
ms.openlocfilehash: e6c260456a4d34f2de83bf8f936c0789adabd225
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/09/2022
|
||||
ms.locfileid: '148159968'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193090'
|
||||
---
|
||||
## Codespaces Organizations API について
|
||||
## {% data variables.product.prodname_codespaces %} Organization について
|
||||
|
||||
{% data variables.product.prodname_codespaces %} Organizations API を使用すると、REST API を使って Organization に対する {% data variables.product.prodname_codespaces %} の課金を管理することができます。 この API は、認証された Organization 管理者と OAuth Apps に使用できますが、GitHub Apps には使用できません。 詳細については、「[{% data variables.product.prodname_codespaces %}](/codespaces)」を参照してください。
|
||||
Organization に請求される {% data variables.product.prodname_codespaces %} を管理できます。 このエンドポイントは、認証された Organization 管理者と OAuth Apps に使用できますが、GitHub Apps には使用できません。 詳細については、「[{% data variables.product.prodname_codespaces %}](/codespaces)」を参照してください。
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
title: Codespaces リポジトリ シークレット
|
||||
allowTitleToDifferFromFilename: true
|
||||
shortTitle: Repository secrets
|
||||
intro: Codespaces Repository Secrets API を使うと、codespace でユーザーがアクセスできるリポジトリのシークレット (クラウド サービスのアクセス トークンなど) を作成、一覧表示、削除することができます。
|
||||
intro: REST API を使用し、ユーザーが codespace でアクセスできるリポジトリのシークレットを管理します。
|
||||
permissions: 'Users with write access to a repository can manage {% data variables.product.prodname_codespaces %} repository secrets.'
|
||||
versions:
|
||||
fpt: '*'
|
||||
@@ -10,13 +10,13 @@ versions:
|
||||
topics:
|
||||
- API
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: 95b3dfaafef598bf05f55d697716eb1036093697
|
||||
ms.sourcegitcommit: 9490533fcb7b7d5c16f8fea082a06ee66dd5db8f
|
||||
ms.openlocfilehash: f38e196db7ab0601a28612cf13c363f18181342a
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/16/2022
|
||||
ms.locfileid: '148165602'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192730'
|
||||
---
|
||||
## Codespaces リポジトリ シークレット API について
|
||||
## {% data variables.product.prodname_codespaces %} リポジトリ シークレットについて
|
||||
|
||||
Codespaces リポジトリ シークレット API を使用すると、ユーザーがアクセスできるリポジトリのシークレット (クラウド サービスのアクセス トークンなど) を作成、一覧表示、削除することができます。 これらのシークレットは、実行時に codespace で使用できます。 詳細については、「[Codespaces の暗号化されたシークレットを管理する](/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces)」を参照してください。
|
||||
ユーザーがアクセスできるリポジトリのシークレット (クラウド サービスのアクセス トークンなど) を作成、一覧表示、削除できます。 これらのシークレットは、実行時に codespace で使用できます。 詳細については、「[Codespaces の暗号化されたシークレットを管理する](/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces)」を参照してください。
|
||||
|
||||
@@ -2,20 +2,20 @@
|
||||
title: Codespaces ユーザー シークレット
|
||||
allowTitleToDifferFromFilename: true
|
||||
shortTitle: User secrets
|
||||
intro: Codespaces ユーザー シークレット API を使うと、シークレット (クラウド サービスのアクセス トークンなど) を作成、一覧表示、削除することに加え、codespace 内でユーザーがアクセスできるリポジトリにシークレットを割り当てることができます。
|
||||
intro: codespace で、ユーザーがアクセスできる REST API 管理シークレットを使うことができます。
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- API
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: 28588492685865888643b5ed1956b327c9ac838c
|
||||
ms.sourcegitcommit: 80842b4e4c500daa051eff0ccd7cde91c2d4bb36
|
||||
ms.openlocfilehash: 4042f361c8565512518c400a4c5ace7e14a107ab
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/12/2022
|
||||
ms.locfileid: '147067235'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193556'
|
||||
---
|
||||
## Codespaces ユーザー シークレット API について
|
||||
## {% data variables.product.prodname_codespaces %} ユーザー シークレットについて
|
||||
|
||||
Codespaces ユーザー シークレット API を使うと、シークレット (クラウド サービスのアクセス トークンなど) を作成、一覧表示、削除することに加え、ユーザーがアクセスできるリポジトリにシークレットを割り当てることができます。 これらのシークレットは、実行時に codespace で使用できます。 詳細については、「[Codespaces の暗号化されたシークレットを管理する](/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces)」を参照してください。
|
||||
ユーザーがアクセスできるリポジトリにシークレット (クラウド サービスのアクセス トークンなど) を作成、一覧表示、削除したり、シークレットを割り当てることができます。 これらのシークレットは、実行時に codespace で使用できます。 詳細については、「[Codespaces の暗号化されたシークレットを管理する](/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces)」を参照してください。
|
||||
|
||||
@@ -20,6 +20,7 @@ children:
|
||||
- /announcement
|
||||
- /audit-log
|
||||
- /billing
|
||||
- /code-security-and-analysis
|
||||
- /global-webhooks
|
||||
- /ldap
|
||||
- /license
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
title: Git BLOB
|
||||
shortTitle: Blobs
|
||||
allowTitleToDifferFromFilename: true
|
||||
intro: Git BLOB API を使うと、リポジトリ内の各ファイルのコンテンツを格納するために使われるオブジェクトの種類である Git BLOB (バイナリ ラージ オブジェクト) を作成し、取得することができます。
|
||||
intro: REST API を使用し、リポジトリ内の各ファイルのコンテンツを格納するために使われるオブジェクトの種類である Git BLOB (バイナリ ラージ オブジェクト) を操作します。
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -11,14 +11,14 @@ versions:
|
||||
topics:
|
||||
- API
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: 3b7cac6d268fb4c7e786651a7281ca5ce4241ec5
|
||||
ms.sourcegitcommit: cfe91073c844cb762131b2de9fb41f7f9db792fc
|
||||
ms.openlocfilehash: b29c69d2635e20720d23aad62c7aa88984cff984
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/24/2022
|
||||
ms.locfileid: '148181246'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192722'
|
||||
---
|
||||
## Git BLOB API について
|
||||
## Git BLOB について
|
||||
|
||||
Git blob (バイナリラージオブジェクト) は、各ファイルのコンテンツをリポジトリに保存する際に使用されるオブジェクトタイプです。 ファイルの SHA-1 ハッシュが計算され、blob オブジェクトに保存されます。 これらのエンドポイントを使うと、{% data variables.product.product_name %} 上の Git データベースの [BLOB オブジェクト](https://git-scm.com/book/en/v2/Git-Internals-Git-Objects)を読み書きできます。 BLOB では、[これらのカスタム メディアの種類が利用されます](#custom-media-types-for-blobs)。 API でのメディア タイプの使用に関する詳細については、[こちら](/rest/overview/media-types)をお読みください。
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
title: Git のコミット
|
||||
shortTitle: Commits
|
||||
allowTitleToDifferFromFilename: true
|
||||
intro: 'Git コミット API を使うと、{% data variables.product.product_name %} 上の Git データベースとの間でコミット オブジェクトの読み取りと書き込みを行うことができます。'
|
||||
intro: 'REST API を使用し、{% data variables.product.product_name %} で Git データベースのコミット オブジェクトを操作します。'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -11,13 +11,13 @@ versions:
|
||||
topics:
|
||||
- API
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: 2b0f1e07134b67be6c00f8bf1c65d9ccf0c2aac5
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 07813929bac1dc0ff6093b302449f1f7beb905c0
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147063483'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192626'
|
||||
---
|
||||
## Git コミット API について
|
||||
## Git コミットについて
|
||||
|
||||
Git コミットは、階層 ([Git ツリー](/rest/reference/git#trees)) と Git リポジトリ内のファイル ([Git BLOB](/rest/reference/git#blobs)) の内容のスナップショットです。 これらのエンドポイントを使用すると、{% data variables.product.product_name %} 上の Git データベースに[コミット オブジェクト](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Commit-Objects)を読み書きできます。
|
||||
Git コミットは、階層 ([Git ツリー](/rest/reference/git#trees)) と Git リポジトリ内のファイル ([Git BLOB](/rest/reference/git#blobs)) の内容のスナップショットです。 これらのエンドポイントを使用すると、{% data variables.product.product_name %} 上の Git データベースに[コミット オブジェクト](https://git-scm.com/book/en/v2/Git-Internals-Git-Objects#_git_commit_objects)を読み書きできます。
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Git データベース
|
||||
intro: 'Git Database APIを使うと、{% data variables.product.product_name %}上のGitデータベースに対してRaw形式のGitオブジェクトを読み書きしたり、リファレンス (ブランチheadやタグ) をリストおよび更新したりできます。'
|
||||
intro: 'REST API を使って、{% data variables.product.product_name %} 上の Git データベース内にある raw 形式の Git オブジェクトを操作したり、Git リファレンス (ブランチ head やタグ) の一覧表示や更新を行ったりします。'
|
||||
allowTitleToDifferFromFilename: true
|
||||
redirect_from:
|
||||
- /v3/git
|
||||
@@ -19,11 +19,13 @@ children:
|
||||
- /refs
|
||||
- /tags
|
||||
- /trees
|
||||
ms.openlocfilehash: a3f498f0334712d268e80a3d25c9147b62a197da
|
||||
ms.sourcegitcommit: 5f9527483381cfb1e41f2322f67c80554750a47d
|
||||
ms.openlocfilehash: 98251c33c4bf065a3df35dfb014689aae1890e69
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/11/2022
|
||||
ms.locfileid: '147882280'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193604'
|
||||
---
|
||||
Git Database API では、{% data variables.product.product_name %} 上の Git データベースに対して生の Git オブジェクトを読み書きしたり、リファレンス(ブランチ head やタグ)をリストおよび更新したりすることができます。 Git Database API の使用の詳細については、「[Git Database API を使ってみる](/rest/guides/getting-started-with-the-git-database-api)」を参照してください。
|
||||
## Git データベースについて
|
||||
|
||||
REST API を使うと、{% data variables.product.product_name %} 上の Git データベースに対して raw 形式の Git オブジェクトを読み書きしたり、リファレンス (ブランチ head やタグ) の一覧表示や更新を行ったりするためのアクセス権が付与されます。 REST API を使った Git データベースの操作について詳しくは、「[Git Database API を使ってみる](/rest/guides/getting-started-with-the-git-database-api)」をご覧ください。
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
title: Git 参照
|
||||
shortTitle: References
|
||||
intro: 'Git 参照 API を使うと、{% data variables.product.product_name %} 上の Git データベースとの間で参照の読み取りと書き込みを行うことができます。'
|
||||
intro: 'REST API を使用し、{% data variables.product.product_name %} で Git データベースの参照を操作します。'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -11,13 +11,13 @@ topics:
|
||||
- API
|
||||
miniTocMaxHeadingLevel: 3
|
||||
allowTitleToDifferFromFilename: true
|
||||
ms.openlocfilehash: 60f76710e14a754f9508f0919c94b9fbe57d21e1
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: c248685d867fff1835018f0b3021536a8a968168
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147093055'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192898'
|
||||
---
|
||||
## Git 参照 API について
|
||||
## Git 参照について
|
||||
|
||||
Git 参照 (`git ref`) は、Git コミット SHA-1 ハッシュを含むファイルです。 Git コミットを参照するときは、ハッシュではなく、覚えやすい名前の Git 参照を使用できます。 Git 参照は、新しいコミットを指すように書き換えることができます。 ブランチは、新しい Git コミット ハッシュを格納する Git 参照です。 これらのエンドポイントを使用すると、{% data variables.product.product_name %} 上の Git データベースへの[参照](https://git-scm.com/book/en/v1/Git-Internals-Git-References)を読み書きできます。
|
||||
Git 参照 (`git ref`) は、Git コミット SHA-1 ハッシュを含むファイルです。 Git コミットを参照するときは、ハッシュではなく、覚えやすい名前の Git 参照を使用できます。 Git 参照は、新しいコミットを指すように書き換えることができます。 ブランチは、新しい Git コミット ハッシュを格納する Git 参照です。 これらのエンドポイントを使用すると、{% data variables.product.product_name %} 上の Git データベースへの[参照](https://git-scm.com/book/en/v2/Git-Internals-Git-References)を読み書きできます。
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
title: Git タグ
|
||||
shortTitle: Tags
|
||||
allowTitleToDifferFromFilename: true
|
||||
intro: 'Git タグ API を使うと、{% data variables.product.product_name %} 上の Git データベースでタグ オブジェクトの読み取りと書き込みを行うことができます。'
|
||||
intro: 'REST API を使用し、{% data variables.product.product_name %} で Git データベースのタグ オブジェクトを操作します。'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -11,13 +11,13 @@ versions:
|
||||
topics:
|
||||
- API
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: d0ba994be564467d3b84744e6618417b927828aa
|
||||
ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d
|
||||
ms.openlocfilehash: 0d0a10afabf100cb34a0061585b87b17d5afc416
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/10/2022
|
||||
ms.locfileid: '145131400'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192890'
|
||||
---
|
||||
## Git タグ API について
|
||||
## Git タグについて
|
||||
|
||||
Git タグは [Git リファレンス](/rest/reference/git#refs)に似ていますが、これがポイントする Git コミットが変更されることはありません。 Git タグは、特定のリリースを指すときに役立ちます。 これらのエンドポイントを使用すると、{% data variables.product.product_name %} 上の Git データベースに[タグ オブジェクト](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags)を読み書きできます。 Git タグ API では、軽量タグではなく、[注釈付きタグ オブジェクト](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags)のみをサポートします。
|
||||
Git タグは [Git リファレンス](/rest/reference/git#refs)に似ていますが、これがポイントする Git コミットが変更されることはありません。 Git タグは、特定のリリースを指すときに役立ちます。 これらのエンドポイントを使用すると、{% data variables.product.product_name %} 上の Git データベースに[タグ オブジェクト](https://git-scm.com/book/en/v2/Git-Internals-Git-References#_tags)を読み書きできます。 この API では、軽量タグではなく、[注釈付きタグ オブジェクト](https://git-scm.com/book/en/v2/Git-Internals-Git-References#_tags)のみをサポートします。
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
title: Git ツリー
|
||||
shortTitle: Trees
|
||||
allowTitleToDifferFromFilename: true
|
||||
intro: 'Git trees API を使うと、{% data variables.product.product_name %} 上の Git データベースでツリー オブジェクトの読み取りと書き込みを行うことができます。'
|
||||
intro: 'REST API を使用し、{% data variables.product.product_name %} で Git データベースのツリー オブジェクトを操作します。'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -11,13 +11,13 @@ versions:
|
||||
topics:
|
||||
- API
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: 8c13e6c74f334152d67433ab9a90f7dac663b3d6
|
||||
ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d
|
||||
ms.openlocfilehash: ecd3781bbc78fff8b2d75f25b16d303081a7d605
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/11/2022
|
||||
ms.locfileid: '147884470'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193050'
|
||||
---
|
||||
## Git ツリー API について
|
||||
## Git ツリーについて
|
||||
|
||||
Git ツリーオブジェクトは、Git リポジトリ内のファイル間の階層を作成します。 Git ツリーオブジェクトを使用して、ディレクトリとそこに含まれるファイルの関係を作成できます。 これらのエンドポイントを使用すると、{% data variables.product.product_name %} 上の Git データベースに[ツリー オブジェクト](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Tree-Objects)を読み書きできます。
|
||||
Git ツリーオブジェクトは、Git リポジトリ内のファイル間の階層を作成します。 Git ツリーオブジェクトを使用して、ディレクトリとそこに含まれるファイルの関係を作成できます。 これらのエンドポイントを使用すると、{% data variables.product.product_name %} 上の Git データベースに[ツリー オブジェクト](https://git-scm.com/book/en/v2/Git-Internals-Git-Objects#_tree_objects)を読み書きできます。
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Gitignore
|
||||
intro: Gitignore API では、ファイルやディレクトリを無視するために利用できる `.gitignore` テンプレートをフェッチします。
|
||||
intro: REST API を使用して、ファイルとディレクトリを無視するために使用できる `.gitignore` テンプレートを取得します。
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -11,21 +11,15 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
redirect_from:
|
||||
- /rest/reference/gitignore
|
||||
ms.openlocfilehash: e830b0f00d60f3eb121fa2a99a910b073780700e
|
||||
ms.sourcegitcommit: cfe91073c844cb762131b2de9fb41f7f9db792fc
|
||||
ms.openlocfilehash: a3d6d35014a0c6bc46102fa7abfa11659fff6fbf
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/24/2022
|
||||
ms.locfileid: '148181269'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193042'
|
||||
---
|
||||
## Gitignore API について
|
||||
## gitignore について
|
||||
|
||||
この API を使って {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %} に新しいリポジトリを作成する場合、作成時にリポジトリに適用する [.gitignore テンプレート](/github/getting-started-with-github/ignoring-files)を指定できます。 .gitignore テンプレート API では、{% data variables.product.product_name %} [.gitignore リポジトリ](https://github.com/github/gitignore)からテンプレートを列挙およびフェッチします。
|
||||
この API を使って {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %} に新しいリポジトリを作成する場合、作成時にリポジトリに適用する [.gitignore テンプレート](/github/getting-started-with-github/ignoring-files)を指定できます。 REST API を使って、{% data variables.product.product_name %} [.gitignore リポジトリ](https://github.com/github/gitignore)から .gitignore テンプレートを取得できます。
|
||||
|
||||
### gitignore のカスタムメディアタイプ
|
||||
|
||||
gitignore テンプレートを取得するときに、このカスタムメディアタイプを使用できます。
|
||||
|
||||
application/vnd.github.raw
|
||||
|
||||
詳細については、「[メディア タイプ](/rest/overview/media-types)」を参照してください。
|
||||
gitignore テンプレートを取得するときに、この `application/vnd.github.raw` カスタム メディア タイプを使用できます。 詳細については、「[メディア タイプ](/rest/overview/media-types)」を参照してください。
|
||||
|
||||
@@ -12,12 +12,12 @@ versions:
|
||||
topics:
|
||||
- API
|
||||
shortTitle: Integrator best practices
|
||||
ms.openlocfilehash: 76e0a405394529bb8b40b0a0af10d5e19fbbf3a5
|
||||
ms.sourcegitcommit: 5f9527483381cfb1e41f2322f67c80554750a47d
|
||||
ms.openlocfilehash: bdfc2449946e40b017dc028869deb7991d5a344a
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/11/2022
|
||||
ms.locfileid: '147882272'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193524'
|
||||
---
|
||||
GitHubプラットフォームとの統合に興味はありますか。 [あなたには良い仲間がいます](https://github.com/integrations)。 このガイドは、ユーザーに最適なエクスペリエンスを提供するアプリを構築 *し、* API と確実に対話できるようにするのに役立ちます。
|
||||
|
||||
@@ -65,7 +65,7 @@ APIレスポンスには、URLの形でデータが含まれていることが
|
||||
|
||||
アプリケーションの安定性を保つため、このデータをパースしようとしたり、先のURLの形式を予想して作成しようとしたりしないでください。 URLを変更した場合、アプリケーションが壊れるおそれがあります。
|
||||
|
||||
たとえば、ページネーションされた結果を処理するときは、末尾に `?page=<number>` の付いた URL を構築したいことがよくあります。 この誘惑に負けてはなりません。 [ページネーションに関するガイド](/guides/traversing-with-pagination)では、ページネーションされた結果を安全に扱うための信頼できるヒントがいくつか提供されています。
|
||||
たとえば、ページネーションされた結果を処理するときは、末尾に `?page=<number>` の付いた URL を構築したいことがよくあります。 この誘惑に負けてはなりません。 ページネーションされた結果を確実にフォローする方法について詳しくは、[REST API でページネーションを使うこと](/rest/guides/using-pagination-in-the-rest-api)に関する説明をご覧ください。
|
||||
|
||||
## イベントの処理前にイベントのタイプとアクションを確認する
|
||||
|
||||
|
||||
@@ -12,12 +12,12 @@ versions:
|
||||
topics:
|
||||
- API
|
||||
shortTitle: Discover resources for a user
|
||||
ms.openlocfilehash: 9650ff8dee220f0b32d74cacb0f86acd236df5b6
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 3b3fd627260ac03d0991db73fcb5492c1284b2c0
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '145131365'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193420'
|
||||
---
|
||||
{% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} APIに対して認証済みのリクエストを行う際には、アプリケーションがカレントユーザのリポジトリやOrganizationをフェッチしなければならないことがしばしばあります。 このガイドでは、これらのリソースを確実に調べる方法について説明します。
|
||||
|
||||
@@ -33,7 +33,7 @@ ms.locfileid: '145131365'
|
||||
|
||||
[OAuth スコープ][scopes]と [Organization のアプリケーション ポリシー][oap]によって、アプリでユーザーに対してアクセスできるリポジトリが決まります。 以下のワークフローを使用して、これらのリポジトリを調べます。
|
||||
|
||||
いつものように、まずは [GitHub の Octokit.rb][octokit.rb] Ruby ライブラリが必要です。 そして、[ページネーション][pagination]を自動的に処理するように Octokit.rb を構成します。
|
||||
いつものように、まずは [GitHub の Octokit.rb][octokit.rb] Ruby ライブラリが必要です。 そして、ページネーションを自動的に処理するように Octokit.rb を構成します。 ページネーションについて詳しくは、「[REST API でページネーションを使う](/rest/guides/using-pagination-in-the-rest-api)」をご覧ください。
|
||||
|
||||
``` ruby
|
||||
require 'octokit'
|
||||
@@ -70,7 +70,7 @@ end
|
||||
|
||||
アプリケーションは、ユーザに対してOrganizationに関するあらゆるタスクを実行できます。 これらのタスクを実行するには、アプリに十分な権限を持つ [OAuth 承認][scopes]が必要です。 たとえば、`read:org` スコープを使うと[チームの一覧を表示する][list-teams]ことができ、`user` スコープでは[ユーザーの Organization メンバーシップを公開する][publicize-membership]ことができます。 ユーザがこれらのスコープのうちの1つ以上をアプリケーションに付与すると、ユーザのOrganizationをフェッチする準備が整います。
|
||||
|
||||
上でリポジトリを調べたときと同様に、まずは [GitHub の Octokit.rb][octokit.rb] Ruby ライブラリを要求し、[ページネーション][pagination]を自動的に処理するように構成します。
|
||||
上でリポジトリを調べたときと同様に、まずは [GitHub の Octokit.rb][octokit.rb] Ruby ライブラリを要求し、ページネーションを自動的に処理するように構成します。 ページネーションについて詳しくは、「[REST API でページネーションを使う](/rest/guides/using-pagination-in-the-rest-api)」をご覧ください。
|
||||
|
||||
``` ruby
|
||||
require 'octokit'
|
||||
@@ -108,7 +108,6 @@ end
|
||||
[make-authenticated-request-for-user]: /rest/guides/basics-of-authentication#making-authenticated-requests
|
||||
[oap]: https://developer.github.com/changes/2015-01-19-an-integrators-guide-to-organization-application-policies/
|
||||
[octokit.rb]: https://github.com/octokit/octokit.rb
|
||||
[pagination]: /rest#pagination
|
||||
[platform samples]: https://github.com/github/platform-samples/tree/master/api/ruby/discovering-resources-for-a-user
|
||||
[publicize-membership]: /rest/reference/orgs#set-public-organization-membership-for-the-authenticated-user
|
||||
[register-oauth-app]: /rest/guides/basics-of-authentication#registering-your-app
|
||||
|
||||
@@ -0,0 +1,185 @@
|
||||
---
|
||||
title: REST API 内での改ページ位置の自動修正の使用
|
||||
intro: REST API からページ分割された応答間を移動する方法について説明します。
|
||||
redirect_from:
|
||||
- /guides/traversing-with-pagination
|
||||
- /v3/guides/traversing-with-pagination
|
||||
- /rest/guides/traversing-with-pagination
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- API
|
||||
shortTitle: Pagination
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: 3a47974e431b227a225584ff6d3cd65f21a1ab9a
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193444'
|
||||
---
|
||||
## 改ページ位置の自動修正について
|
||||
|
||||
REST API からの応答にたくさんの結果が含まれるとき、{% data variables.product.company_short %} では結果のページが分割され、結果のサブセットが返されます。 たとえば、`GET /repos/octocat/Spoon-Knife/issues` は、リポジトリに 1600 を超える未解決の issue が含まれている場合でも、`octocat/Spoon-Knife` リポジトリから 30 の issue のみを返します。 これにより、サーバーとユーザーに対して、応答の処理が簡単になります。
|
||||
|
||||
このガイドでは、ページ分割された応答に結果の追加ページを要求する方法、各ページで返される結果の数を変更する方法、および複数の結果ページをフェッチするスクリプトを記述する方法を示します。
|
||||
|
||||
## リンク ヘッダーの使用
|
||||
|
||||
応答がページ分割される場合、応答ヘッダーにはリンク ヘッダーが含まれます。 エンドポイントが改ページ位置の自動修正をサポートしていない場合、またはすべての結果が 1 つのページに収まる場合、リンク ヘッダーは省略されます。 リンク ヘッダーには、結果の追加ページをフェッチするために使用できる URL が含まれています。 curl または {% data variables.product.prodname_cli %} を使用している場合に応答ヘッダーを表示するには、要求に `--include` フラグを渡します。 ライブラリを使用して要求を行っている場合に応答ヘッダーを表示するには、そのライブラリのドキュメントに従います。 たとえば、次のように入力します。
|
||||
|
||||
```shell
|
||||
curl --include --request GET \
|
||||
--url "https://api.github.com/repos/octocat/Spoon-Knife/issues" \
|
||||
--header "Accept: application/vnd.github+json"
|
||||
```
|
||||
|
||||
応答がページ分割されている場合、リンク ヘッダーは次のようになります。
|
||||
|
||||
```
|
||||
link: <https://api.github.com/repositories/1300192/issues?page=2>; rel="prev", <https://api.github.com/repositories/1300192/issues?page=4>; rel="next", <https://api.github.com/repositories/1300192/issues?page=515>; rel="last", <https://api.github.com/repositories/1300192/issues?page=1>; rel="first"
|
||||
```
|
||||
|
||||
リンク ヘッダーでは、結果の前、次、最初、最後のページの URL が次のように提供されます。
|
||||
|
||||
- 前のページの URL の後には `rel="prev"` が続きます。
|
||||
- 次のページの URL の後には `rel="next"` が続きます。
|
||||
- 最後のページの URL の後には `rel="last"` が続きます。
|
||||
- 最初のページの URL の後には `rel="first"` が続きます。
|
||||
|
||||
場合によっては、これらのリンクのサブセットのみが使用できます。 たとえば、結果の最初のページにいる場合、前のページへのリンクは含まれません。また、最後のページへのリンクが計算できない場合、それは含まれません。
|
||||
|
||||
リンク ヘッダーの URL を使用して、結果の別のページを要求できます。 たとえば、前の例に基づいて結果の最後のページを要求するには、次のようにします。
|
||||
|
||||
```shell
|
||||
curl --include --request GET \
|
||||
--url "https://api.github.com/repositories/1300192/issues?page=515" \
|
||||
--header "Accept: application/vnd.github+json"
|
||||
```
|
||||
|
||||
リンク ヘッダーの URL は、クエリ パラメーターを使用して、どのページの結果を返すかを示します。 リンク URL のクエリ パラメーターは、エンドポイントによって異なる場合があります。ページ分割された各エンドポイントでは、`page`、`before`/`after`、または `since` クエリ パラメーターが使用されます。 (一部のエンドポイントでは、改ページ位置の自動修正以外のものに対しては `since` パラメーターが使用されます)。いずれの場合も、リンク ヘッダーの URL を使用して、結果の追加ページをフェッチできます。 クエリ パラメーターについて詳しくは、「[REST API を使用した作業の開始](/rest/guides/getting-started-with-the-rest-api#using-query-parameters)」を参照してください。
|
||||
|
||||
## ページごとのアイテム数の変更
|
||||
|
||||
`per_page` クエリ パラメーターがエンドポイントでサポートされる場合、1 ページで返される結果の数を制御できます。 クエリ パラメーターについて詳しくは、「[REST API を使用した作業の開始](/rest/guides/getting-started-with-the-rest-api#using-query-parameters)」を参照してください。
|
||||
|
||||
たとえば、この要求では、`per_page` クエリ パラメーターを使用してページごとに 2 つのアイテムを返します。
|
||||
|
||||
```shell
|
||||
curl --include --request GET \
|
||||
--url "https://api.github.com/repos/octocat/Spoon-Knife/issues?per_page=2" \
|
||||
--header "Accept: application/vnd.github+json"
|
||||
```
|
||||
|
||||
`per_page` パラメーターはリンク ヘッダーに自動的に含まれます。 たとえば、次のように入力します。
|
||||
|
||||
```
|
||||
link: <https://api.github.com/repositories/1300192/issues?per_page=2&page=2>; rel="next", <https://api.github.com/repositories/1300192/issues?per_page=2&page=7715>; rel="last"
|
||||
```
|
||||
|
||||
## 改ページ位置の自動修正を含むスクリプトの作成
|
||||
|
||||
リンク ヘッダーから URL を手動でコピーする代わりに、複数のページの結果をフェッチするスクリプトを記述できます。
|
||||
|
||||
次の例では、JavaScript と {% data variables.product.company_short %} の Octokit.js ライブラリを使用します。 Octokit.js について詳しくは、「[REST API を使用した作業の開始](/rest/guides/getting-started-with-the-rest-api?tool=javascript)」と [Octokit.js の README](https://github.com/octokit/octokit.js/#readme) を参照してください。
|
||||
|
||||
### Octokit.js の改ページ位置の自動修正メソッドの使用例
|
||||
|
||||
Octokit.js を使用してページ分割された結果をフェッチするには、`octokit.paginate()` を使用できます。 `octokit.paginate()` は、最後のページに達するまで結果の次のページをフェッチし、すべての結果を 1 つの配列として返します。 いくつかのエンドポイントは、ページ分割された結果を配列として返すのではなく、ページ分割された結果をオブジェクト内の配列として返します。 生の結果がオブジェクトであっても、`octokit.paginate()` は常にアイテムの配列を返します。 結果がページ分割されていない場合、`octokit.paginate()` は `octokit.request()` のように動作します。
|
||||
|
||||
たとえば、このスクリプトは`octocat/Spoon-Knife` リポジトリからすべての issue を取得します。 一度に 100 の issue が要求されますが、データの最後のページに達するまで関数は返されません。
|
||||
|
||||
```javascript{:copy}
|
||||
import { Octokit } from "octokit";
|
||||
|
||||
const octokit = new Octokit({ {% ifversion ghes or ghae %}
|
||||
baseUrl: "{% data variables.product.api_url_code %}",
|
||||
{% endif %}});
|
||||
|
||||
const data = await octokit.paginate("GET /repos/{owner}/{repo}/issues", {
|
||||
owner: "octocat",
|
||||
repo: "Spoon-Knife",
|
||||
per_page: 100,{% ifversion api-date-versioning %}
|
||||
headers: {
|
||||
"X-GitHub-Api-Version": "{{ allVersions[currentVersion].latestApiVersion }}",
|
||||
},{% endif %}
|
||||
});
|
||||
|
||||
console.log(data)
|
||||
```
|
||||
|
||||
省略可能な map 関数を `octokit.paginate()` に渡して最後のページに達する前に改ページ位置の自動修正を終了するか、応答のサブセットのみを保持することでメモリ使用量を削減できます。 `octokit.paginate.iterator()` を使用して、すべてのページを要求するのではなく、一度に 1 つのページを反復処理することもできます。 詳しくは、[Octokit.js のドキュメント](https://github.com/octokit/octokit.js#pagination)を参照してください。
|
||||
|
||||
### 改ページ位置の自動修正メソッドの作成例
|
||||
|
||||
改ページ位置の自動修正メソッドがない別の言語またはライブラリを使用している場合は、独自の改ページ位置の自動修正メソッドを作成できます。 この例では、引き続き Octokit.js ライブラリを使用して要求を行いますが、`octokit.paginate()` には依存しません。
|
||||
|
||||
`getPaginatedData` 関数は、`octokit.request()` を使用してエンドポイントに要求を行います。 応答からのデータは `parseData` によって処理されます。この場合、データが返されないケースや、返されるデータが配列ではなくオブジェクトであるケースが処理されます。 処理されたデータはその後、これまでに収集された、ページ分割されたすべてのデータを含むリストに追加されます。 応答にリンク ヘッダーが含まれており、リンク ヘッダーに次のページのリンクが含まれている場合、関数は RegEx パターン (`nextPattern`) を使用して次のページの URL を取得します。 関数は、今度はこの新しい URL を使用して、前のステップを繰り返します。 リンク ヘッダーに次のページへのリンクが含まれなくなると、すべての結果が返されます。
|
||||
|
||||
```javascript{:copy}
|
||||
import { Octokit } from "octokit";
|
||||
|
||||
const octokit = new Octokit({ {% ifversion ghes or ghae %}
|
||||
baseUrl: "{% data variables.product.api_url_code %}",
|
||||
{% endif %}});
|
||||
|
||||
async function getPaginatedData(url) {
|
||||
const nextPattern = /(?<=<)([\S]*)(?=>; rel="Next")/i;
|
||||
let pagesRemaining = true;
|
||||
let data = [];
|
||||
|
||||
while (pagesRemaining) {
|
||||
const response = await octokit.request(`GET ${url}`, {
|
||||
per_page: 100,{% ifversion api-date-versioning %}
|
||||
headers: {
|
||||
"X-GitHub-Api-Version":
|
||||
"{{ allVersions[currentVersion].latestApiVersion }}",
|
||||
},{% endif %}
|
||||
});
|
||||
|
||||
const parsedData = parseData(response.data)
|
||||
data = [...data, ...parsedData];
|
||||
|
||||
const linkHeader = response.headers.link;
|
||||
|
||||
pagesRemaining = linkHeader && linkHeader.includes(`rel=\"next\"`);
|
||||
|
||||
if (pagesRemaining) {
|
||||
url = linkHeader.match(nextPattern)[0];
|
||||
}
|
||||
}
|
||||
|
||||
return data;
|
||||
}
|
||||
|
||||
function parseData(data) {
|
||||
// If the data is an array, return that
|
||||
if (Array.isArray(data)) {
|
||||
return data
|
||||
}
|
||||
|
||||
// Some endpoints respond with 204 No Content instead of empty array
|
||||
// when there is no data. In that case, return an empty array.
|
||||
if (!data) {
|
||||
return []
|
||||
}
|
||||
|
||||
// Otherwise, the array of items that we want is in an object
|
||||
// Delete keys that don't include the array of items
|
||||
delete data.incomplete_results;
|
||||
delete data.repository_selection;
|
||||
delete data.total_count;
|
||||
// Pull out the array of items
|
||||
const namespaceKey = Object.keys(data)[0];
|
||||
data = data[namespaceKey];
|
||||
|
||||
return data;
|
||||
}
|
||||
|
||||
const data = await getPaginatedData("/repos/octocat/Spoon-Knife/issues");
|
||||
|
||||
console.log(data);
|
||||
```
|
||||
@@ -4,12 +4,12 @@ shortTitle: API Versions
|
||||
intro: REST API に対して要求を行う場合は、必ず使用する REST API バージョンを指定する必要があります。
|
||||
versions:
|
||||
feature: api-date-versioning
|
||||
ms.openlocfilehash: c1209120fab4c4cc26962991ad48b76638627db5
|
||||
ms.sourcegitcommit: d2f0b59ed096b9e68ef8f6fa019cd925165762ec
|
||||
ms.openlocfilehash: 6689d8c342930a44c7d243c3872cdc431007eb1c
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/29/2022
|
||||
ms.locfileid: '148184403'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192866'
|
||||
---
|
||||
## API のバージョン管理について
|
||||
|
||||
@@ -51,4 +51,4 @@ $ curl {% data reusables.rest-api.version-header %} https://api.github.com/zen
|
||||
|
||||
{% for apiVersion in allVersions[currentVersion].apiVersions %} {{ apiVersion }} {% endfor %}
|
||||
|
||||
API 要求を実行し、サポートされているすべての API バージョンを取得することもできます。 詳しくは、「[すべての API バージョンを取得する](/rest/meta#get-all-api-versions)」を参照してください。
|
||||
API 要求を行い、サポートされているすべての API バージョンを取得することもできます。 詳しくは、「[すべての API バージョンを取得する](/rest/meta#get-all-api-versions)」を参照してください。
|
||||
|
||||
@@ -11,12 +11,12 @@ versions:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
topics:
|
||||
- API
|
||||
ms.openlocfilehash: 4fd3e2aad72ee0ffc4778a86dc99cd5bb6f9d2c5
|
||||
ms.sourcegitcommit: 4daa156856e651cb3854ead40e35bd918e481ad6
|
||||
ms.openlocfilehash: c7928ce90b887d6fa3bd5342fc1633b3e30983f1
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/02/2022
|
||||
ms.locfileid: '148190400'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192850'
|
||||
---
|
||||
{% ifversion api-date-versioning %}
|
||||
## API バージョン
|
||||
@@ -273,50 +273,7 @@ REST API を使用して `node_id` を検索し、GraphQL 演算で使用する
|
||||
|
||||
## 改ページ位置の自動修正
|
||||
|
||||
複数の項目を返す要求は、既定では 30 項目ごとにページ分けされます。 `page` パラメーターを使用すると、さらにページを指定できます。 一部のリソースでは、`per_page` パラメーターを使用してカスタム ページ サイズを最大 100 に設定することもできます。
|
||||
技術的な理由から、すべてのエンドポイントで `per_page` パラメーターが考慮されるわけではないことに注意してください。たとえば、[イベント](/rest/reference/activity#events)を参照してください。
|
||||
|
||||
```shell
|
||||
$ curl '{% data variables.product.api_url_pre %}/user/repos?page=2&per_page=100'
|
||||
```
|
||||
|
||||
ページ番号は 1 から始まり、`page` パラメーターを省略すると最初のページが返されることに注意してください。
|
||||
|
||||
カーソルベースのページネーションを使用するエンドポイントもあります。 カーソルとは、結果セットで場所を示す文字列です。
|
||||
カーソルベースのページネーションでは、結果セットで「ページ」という概念がなくなるため、特定のページに移動することはできません。
|
||||
代わりに、`before` パラメーターまたは `after` パラメーターを使用して結果を走査できます。
|
||||
|
||||
改ページ位置の詳細については、「[改ページ位置を使用した走査][pagination-guide]」に関するガイドを参照してください。
|
||||
|
||||
### リンクヘッダ
|
||||
|
||||
{% note %}
|
||||
|
||||
**注**: 独自の URL を作成するのではなく、Link ヘッダー値を使用して呼び出しを形成することが重要です。
|
||||
|
||||
{% endnote %}
|
||||
|
||||
[Link ヘッダー](https://datatracker.ietf.org/doc/html/rfc5988)には、改ページ位置の情報が含まれています。 次に例を示します。
|
||||
|
||||
Link: <{% data variables.product.api_url_code %}/user/repos?page=3&per_page=100>; rel="next",
|
||||
<{% data variables.product.api_url_code %}/user/repos?page=50&per_page=100>; rel="last"
|
||||
|
||||
_この例は、読みやすいように改行されています。_
|
||||
|
||||
エンドポイントでカーソルベースのページネーションを使用する場合:
|
||||
|
||||
Link: <{% data variables.product.api_url_code %}/orgs/ORG/audit-log?after=MTYwMTkxOTU5NjQxM3xZbGI4VE5EZ1dvZTlla09uWjhoZFpR&before=>; rel="next",
|
||||
|
||||
この `Link` 応答ヘッダーには 1 つ以上の [Hypermedia](/rest#hypermedia) リンク関係が含まれており、その一部は [URI テンプレート](https://datatracker.ietf.org/doc/html/rfc6570)として展開が必要な場合があります。
|
||||
|
||||
取りうる可能性のある `rel` の値は次のようになります。
|
||||
|
||||
名前 | 説明
|
||||
-----------|-----------|
|
||||
`next` |結果のすぐ次のページのリンク関係。
|
||||
`last` |結果の最後のページのリンク関係。
|
||||
`first` |結果の最初のページのリンク関係。
|
||||
`prev` |結果の直前のページのリンク関係。
|
||||
REST API からの応答にたくさんの結果が含まれるとき、{% data variables.product.company_short %} ではページが分割され、結果のサブセットが返されます。 応答のリンク ヘッダーを利用し、データの追加ページを要求できます。 `per_page` クエリ パラメーターがエンドポイントでサポートされる場合、1 ページで返される結果の数を制御できます。 ページネーションの詳細については、「[REST API でページネーションを使用する](/rest/guides/using-pagination-in-the-rest-api)」を参照してください。
|
||||
|
||||
## Timeouts
|
||||
|
||||
@@ -672,5 +629,3 @@ $ curl -H "Time-Zone: Europe/Amsterdam" -X POST {% data variables.product.api_ur
|
||||
### 他のタイムゾーン情報を含まない UTC をデフォルトにする
|
||||
|
||||
上記の手順で情報が得られない場合は、UTC をタイムゾーンとして使用して git コミットを作成します。
|
||||
|
||||
[pagination-guide]: /guides/traversing-with-pagination
|
||||
|
||||
@@ -10,12 +10,12 @@ versions:
|
||||
ghec: '*'
|
||||
topics:
|
||||
- API
|
||||
ms.openlocfilehash: ecfa3a360ef9b042d96a1f80a2f0cde49390727f
|
||||
ms.sourcegitcommit: d2f0b59ed096b9e68ef8f6fa019cd925165762ec
|
||||
ms.openlocfilehash: c696f18d89ffe7d9c9c7c13eda933285502132ae
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/29/2022
|
||||
ms.locfileid: '148184234'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192834'
|
||||
---
|
||||
API で不可解な問題が発生した場合、発生したと思われる問題の解決策をこちらの一覧から確認できます。
|
||||
|
||||
@@ -46,7 +46,7 @@ $ curl {% data reusables.rest-api.version-header %} https://api.github.com/zen
|
||||
|
||||
リソースの一 _覧 (ユーザー_、問題 _など_) にアクセスするほとんどの API 呼び出しでは、改ページ処理がサポートされます。 要求したがすべての結果を受け取っていない場合は、おそらく最初のページしか表示されていません。 より多くの結果を受け取るには、残りのページを要求する必要があります。
|
||||
|
||||
改ページ URL の形式を推測 *しないように* することが重要です。 すべての API 呼び出しで同じ構造が使用されるわけではありません。 代わりに、すべての要求で送信される [Link Header](/rest#pagination) からページネーション情報を抽出します。
|
||||
改ページ URL の形式を推測 *しないように* することが重要です。 すべての API 呼び出しで同じ構造が使用されるわけではありません。 代わりに、すべての要求で返されるリンク ヘッダーからページネーション情報を抽出します。 ページネーションの詳細については、「[REST API でページネーションを使用する](/rest/guides/using-pagination-in-the-rest-api)」を参照してください。
|
||||
|
||||
[oap-guide]: https://developer.github.com/changes/2015-01-19-an-integrators-guide-to-organization-application-policies/
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: パッケージ
|
||||
intro: '{% data variables.product.prodname_registry %} APIを使うと、{% data variables.product.prodname_dotcom %}の自分のリポジトリとOrganizationのパッケージの管理ができます。'
|
||||
intro: 'REST API を使用して {% data variables.product.prodname_registry %} を操作します。'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
@@ -9,22 +9,22 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
redirect_from:
|
||||
- /rest/reference/packages
|
||||
ms.openlocfilehash: 5edb7e30b296626a53fdc41806bcfba88718e6b3
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: a40709d8c51e445fb815c78eadbdb7886b5d60db
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147059923'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192826'
|
||||
---
|
||||
## {% data variables.product.prodname_registry %} API について
|
||||
## {% data variables.product.prodname_registry %} について
|
||||
|
||||
{% data variables.product.prodname_registry %} APIでは、REST APIを使ってパッケージを管理できます。 パッケージの復元または削除の詳細については、「[パッケージの復元と削除](/packages/learn-github-packages/deleting-and-restoring-a-package)」を参照してください
|
||||
REST API を使用して {% data variables.product.prodname_dotcom %} リポジトリと組織のパッケージを管理できます。 詳しくは、「[パッケージの復元と削除](/packages/learn-github-packages/deleting-and-restoring-a-package)」をご覧ください。
|
||||
|
||||
このAPIを使うには、個人アクセストークンを使って認証を受けなければなりません。
|
||||
REST API を使用して {% data variables.product.prodname_registry %} を管理するには、{% data variables.product.pat_v1 %} を使用して認証する必要があります。
|
||||
- パッケージのメタデータにアクセスするには、トークンに `read:packages` のスコープを含める必要があります。
|
||||
- パッケージとパッケージのバージョンを削除するには、トークンに `read:packages` と `delete:packages` のスコープを含める必要があります。
|
||||
- パッケージとパッケージのバージョンを復元するには、トークンに `read:packages` と `write:packages` のスコープを含める必要があります。
|
||||
|
||||
`package_type` が `npm`、`maven`、`rubygems` または `nuget` の場合、パッケージは {% data variables.product.prodname_dotcom %} リポジトリからアクセス許可を継承するため、トークンに `repo` のスコープも含める必要があります。 パッケージが {% data variables.product.prodname_container_registry %} 内にある場合は、`package_type` は `container` になり、トークンでこの `package_type` へのアクセスまたは管理に `repo` のスコープは必要ありません。 `container` パッケージには、リポジトリとは別の細かいアクセス許可が用意されています。 詳細については、「[{% data variables.product.prodname_registry %} のアクセス許可について](/packages/learn-github-packages/about-permissions-for-github-packages#about-scopes-and-permissions-for-package-registries)」を参照してください。
|
||||
細かなアクセス許可がサポートされているレジストリにパッケージが置かれている場合、トークンに `repo` 範囲がなくてもそのパッケージにアクセスしたり、管理したりできます。 リポジトリを範囲とするアクセス許可のみをサポートしているレジストリにパッケージが置かれている場合、トークンには `repo` 範囲も含まれている必要があります。パッケージは {% data variables.product.prodname_dotcom %} リポジトリからアクセス許可を継承するためです。 リポジトリを範囲とするアクセス許可のみをサポートするレジストリの一覧については、「[{% data variables.product.prodname_registry %} のアクセス許可について](/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages)」を参照してください。
|
||||
|
||||
SSOが有効化されたOrganization内のリソースにアクセスするために{% data variables.product.prodname_registry %} APIを使いたい場合は、個人アクセストークンにSSOを有効化しなければなりません。 詳細については、{% data variables.product.prodname_ghe_cloud %} ドキュメントの「[Authorizing a personal access token for use with SAML single sign-on](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on){% ifversion fpt %}」 (SAML シングル サインオンで使用する個人用アクセス トークンの認証) を参照してください。{% else %}."{% endif %}
|
||||
SSO が有効になっている組織のリソースにアクセスするには、{% data variables.product.pat_v1 %} の SSO を有効にする必要があります。 詳しい情報については、{% data variables.product.prodname_ghe_cloud %} ドキュメント内の「[SAML シングル サインオンで使用するために {% data variables.product.pat_generic %} を承認する](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on){% ifversion fpt %}」を参照してください{% else %}。{% endif %}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: ページ
|
||||
intro: GitHub Pages APIを使うと、GitHub Pagesのサイトとビルド情報の操作ができます。
|
||||
intro: 'REST API を使って、{% data variables.product.prodname_pages %} サイトやビルドを操作できます。'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -11,11 +11,11 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
redirect_from:
|
||||
- /rest/reference/pages
|
||||
ms.openlocfilehash: 6a4902cb0b0a5fd8bfa319cb0385df1d2de64346
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 9ae93ad1bbf96c4219c834a32a3e66c96a732565
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147064211'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193508'
|
||||
---
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
title: '{% data variables.product.prodname_project_v1_caps %} cards'
|
||||
shortTitle: Cards
|
||||
allowTitleToDifferFromFilename: true
|
||||
intro: '{% data variables.product.prodname_project_v1 %} cards API を使用すると、{% data variables.projects.projects_v1_board %} でカードを作成および管理できます。'
|
||||
intro: 'REST API を使って、{% data variables.projects.projects_v1_board %} でカードを作成し、管理できます。'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -11,11 +11,13 @@ versions:
|
||||
topics:
|
||||
- API
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: 5e923c48ae6b5026ad5eaf518320e33f477e1926
|
||||
ms.sourcegitcommit: fb047f9450b41b24afc43d9512a5db2a2b750a2a
|
||||
ms.openlocfilehash: 92e3e1c003656ce8a11dc5de4285336bb0331f7c
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/11/2022
|
||||
ms.locfileid: '147881869'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193503'
|
||||
---
|
||||
{% data reusables.projects.projects-api %}
|
||||
|
||||
{% data reusables.user-settings.classic-projects-api-classic-pat-only %}
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
title: '{% data variables.product.prodname_project_v1_caps %} collaborators'
|
||||
shortTitle: Collaborators
|
||||
allowTitleToDifferFromFilename: true
|
||||
intro: '{% data variables.product.prodname_project_v1 %} collaborators API を使用すると、{% data variables.projects.projects_v1_board %} でコラボレーターを管理できます。'
|
||||
intro: 'REST API を使って、{% data variables.projects.projects_v1_board %} でコラボレーターを管理できます。'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -11,11 +11,13 @@ versions:
|
||||
topics:
|
||||
- API
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: 72473eabf86bc1eab841b86a85acfdf9ffe6bb01
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 648e251f1cc45b408acf7eccbe20c75971d29a02
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147423061'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193500'
|
||||
---
|
||||
{% data reusables.projects.projects-api %}
|
||||
|
||||
{% data reusables.user-settings.classic-projects-api-classic-pat-only %}
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
title: '{% data variables.product.prodname_project_v1_caps %} columns'
|
||||
shortTitle: Columns
|
||||
allowTitleToDifferFromFilename: true
|
||||
intro: '{% data variables.product.prodname_project_v1 %} columns API を使用すると、{% data variables.projects.projects_v1_board %} で列を作成および管理できます。'
|
||||
intro: 'REST API を使って、{% data variables.projects.projects_v1_board %} で列を作成し、管理できます。'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -11,11 +11,13 @@ versions:
|
||||
topics:
|
||||
- API
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: 8804dd9fafb1dd8142c50e30db36cc5daf7c04df
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 41ae7c65372079bb9a226839fa1615cbaab9f60b
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147423069'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193495'
|
||||
---
|
||||
{% data reusables.projects.projects-api %}
|
||||
|
||||
{% data reusables.user-settings.classic-projects-api-classic-pat-only %}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: '{% data variables.product.prodname_projects_v1_caps %}'
|
||||
intro: '{% data variables.product.prodname_projects_v1 %} API を使用すると、{% data variables.projects.projects_v1_boards %} の作成、一覧表示、更新、削除、カスタマイズを行うことができます。'
|
||||
intro: 'REST API を使って、{% data variables.projects.projects_v1_boards %} を作成、一覧表示、更新、削除、カスタマイズできます。'
|
||||
redirect_from:
|
||||
- /v3/projects
|
||||
- /rest/reference/projects
|
||||
@@ -18,11 +18,11 @@ children:
|
||||
- /cards
|
||||
- /collaborators
|
||||
- /columns
|
||||
ms.openlocfilehash: 815c82656605773c4bda0750f331f819ca39551e
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: fa8677c2bb88d39a1ebb2dff546718a3f8524972
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147423042'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193492'
|
||||
---
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
title: '{% data variables.product.prodname_projects_v1_caps %}'
|
||||
shortTitle: Boards
|
||||
allowTitleToDifferFromFilename: true
|
||||
intro: '{% data variables.product.prodname_projects_v1 %} API を使用すると、リポジトリで {% data variables.projects.projects_v1_boards %} を作成および管理できます。'
|
||||
intro: 'REST API を使用し、リポジトリで {% data variables.projects.projects_v1_boards %} を作成し、管理します。'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -11,11 +11,13 @@ versions:
|
||||
topics:
|
||||
- API
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: f5c7d3e39f4de88bd071fecab159b08d540e5055
|
||||
ms.sourcegitcommit: 5f9527483381cfb1e41f2322f67c80554750a47d
|
||||
ms.openlocfilehash: c614e93e12b759936da21d89e74161156248f3d0
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/11/2022
|
||||
ms.locfileid: '147882360'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192818'
|
||||
---
|
||||
{% data reusables.projects.projects-api %}
|
||||
|
||||
{% data reusables.user-settings.classic-projects-api-classic-pat-only %}
|
||||
|
||||
@@ -14,12 +14,12 @@ redirect_from:
|
||||
- /guides/getting-started
|
||||
- /v3/guides/getting-started
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: 73b92aa20c38377f878bf9b6fffb7c1c6e2639b9
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 001c4e3291e697be034579525d9f0bc6da8c0c88
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147718198'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192882'
|
||||
---
|
||||
この記事では、{% data variables.product.prodname_cli %}、JavaScript、または cURL を使用して、{% data variables.product.prodname_dotcom %} REST API の使用をすばやく開始する方法について説明します。 詳しいガイドについては、「[REST API を使用した作業の開始](/rest/guides/getting-started-with-the-rest-api)」をご覧ください。
|
||||
|
||||
@@ -67,7 +67,7 @@ jobs:
|
||||
|
||||
{% data variables.product.prodname_github_app %} を使用して認証する場合は、ワークフロー内にインストール アクセス トークンを作成します。
|
||||
|
||||
1. {% data variables.product.prodname_github_app %} の ID をシークレットとして保存します。 以下の例では、`APP_ID` をシークレットの名前に置き換えます。 アプリケーションIDは、アプリケーションの設定ページで、あるいはアプリケーションのAPIを通じて確認できます。 詳細については、「[アプリ](/rest/apps/apps#get-an-app)」を参照してください。 シークレットについて詳しくは、「[暗号化されたシークレット](/actions/security-guides/encrypted-secrets)」を参照してください。
|
||||
1. {% data variables.product.prodname_github_app %} の ID をシークレットとして保存します。 以下の例では、`APP_ID` をシークレットの名前に置き換えます。 アプリ ID は、アプリの設定ページで、あるいは API を通じて確認できます。 詳しくは、REST API のドキュメントの「[アプリ](/rest/apps/apps#get-an-app)」をご覧ください。 シークレットについて詳しくは、「[暗号化されたシークレット](/actions/security-guides/encrypted-secrets)」を参照してください。
|
||||
1. アプリケーションの秘密鍵を生成してください。 作成されたファイルの内容をシークレットとして保存します。 (`-----BEGIN RSA PRIVATE KEY-----` および `-----END RSA PRIVATE KEY-----` を含め、ファイルの内容全体を保存します)。以下の例では、`APP_PEM` をシークレットの名前に置き換えます。 詳細については、「[{% data variables.product.prodname_github_apps %} による認証](/developers/apps/building-github-apps/authenticating-with-github-apps#generating-a-private-key)」を参照してください。
|
||||
1. トークンを生成するステップを追加し、`GITHUB_TOKEN` ではなくそのトークンを使用します。 このトークンは 60 分後に期限切れになるので注意してください。 次に例を示します。
|
||||
|
||||
@@ -104,11 +104,11 @@ Octokit.js を使用すれば、JavaScript スクリプト内で {% data variabl
|
||||
|
||||
### Octokit.js の使用
|
||||
|
||||
1. アクセス トークンを作成します。 たとえば、個人用アクセス トークン (PAT) または {% data variables.product.prodname_github_app %} のユーザーからサーバーへのアクセス トークンを作成します。 詳しくは、「[個人用アクセス トークンの作成](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)」または「[GitHub アプリのユーザーを特定および認可する](/developers/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps)」を参照してください。
|
||||
1. アクセス トークンを作成します。 たとえば、{% data variables.product.pat_generic %} または {% data variables.product.prodname_github_app %} のユーザーからサーバーへのアクセス トークンを作成します。 詳しい情報については、「[{% data variables.product.pat_generic %} の作成](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)」か「[GitHub App のユーザーの特定と認可](/developers/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps)」を参照してください。
|
||||
|
||||
{% warning %}
|
||||
|
||||
**警告**: アクセス トークンは、パスワードと同様の扱いとしてください。
|
||||
**警告**: アクセス トークンはパスワードと同様に扱ってください。
|
||||
|
||||
トークンを安全な状態に保つには、ご利用のトークンをシークレットとして格納し、{% data variables.product.prodname_actions %} を介してスクリプトを実行します。 詳しくは、「[{% data variables.product.prodname_actions %} での Octokit.js の使用](#using-octokitjs-in-github-actions)」セクションを参照してください。
|
||||
|
||||
@@ -169,7 +169,7 @@ jobs:
|
||||
- name: Setup Node
|
||||
uses: {% data reusables.actions.action-setup-node %}
|
||||
with:
|
||||
node-version: '16.15.0'
|
||||
node-version: '16.17.0'
|
||||
cache: npm
|
||||
|
||||
- name: Install dependencies
|
||||
@@ -227,7 +227,7 @@ jobs:
|
||||
- name: Setup Node
|
||||
uses: {% data reusables.actions.action-setup-node %}
|
||||
with:
|
||||
node-version: '16.15.0'
|
||||
node-version: '16.17.0'
|
||||
cache: npm
|
||||
|
||||
- name: Install dependencies
|
||||
@@ -262,7 +262,7 @@ jobs:
|
||||
{% endnote %}
|
||||
|
||||
1. cURL がまだコンピューターにインストールされていない場合は、cURL をインストールします。 cURL がインストールされているかどうかを確認するには、コマンド ラインで `curl --version` を実行します。 出力が cURL バージョンに関する情報である場合は、cURL がインストールされています。 `command not found: curl` のようなメッセージが表示された場合は、cURL をダウンロードしてインストールする必要があります。 詳しくは、[cURL プロジェクトのダウンロードに関するページ](https://curl.se/download.html)を参照してください。
|
||||
1. アクセス トークンを作成します。 たとえば、個人用アクセス トークン (PAT) または {% data variables.product.prodname_github_app %} のユーザーからサーバーへのアクセス トークンを作成します。 詳しくは、「[個人用アクセス トークンの作成](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)」または「[GitHub アプリのユーザーを特定および認可する](/developers/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps)」を参照してください。
|
||||
1. アクセス トークンを作成します。 たとえば、{% data variables.product.pat_generic %} または {% data variables.product.prodname_github_app %} のユーザーからサーバーへのアクセス トークンを作成します。 詳しい情報については、「[{% data variables.product.pat_generic %} の作成](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)」か「[GitHub App のユーザーの特定と認可](/developers/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps)」を参照してください。
|
||||
|
||||
{% warning %}
|
||||
|
||||
@@ -283,8 +283,8 @@ jobs:
|
||||
```shell
|
||||
curl --request GET \
|
||||
--url "https://api.github.com/repos/octocat/Spoon-Knife/issues" \
|
||||
--header "Accept: application/vnd.github.v3+json" \
|
||||
--header "Authorization: Bearer <em>YOUR-TOKEN</em>"
|
||||
--header "Accept: application/vnd.github+json" \
|
||||
--header "Authorization: Bearer YOUR-TOKEN"
|
||||
```
|
||||
|
||||
{% note %}
|
||||
@@ -313,7 +313,7 @@ jobs:
|
||||
run: |
|
||||
curl --request GET \
|
||||
--url "https://api.github.com/repos/octocat/Spoon-Knife/issues" \
|
||||
--header "Accept: application/vnd.github.v3+json" \
|
||||
--header "Accept: application/vnd.github+json" \
|
||||
--header "Authorization: Bearer $GH_TOKEN"
|
||||
```
|
||||
|
||||
@@ -345,7 +345,7 @@ jobs:
|
||||
run: |
|
||||
curl --request GET \
|
||||
--url "https://api.github.com/repos/octocat/Spoon-Knife/issues" \
|
||||
--header "Accept: application/vnd.github.v3+json" \
|
||||
--header "Accept: application/vnd.github+json" \
|
||||
--header "Authorization: Bearer $GH_TOKEN"
|
||||
```
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: レート制限
|
||||
intro: Rate Limit API を使うと、さまざまな REST API の現在のレート制限のステータスを確認できます。
|
||||
intro: REST API を使って、現在のレート制限の状態を確認します。
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -11,29 +11,25 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
redirect_from:
|
||||
- /rest/reference/rate-limit
|
||||
ms.openlocfilehash: 282b7e7bbb947256ccad4950b6a17d8874044d8f
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: a609d339af2201bba5ec12044a8eebe733013cea
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147081049'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193415'
|
||||
---
|
||||
## Rate Limit API について
|
||||
## レート制限について
|
||||
|
||||
REST API の概要ドキュメントでは、[レート制限のルール](/rest/overview/resources-in-the-rest-api#rate-limiting)について説明しています。 以下で説明する Rate Limit API を使用して、現在のレート制限ステータスをいつでも確認できます。
|
||||
現在のレート制限の状態はいつでも確認できます。 レート制限規則について詳しくは、「[REST API のリソース](/rest/overview/resources-in-the-rest-api#rate-limiting)」をご覧ください。
|
||||
|
||||
### レート制限のステータスを理解する
|
||||
|
||||
Search API には、残りの REST API に適用されるレート制限とは別の、[カスタム](/rest/reference/search#rate-limit)のレート制限があります。 GraphQL API にも、REST API のレート制限とは別の、別の方法で計算される[カスタム レート制限](/graphql/overview/resource-limitations#rate-limit)があります。
|
||||
|
||||
そのため、Rate Limit APIのレスポンスは、レート制限を分類します。 `resources` の下に、次の 4 つのオブジェクトがあります。
|
||||
アイテムを検索するための REST API には、他の REST API エンドポイントを管理するレート制限とは別のカスタム レート制限があります。 詳しくは、「[search](/rest/search)」をご覧ください。 GraphQL API にも、REST API のレート制限とは別の、別の方法で計算されるカスタム レート制限があります。 詳しくは、「[リソースの制限](/graphql/overview/resource-limitations#rate-limit)」をご覧ください。 そのため、API の応答は、レート制限を分類します。 `resources` の下には、次のようなさまざまなカテゴリに関連するオブジェクトが表示されます。
|
||||
|
||||
* `core` オブジェクトは、REST API の検索に関連しないすべてのリソースに関するレート制限の状態を示します。
|
||||
|
||||
* `search` オブジェクトは、[Search API](/rest/reference/search) のレート制限の状態を示します。
|
||||
* `search` オブジェクトは、REST API の検索に関するレート制限の状態を示します。
|
||||
|
||||
* `graphql` オブジェクトは、[GraphQL API](/graphql) のレート制限の状態を示します。
|
||||
* `graphql` オブジェクトは、GraphQL API のレート制限の状態を示します。
|
||||
|
||||
* `integration_manifest` オブジェクトは、[GitHub App Manifest コード変換](/apps/building-github-apps/creating-github-apps-from-a-manifest/#3-you-exchange-the-temporary-code-to-retrieve-the-app-configuration)エンドポイントのレート制限の状態を示します。
|
||||
* `integration_manifest` オブジェクトは、`POST /app-manifests/{code}/conversions` 操作のレート制限の状態を示します。 詳しくは、「[マニフェストから GitHub アプリを作成する](/apps/building-github-apps/creating-github-apps-from-a-manifest/#3-you-exchange-the-temporary-code-to-retrieve-the-app-configuration)」をご覧ください。
|
||||
|
||||
レート制限の応答のヘッダーと値の詳細については、「[Resources in the REST API](/rest/overview/resources-in-the-rest-api#rate-limit-http-headers)」 (REST API のリソース) を参照してください。
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: リアクション
|
||||
intro: Reactions APIを使うと、コメントのリアクションの作成、リスト、削除が行えます。
|
||||
intro: 'REST API を使って、{% data variables.product.prodname_dotcom %} 上のリアクションを操作できます。'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -11,15 +11,15 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
redirect_from:
|
||||
- /rest/reference/reactions
|
||||
ms.openlocfilehash: 6598b1f9a42c2520b3e48062ae730c3873d5e657
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: b6b8b10a28fdc48963fae6da931d9dd5b3af5a4d
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147063435'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193551'
|
||||
---
|
||||
## Reactions API について
|
||||
## リアクションについて
|
||||
|
||||
Reactions API を使用して、コメントに対するリアクションを作成および管理できます。 リアクションを作成する際、`content` パラメーターで利用可能な値は以下の通りです (参考のため、対応する絵文字も掲載します)。
|
||||
{% data variables.product.prodname_dotcom %} 上のコメント、Issue、pull request、ディスカッションに対するリアクションを作成および管理できます。 リアクションを作成する際、`content` パラメーターで利用可能な値は以下の通りです (参考のため、対応する絵文字も掲載します)。
|
||||
|
||||
{% data reusables.repositories.reaction_list %}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Webhooks
|
||||
intro: webhooks APIを使うと、リポジトリのwebhookの作成と管理ができます。
|
||||
title: リポジトリ webhook
|
||||
intro: REST API を使って、リポジトリ用に Webhook を作成および管理できます。
|
||||
allowTitleToDifferFromFilename: true
|
||||
versions:
|
||||
fpt: '*'
|
||||
@@ -16,28 +16,30 @@ children:
|
||||
- /repos
|
||||
redirect_from:
|
||||
- /rest/reference/webhooks
|
||||
ms.openlocfilehash: 9216b892bbc19752266cea22d88bec655363ecaf
|
||||
ms.sourcegitcommit: 5f9527483381cfb1e41f2322f67c80554750a47d
|
||||
ms.openlocfilehash: 5654fb1644f654c4664cccdeb987667c157b16cf
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/11/2022
|
||||
ms.locfileid: '147882344'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193540'
|
||||
---
|
||||
## リポジトリ Webhook について
|
||||
|
||||
リポジトリ Webhook を使用すると、リポジトリで特定のイベントが発生した場合に必ず HTTP `POST` ペイロードを受け取ることができます。 {% data reusables.webhooks.webhooks-rest-api-links %}
|
||||
|
||||
Organization のすべてのリポジトリからイベントを受信するため単一の webhook を設定する場合は、[Organization Webhooks](/rest/reference/orgs#webhooks) の API ドキュメントを参照してください。
|
||||
Organization のすべてのリポジトリからイベントを受信する Webhook を 1 つ設定する場合は、「[Organization Webhook](/rest/reference/orgs#webhooks)」での Rest API のドキュメントをご覧ください。
|
||||
|
||||
REST API に加えて、{% data variables.product.prodname_dotcom %} もリポジトリの [PubSubHubbub](#pubsubhubbub) ハブとして機能できます。
|
||||
|
||||
## webhook の受信
|
||||
### webhook の受信
|
||||
|
||||
{% data variables.product.product_name %} で webhook ペイロードを送信するには、インターネットからサーバーにアクセスできる必要があります。 暗号化されたペイロードを HTTPS 経由で送信できるように、SSL の使用も強く推奨します。
|
||||
|
||||
### webhook ヘッダー
|
||||
#### webhook ヘッダー
|
||||
|
||||
{% data variables.product.product_name %} は、イベントタイプとペイロード識別子を区別するために、複数の HTTP ヘッダーも送信します。 詳細については、[Webhook のヘッダー](/developers/webhooks-and-events/webhook-events-and-payloads#delivery-headers)に関する記事を参照してください。
|
||||
|
||||
## PubSubHubbub
|
||||
### PubSubHubbub
|
||||
|
||||
GitHub は、すべてのリポジトリの [PubSubHubbub](https://github.com/pubsubhubbub/PubSubHubbub) ハブとしても機能できます。 PSHB はシンプルな公開/サブスクライブプロトコルで、トピックが更新されたときにサーバーが更新を受信できるよう登録できます。 更新は HTTP POST リクエストでコールバック URL に送信されます。
|
||||
GitHub リポジトリのプッシュに対するトピック URL のフォーマットは以下の通りです。
|
||||
@@ -46,21 +48,21 @@ GitHub リポジトリのプッシュに対するトピック URL のフォー
|
||||
|
||||
イベントには、任意の使用可能な webhook イベントを指定します。 詳細については、「[webhook イベントとペイロード](/developers/webhooks-and-events/webhook-events-and-payloads)」を参照してください。
|
||||
|
||||
### 応答形式
|
||||
#### 応答形式
|
||||
|
||||
既定の形式は、[既存の post-receive フックで想定される形式](/post-receive-hooks/)、つまり POST の `payload` パラメーターとして送信される JSON 本文になります。 `Accept` ヘッダーまたは `.json` 拡張子を使用して、Raw 形式の JSON 本文を受信するように指定することもできます。
|
||||
|
||||
Accept: application/json
|
||||
https://github.com/{owner}/{repo}/events/push.json
|
||||
|
||||
### コールバック URL
|
||||
#### コールバック URL
|
||||
|
||||
コールバック URL では、`http://` プロトコルを使用できます。
|
||||
|
||||
# Send updates to postbin.org
|
||||
http://postbin.org/123
|
||||
|
||||
### サブスクライブ
|
||||
#### サブスクライブ
|
||||
|
||||
GitHub PubSubHubbub のエンドポイントは `{% data variables.product.api_url_code %}/hub` です。 curl でリクエストに成功すると、以下のように表示されます。
|
||||
|
||||
@@ -74,7 +76,7 @@ curl -u "user" -i \
|
||||
|
||||
PubSubHubbub リクエストは複数回送信できます。 フックがすでに存在する場合は、リクエストに従って変更されます。
|
||||
|
||||
#### パラメーター
|
||||
##### パラメーター
|
||||
|
||||
名前 | 型 | 説明
|
||||
-----|------|--------------
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: リポジトリ webhook の構成
|
||||
intro: ''
|
||||
intro: REST API を使って、リポジトリ Webhook の構成を管理します。
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -10,11 +10,11 @@ topics:
|
||||
- API
|
||||
miniTocMaxHeadingLevel: 3
|
||||
allowTitleToDifferFromFilename: true
|
||||
ms.openlocfilehash: 177126cebda7cd020d109107f920ef88b1c1278c
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 46cd5a1a67a6a2791bc260d8332c1bc626e0dc46
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147062795'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193281'
|
||||
---
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: リポジトリ Webhook の配信
|
||||
intro: ''
|
||||
intro: REST API を使って、リポジトリ Webhook の配信を操作します。
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -10,11 +10,11 @@ topics:
|
||||
- API
|
||||
miniTocMaxHeadingLevel: 3
|
||||
allowTitleToDifferFromFilename: true
|
||||
ms.openlocfilehash: a3fdc76ab7b02c60cac519ec0a44e215dab122df
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 6d9d43bbf7992b6339b13129c93ba45560acc09a
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147063123'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193280'
|
||||
---
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: リポジトリ webhook
|
||||
intro: ''
|
||||
intro: REST API を使って、リポジトリ Webhook を管理します。
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -10,11 +10,11 @@ topics:
|
||||
- API
|
||||
miniTocMaxHeadingLevel: 3
|
||||
allowTitleToDifferFromFilename: true
|
||||
ms.openlocfilehash: 85e0c2746416c5ba810b7729b06f1661d7319ec3
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 39d6e01bc3df2c805c52df706088942b4b7c3367
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147061882'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193623'
|
||||
---
|
||||
|
||||
|
||||
@@ -8,12 +8,12 @@ versions:
|
||||
ghes: '*'
|
||||
topics:
|
||||
- Support
|
||||
ms.openlocfilehash: 35c7b28232c0d11170ea9585480b2cfb1785ebd0
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: b735331d90c590ff6911fed44e181563b44bfc27
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147051981'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148193620'
|
||||
---
|
||||
## チケット管理について
|
||||
|
||||
@@ -27,7 +27,12 @@ ms.locfileid: '147051981'
|
||||
|
||||
{% data reusables.support.view-open-tickets %}
|
||||
1. テキスト ボックスの下で、コメント履歴を読むことができます。 最新の応答は一番上にあります。
|
||||

|
||||
|
||||

|
||||
|
||||
1. 必要に応じて、チケット コメントを翻訳するには、{% octicon "globe" aria-label="The globe icon" %} をクリックし、ドロップダウン メニューから任意の言語を選択します。 サポート チケットは、中国語 (簡体字)、フランス語、ドイツ語、日本語、ポルトガル語 (ブラジル)、またはスペイン語に翻訳できます。
|
||||
|
||||

|
||||
|
||||
{% ifversion ghec or ghes or ghae %}
|
||||
|
||||
|
||||
@@ -21,12 +21,12 @@ redirect_from:
|
||||
- /enterprise-server/admin/enterprise-support/about-support-for-advanced-security
|
||||
topics:
|
||||
- Support
|
||||
ms.openlocfilehash: 4044d5741b6df2827fa41c71476f4fb66ac717a4
|
||||
ms.sourcegitcommit: 5b0becac9098ab45c2204882d719f5cf17bfff18
|
||||
ms.openlocfilehash: aa2b407b96cc7ee2ecc20fee9782e3084b3627db
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 10/31/2022
|
||||
ms.locfileid: '148120865'
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: '148192914'
|
||||
---
|
||||
## {% data variables.contact.github_support %}について
|
||||
|
||||
@@ -79,6 +79,8 @@ ms.locfileid: '148120865'
|
||||
{% else %}{% data variables.product.product_name %} を使用している場合は、英語と日本語のサポートにアクセスできます。
|
||||
{% endif %}
|
||||
|
||||
{% ifversion fpt or ghec or ghes %} {% data reusables.support.support-ticket-translation-option %} {% endif %}
|
||||
|
||||
{% ifversion ghes or ghec %}
|
||||
|
||||
{% data variables.contact.github_support %}に問い合わせるには、{% data variables.contact.contact_support_portal %}にアクセスしてください。 詳細については、「[サポート チケットの作成](/support/contacting-github-support/creating-a-support-ticket)」を参照してください。
|
||||
|
||||
@@ -1,15 +1,24 @@
|
||||
---
|
||||
ms.openlocfilehash: a43b7fac5396fcbdb1b7d9ec241af9879de7b2b8
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: bf7a1cdb9c8b1300ef8ba8ab2dd427a9b5d28128
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: "145115021"
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: "148193463"
|
||||
---
|
||||
# GitHub Enterprise Serverリリースノート
|
||||
|
||||
表示場所: https://docs.github.com/en/enterprise-server@latest/admin/release-notes
|
||||
|
||||
## 非推奨の GitHub Enterprise Server リリースへのリリース ノートの追加
|
||||
|
||||
[この Issue テンプレート](/.github/actions-scripts/enterprise-server-issue-templates/deprecation-issue.md)に従った非推奨の GitHub Enterprise Server リリースでは、バージョンのリリース ノートを含む YAML ファイルがドキュメント エンジニアリングによって `github/docs-internal` から削除されます。
|
||||
|
||||
利害関係者から非推奨のリリース ノートの更新を求められた場合には、次の手順を実行してノートを更新できます。
|
||||
|
||||
1. 実行時間の長いブランチ <code>enterprise-<em>VERSION</em>-release</code> を確認し、PR を作成して、そのブランチの非推奨バージョンのリリース ノートを更新します。
|
||||
2. #docs-engineering に連絡して、Azure に格納されているコンテンツの再スクレイピングと更新を求めます。 [非推奨のチェックリスト](/.github/actions-scripts/enterprise-server-issue-templates/deprecation-issue.md)のコンテンツの再スクレイピングに関するセクションをご覧ください。
|
||||
|
||||
## しくみ
|
||||
|
||||
### プレースホルダーコンテンツファイル
|
||||
@@ -30,7 +39,7 @@ ms.locfileid: "145115021"
|
||||
|
||||
### ミドルウェアの処理
|
||||
|
||||
YAML データは `middleware/contextualizers/release-notes.js` によって処理、並べ替えされ、`context` オブジェクトに追加されます。
|
||||
YAML データは `middleware/contextualizers/ghes-release-notes.js` によって処理、並べ替えされ、`context` オブジェクトに追加されます。
|
||||
|
||||
### Layouts
|
||||
|
||||
@@ -40,6 +49,6 @@ YAML データは `middleware/contextualizers/release-notes.js` によって処
|
||||
|
||||
### スキーマ
|
||||
|
||||
YAML データを検証するスキーマは `tests/helpers/schemas/ghes-release-notes-schema.js` に存在します。 必須及びオプションのプロパティを調べるには、このスキーマファイルを見てください。
|
||||
YAML データを検証するスキーマは `tests/helpers/schemas/release-notes-schema.js` に存在します。 必須及びオプションのプロパティを調べるには、このスキーマファイルを見てください。
|
||||
|
||||
スキーマは `tests/linting/lint-files.js` のテストによって実行されます。 データが検証をパスしなければ、このテストは失敗します。
|
||||
|
||||
@@ -0,0 +1,11 @@
|
||||
---
|
||||
ms.openlocfilehash: 7c61def739c3054b56539e3eaf121b1a1484107b
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: "148193607"
|
||||
---
|
||||
## {% data variables.product.prodname_actions %} の外部ストレージについて
|
||||
|
||||
{% data reusables.actions.enterprise-storage-contents %} 詳しくは、「[{% data variables.product.prodname_ghe_server %} の {% data variables.product.prodname_actions %} を使ってみる](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server#external-storage-requirements)」をご覧ください。
|
||||
@@ -0,0 +1,9 @@
|
||||
---
|
||||
ms.openlocfilehash: 3ec09dc01c2c03dca0d7040cf3aab055d90128be
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: "148193468"
|
||||
---
|
||||
{% data variables.product.prodname_actions %} は、ワークフロー ログ{% ifversion actions-caching %}、キャッシュ{% endif %}、ユーザーがアップロードしたビルド成果物など、ワークフローの実行によって生成されたデータを、外部の BLOB ストレージを使って保存します。
|
||||
@@ -1,31 +1,33 @@
|
||||
---
|
||||
ms.openlocfilehash: 33d0297fab7d3dce2bea9fa3d63ba9c73ef5cb91
|
||||
ms.sourcegitcommit: dac72908e8660cb4a347fbf73beab61034eed8c5
|
||||
ms.openlocfilehash: 7d7a7cfa05c2c0d5e3ac89b603d1efb0ba51fc84
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 11/25/2022
|
||||
ms.locfileid: "148182283"
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: "148192714"
|
||||
---
|
||||
<!-- If you update the list of supported languages for CodeQL, update docs-internal/content/get-started/learning-about-github/github-language-support.md to reflect the changes. -->
|
||||
- C/C++
|
||||
- C#
|
||||
- Go
|
||||
- Java
|
||||
- Java{% ifversion codeql-kotlin-beta %}/Kotlin{% endif %}
|
||||
- JavaScript/TypeScript
|
||||
- Python{% ifversion fpt or ghes > 3.3 or ghec or ghae > 3.3 %}
|
||||
- Ruby
|
||||
|
||||
{% ifversion ghes < 3.8 or ghae < 3.8 %} {% note %}
|
||||
|
||||
**注**: Ruby の {% data variables.product.prodname_codeql %} 分析は、現在ベータ版です。 ベータ版の間、Ruby の分析は他の言語の {% data variables.product.prodname_codeql %} 分析ほど包括的ではありません。
|
||||
|
||||
{% endnote %} {% endif %}{% endif %}{% ifversion codeql-kotlin-beta %}
|
||||
- Kotlin
|
||||
- Ruby{% endif %}
|
||||
|
||||
{% note %}
|
||||
|
||||
**注**: Kotlin の {% data variables.product.prodname_codeql %} 分析は、現在ベータ版です。 ベータ版の間、Kotlin の分析は他の言語の {% data variables.product.prodname_codeql %} 分析ほど包括的ではありません。
|
||||
{% ifversion fpt or ghec or ghae or ghes > 3.3 %} **注**:
|
||||
|
||||
{% endnote %} {% endif %}
|
||||
{% ifversion ghes < 3.8 or ghae < 3.8 %}
|
||||
- Ruby の {% data variables.product.prodname_codeql %} 分析は、現在ベータ版です。 ベータ版の間、Ruby の分析は他の言語の {% data variables.product.prodname_codeql %} 分析ほど包括的ではありません。 {% endif %}{% ifversion codeql-kotlin-beta %}
|
||||
- Kotlin の {% data variables.product.prodname_codeql %} 分析は、現在ベータ版です。 ベータ版の間、Kotlin の分析は他の言語の {% data variables.product.prodname_codeql %} 分析ほど包括的ではありません。
|
||||
- Java、Kotlin、またはその両方で記述されたコードを分析するには `java` を使用します。 {% endif %}
|
||||
- JavaScript、TypeScript、またはその両方で記述されたコードを分析するには `javascript` を使用します。
|
||||
|
||||
{% else %} **注**: JavaScript、TypeScript、またはその両方で記述されたコードを分析するには `javascript` を使用します。
|
||||
{% endif %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
詳細については、{% data variables.product.prodname_codeql %} Web サイトのドキュメント「[サポートされている言語とフレームワーク](https://codeql.github.com/docs/codeql-overview/supported-languages-and-frameworks/)」を参照してください。
|
||||
|
||||
@@ -0,0 +1,9 @@
|
||||
---
|
||||
ms.openlocfilehash: 410f42fe3744309d9d0b404e7da493dbbcf8f306
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: "148193519"
|
||||
---
|
||||
{% data variables.product.prodname_copilot %} は、コードをより迅速に書くのに役立つ、AI を使った新しいコード補完ツールです。 {% data variables.product.prodname_copilot %} は {% data variables.product.prodname_copilot_for_individuals %} の {% data variables.product.prodname_dotcom %} 個人アカウントと {% data variables.product.prodname_copilot_for_business %} の {% data variables.product.prodname_ghe_cloud %} を介して利用できます。 詳しくは、[{% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot) に関する説明をご覧ください。
|
||||
@@ -1,10 +1,10 @@
|
||||
---
|
||||
ms.openlocfilehash: 65ef5b7ddead68864d8890f47e1ec5e8163a368b
|
||||
ms.sourcegitcommit: 5f9527483381cfb1e41f2322f67c80554750a47d
|
||||
ms.openlocfilehash: 69fce359695e2b23342e04a73397ac717d580b7b
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/11/2022
|
||||
ms.locfileid: "147881949"
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: "148193455"
|
||||
---
|
||||
- 検証済みの学生とオープンソースのメンテナンス担当者は、{% data variables.product.prodname_copilot %} を無料で使用できます。
|
||||
- 学生またはオープンソースのメンテナンス担当者ではない場合は、1 回限りの 60 日間の試用版で {% data variables.product.prodname_copilot %} を無料で試すことができます。 無料試用版の後、継続して使うためには、有料のサブスクリプションが必要になります。 無料試用版を開始するには、課金情報を入力する必要があります。 詳細については、「[{% data variables.product.prodname_copilot %} の課金について](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)」を参照してください。
|
||||
- 検証済みの学生、教師とオープンソースのメンテナンス担当者は、{% data variables.product.prodname_copilot %} を無料で使えます。
|
||||
- 学生、教師、またはオープンソースのメンテナンス担当者でない場合は、アクティブな無料試用版またはサブスクリプションが必要です。 詳しくは、「[{% data variables.product.prodname_copilot %} の課金について](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)」をご覧ください。
|
||||
|
||||
@@ -1,16 +1,18 @@
|
||||
---
|
||||
ms.openlocfilehash: 224ce401421d3af0e9afa5976695c95ed219a7b5
|
||||
ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110
|
||||
ms.openlocfilehash: 6946b53d41210f3e5ec43a06e0917d60fe959096
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 10/25/2022
|
||||
ms.locfileid: "148109179"
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: "148192874"
|
||||
---
|
||||
## {% data variables.product.prodname_copilot %} の設定を {% data variables.product.prodname_dotcom_the_website %} で構成する
|
||||
|
||||
アクティブな {% data variables.product.prodname_copilot %}試用版またはサブスクリプションがある場合、[{% data variables.product.prodname_copilot %} 設定](https://github.com/settings/copilot)で {% data variables.product.prodname_dotcom %} 上の個人用アカウントの {% data variables.product.prodname_copilot %} 設定を調整できます。 この設定は、{% data variables.product.prodname_copilot %} を使うすべての場所に適用されます。 {% data variables.product.prodname_copilot %} が提示する候補と、{% data variables.product.company_short %} がテレメトリ データを使う方法を構成できます。
|
||||
|
||||
## 重複検出の有効化または無効化
|
||||
### 重複検出の有効化または無効化
|
||||
|
||||
{% data reusables.copilot.duplication-setting-org %}
|
||||
|
||||
{% data variables.product.prodname_copilot %} には、{% data variables.product.prodname_dotcom %} のパブリック コードと一致するコード候補を検出するフィルターが含まれています。 フィルターを有効または無効にすることを選択できます。 フィルターが有効になっていると、{% data variables.product.prodname_copilot %} によって、周囲の約 150 文字のコードに関するコード候補が、{% data variables.product.prodname_dotcom %} でのパブリック コードに対してチェックされます。 一致または近い一致がある場合、候補は表示されません。
|
||||
|
||||
@@ -18,7 +20,9 @@ ms.locfileid: "148109179"
|
||||
1. **[Suggestions matching public code]\(公開コードに一致する候補\)** でドロップダウン メニューを選択し、 **[Allow]\(許可\)** をクリックして公開コードに一致する候補を許可するか、 **[Block]\(ブロック\)** をクリックして公開コードに一致する候補をブロックします。
|
||||
 {% data reusables.copilot.save-settings %}
|
||||
|
||||
## テレメトリの有効化または無効化
|
||||
### テレメトリの有効化または無効化
|
||||
|
||||
{% data reusables.copilot.telemetry-setting-org %}
|
||||
|
||||
ユーザー設定を調整することで、GitHub によってコード スニペットを収集して保持し、さらに処理して Microsoft や OpenAI と共有するかどうかを選択できます。 テレメトリの設定に応じて {% data variables.product.prodname_copilot %} で収集できるデータについて詳しくは、「[{% data variables.product.company_short %} 追加製品および機能の利用規約](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot)」と [{% data variables.product.prodname_copilot %} のプライバシーの FAQ](https://github.com/features/copilot/#faq-privacy) に関するページをご覧ください。
|
||||
|
||||
|
||||
@@ -0,0 +1,13 @@
|
||||
---
|
||||
ms.openlocfilehash: 1ee05e01e6ff5b072920edecfb1409f9d29f4dc4
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: "148193535"
|
||||
---
|
||||
{% note %}
|
||||
|
||||
**注:** あなたが {% data variables.product.prodname_ghe_cloud %} 上の Organization のメンバーで、Organization を通じて {% data variables.product.prodname_copilot %} シートが割り当てられている場合、個人アカウント設定で重複検出を構成することはできません。 重複検出設定は、Organization または Enterprise から継承されます。
|
||||
|
||||
{% endnote %}
|
||||
@@ -1,15 +1,13 @@
|
||||
---
|
||||
ms.openlocfilehash: 8fd599404931b2ec2334e0ad0200bbf8734f962e
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 495034c23fd83bd0d70bd080c03bbe0cfe455608
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: "147080296"
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: "148193511"
|
||||
---
|
||||
{% data variables.product.prodname_copilot %} の使用を開始する前に、無料試用版またはサブスクリプションを設定する必要があります。
|
||||
|
||||
{% data reusables.user-settings.access_settings %}
|
||||
1. サイドバーの [コード、計画、および自動化] セクションで、 **[{% octicon "copilot" aria-label="The copilot icon" %} GitHub Copilot]** をクリックします。
|
||||
1. サイドバーの [コード、計画、および自動化] セクションで、 **[{% octicon "copilot" aria-label="The copilot icon" %} {% data variables.product.prodname_copilot %}]** をクリックします。
|
||||
1. {% data variables.product.prodname_copilot %} 設定ページで、 **[{% data variables.product.prodname_copilot %} を有効にする]** をクリックします。
|
||||
|
||||
![[{% data variables.product.prodname_copilot %} を有効にする] ボタンが強調された GitHub Copilot 設定のスクリーンショット](/assets/images/help/copilot/copilot-settings-enable-button.png)
|
||||
|
||||
@@ -0,0 +1,13 @@
|
||||
---
|
||||
ms.openlocfilehash: afebc8fafe366fb62687cda658cac25d6f592f4c
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: "148193615"
|
||||
---
|
||||
{% note %}
|
||||
|
||||
**メモ:** あなたが {% data variables.product.prodname_ghe_cloud %} 上の Organization のメンバーで、Organization を通じて {% data variables.product.prodname_copilot %} シートが割り当てられている場合、個人アカウント設定でテレメトリを構成することはできません。 テレメトリは自動的に無効になります。
|
||||
|
||||
{% endnote %}
|
||||
@@ -0,0 +1,13 @@
|
||||
---
|
||||
ms.openlocfilehash: 2899f99d030f3aaf3910c8ba319e049141b8724a
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: "148193275"
|
||||
---
|
||||
{% note %}
|
||||
|
||||
**注:** ディスカッション カテゴリ フォームは現在、限定パブリック ベータ版であり、変更される可能性があります。
|
||||
|
||||
{% endnote %}
|
||||
@@ -0,0 +1,9 @@
|
||||
---
|
||||
ms.openlocfilehash: 2eec5f30b3778bb590ae07073965156e03c044ba
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: "148193516"
|
||||
---
|
||||
名前は、いずれかのディスカッション カテゴリのスラッグに対応している必要があります。 たとえば、"Announcements" カテゴリのテンプレートは、`.github/DISCUSSION_TEMPLATE/announcements.yml` にする必要があります。
|
||||
@@ -0,0 +1,9 @@
|
||||
---
|
||||
ms.openlocfilehash: 081bb743422f3dd749a9efa26d4e219e32e1045e
|
||||
ms.sourcegitcommit: 6185352bc563024d22dee0b257e2775cadd5b797
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 12/09/2022
|
||||
ms.locfileid: "148193479"
|
||||
---
|
||||
1. "{% octicon "law" aria-label="The law icon" %} ポリシー" で **[{% data variables.product.prodname_copilot_short %}]** をクリックします。
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user