スペースへのカスタムブループリントの発行 - Amazon CodeCatalyst
カスタムブループリントのプレビューバージョンの表示と公開カスタム設計図の標準バージョンの表示と公開指定されたスペースとプロジェクトでのカスタムブループリントの発行と追加

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

スペースへのカスタムブループリントの発行

スペースのブループリントカタログにカスタムブループリントを追加する前に、スペースに公開する必要があります。公開する前に CodeCatalyst 、コンソールでブループリントを表示することもできます。プレビューバージョンまたは通常のバージョンのブループリントを発行できます。

重要

外部ソースからのブループリントパッケージを使用する場合は、それらのパッケージに伴うリスクを考慮してください。スペースに追加するカスタム設計図とそれらが生成するコードは、お客様の責任となります。

重要

CodeCatalyst スペースにカスタムブループリントを発行するには、スペース管理者またはパワーユーザーロールがスペースにあるアカウントでサインインする必要があります。

カスタムブループリントのプレビューバージョンの表示と公開

スペースのブループリントカタログに追加する場合は、カスタムブループリントのプレビューバージョンをスペースに公開できます。これにより、非プレビューバージョンをカタログに追加する前に、ブループリントをユーザーとして表示できます。プレビューバージョンでは、実際のバージョンを使わずに公開できます。例えば、 0.0.1バージョンで作業する場合、プレビューバージョンを発行して追加できるため、2 番目のバージョンの新しい更新を として発行して追加できます0.0.2。

変更を加えたら、 package.json ファイルを実行してカスタムブループリントのパッケージを再構築し、変更をプレビューします。

カスタムブループリントのプレビューバージョンを表示および公開するには

  1. 開発環境を再開します。詳細については、「開発環境の再開」を参照してください

  2. 開発環境で作業ターミナルを開きます。

  3. （オプション) 作業ターミナルで、プロジェクトに必要な依存関係をまだインストールしていない場合は、インストールします。以下のコマンドを使用します。

    yarn

  4. （オプション) .projenrc.ts ファイルに変更を加えた場合は、設計図を構築してプレビューする前に、プロジェクトの設定を再生成します。以下のコマンドを使用します。

    yarn projen

  5. 次のコマンドを使用して、カスタムブループリントを再構築してプレビューします。以下のコマンドを使用します。

    yarn blueprint:preview

    提供されたSee this blueprint at:リンクに移動して、カスタム設計図をプレビューします。設定に基づいて、テキストを含む UI が想定どおりに表示されることを確認します。カスタムブループリントを変更する場合は、blueprint.tsファイルを編集し、ブループリントを再合成してから、プレビューバージョンを再公開できます。詳細については、「再合成」を参照してください。

  6. （オプション) カスタムブループリントのプレビューバージョンを発行し、スペースのブループリントカタログに追加できます。Enable version [preview version number] at: リンクに移動して、プレビューバージョンをスペースに公開します。

でプロジェクトを作成することなく、プロジェクトの作成をエミュレートできます CodeCatalyst。プロジェクトを合成するには、次のコマンドを使用します。

yarn blueprint:synth

ブループリントが synth/synth.[options-name]/proposed-bundle/フォルダに生成されます。詳細については、「合成」を参照してください。

カスタムブループリントを更新する場合は、代わりに次のコマンドを使用してプロジェクトを再合成します。

yarn blueprint:resynth

ブループリントが synth/synth.[options-name]/proposed-bundle/フォルダに生成されます。詳細については、「再合成」を参照してください。

プレビューバージョンを発行した後、スペースメンバーがそれを使用して新しいプロジェクトを作成したり、既存のプロジェクトを追加したりできるように、ブループリントを追加できます。詳細については、「スペースブループリントカタログへのカスタムブループリントの追加」を参照してください。

カスタム設計図の標準バージョンの表示と公開

