やりたいこと

Home Assistantのカスタムインテグレーション開発環境（以下、HA開発環境）において、
これまで開発用とリリース用で分けていたGitリポジトリを一本化しました。

リリース作業の簡素化、IssueなどのGitHub機能の一元管理を目的としたもので、
リリース用リポジトリにdevelopブランチを作成し、開発も同じリポジトリで行う構成に変更しています。

Git操作にまだ不慣れなところもあるため、備忘録として移行作業の手順を残しておきます。

ちなみに、今回出てくるHome Assistantのカスタムインテグレーションはこちらです。

■現状

開発用リポジトリ：homeassistant_config（プライベート）
リリース用リポジトリ：homeassistant_nature_remo（パブリック）

※開発・リリースが別々のリポジトリで管理されていた

■変更後

リリース用リポジトリ homeassistant_nature_remo に develop ブランチを作成
開発環境も同一リポジトリ内で行うことで、GitHub機能を一元活用

開発環境

OS：Ubuntu
構成：~/homeassistant-dev/config に開発用リポジトリをクローン済み
Home Assistant Core（venv構成）
開発リポジトリの履歴は移行しない方針

やりたいこと

開発・リリース統合リポジトリへ環境を切り替え
developブランチで開発継続
Home Assistantがこれまで通り動作すること

移行手順

Step 1：既存の開発用リポジトリのバックアップ

sudo apt update
sudo apt install zip

cd ~/homeassistant-dev
zip -r config_backup_$(date +%Y%m%d).zip config

※ zip が入っていない環境では、最初にインストールします
※ config_backup_20250415.zip のように日付付きファイルが作成されます

Step 2：リリース用リポジトリに develop ブランチを作成

GitHubのWeb UIから操作するのが簡単です：
１. main ドロップダウンをクリック
２. develop と入力して「Create branch develop from main」をクリック

３. ブランチ作成を確認

Step 3：開発環境の config/ を切り替える

# .git削除してGit追跡を外す
cd ~/homeassistant-dev/config
rm -rf .git

# config ディレクトリを退避
cd ~/homeassistant-dev
mv config config_old

# developブランチを新しくクローン
git clone -b develop https://github.com/NaNaLinks/homeassistant_nature_remo.git config

# developブランチになっていることを確認
cd config
git branch

Step 4：旧configから必要なファイルを移植

cd ~/homeassistant-dev

# カスタム統合をコピー
cp -r config_old/custom_components/nature_remo config/custom_components/

# 基本設定ファイルをコピー
cp config_old/configuration.yaml config/
cp config_old/secrets.yaml config/
cp config_old/automations.yaml config/
cp config_old/scripts.yaml config/
cp config_old/scenes.yaml config/

Step 5：.gitignore を整理

.gitignore

# Python
__pycache__/
*.pyc
.env
.venv/
.idea/
.vscode/
*.egg-info/
dist/
build/

# Home Assistant
*.log
*.db
*.db-shm
*.db-wal
secrets.yaml
.cloud
.storage/
home-assistant.log*
deps/
.HA_VERSION
blueprints/
configuration.yaml
automations.yaml
scenes.yaml
scripts.yaml

# optional
custom_components/__pycache__/

.yaml ファイルはGit管理しない方針にしています

Step 6：移行後の環境でHome Assistantを起動

source ~/homeassistant-dev/venv/bin/activate
hass -c ~/homeassistant-dev/config

初回起動時はユーザー登録画面が表示される

DBは移行していないため、新規環境としてセットアップされる

Step 7：旧環境 config_old を削除

rm -rf ~/homeassistant-dev/config_old

まとめ

リポジトリを一つに統合することで、運用がかなり楽になりました。
ブランチを活用することで、開発・検証・リリースのフローもスムーズにできそうです。