スペースへのカスタムブループリントの発行 - 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