Merge pull request #2 from homenoc/develop

feat: add configuration of the BGP connection by VyOS GRE and some improvements

Author: symysak

docs/examples/bgp/etherip/nec-ix.md

@@ -26,6 +26,20 @@ architecture-beta
 ```
 
 ## デフォルトルート
+- 例示環境
+  - サンプルコンフィグ内のIPアドレスは、以下の仮定の下、設定しています。実際に投入する際は、ダッシュボードの値をもとに、適宜変更してください。
+  - 割り当てIPv4 Prefix: 192.0.2.0/29
+    - ルータのIPv4アドレス: 192.0.2.6/29
+    - DHCPサーバの割り当て範囲:
+      - 開始: 192.0.2.1
+      - 終了: 192.0.2.5
+  - トンネル用IPv4 Prefix: 192.0.2.254/31
+    - 弊団体側IPv4アドレス: 192.0.2.254/31
+    - 貴団体側IPv4アドレス: 192.0.2.255/31
+  - 貴団体側ASN: 64512
+  - 弊団体側トンネル終端アドレス: 2001:db8:3::1
+  - ネームサーバのIPアドレス(お好みで設定してください): 198.51.100.1
+  - IPv6 Interface Identifier: 00:00:00:00:00:00:00:01
 ```
 ! NEC Portable Internetwork Core Operating System Software
 ! IX Series IX2215 (magellan-sec) Software, Version 10.7.18, RELEASE SOFTWARE
@@ -37,13 +51,11 @@ timezone +09 00
 !
 ip ufs-cache enable
 ! GigaEthernet2がdownでもルートを広報する
-ip route <割り当てIPv4プレフィックス> Null0.0
+ip route 192.0.2.0/29 Null0.0
 ip dhcp enable
-ip prefix-list pref-in 10 permit 0.0.0.0/0
-ip prefix-list pref-in 20 deny any
-ip prefix-list pref-out 10 permit <割り当てIPv4プレフィックス>
+ip prefix-list pref-out 10 permit 192.0.2.0/29
 ip prefix-list pref-out 20 deny any
-ip access-list proxy-dns permit ip src <割り当てIPv4プレフィックス> dest any
+ip access-list proxy-dns permit ip src 192.0.2.0/29 dest any
 ip access-list proxy-dns deny ip src any dest any
 !
 !
@@ -60,21 +72,20 @@ bridge irb enable
 !
 proxy-dns ip enable
 proxy-dns ip access-list proxy-dns
-proxy-dns server <任意のDNSサーバアドレス>
+proxy-dns server 198.51.100.1
 !
 !
 !
 ip dhcp profile server1
-  assignable-range <最小割り当てアドレス> <最大割り当てアドレス>
-  default-gateway <自身のルータのアドレス>
-  dns-server <自身のルータのアドレス>
+  assignable-range 192.0.2.1 192.0.2.5
+  default-gateway 192.0.2.6
+  dns-server 192.0.2.6
 !
-router bgp <割り当てられたAS番号>
-  neighbor <HomeNOC側境界アドレス> remote-as 59105
+router bgp 64512
+  neighbor 192.0.2.254 remote-as 59105
   address-family ipv4 unicast
-    neighbor <HomeNOC側境界アドレス> distribute-list pref-in in
-    neighbor <HomeNOC側境界アドレス> distribute-list pref-out out
-    network <割り当てIPv4プレフィックス>
+    neighbor 192.0.2.254 distribute-list pref-out out
+    network 192.0.2.0/29
 !
 device GigaEthernet0
 !
@@ -92,7 +103,7 @@ interface GigaEthernet0.0
   no ip address
   ipv6 enable
 ! 以下のコマンドで、IPv6アドレスのインターフェースIDを指定する
-  ipv6 interface-identifier 00:00:00:00:ca:fe:00:02
+  ipv6 interface-identifier 00:00:00:00:00:00:00:01
   ipv6 address autoconfig receive-default
   ipv6 traffic-class tos 0
   no shutdown
@@ -102,7 +113,7 @@ interface GigaEthernet1.0
   shutdown
 !
 interface GigaEthernet2.0
-  ip address <自身のルータのアドレス>/<割り当てられたIPv4プレフィックス長>
+  ip address 192.0.2.6/29
   ip dhcp binding server1
   no shutdown
 !
@@ -119,7 +130,7 @@ interface USB-Serial0.0
   shutdown
 !
 interface BVI1
-  ip address <貴団体側トンネル境界アドレス>
+  ip address 192.0.2.255/31
   bridge-group 1
   no shutdown
 !
@@ -131,7 +142,7 @@ interface Null0.0
 !
 interface Tunnel0.0
   tunnel mode ether-ip ipv6
-  tunnel destination <トンネル終端アドレス（HomeNOC側）>
+  tunnel destination 2001:db8:3::1
   no ip address
   bridge-group 1
 ! 以下のMSS値は、MTUが1500の場合の値です。MTUが異なる場合は適宜調整してください。
@@ -157,6 +168,9 @@ interface Tunnel0.0
 単位: byte
 ```
 
+また、MSS計算の際には、運営委員の須山が作成した計算サイトもよろしければご利用ください。
+https://nw-tools.suyama.ne.jp/mtu-calculator/
+
 ## 免責事項
 本資料は参考情報です。これらの情報によって被ったいかなる損害については、弊団体は一切の責任を負いません。十分なご検証の上ご利用ください。  
 また、必要に応じてセキュリティの設定を行ってください。  

docs/examples/bgp/gre/nec-ix.md

@@ -26,6 +26,22 @@ architecture-beta
 ```
 
 ## デフォルトルート
