> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ale.run/llms.txt
> Use this file to discover all available pages before exploring further.

# プラグイン管理

> プラグインを追加してエールの機能を拡張やカスタマイズすることができます。

<video autoPlay muted loop playsInline className="w-full aspect-video" src="https://storage.googleapis.com/files.cloudtype.io/ale-docs/operations/images/plugin.mp4" />

<Info>
  エールが提供するプラグインは、以下のGitHubリポジトリで確認できます。

  * [https://github.com/ale-run](https://github.com/ale-run)
</Info>

***

## プラグインのインストール

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/operations/images/ja/plugin01.png" />
</Frame>

> 運用システムのプラグインページで右側の`+`アイコンをクリックし、インストール方式に応じた情報を入力することでプラグインを追加できます。

### GitHub

> GitHubのURLフィールドに、プラグインが配置されているリポジトリ情報を以下の形式で入力してください。

```plain theme={null}
# プラグイン参照形式
[組織名またはアカウント名]/[リポジトリ名]               
[組織名またはアカウント名]/[リポジトリ名]#[ブランチ名]    

# 使用例
ale-run/plugin-aws
ale-run/plugin-aws#nightly
```

<Info>
  ブランチを指定しない場合は、main/masterが適用されます。
</Info>

### NPM

> NPMリポジトリに配置されているパッケージ名を入力し、プラグインがダウンロードされたら必要な情報を入力してインストールできます。

```plain theme={null}
[組織名またはアカウント名]/[パッケージ名]               
[組織名またはアカウント名]/[パッケージ名]@0.1.0-rc.1
```

<Info>
  バージョンを指定しない場合は、latestバージョンが適用されます。
</Info>

### URL

> パッケージが配置されているURLを入力することで、プラグインをインストールできます。

<Info>
  対応しているファイル形式は、tar、tar.gz、tgz、zipです。
</Info>

## プラグインの削除

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/operations/images/ja/plugin02.png" />
</Frame>

> 削除したいプラグインカードの右上のアイコンをクリックすると、アンインストールまたは削除できます。

<Tip>
  EssentialsとFile Storeプラグインはデフォルトプラグインのため削除できません。アンインストールされたプラグインは無効化状態となり、簡単に再インストールすることができます。
</Tip>