スナップショットの管理 – mablヘルプ

スナップショットを使用すると、特定のバージョンのテストとフローをmabl環境に固定できます。この記事では、スナップショットの管理方法について説明します。

スナップショットとは何ですか？

スナップショットの詳細、仕組み、使用する理由については、こちらの記事をご覧ください。

スナップショットを作成および更新する

mabl CLIでmabl deployments createコマンドを使用して、スナップショットを作成および更新できます。このコマンドには、最低限次の2つのオプションを含める必要があります。

mabl deployments create -e [env-id] --snapshot-from [branch_name]

このコマンドを実行すると、mablでデプロイメントエベントが作成され、この環境内のすべてのアクティブなプランが実行されます。

環境のスナップショットを作成または更新する際に、関連するテストプランを実行しないようにするには、存在しないラベルを-lまたは--labelsオプションで追加します。次の例では、ワークスペースに「fake」というプランラベルが存在しないことを前提としています。

mabl deployments create -e [env-id] --snapshot-from master -l fake

スナップショットされたすべてのテストとフローを確認するには、テスト > ブランチに移動してください。スナップショットはブランチのリスト内に表示され、ステータス「スナップショット」で示されます。スナップショット名は、作成された環境IDに基づいて自動的に生成されます。

mablテストブランチとスナップショットの一覧

テストの詳細に移動し、変更履歴タブを確認することで、どのバージョンのテストがスナップショットされているかを特定できます。

スナップショット環境に固定されたバージョンでテストの変更履歴を確認する

スナップショットを削除するには、環境からスナップショットを切り離し、mabl UIからスナップショットを削除する必要があります。

mabl CLIでデプロイメントエベントを作成し、--snapshot-fromオプションを使用せずに環境を指定します。スナップショットを削除したい環境のIDを提供してください。

mabl deployments create -e [env-id]

デプロイメントイベントは、指定したパラメータに一致するすべてのアクティブなテストを実行することを忘れないでください。テストの実行を避けるには、存在しないラベルを指定して-lまたは--labelオプションを含めてください。

mabl deployments create -e [env-id] -l nonexistent-label

今後、mablはプランの実行において、特定のブランチを指定しない限り、テストのマスターブランチバージョンを使用します。

mablアプリでテスト > ブランチに移動し、mabl UIからスナップショットを削除して、リストに表示されないようにします。

環境からスナップショットを誤って切り離してしまった場合は、このコマンドを実行して環境を再びスナップショットに固定できます。

mabl environments update [env-id] --mabl-branch [snapshot-name]

環境がスナップショットを使用するように設定されているかどうかを確認するには、mabl CLIで次のコマンドを実行してください。

mabl environments describe [env-id]

mabl CLIは、環境に関するメタデータを返します。これには、スナップショットを使用するように設定されているかどうかが含まれます。

メタデータにuse_source_control_tag: trueと表示されている場合、環境はスナップショットを使用するように設定されています。
メタデータにuse_source_control_tag: falseと表示されている場合、またはuse_source_control_tagプロパティが存在しない場合、環境はスナップショットを使用するように設定されていません。