# 拡張パッケージを登録する

必要なサービスだけを選び、正式な実行ファイルと定義を登録します。

## GitHub拡張を導入する

基盤導入後に実行します。パッケージの取得・来歴検証・登録は補助ツールが行い、低水準の extensions add / replace の検証と状態維持を利用します。

```text
zix-setup install --with github
zix extensions inspect github --format json
```

[基盤の準備](https://zixcel.com/ja/docs/setup)

[GitHubの機能一覧](https://zixcel.com/ja/tools/github)

## 登録・更新・有効化を分ける

extensions add は初回登録、extensions replace は更新です。更新には新しいハッシュと現在登録されているハッシュを指定し、有効・無効の状態を維持します。資格情報への権限付与やプロバイダーの設定変更は登録時には行いません。

```text
zix extensions inspect github --format json
zix extensions --help
```

[拡張と案内の仕様](https://github.com/zixcel/cli/blob/main/docs/operation-guidance.md)

## 自分の目的に合わせて選ぶ

拡張ごとに機能・配布版・OS 条件が異なります。導入した拡張の capabilities と describe を実際の利用口として確認してください。

[対応サービスと機能](https://zixcel.com/ja/tools)

[認証情報を設定する](https://zixcel.com/ja/docs/credentials)

Canonical: https://zixcel.com/ja/docs/extensions