# Diarkis CLI v3 への切り替え手順

## 概要 <a href="#gai-yao" id="gai-yao"></a>

Diarkis CLI の v1 及び v2 バージョンは廃止していく方針のため、最新の Diarkis CLI v3 への切り替えをお願いしております。以前から Diarkis をご利用いただいている場合、v1/v2 を利用している可能性があるため、Diarkis CLI のバージョンアップが必要となります。

最新バージョンを利用いただくことによって、ビルドの高速化ができますので、お手数をおかけしますが、よろしくお願いいたします。

## 利用中のバージョンの確認方法

サーバーのソースコードに `builder.diarkis.io` があるか検索します。

検索結果が `v3.builder.diarkis.io` であれば切り替える必要はありません。

検索結果が `builder.diarkis.io` / `v2.builder.diarkis.io` の場合は切り替える必要があるので、以降の手順を実施してください。

## 手順 <a href="#shou-shun" id="shou-shun"></a>

1. 新しい diarkis-cli のダウンロード
   * <https://github.com/Diarkis/diarkis-server-template/tree/develop/src/diarkis-cli/os> よりバイナリをダウンロードできますので、既存の diarkis-cli のバイナリと置き換えます。
2. diarkis ビルドサーバーのエンドポイントの変更
   * ソースコード内の`builder.diarkis.io` / `v2.builder.diarkis.io` で記載されている箇所を **`v3.builder.diarkis.io`** に書き換えます
3. (Optional) `.buildignore` を利用することで更にビルドを速くすることができます。
   * `.buildignore` はビルドサーバーにアップロードしない対象を指定するもので、アップロードサイズを減らしてビルド全体にかかる時間を削減できます。
   * <https://github.com/Diarkis/diarkis-server-template/blob/develop/src/.buildignore> を参考にリポジトリに配置します。基本的にデフォルトで問題ありせんが、他に不要なファイルやフォルダ、特に大きなサイズのバイナリファイルがある場合は追記することをおすすめします。
4. 実際に `diarkis-cli` を実行するスクリプトやタスクを実行して、問題がないことを確認します。