+- 例示環境
+  - サンプルコンフィグ内のIPアドレスは、以下の仮定の下、設定しています。実際に投入する際は、ダッシュボードの値をもとに、適宜変更してください。
+  - 割り当てIPv4 Prefix: 192.0.2.0/29
+    - ルータのIPv4アドレス: 192.0.2.6/29
+    - DHCPサーバの割り当て範囲:
+      - 開始: 192.0.2.1
+      - 終了: 192.0.2.5
+  - トンネル用IPv4 Prefix: 192.0.2.254/31
+    - 弊団体側IPv4アドレス: 192.0.2.254/31
+    - 貴団体側IPv4アドレス: 192.0.2.255/31
+  - 貴団体側ASN: 64512
+  - 弊団体側トンネル終端アドレス: 2001:db8:3::1
+  - ネームサーバのIPアドレス(お好みで設定してください): 198.51.100.1
+  - IPv6 Interface Identifier: 00:00:00:00:00:00:00:01
+- 変数
+  - サンプルコンフィグ内の変数は以下の通りです。実際に投入する際は、ダッシュボードの値をもとに、もしくは実際の環境をもとに、適宜変更してください。
 ```
 ! NEC Portable Internetwork Core Operating System Software
 ! IX Series IX2215 (magellan-sec) Software, Version 10.7.18, RELEASE SOFTWARE
@@ -37,13 +53,11 @@ timezone +09 00
 !
 ip ufs-cache enable
 ! GigaEthernet2がdownでもルートを広報する
-ip route <割り当てIPv4プレフィクス> Null0.0
+ip route 192.0.2.0/29 Null0.0
 ip dhcp enable
-ip prefix-list pref-in 10 permit 0.0.0.0/0
-ip prefix-list pref-in 20 deny any
-ip prefix-list pref-out 10 permit <割り当てIPv4プレフィクス>
+ip prefix-list pref-out 10 permit 192.0.2.0/29
 ip prefix-list pref-out 20 deny any
-ip access-list proxy-dns permit ip src <割り当てIPv4プレフィクス> dest any
+ip access-list proxy-dns permit ip src 192.0.2.0/29 dest any
 ip access-list proxy-dns deny ip src any dest any
 !
 !
@@ -59,22 +73,21 @@ ipv6 ufs-cache enable
 !
 proxy-dns ip enable
 proxy-dns ip access-list proxy-dns
-proxy-dns server <任意のDNSサーバアドレス>
+proxy-dns server 198.51.100.1
 !
 !
 !
 !
 ip dhcp profile server1
-  assignable-range <最小割り当てアドレス> <最大割り当てアドレス>
-  default-gateway <自身のルータのアドレス>
-  dns-server <自身のルータのアドレス>
+  assignable-range 192.0.2.1 192.0.2.5
+  default-gateway 192.0.2.6
+  dns-server 192.0.2.6
 !
-router bgp <割り当てられたAS番号>
-  neighbor <HomeNOC側境界アドレス> remote-as 59105
+router bgp 64512
+  neighbor 192.0.2.254 remote-as 59105
   address-family ipv4 unicast
-    neighbor <HomeNOC側境界アドレス> distribute-list pref-in in
-    neighbor <HomeNOC側境界アドレス> distribute-list pref-out out
-    network <割り当てIPv4プレフィクス>
+    neighbor 192.0.2.254 distribute-list pref-out out
+    network 192.0.2.0/29
 !
 device GigaEthernet0
 !
@@ -92,7 +105,7 @@ interface GigaEthernet0.0
   no ip address
   ipv6 enable
 ! 以下のコマンドで、IPv6アドレスのインターフェースIDを指定する
-  ipv6 interface-identifier xx:xx:xx:xx:xx:xx:xx:xx
+  ipv6 interface-identifier 00:00:00:00:00:00:00:01
   ipv6 address autoconfig receive-default
   ipv6 traffic-class tos 0
   no shutdown
@@ -102,7 +115,7 @@ interface GigaEthernet1.0
   shutdown
 !
 interface GigaEthernet2.0
-  ip address <自身のルータのアドレス>/<割り当てられたIPv4プレフィクス長>
+  ip address 192.0.2.6/29
   ip dhcp binding server1
   no shutdown
 !
@@ -126,8 +139,8 @@ interface Null0.0
 !
 interface Tunnel0.0
   tunnel mode gre ipv6
-  tunnel destination <トンネル終端アドレス（HomeNOC側）>
-  ip address <貴団体側トンネル境界アドレス>
+  tunnel destination 2001:db8:3::1
+  ip address 192.0.2.255/31
 ! 以下のMSS値は、MTUが1500の場合の値です。MTUが異なる場合は適宜調整してください。
   ip tcp adjust-mss 1416
   no shutdown
@@ -151,6 +164,9 @@ interface Tunnel0.0
 単位: byte
 ```
 
+また、MSS計算の際には、運営委員の須山が作成した計算サイトもよろしければご利用ください。
+https://nw-tools.suyama.ne.jp/mtu-calculator/
+
 ## 免責事項
 本資料は参考情報です。これらの情報によって被ったいかなる損害については、弊団体は一切の責任を負いません。十分なご検証の上ご利用ください。  
 また、必要に応じてセキュリティの設定を行ってください。