Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[CodeCatalyst から移行する方法](migration.md)」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# nuget CLI または dotnet CLI を設定して使用する
<a name="packages-nuget-cli"></a>

`NuGet` および `dotnet` のような CLI ツールを使用して、CodeCatalyst からパッケージを公開して使用できます。このドキュメントでは、CLI ツールの設定と、それらを使用してパッケージを公開または使用する方法について説明します。

**Contents**
+ [CodeCatalyst で NuGet を設定する](#nuget-configure-cli)
+ [CodeCatalyst リポジトリから NuGet パッケージを使用する](#nuget-consume-cli)
+ [CodeCatalyst を介して NuGet.org から NuGet パッケージを使用する](#nuget-consume-nuget-gallery)
+ [CodeCatalyst に NuGet パッケージを公開する](#nuget-publish-cli)

## CodeCatalyst で NuGet を設定する
<a name="nuget-configure-cli"></a>

CodeCatalyst で NuGet を設定するには、NuGet 設定ファイルにリポジトリエンドポイントと個人用アクセストークンを追加して、`nuget` または `dotnet` に CodeCatalyst パッケージリポジトリへの接続を許可します。

**CodeCatalyst パッケージリポジトリで NuGet を設定するには**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。

1. プロジェクトの概要ページで、**[パッケージ]** を選択します。

1. パッケージリポジトリのリストからパッケージリポジトリを選択します。

1. **[リポジトリに接続]** を選択します。

1. **[リポジトリに接続]** ダイアログボックスで、パッケージマネージャークライアントのリストから **[NuGet]** または **[dotnet]** を選択します。

1. CodeCatalyst で NuGet を認証するには、個人用アクセストークン (PAT) が必要です。トークンが既にある場合はそれを使用できます。そうでない場合は、ここで作成できます。

   1. **[トークンを作成]** をクリックします。

   1. **[コピー]** をクリックして PAT をコピーします。
**警告**  
ダイアログボックスを閉じると、PAT を再度表示またはコピーできなくなります。

1. リポジトリの NuGet エンドポイントと CodeCatalyst PAT を使用するように `nuget` または `dotnet` を設定します。次の値を置き換えます。
**注記**  
コンソールの手順からコピーする場合は、以下の値は自動的に更新されるため、変更する必要はありません。
   + *username* を CodeCatalyst のユーザー名に置き換えます。
   + *PAT* を CodeCatalyst の PAT に置き換えます。
   + *space\$1name* を CodeCatalyst のスペース名に置き換えます。
   + *proj\$1name* を CodeCatalyst のプロジェクト名に置き換えます。
   + *repo\$1name* を CodeCatalyst のパッケージリポジトリ名に置き換えます。

   1. `nuget` では、`nuget sources add` コマンドを使用します。

      ```
      nuget sources add -name "repo_name" -Source "https://packages.region.codecatalyst.aws/nuget/space_name/proj_name/repo_name/v3/index.json" -username "username" -password "PAT"
      ```

   1. `dotnet` では、`dotnet nuget add source` コマンドを使用します。

      **Linux および MacOS のユーザー:** 暗号化は Windows 以外のプラットフォームではサポートされていないため、次のコマンドに `--store-password-in-clear-text` フラグを追加する必要があります。これにより、パスワードがプレーンテキストとして設定ファイルに保存されるため注意してください。

      ```
      dotnet nuget add source "https://packages.region.codecatalyst.aws/nuget/space_name/proj_name/repo_name/v3/index.json" -n "proj_name/repo_name" -u "username" -p "PAT" --store-password-in-clear-text
      ```

CodeCatalyst で NuGet を設定すると、CodeCatalyst リポジトリまたはそのアップストリームリポジトリの 1 つに保存されている [NuGet パッケージを使用](#nuget-consume-cli)できます。また、CodeCatalyst リポジトリに [NuGet パッケージを公開する](#nuget-publish-cli)こともできます。

## CodeCatalyst リポジトリから NuGet パッケージを使用する
<a name="nuget-consume-cli"></a>

[CodeCatalyst で NuGet を設定する](#nuget-configure-cli)と、CodeCatalyst リポジトリまたはそのアップストリームリポジトリの 1 つに保存されている NuGet パッケージを使用できます。

CodeCatalyst リポジトリまたはそのアップストリームリポジトリのいずれかから nuget または dotnet を使用してパッケージバージョンを使用するには、次のコマンドを実行します。*packageName* を使用するパッケージの名前に置き換え、*packageSourceName* を NuGet 設定ファイルの CodeCatalyst パッケージリポジトリのソース名に置き換えます。ソース名はリポジトリ名であるはずです。

**`dotnet` でパッケージをインストールするには**

```
dotnet add packageName --source packageSourceName
```

**`nuget` でパッケージをインストールするには**

```
nuget install packageName --source packageSourceName
```

詳細については、*Microsoft ドキュメント*の「[NuGet.exe CLI を使用して NuGet パッケージを管理する](https://docs.microsoft.com/en-us/nuget/consume-packages/install-use-packages-nuget-cli)」または「[dotnet CLI を使用して NuGet パッケージをインストールし、管理する](https://docs.microsoft.com/en-us/nuget/consume-packages/install-use-packages-dotnet-cli)」を参照してください。

## CodeCatalyst を介して NuGet.org から NuGet パッケージを使用する
<a name="nuget-consume-nuget-gallery"></a>

CodeCatalyst リポジトリを介して **Nuget.org** から NuGet パッケージを使用するには、[Nuget.org](https://www.nuget.org/) へのアップストリーム接続を設定します。**Nuget.org** から使用されたパッケージは、CodeCatalyst リポジトリに取り込まれて保存されます。

**NuGet.org からパッケージを使用するには**

1. まだ設定していない場合は、「[CodeCatalyst で NuGet を設定する](#nuget-configure-cli)」の手順に従って CodeCatalyst パッケージリポジトリで NuGet パッケージマネージャーを設定します。

1. リポジトリにアップストリーム接続として **NuGet.org** が追加されていることを確認します。追加されているアップストリームソースを確認するか、「[アップストリームリポジトリを追加する](packages-upstream-repositories-add.md)」の手順で **NuGet ストア**リポジトリを選択して、アップストリームソースとして **Nuget.org** を追加します。

## CodeCatalyst に NuGet パッケージを公開する
<a name="nuget-publish-cli"></a>

[CodeCatalyst で NuGet を設定](#nuget-configure-cli)すると、`nuget` または `dotnet` を使用して CodeCatalyst リポジトリにパッケージバージョンを公開できます。

パッケージバージョンを CodeCatalyst リポジトリにプッシュするには、次のコマンドを、`.nupkg` ファイルへのフルパスと NuGet 設定ファイル内の CodeCatalyst リポジトリのソース名を使用して実行します。

**`dotnet` でパッケージを公開するには**

```
dotnet nuget push path/to/nupkg/SamplePackage.1.0.0.nupkg --source packageSourceName
```

**`nuget` でパッケージを公開するには**

```
nuget push path/to/nupkg/SamplePackage.1.0.0.nupkg --source packageSourceName
```