はじめに
以前の記事(【AWS】Amazon EC2にNetBoxコンテナを構築したい)でAWS上にNetBoxのコンテナ環境を構築しました。今回はその環境を使い、CSVでの設定投入をしてみます。
IPアドレス管理をExcelなどで行っている環境からNetBoxへ手軽に移行するには、CSVを使った一括登録が非常に便利です。
この記事では、NetBoxに登録済みのデバイスに対して、「インターフェース作成 → プレフィックス作成 → IPアドレス割り当て」という一連の作業を、CSVファイルをインポートするだけで実現する方法を解説します。
TL;DR
この記事を読めば、以下のことができるようになります
- CSVを使ってNetBoxにインターフェース、プレフィックス、IPアドレスをまとめて作成する方法
- NetBoxのCSVインポート機能の基本的な使い方と、インポートする際の注意点の理解
- Excelからのデータ移行を効率化する最初のステップを学ぶ
実行環境
- NetBox: v4.2.8
前提条件
- NetBoxにログインできるユーザーアカウントがあること
- 上記アカウントに、各種設定(インターフェース、IPアドレスなど)を追加・変更する権限が付与されていること
- インポート対象のデバイスが作成済みであること (今回は、作成済みの
Router-test
を使用)
詳細
1. インポート用CSV作成のポイント
- 設定項目ごとにCSVが必要
- 今回はインターフェース、プレフィックス、IPアドレスの3つを作成します
- CSVのヘッダーは
フィールドオプション
で確認- Web UIが日本語表示でも、ヘッダーには英語の
フィールド名
(name
やdevice
など)を指定する必要があります。この正式な名称は、インポート画面のフィールドオプション
で確認できます
- Web UIが日本語表示でも、ヘッダーには英語の
- 設定項目には依存関係があるため、CSVをインポートする順番が非常に重要
- 例:IPアドレスはインターフェースに割り当てるため、先にインターフェースが存在している必要があります
- 今回は、インターフェース -> プレフィックス -> IPアドレス の順でCSVをインポートします
2. インポート用CSVの作成 & 設定投入
2-1. インターフェース
-
デバイス
>インターフェース
を選択する -
画面右上の[インポート]を選択する
-
フィールドオプション
を見ながら、CSVを作成する-
必須
フィールドは必ず記入する -
type
フィールドのように記入方法が決まっている項目は、末尾の?
マークをクリックすると選択肢(インポート値)が確認できます
-
-
作成したCSVの内容を
Data
に貼り付けて、[送信]を選択する(実際に入れたCSVは下記)name,device,type,enabled port-01,Router-test,1000base-t,true port-02,Router-test,1000base-t,true
2-2. プレフィックス
-
IPAM
>プレフィックス
を選択する -
作成したCSVの内容を
Data
に貼り付けて、[送信]を選択しますprefix,status 192.168.0.0/24,active 192.168.1.0/24,active
2-3. IP アドレス
-
IPAM
>IP アドレス
を選択する -
作成したCSVの内容を
Data
に貼り付けて、[送信]を選択しますaddress,status,device,interface 192.168.0.1/24,active,Router-test,port-01 192.168.1.1/24,active,Router-test,port-02
3. 実行結果
以下のように、アドレス適用までをCSVのインポートでできました。port-01
にIPアドレス192.168.0.1
が
割り振られています。
さいごに
今回は、NetBoxのCSVインポート機能を使って、インターフェース作成からIPアドレスの割り当てまでを一括で行う方法を紹介しました。
これまでExcelなどでIPアドレスや機器構成を管理していた方にとって、このCSVインポート機能は非常に強力な移行ツールになります。手作業でのコピー&ペーストや、複数ファイルに散らばった情報を手入力する手間とミスから解放されるだけでも、NetBoxを導入する価値は十分にあります。ぜひ活用してみてください。
参考URL
-
【AWS】Amazon EC2にNetBoxコンテナを構築したい
- 以前のNetBox構築記事
-
【Ansible】NetBoxへのインターフェース作成 & IPアドレス割り当てを自動化したい
- Netboxの自動化に関する記事