0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

NetBoxを使ってみよう 3回: データの登録 (Organization & Device)

Last updated at Posted at 2024-09-24

概要

NetBoxを使ってみようの第3回で、今回はデータの登録を行っていきます。
NetBoxでは組織のデータやデバイスの情報などを登録してそれらの情報の関係をつなぎ合わせることで、各情報へスムーズにアクセスを行うことができるようになります。
その登録方法として大きく以下4つがあり、今回はUIから手動で登録を行っていきます。

  • UI上で手動で登録
  • 一括インポート (CSV, YAML)
  • スクリプト
  • REST API

全記事

データの種類について

NetBoxでは非常に多くのデータを登録して管理することができます。
例えばデータセンターやデータセンターの地理情報、データセンター内のラックや、ラックに搭載されているデバイスの所在などなど非常に多いです。

今回はその中でも以下のデータを登録して関連付けていきます。

データ名 大区分 概要
Tenant Organization 所有組織や所有者を指すパラメータ
Region Organization 国や県(州)などの大まかな地理
Site Organization データセンターやオフィスなどの物理的な場所
Location Organization サイト内の具体的な区画や部屋などの場所
Device Device 特定の1台のハードウェア機器
Device Type Device デバイスの型番とかのデータ
Device Role Device ルーターやスイッチ、サーバーなどといったDeviceの役割
Manufacturer Device メーカー名
Interface Device Deviceが所有しているInterface

Organization

Tenantの登録

一番最初に設定すべきパラメータとしてTenatというものがあります。
これは他のデータに対しての所有組織や所有者を指すパラメータになっています。
1つのデータに対して1つ設定可能で、所有がどこかを明確にすべきDeviceやSite、IPアドレスなどほぼ全てのパラメータに関連付けることができます。
※RegionやDevice Type、Device Roleといった特定組織に限定されないようなものは設定対象外

今回は”Stjam-Dev”というパラメータで登録していきます。

項目 名称
Tenant Stjam-Dev

登録方法は基本的にはどのデータにおいても、netbox左の欄から”+”マークを押すことで追加画面に移れます。
Tenantは“Organization”の区分に含まれています。

作成画面ではNameを入力してそのままCreateを選択して作成します。
Nameを入力すると自動で”Slug”は反映されます。

image.png

作成を行うと以下のようにTenantが確認できるようになります。
まだ何も関連付けていませんが、Tenantを関連付けると右側の”Related Objects”から数等が見れたり、リンクで各データの詳細画面に飛んだりできるようになります。
基本的にはこのあと作成するデータでTenantの関連付けができるものは全てこのTenantを設定していきます。

image.png

なお、今回は実施していませんが、Tenantは”Tenant Group”という単位でまとめることもできます。
この”Group”レベルの管理は他のパラメータでも存在していたりしますが、基本的に今回はすべて無しで単一で進めていきます。

Site関連の登録

NetBoxではDeviceなどを登録するにあたり、所在を明確にするためのデータをあらかじめ用意して関連付けて管理します。
所在を明確にするためのデータとして大きく以下3つがあり、これらを作成していく形になります。

  • Region
    • 国や県などの大枠の地理を表す
    • 例: JP, East
    • 親子関係を作成可能
  • Site
    • データセンターやオフィスなどの物理的な場所
    • 例: Tokyo-DC, Osaka-Office
  • Location
    • Site内での更に詳細な場所
    • 例: 1F, Area-01
    • 親子関係を作成可能

以下のようなイメージでそれぞれ関連付けがされていく形です。
この場合だと、”JP”の”East”の”Reagion”に”Tokyo-DC”が”Site”としてあり、その中の”1F”に”Area-01”などの”Location”があることが明確です。
image.png

今回はそこまで大規模でもないため、親子関係等は作成せず以下のようにシンプルな構成で作成を行っていきます。

項目 名称
Region JP
Site Home
Location Living

Tenantの時と同様に左の欄からReagionの”+”マークを押して、名前を入力して作成します。

image.png

作成後、Reagionの画面が表示されます。
そのまま、”Add Suite”を選択して、Siteの作成も行います。

image.png

Siteの作成では、今回は名前の入力とテナントを選択して作成をします。
今回Reagionの画面から遷移しているため、Reagionは自動で選択されています。

image.png

作成後Siteの画面が表示されます。
このまま、右下の”Add Locatoin”を選択してLocationの作成画面に移ります。

