エラスティックIPの設定
Equinix Metalでは、コンソールやAPIを通じてお客様のサーバーに静的にElastic IPアドレスを割り当てることができます。
Elastic IPとして使用できるIPアドレス：
- Addresses in Reserved Public IPv4 subnets
- Global Anycast IP Addresses
- Private IPv4 Addresses
- Public IPv6 Addresses
すべてのIPアドレスは、グローバル・エニーキャストIPアドレス（グローバルに使用可能）を除いて、割り当てるサーバーと同じメトロとプロジェクトでなければなりません。
既存サーバへのElastic IPアドレスの追加
- Console
- CLI
- API
サーバーの［ネットワーク］タブで、［Elastic IPs］セクションの［+ Assign New Elastic ］をクリックします。スライドアウトが表示され、割り当てるサブネットとIPアドレスを選択できます。
metal ip assignコマンドでElastic IPをサーバに割り当てることができます。--addressフラグにサーバに割り当てたいIPアドレスとCIDRをプロバイダに指定します。
metal ip assign --device-id <UUID> --address 198.51.100.3/31
割り当てコマンドの応答には、ID列にUUIDが含まれています。後でElastic IPの割り当てを解除したい場合は、このUUIDが必要になります。
+--------------------------------------+----------------+--------+----------------------+
| ID | ADDRESS | PUBLIC | CREATED |
+--------------------------------------+----------------+--------+----------------------+
| c6377504-b6cd-4bf9-aaea-ebba769e0b7e | 198.51.100.3 | true | 2022-12-21T16:28:58Z |
+--------------------------------------+----------------+--------+----------------------+
APIでElastic IPをサーバに割り当てるには、/devices/{id}/ipsエンドポイントにPOSTリクエストを送信します。サーバのUUIDはパスで指定し、IPアドレスとCIDRはリクエストのボディで渡します。
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/devices/{id}/ips" \
-d '{
"address": "198.51.100.3/31"
}'
そのIPだけを送信することで、サブネットから単一のIPアドレスを割り当てることができます。サブネットの全サイズを送信してサブネット全体を割り当てることも、任意の小さいサイズのサブネットを指定することもできます。APIリファレンスにパラメータオプションの詳細が記載されています。
注意 - 割り当て要求に対する応答では、"id"フィールドにUUIDがあります。後でElastic IPの割り当てを解除したい場合は、このUUIDが必要になります。
ホストIPの設定
管理用IPとは異なり、エラスティックIPはサーバーに自動的に設定されません。セキュリティ対策として、オペレーティングシステムがインストールされると、サーバーのネットワーク設定ファイルを更新するためのサーバーへのアクセスは維持されません。サーバーのネットワーク構成に新しいIPアドレスを追加するには、お客様ご自身で行っていただく必要があります。
サンプルのIPアドレス198.51.100.3を使用して、以下の設定を変更すると、サーバーでIPアドレスが使用可能になります：
- Ubuntu/Debian
- netplan
一時的に設定する（再起動しても復帰しない）：
sudo ip addr add 198.51.100.3 dev lo
永続化するには、/etc/network/interfacesに追加します：
auto lo:0
iface lo:0 inet static
address 198.51.100.3
netmask 255.255.255.255
一時的に設定する（再起動しても復帰しない）：
sudo ip addr add 198.51.100.3 dev lo
永続化するには、/etc/netplan/00-elastic.yamlに追加します：
network:
version: 2
renderer: networkd
ethernets:
lo:
addresses:
- 127.0.0.1/8
- 198.51.100.3/32
の場合、sudo netplan try または sudo netplan apply のどちらかです。
エラスティックIPアドレスの追跡
- Console
- CLI
- API
コンソールでサブネットとIPアドレスのステータスを確認するには、プロジェクトの_IPs_タブをクリックします。IPブロックの_Actions_メニューをクリックすると、どのサブネットとIPがどのサーバーに割り当てられているかを確認できます。
サーバレベルで表示するには、サーバの_Network_タブに移動します。Elastic IPs_セクションで、そのサーバーに割り当てられたElastic IPを確認できます。
プロジェクトのすべての予約ブロック IP アドレス情報は、metal ip get コマンドから入手できます。
`metal ip get -p <project-uuid>`
特定の予約 IP ブロックで使用可能なサブネットと IP アドレスを確認するには、metal ip available コマンドを使用します。 --reservation-idはmetal ip get -p <project-uuid>コマンドから取得できます。
metal ip available --reservation-id <reservation_UUID> --cidr <size_of_subnet>
サーバに割り当てられた IP アドレスは、metal device get コマンドのレスポンスの "ip_addresses" オブジェクトで確認できます。
device get -i <device-id> --output json
回答例（切り捨て）：
{
"id": "d97f0c03-10d2-4667-9465-7f7a27a4f7a7",
....
"ip_addresses": [
{
"id": "4cc7f67b-522e-4b6c-82a5-3b2505be326a",
"address": "198.51.100.3",
"gateway": "198.51.100.2",
"network": "198.51.100.1",
"address_family": 4,
"netmask": "255.255.255.252",
"public": true,
....
"metro": {
"id": "2991b022-b8c4-497e-8db7-5a407c3a209b",
"name": "Silicon Valley",
"code": "sv",
"country": "US"
},
}
]
....
}
/ips/{id} エンドポイントに GET リクエストを送信することで、プロジェクトのサブネットと IP ブロックの IP アドレスのステータスを確認できます。IP アドレスの UUID は、それが予約 IP であろうと管理 IP ブロックであろうとパスに入ります。
curl -X GET \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/ips/{id}"
応答には、指定されたIPアドレスブロックのうち、どのIPとサブネットが使用されているかが含まれる。
サーバ レベルのビューを表示するには、/devices/{id}/ips エンドポイントに GET リクエストを送信します。
curl -X GET \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/devices/{id}/ips"
エラスティックIPアドレスの割り当て解除
- Console
- CLI
- API
サーバーからサブネットまたはIPアドレスの割り当てを解除するには、サーバーの_Network_タブに移動します。Elastic IPs_セクションでElastic IPsを選択し、Detach をクリックしてサーバーから割り当てを解除します。
metal ip unssignコマンドを使ってElastic IPアドレスの割り当てを解除します。assignment-idは元の割り当てコマンドのレスポンスから、またはdevice get -i <device-id> -o jsonコマンドからのレスポンスの"ip_addresses"オブジェクトの"id"フィールドから取得できます。
ip unassign --id <assignment-id>
その他のサブネットとIPアドレスのオプション
IPやサブネットを静的に割り当てることは、予約サブネットや管理ブロックのIPアドレスを使用する唯一の方法ではありません。
- パブリックIPv4アドレスを予約している場合、プロビジョニング時にそれらのアドレスとサブネットをサーバーに割り当てることができます。
- BGPを使用してIPアドレスをアナウンスできます。
さらにEquinix Metalは、サブネットのゲートウェイとしてパブリックまたはプライベートIPv4アドレスを提供するMetal Gatewaysを提供しています。