Helix Swarmガイドについて

このガイドでは、 Helix Coreサーバの使用方法と、チーム内でHelix Swarmを使用してコラボレーションとコードレビューを行う方法について説明します。このガイドは、 Swarm を使用して Helixサーバでコードレビューを行うユーザを対象としています。

まずは次のトピックからご覧ください。

Swarm 2021.2の新機能

ここでは、このリリースで本ガイドに追加された情報の概要について説明します。重要なトピックには、リンクが挿入されています。詳細なリストについては、「最新情報」を参照してください。

自動テスト機能の改善

  • 影響を受けるプロジェクトとブランチの反復テスト

  • Swarmで、レビューが複数のプロジェクトとブランチにまたがる場合に、それぞれのプロジェクトとブランチで個別にテストを実行できるようになりました。この機能は、テストごとに選択されます。詳しくは、「[影響を受けるプロジェクトとブランチの反復テスト]チェックボックス」を参照してください。

  • オンデマンドテストをワークフローに追加する

  • ワークフローにテストを追加し、そのワークフローを使用するレビューから手動でテストを実行できるようになりました。

    • オンデマンドテストをワークフローに追加する方法については、「ワークフローの追加」を参照してください。

    • 手動でテストを実行する方法については、「テストステータス」を参照してください。

  • レビューからテストを再実行する

  • レビューの[テストステータス]ドロップダウンでテストを再実行できるようになりました。詳しくは、「テストステータス」を参照してください。

  • テストが失敗した場合に承認をブロックする

  • テストが失敗した場合にレビューの承認をブロックできるようになりました。詳しくは、「ワークフローの追加」を参照してください。

保留中チェンジリストの処理中タグ

処理中タグ(デフォルトの処理中タグは#wip)を、作業中チェンジリストの説明に追加できるようになりました。これにより、関連するレビューを更新したり新しいレビューを作成したりすることなく、保留状態のファイルを更新することができます。レビューに対して多数の変更が必要な場合や、段階的に変更を行い、すべての変更を最後にまとめてレビューする場合などに、処理中タグを使用すると便利です。変更内容をレビューする準備ができたら、チェンジリストの説明から#wipを削除し、シェルフを更新してレビューを行います。

  • 処理中タグの使用方法については、「処理中タグ」を参照してください。

  • 処理中タグの変更方法については、「タグプロセッサ」を参照してください。

Swarm OVAでUbuntu 20.04 LTSが使用されるようになりました

Swarmバージョン2021.1以降、Swarm OVAオペレーティングシステムがUbuntu 20.04 LTS (旧称: Ubuntu 16.04 LTS)になりました。16.04 LTS OVAを使用している場合は、20.04 LTS OVAを導入し、Swarmのインストール環境を新しいOVAに移動することをお勧めします。Ubuntu 20.04 LTS OVAの導入方法とSwarmインスタンスの移動方法については、「OVAからSwarm VMの展開と構成を行う」と「Swarmインスタンスの移動」を参照してください。

サポート対象のAPIバージョンの変更

  • v9よりも古いAPIは、Swarm 2022.2リリースではサポートされなくなります。

  • 次のリリースのSwarmでは、v11の新しいAPIセットが導入されます。このAPIセットは、v10のAPIセットを拡張し、エンドポイントと応答パターンをさらに標準化したものになります。

  • v10のAPIは、今後もしばらくは使用することができます。

    • v11への移行後に機能改善が導入された場合、その機能改善がv9やv10に反映されることはありません。

    • 新しいAPIエンドポイントはv11として作成されます。これらのエンドポイントがv9やv10に反映されることはありません。

次のリリースのSwarmで変更されるPHPのサポート

次のリリースのSwarmでは、PHP 7.0と7.1がサポートされなくなります。これは、サポート終了(EOL)になったバージョンのプラットフォームを使用しないようにするための措置です。

Helix Coreの追加のヘルプ

コマンドラインクライアントの使用

Helixサーバコマンドラインクライアントの使用方法の詳細については、『Helix Coreサーバユーザガイド』を参照してください。

コマンドリファレンス

混在するクライアント用に Helixサーバを設定する方法については、『Helix Core P4コマンドリファレンス』のp4 client (graph)を参照してください。

Helixサーバの管理

Helixサーバのインストール、設定、管理については、『Helix Coreサーバ管理者ガイド』を参照してください。