image.png

こちらもSiteと同様に名前の入力とTenantを選択して作成します。

image.png

以上でOrganizationの準備は完了となります。
今回はかなりシンプルなデータとしましたが、親子関係を作ったり、グループを用いたり、更に細かいパラメータも設定しておくこともできますので、ぜひ試してみてください。

image.png

一応今回の構成を図にするとこんな感じ。

image.png

Device

Deviceの登録

続いてDevice関連のデータの登録を行っていきます。
Deviceの登録はかなり多くのデータがありますため、今回は登録予定の以下データの関係性にまず触れます。

  • Manufacturer
    • メーカー名
  • Device Type
    • デバイスの型番とかのデータ
  • Device Role
    • ルーターやスイッチ、サーバーなどといったDeviceの役割
  • Device
    • 特定の1台のハードウェアを指す
  • Interface
    • Deviceが所有しているInterface

Deviceが保有するパラメータとしてDevice Type、Device Roleなどがあります。
そのDevice TypeとPlatformに関してはManufacturerというパラメータも持っている形になります。
更にDeviceにInterfaceを関連付けることもできます。

例えばCiscoのCatalyst 9000のSwitchを1台登録する場合、以下のような感じになります。
Switch01は、「CiscoメーカーのCatalyst 9000であり」「役割はSwitching Hubである」といったことがわかるような関連付けですね。

image.png

今回は以下図のようにRouter、Switch、Serverを1台ずつ計3台登録していく形にしてみます。
それに関連するデータも以下図に示す通りに作成していきます。
※Switch-01のInterfaceはスペースの都合上、一部省略した図になっています
image.png

まずManufacturerの登録を行っていきます。
ここは名前だけの設定のため、あらかじめ決めておいた名前でそれぞれ作成しておきます。
image.png

続いてDevice Typeの作成を行います。
今回は名前とManufacturerの関連付けだけ行っておきます。
なお、ラックマウント型想定でサイズや重さなどを指定したり、画像を添付したりもすることができます。

image.png

あらかじめ決めておいた3種類全部登録しておきました。

image.png

続いてDevice Roleの登録を行います。
名前の入力と色決めを求められるため、決めておいた3つをそれぞれ登録しておきます。

image.png

そしていよいよDeviceの登録となります。
ここまでに準備しておいた”Device Type”と”Device Role”を紐づける形になります。
また、LocationやTenantの関連付けも忘れず行っておきます。

image.png

3種類終えた感じは以下のようになります。
この時点でもどのようなDeviceかがすぐわかることが確認できます。

image.png

それではDeviceにInterfaceも追加します。
Deviceを開き、”Add Components”から”Interfaces”を選択して作成画面に遷移します。

image.png

作成画面では名前と関連付けるDeviceとType(1000-BASE-Tとかの規格)を入力及び選択する形になります。少し数が多いですが、それぞれのDeviceに関連付けて登録を行っていきます。

image.png

登録完了すると、このようにInterfaceが一覧で確認できます。
image.png

以上がDeviceの登録になります。

ケーブルの接続

先ほど登録したInterface同士をCableで接続させることができます。
これを行うことで、SwitchのどのPortに何が刺さっているか、Portの空き状況はどうかなどを確認できるようになります。

Interfaceを開き、”Connect”を選択します。

image.png

Cableの作成画面に遷移します。
ここでは接続する2つのDeviceとそのInterfaceを指定します。
また、利用するCableの種類 (CAT6等)も登録しておくこともできます。

image.png

関連付けを行うと以下のCONNECTION列のようにどこに刺さっているかが確認できます。

image.png

つながっている状態を図として表示させることもできます。

image.png

まとめ

今回はデータの登録を行っていきました。
登録してのDevice登録等はかなり大規模向けの管理な印象です。
まだまだ他にも関連付けられるデータもありますが、自宅環境程度であれば一旦今回の内容ぐらいで大丈夫かなという感じです。

次の記事はこちら

おまけ

私は全てTower型のPCをサーバーとして利用しているため用いていませんが、netboxではラック管理も行えます。
例えば、以下はnetboxの公開デモから持ってきた図ですが、このようにラックのどこに何があるかまで管理して、可視化できるもようです。
デバイスの登録時にパラメータとして機器のサイズやラックの配置場所も登録できるようになっていたりします。

image.png

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?