カスタムブループリントの開発とプレビューが完了したら、スペースのブループリントカタログに追加する新しいバージョンを表示して公開できます。プロジェクトの作成時に生成されるリリースワークフローは、プッシュされる変更を自動的に発行します。設計図の作成時にワークフロー生成をオフにしても、設計図はスペースの設計図カタログに追加するために自動的に使用されることはありません。yarn コマンドの実行後も、カスタムブループリントをスペースに公開できます。

カスタムブループリントを表示および公開するには

  1. 開発環境を再開します。詳細については、「開発環境の再開」を参照してください

  2. 開発環境で作業ターミナルを開きます。

    • ブループリントの作成時にリリースワークフローの生成をオプトアウトした場合は、次のコマンドを使用します。

      yarn blueprint:release

      提供されたSee this blueprint at:リンクに移動して、カスタムブループリントを表示することもできます。

      カスタムブループリントの更新バージョンを発行し、スペースのブループリントカタログに追加できます。Enable version [release version number] at: リンクに移動して、最新バージョンをスペースに公開します。

    • ブループリントの作成時にリリースワークフローにオプトインした場合、変更がプッシュされると、最新のブループリントバージョンが自動的に発行されます。次のコマンドを使用します。

      git add .
      git commit -m "commit message"
      git push

通常のバージョンを発行したら、ブループリントを追加して、スペースメンバーがそれを使用して新しいプロジェクトを作成したり、既存のプロジェクトに追加したりできます。詳細については、「スペースブループリントカタログへのカスタムブループリントの追加」を参照してください。

指定されたスペースとプロジェクトでのカスタムブループリントの発行と追加

デフォルトでは、 コマンドblueprint:previewと blueprint:release コマンドは、ブループリントを作成した CodeCatalyst スペースに発行されます。複数のエンタープライズスペースがある場合は、それらのスペースで同じ設計図をプレビューして公開することもできます。別のスペースの既存のプロジェクトにブループリントを追加することもできます。

指定されたスペースにカスタムブループリントを発行または追加するには

  1. 開発環境を再開します。詳細については、「開発環境の再開」を参照してください。

  2. 開発環境で作業ターミナルを開きます。

  3. （オプション) まだインストールしていない場合は、プロジェクトに必要な依存関係をインストールします。以下のコマンドを使用します。

    yarn

  4. --space タグを使用して、プレビューバージョンまたは標準バージョンを指定されたスペースに発行します。例:

    • yarn blueprint:preview --space my-awesome-space # publishes under a "preview" version tag to 'my-awesome-space'

      出力例:

      Enable version 0.0.1-preview.0 at: https://codecatalyst.aws/spaces/my-awesome-space/blueprints
Blueprint applied to [NEW]: https://codecatalyst.aws/spaces/my-awesome-space/blueprints/%40amazon-codecatalyst%2Fmyspace.my-blueprint/publishers/1524817d-a69b-4abe-89a0-0e4a9a6c53b2/versions/0.0.1-preview.0/projects/create
    • yarn blueprint:release --space my-awesome-space # publishes normal version to 'my-awesome-space'

      出力例:

      Enable version 0.0.1 at: https://codecatalyst.aws/spaces/my-awesome-space/blueprints
Blueprint applied to [NEW]: https://codecatalyst.aws/spaces/my-awesome-space/blueprints/%40amazon-codecatalyst%2Fmyspace.my-blueprint/publishers/1524817d-a69b-4abe-89a0-0e4a9a6c53b2/versions/0.0.1/projects/create

    --project を使用して、カスタムブループリントのプレビューバージョンを、指定されたスペース内の既存のプロジェクトに追加します。例:

    yarn blueprint:preview --space my-awesome-space --project my-project # previews blueprint application to an existing project

    出力例:

    Enable version 0.0.1-preview.1 at: https://codecatalyst.aws/spaces/my-awesome-space/blueprints
Blueprint applied to [my-project]: https://codecatalyst.aws/spaces/my-awesome-space/projects/my-project/blueprints/%40amazon-codecatalyst%2FmySpace.my-blueprint/publishers/1524817d-a69b-4abe-89a0-0e4a9a6c53b2/versions/0.0.1-preview.1/add