summaryrefslogtreecommitdiff
path: root/docs/_locale/pt/LC_MESSAGES/automation.mo
blob: e9c17d9e2ed25b4528cd813b97445f44e6f7314c (plain)
ofshex dumpascii
0000 de 12 04 95 00 00 00 00 e1 00 00 00 1c 00 00 00 24 07 00 00 33 01 00 00 2c 0e 00 00 00 00 00 00 ................$...3...,.......
0020 f8 12 00 00 69 00 00 00 f9 12 00 00 25 00 00 00 63 13 00 00 6a 00 00 00 89 13 00 00 54 00 00 00 ....i.......%...c...j.......T...
0040 f4 13 00 00 5d 00 00 00 49 14 00 00 26 00 00 00 a7 14 00 00 0c 00 00 00 ce 14 00 00 0a 00 00 00 ....]...I...&...................
0060 db 14 00 00 09 00 00 00 e6 14 00 00 06 00 00 00 f0 14 00 00 09 00 00 00 f7 14 00 00 07 00 00 00 ................................
0080 01 15 00 00 06 00 00 00 09 15 00 00 09 00 00 00 10 15 00 00 05 00 00 00 1a 15 00 00 c2 00 00 00 ................................
00a0 20 15 00 00 f2 00 00 00 e3 15 00 00 6d 00 00 00 d6 16 00 00 3d 00 00 00 44 17 00 00 0d 00 00 00 ............m.......=...D.......
00c0 82 17 00 00 11 00 00 00 90 17 00 00 64 00 00 00 a2 17 00 00 44 00 00 00 07 18 00 00 19 00 00 00 ............d.......D...........
00e0 4c 18 00 00 07 00 00 00 66 18 00 00 8f 00 00 00 6e 18 00 00 41 00 00 00 fe 18 00 00 0e 00 00 00 L.......f.......n...A...........
0100 40 19 00 00 82 00 00 00 4f 19 00 00 64 00 00 00 d2 19 00 00 22 00 00 00 37 1a 00 00 21 00 00 00 @.......O...d......."...7...!...
0120 5a 1a 00 00 33 00 00 00 7c 1a 00 00 19 01 00 00 b0 1a 00 00 14 00 00 00 ca 1b 00 00 22 00 00 00 Z...3...|..................."...
0140 df 1b 00 00 15 00 00 00 02 1c 00 00 21 00 00 00 18 1c 00 00 11 00 00 00 3a 1c 00 00 23 00 00 00 ............!...........:...#...
0160 4c 1c 00 00 16 00 00 00 70 1c 00 00 0e 00 00 00 87 1c 00 00 0d 00 00 00 96 1c 00 00 98 00 00 00 L.......p.......................
0180 a4 1c 00 00 1d 00 00 00 3d 1d 00 00 19 00 00 00 5b 1d 00 00 14 00 00 00 75 1d 00 00 19 00 00 00 ........=.......[.......u.......
01a0 8a 1d 00 00 13 00 00 00 a4 1d 00 00 1b 00 00 00 b8 1d 00 00 2a 00 00 00 d4 1d 00 00 18 00 00 00 ....................*...........
01c0 ff 1d 00 00 1f 00 00 00 18 1e 00 00 0f 00 00 00 38 1e 00 00 c7 00 00 00 48 1e 00 00 0f 00 00 00 ................8.......H.......
01e0 10 1f 00 00 5c 00 00 00 20 1f 00 00 49 00 00 00 7d 1f 00 00 07 00 00 00 c7 1f 00 00 4f 00 00 00 ....\.......I...}...........O...
0200 cf 1f 00 00 19 00 00 00 1f 20 00 00 13 00 00 00 39 20 00 00 08 00 00 00 4d 20 00 00 1f 00 00 00 ................9.......M.......
0220 56 20 00 00 26 00 00 00 76 20 00 00 0d 00 00 00 9d 20 00 00 53 00 00 00 ab 20 00 00 3d 00 00 00 V...&...v...........S.......=...
0240 ff 20 00 00 3a 00 00 00 3d 21 00 00 9d 00 00 00 78 21 00 00 37 00 00 00 16 22 00 00 2d 00 00 00 ....:...=!......x!..7...."..-...
0260 4e 22 00 00 b3 00 00 00 7c 22 00 00 46 00 00 00 30 23 00 00 0f 00 00 00 77 23 00 00 13 00 00 00 N"......|"..F...0#......w#......
0280 87 23 00 00 0f 00 00 00 9b 23 00 00 19 00 00 00 ab 23 00 00 55 00 00 00 c5 23 00 00 a7 00 00 00 .#.......#.......#..U....#......
02a0 1b 24 00 00 3c 00 00 00 c3 24 00 00 4d 01 00 00 00 25 00 00 b3 00 00 00 4e 26 00 00 8d 00 00 00 .$..<....$..M....%......N&......
02c0 02 27 00 00 8f 00 00 00 90 27 00 00 31 00 00 00 20 28 00 00 42 00 00 00 52 28 00 00 2e 00 00 00 .'.......'..1....(..B...R(......
02e0 95 28 00 00 62 00 00 00 c4 28 00 00 a9 00 00 00 27 29 00 00 15 00 00 00 d1 29 00 00 1e 00 00 00 .(..b....(......').......)......
0300 e7 29 00 00 c7 00 00 00 06 2a 00 00 1e 00 00 00 ce 2a 00 00 0c 00 00 00 ed 2a 00 00 d7 00 00 00 .).......*.......*.......*......
0320 fa 2a 00 00 58 01 00 00 d2 2b 00 00 9b 00 00 00 2b 2d 00 00 30 00 00 00 c7 2d 00 00 06 00 00 00 .*..X....+......+-..0....-......
0340 f8 2d 00 00 07 00 00 00 ff 2d 00 00 0d 00 00 00 07 2e 00 00 b6 00 00 00 15 2e 00 00 40 00 00 00 .-.......-..................@...
0360 cc 2e 00 00 07 00 00 00 0d 2f 00 00 06 00 00 00 15 2f 00 00 fa 00 00 00 1c 2f 00 00 50 00 00 00 ........./......./......./..P...
0380 17 30 00 00 34 00 00 00 68 30 00 00 a5 00 00 00 9d 30 00 00 12 00 00 00 43 31 00 00 81 00 00 00 .0..4...h0.......0......C1......
03a0 56 31 00 00 15 00 00 00 d8 31 00 00 07 00 00 00 ee 31 00 00 16 00 00 00 f6 31 00 00 06 00 00 00 V1.......1.......1.......1......
03c0 0d 32 00 00 0e 00 00 00 14 32 00 00 4a 00 00 00 23 32 00 00 12 00 00 00 6e 32 00 00 1d 00 00 00 .2.......2..J...#2......n2......
03e0 81 32 00 00 11 00 00 00 9f 32 00 00 18 00 00 00 b1 32 00 00 28 00 00 00 ca 32 00 00 1e 00 00 00 .2.......2.......2..(....2......
0400 f3 32 00 00 06 00 00 00 12 33 00 00 93 01 00 00 19 33 00 00 0a 00 00 00 ad 34 00 00 70 00 00 00 .2.......3.......3.......4..p...
0420 b8 34 00 00 0c 00 00 00 29 35 00 00 0b 00 00 00 36 35 00 00 15 00 00 00 42 35 00 00 1a 00 00 00 .4......)5......65......B5......
0440 58 35 00 00 18 00 00 00 73 35 00 00 1d 00 00 00 8c 35 00 00 04 00 00 00 aa 35 00 00 1a 00 00 00 X5......s5.......5.......5......
0460 af 35 00 00 27 00 00 00 ca 35 00 00 8c 00 00 00 f2 35 00 00 15 00 00 00 7f 36 00 00 c9 00 00 00 .5..'....5.......5.......6......
0480 95 36 00 00 0b 00 00 00 5f 37 00 00 62 00 00 00 6b 37 00 00 81 00 00 00 ce 37 00 00 17 00 00 00 .6......_7..b...k7.......7......
04a0 50 38 00 00 12 00 00 00 68 38 00 00 19 00 00 00 7b 38 00 00 18 01 00 00 95 38 00 00 7d 00 00 00 P8......h8......{8.......8..}...
04c0 ae 39 00 00 80 00 00 00 2c 3a 00 00 45 00 00 00 ad 3a 00 00 35 00 00 00 f3 3a 00 00 2f 00 00 00 .9......,:..E....:..5....:../...
04e0 29 3b 00 00 d2 00 00 00 59 3b 00 00 84 00 00 00 2c 3c 00 00 48 00 00 00 b1 3c 00 00 21 00 00 00 );......Y;......,<..H....<..!...
0500 fa 3c 00 00 61 00 00 00 1c 3d 00 00 41 00 00 00 7e 3d 00 00 70 00 00 00 c0 3d 00 00 54 00 00 00 .<..a....=..A...~=..p....=..T...
0520 31 3e 00 00 bc 00 00 00 86 3e 00 00 85 00 00 00 43 3f 00 00 e7 00 00 00 c9 3f 00 00 2a 00 00 00 1>.......>......C?.......?..*...
0540 b1 40 00 00 3b 00 00 00 dc 40 00 00 93 00 00 00 18 41 00 00 1d 00 00 00 ac 41 00 00 37 00 00 00 .@..;....@.......A.......A..7...
0560 ca 41 00 00 8b 00 00 00 02 42 00 00 48 00 00 00 8e 42 00 00 90 00 00 00 d7 42 00 00 31 00 00 00 .A.......B..H....B.......B..1...
0580 68 43 00 00 7f 00 00 00 9a 43 00 00 47 00 00 00 1a 44 00 00 36 00 00 00 62 44 00 00 0f 00 00 00 hC.......C..G....D..6...bD......
05a0 99 44 00 00 95 00 00 00 a9 44 00 00 09 00 00 00 3f 45 00 00 ac 00 00 00 49 45 00 00 18 00 00 00 .D.......D......?E......IE......
05c0 f6 45 00 00 0c 00 00 00 0f 46 00 00 2a 00 00 00 1c 46 00 00 39 00 00 00 47 46 00 00 25 00 00 00 .E.......F..*....F..9...GF..%...
05e0 81 46 00 00 08 00 00 00 a7 46 00 00 0f 00 00 00 b0 46 00 00 18 00 00 00 c0 46 00 00 0f 00 00 00 .F.......F.......F.......F......
0600 d9 46 00 00 3a 00 00 00 e9 46 00 00 48 00 00 00 24 47 00 00 2b 00 00 00 6d 47 00 00 64 00 00 00 .F..:....F..H...$G..+...mG..d...
0620 99 47 00 00 5c 00 00 00 fe 47 00 00 64 00 00 00 5b 48 00 00 32 00 00 00 c0 48 00 00 5b 00 00 00 .G..\....G..d...[H..2....H..[...
0640 f3 48 00 00 ed 01 00 00 4f 49 00 00 31 00 00 00 3d 4b 00 00 0e 01 00 00 6f 4b 00 00 0c 00 00 00 .H......OI..1...=K......oK......
0660 7e 4c 00 00 48 00 00 00 8b 4c 00 00 4d 00 00 00 d4 4c 00 00 4e 00 00 00 22 4d 00 00 21 00 00 00 ~L..H....L..M....L..N..."M..!...
0680 71 4d 00 00 59 00 00 00 93 4d 00 00 1b 00 00 00 ed 4d 00 00 75 00 00 00 09 4e 00 00 18 00 00 00 qM..Y....M.......M..u....N......
06a0 7f 4e 00 00 b5 00 00 00 98 4e 00 00 44 00 00 00 4e 4f 00 00 15 01 00 00 93 4f 00 00 0c 00 00 00 .N.......N..D...NO.......O......
06c0 a9 50 00 00 0b 00 00 00 b6 50 00 00 18 00 00 00 c2 50 00 00 d3 00 00 00 db 50 00 00 0c 00 00 00 .P.......P.......P.......P......
06e0 af 51 00 00 39 00 00 00 bc 51 00 00 05 00 00 00 f6 51 00 00 3c 00 00 00 fc 51 00 00 56 00 00 00 .Q..9....Q.......Q..<....Q..V...
0700 39 52 00 00 08 00 00 00 90 52 00 00 45 00 00 00 99 52 00 00 0f 00 00 00 df 52 00 00 07 00 00 00 9R.......R..E....R.......R......
0720 ef 52 00 00 e2 00 00 00 f7 52 00 00 69 00 00 00 da 53 00 00 25 00 00 00 44 54 00 00 6a 00 00 00 .R.......R..i....S..%...DT..j...
0740 6a 54 00 00 54 00 00 00 d5 54 00 00 5d 00 00 00 2a 55 00 00 26 00 00 00 88 55 00 00 0c 00 00 00 jT..T....T..]...*U..&....U......
0760 af 55 00 00 0a 00 00 00 bc 55 00 00 09 00 00 00 c7 55 00 00 06 00 00 00 d1 55 00 00 09 00 00 00 .U.......U.......U.......U......
0780 d8 55 00 00 07 00 00 00 e2 55 00 00 06 00 00 00 ea 55 00 00 09 00 00 00 f1 55 00 00 05 00 00 00 .U.......U.......U.......U......
07a0 fb 55 00 00 c2 00 00 00 01 56 00 00 f2 00 00 00 c4 56 00 00 6d 00 00 00 b7 57 00 00 3d 00 00 00 .U.......V.......V..m....W..=...
07c0 25 58 00 00 0d 00 00 00 63 58 00 00 11 00 00 00 71 58 00 00 64 00 00 00 83 58 00 00 44 00 00 00 %X......cX......qX..d....X..D...
07e0 e8 58 00 00 19 00 00 00 2d 59 00 00 07 00 00 00 47 59 00 00 8f 00 00 00 4f 59 00 00 41 00 00 00 .X......-Y......GY......OY..A...
0800 df 59 00 00 0e 00 00 00 21 5a 00 00 82 00 00 00 30 5a 00 00 64 00 00 00 b3 5a 00 00 22 00 00 00 .Y......!Z......0Z..d....Z.."...
0820 18 5b 00 00 21 00 00 00 3b 5b 00 00 33 00 00 00 5d 5b 00 00 19 01 00 00 91 5b 00 00 14 00 00 00 .[..!...;[..3...][.......[......
0840 ab 5c 00 00 22 00 00 00 c0 5c 00 00 15 00 00 00 e3 5c 00 00 21 00 00 00 f9 5c 00 00 11 00 00 00 .\.."....\.......\..!....\......
0860 1b 5d 00 00 23 00 00 00 2d 5d 00 00 16 00 00 00 51 5d 00 00 0e 00 00 00 68 5d 00 00 0d 00 00 00 .]..#...-]......Q]......h]......
0880 77 5d 00 00 98 00 00 00 85 5d 00 00 1d 00 00 00 1e 5e 00 00 19 00 00 00 3c 5e 00 00 14 00 00 00 w].......].......^......<^......
08a0 56 5e 00 00 19 00 00 00 6b 5e 00 00 13 00 00 00 85 5e 00 00 1b 00 00 00 99 5e 00 00 2a 00 00 00 V^......k^.......^.......^..*...
08c0 b5 5e 00 00 18 00 00 00 e0 5e 00 00 1f 00 00 00 f9 5e 00 00 0f 00 00 00 19 5f 00 00 c7 00 00 00 .^.......^.......^......._......
08e0 29 5f 00 00 0f 00 00 00 f1 5f 00 00 5c 00 00 00 01 60 00 00 49 00 00 00 5e 60 00 00 07 00 00 00 )_......._..\....`..I...^`......
0900 a8 60 00 00 4f 00 00 00 b0 60 00 00 19 00 00 00 00 61 00 00 13 00 00 00 1a 61 00 00 08 00 00 00 .`..O....`.......a.......a......
0920 2e 61 00 00 1f 00 00 00 37 61 00 00 26 00 00 00 57 61 00 00 0d 00 00 00 7e 61 00 00 53 00 00 00 .a......7a..&...Wa......~a..S...
0940 8c 61 00 00 3d 00 00 00 e0 61 00 00 3a 00 00 00 1e 62 00 00 9d 00 00 00 59 62 00 00 37 00 00 00 .a..=....a..:....b......Yb..7...
0960 f7 62 00 00 2d 00 00 00 2f 63 00 00 b3 00 00 00 5d 63 00 00 46 00 00 00 11 64 00 00 0f 00 00 00 .b..-.../c......]c..F....d......
0980 58 64 00 00 13 00 00 00 68 64 00 00 0f 00 00 00 7c 64 00 00 19 00 00 00 8c 64 00 00 55 00 00 00 Xd......hd......|d.......d..U...
09a0 a6 64 00 00 a7 00 00 00 fc 64 00 00 3c 00 00 00 a4 65 00 00 4d 01 00 00 e1 65 00 00 b3 00 00 00 .d.......d..<....e..M....e......
09c0 2f 67 00 00 8d 00 00 00 e3 67 00 00 8f 00 00 00 71 68 00 00 31 00 00 00 01 69 00 00 42 00 00 00 /g.......g......qh..1....i..B...
09e0 33 69 00 00 2e 00 00 00 76 69 00 00 62 00 00 00 a5 69 00 00 a9 00 00 00 08 6a 00 00 15 00 00 00 3i......vi..b....i.......j......
0a00 b2 6a 00 00 1e 00 00 00 c8 6a 00 00 c7 00 00 00 e7 6a 00 00 1e 00 00 00 af 6b 00 00 0c 00 00 00 .j.......j.......j.......k......
0a20 ce 6b 00 00 d7 00 00 00 db 6b 00 00 58 01 00 00 b3 6c 00 00 9b 00 00 00 0c 6e 00 00 30 00 00 00 .k.......k..X....l.......n..0...
0a40 a8 6e 00 00 06 00 00 00 d9 6e 00 00 07 00 00 00 e0 6e 00 00 0d 00 00 00 e8 6e 00 00 b6 00 00 00 .n.......n.......n.......n......
0a60 f6 6e 00 00 40 00 00 00 ad 6f 00 00 07 00 00 00 ee 6f 00 00 06 00 00 00 f6 6f 00 00 fa 00 00 00 .n..@....o.......o.......o......
0a80 fd 6f 00 00 50 00 00 00 f8 70 00 00 34 00 00 00 49 71 00 00 a5 00 00 00 7e 71 00 00 12 00 00 00 .o..P....p..4...Iq......~q......
0aa0 24 72 00 00 81 00 00 00 37 72 00 00 15 00 00 00 b9 72 00 00 07 00 00 00 cf 72 00 00 16 00 00 00 $r......7r.......r.......r......
0ac0 d7 72 00 00 06 00 00 00 ee 72 00 00 0e 00 00 00 f5 72 00 00 4a 00 00 00 04 73 00 00 12 00 00 00 .r.......r.......r..J....s......
0ae0 4f 73 00 00 1d 00 00 00 62 73 00 00 11 00 00 00 80 73 00 00 18 00 00 00 92 73 00 00 28 00 00 00 Os......bs.......s.......s..(...
0b00 ab 73 00 00 1e 00 00 00 d4 73 00 00 06 00 00 00 f3 73 00 00 93 01 00 00 fa 73 00 00 0a 00 00 00 .s.......s.......s.......s......
0b20 8e 75 00 00 70 00 00 00 99 75 00 00 0c 00 00 00 0a 76 00 00 0b 00 00 00 17 76 00 00 15 00 00 00 .u..p....u.......v.......v......
0b40 23 76 00 00 1a 00 00 00 39 76 00 00 18 00 00 00 54 76 00 00 1d 00 00 00 6d 76 00 00 04 00 00 00 #v......9v......Tv......mv......
0b60 8b 76 00 00 1a 00 00 00 90 76 00 00 27 00 00 00 ab 76 00 00 8c 00 00 00 d3 76 00 00 15 00 00 00 .v.......v..'....v.......v......
0b80 60 77 00 00 c9 00 00 00 76 77 00 00 0b 00 00 00 40 78 00 00 62 00 00 00 4c 78 00 00 81 00 00 00 `w......vw......@x..b...Lx......
0ba0 af 78 00 00 17 00 00 00 31 79 00 00 12 00 00 00 49 79 00 00 19 00 00 00 5c 79 00 00 18 01 00 00 .x......1y......Iy......\y......
0bc0 76 79 00 00 7d 00 00 00 8f 7a 00 00 80 00 00 00 0d 7b 00 00 45 00 00 00 8e 7b 00 00 35 00 00 00 vy..}....z.......{..E....{..5...
0be0 d4 7b 00 00 2f 00 00 00 0a 7c 00 00 d2 00 00 00 3a 7c 00 00 84 00 00 00 0d 7d 00 00 48 00 00 00 .{../....|......:|.......}..H...
0c00 92 7d 00 00 21 00 00 00 db 7d 00 00 61 00 00 00 fd 7d 00 00 41 00 00 00 5f 7e 00 00 70 00 00 00 .}..!....}..a....}..A..._~..p...
0c20 a1 7e 00 00 54 00 00 00 12 7f 00 00 bc 00 00 00 67 7f 00 00 85 00 00 00 24 80 00 00 e7 00 00 00 .~..T...........g.......$.......
0c40 aa 80 00 00 2a 00 00 00 92 81 00 00 3b 00 00 00 bd 81 00 00 93 00 00 00 f9 81 00 00 1d 00 00 00 ....*.......;...................
0c60 8d 82 00 00 37 00 00 00 ab 82 00 00 8b 00 00 00 e3 82 00 00 48 00 00 00 6f 83 00 00 90 00 00 00 ....7...............H...o.......
0c80 b8 83 00 00 31 00 00 00 49 84 00 00 7f 00 00 00 7b 84 00 00 47 00 00 00 fb 84 00 00 36 00 00 00 ....1...I.......{...G.......6...
0ca0 43 85 00 00 0f 00 00 00 7a 85 00 00 95 00 00 00 8a 85 00 00 09 00 00 00 20 86 00 00 ac 00 00 00 C.......z.......................
0cc0 2a 86 00 00 18 00 00 00 d7 86 00 00 0c 00 00 00 f0 86 00 00 2a 00 00 00 fd 86 00 00 39 00 00 00 *...................*.......9...
0ce0 28 87 00 00 25 00 00 00 62 87 00 00 08 00 00 00 88 87 00 00 0f 00 00 00 91 87 00 00 18 00 00 00 (...%...b.......................
0d00 a1 87 00 00 0f 00 00 00 ba 87 00 00 3a 00 00 00 ca 87 00 00 48 00 00 00 05 88 00 00 2b 00 00 00 ............:.......H.......+...
0d20 4e 88 00 00 64 00 00 00 7a 88 00 00 5c 00 00 00 df 88 00 00 64 00 00 00 3c 89 00 00 32 00 00 00 N...d...z...\.......d...<...2...
0d40 a1 89 00 00 5b 00 00 00 d4 89 00 00 ed 01 00 00 30 8a 00 00 31 00 00 00 1e 8c 00 00 0e 01 00 00 ....[...........0...1...........
0d60 50 8c 00 00 0c 00 00 00 5f 8d 00 00 48 00 00 00 6c 8d 00 00 4d 00 00 00 b5 8d 00 00 4e 00 00 00 P......._...H...l...M.......N...
0d80 03 8e 00 00 21 00 00 00 52 8e 00 00 59 00 00 00 74 8e 00 00 1b 00 00 00 ce 8e 00 00 75 00 00 00 ....!...R...Y...t...........u...
0da0 ea 8e 00 00 18 00 00 00 60 8f 00 00 b5 00 00 00 79 8f 00 00 44 00 00 00 2f 90 00 00 15 01 00 00 ........`.......y...D.../.......
0dc0 74 90 00 00 0c 00 00 00 8a 91 00 00 0b 00 00 00 97 91 00 00 18 00 00 00 a3 91 00 00 d3 00 00 00 t...............................
0de0 bc 91 00 00 0c 00 00 00 90 92 00 00 39 00 00 00 9d 92 00 00 05 00 00 00 d7 92 00 00 3c 00 00 00 ............9...............<...
0e00 dd 92 00 00 56 00 00 00 1a 93 00 00 08 00 00 00 71 93 00 00 45 00 00 00 7a 93 00 00 0f 00 00 00 ....V...........q...E...z.......
0e20 c0 93 00 00 07 00 00 00 d0 93 00 00 01 00 00 00 00 00 00 00 a3 00 00 00 06 00 00 00 82 00 00 00 ................................
0e40 d2 00 00 00 00 00 00 00 de 00 00 00 94 00 00 00 73 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................s...............
0e60 3a 00 00 00 4e 00 00 00 00 00 00 00 83 00 00 00 3c 00 00 00 9c 00 00 00 ca 00 00 00 25 00 00 00 :...N...........<...........%...
0e80 89 00 00 00 00 00 00 00 7a 00 00 00 aa 00 00 00 00 00 00 00 a9 00 00 00 b9 00 00 00 00 00 00 00 ........z.......................
0ea0 a1 00 00 00 00 00 00 00 00 00 00 00 0e 00 00 00 9e 00 00 00 78 00 00 00 c4 00 00 00 45 00 00 00 ....................x.......E...
0ec0 87 00 00 00 5f 00 00 00 00 00 00 00 db 00 00 00 8f 00 00 00 a5 00 00 00 b6 00 00 00 00 00 00 00 ...._...........................
0ee0 00 00 00 00 15 00 00 00 66 00 00 00 a8 00 00 00 90 00 00 00 18 00 00 00 58 00 00 00 d8 00 00 00 ........f...............X.......
0f00 c3 00 00 00 cf 00 00 00 76 00 00 00 38 00 00 00 00 00 00 00 e1 00 00 00 d3 00 00 00 7b 00 00 00 ........v...8...............{...
0f20 00 00 00 00 00 00 00 00 b4 00 00 00 35 00 00 00 1d 00 00 00 6e 00 00 00 98 00 00 00 00 00 00 00 ............5.......n...........
0f40 6c 00 00 00 4a 00 00 00 62 00 00 00 71 00 00 00 bc 00 00 00 c1 00 00 00 00 00 00 00 7c 00 00 00 l...J...b...q...............|...
0f60 00 00 00 00 4f 00 00 00 9d 00 00 00 00 00 00 00 74 00 00 00 80 00 00 00 00 00 00 00 af 00 00 00 ....O...........t...............
0f80 60 00 00 00 88 00 00 00 6f 00 00 00 00 00 00 00 b2 00 00 00 24 00 00 00 16 00 00 00 2f 00 00 00 `.......o...........$......./...
0fa0 a4 00 00 00 00 00 00 00 36 00 00 00 00 00 00 00 5b 00 00 00 31 00 00 00 e0 00 00 00 75 00 00 00 ........6.......[...1.......u...
0fc0 c9 00 00 00 11 00 00 00 03 00 00 00 ab 00 00 00 50 00 00 00 41 00 00 00 d4 00 00 00 47 00 00 00 ................P...A.......G...
0fe0 1e 00 00 00 ba 00 00 00 04 00 00 00 05 00 00 00 1c 00 00 00 1a 00 00 00 00 00 00 00 34 00 00 00 ............................4...
1000 7d 00 00 00 72 00 00 00 28 00 00 00 86 00 00 00 00 00 00 00 dd 00 00 00 57 00 00 00 8a 00 00 00 }...r...(...............W.......
1020 00 00 00 00 7e 00 00 00 92 00 00 00 54 00 00 00 c0 00 00 00 5e 00 00 00 10 00 00 00 91 00 00 00 ....~.......T.......^...........
1040 6b 00 00 00 4d 00 00 00 00 00 00 00 00 00 00 00 a0 00 00 00 00 00 00 00 02 00 00 00 00 00 00 00 k...M...........................
1060 9f 00 00 00 00 00 00 00 cb 00 00 00 00 00 00 00 27 00 00 00 46 00 00 00 0d 00 00 00 c5 00 00 00 ................'...F...........
1080 00 00 00 00 2e 00 00 00 5a 00 00 00 00 00 00 00 39 00 00 00 85 00 00 00 81 00 00 00 51 00 00 00 ........Z.......9...........Q...
10a0 09 00 00 00 d6 00 00 00 0f 00 00 00 40 00 00 00 00 00 00 00 00 00 00 00 3f 00 00 00 26 00 00 00 ............@...........?...&...
10c0 c7 00 00 00 53 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 bd 00 00 00 65 00 00 00 23 00 00 00 ....S...................e...#...
10e0 00 00 00 00 6d 00 00 00 00 00 00 00 4c 00 00 00 00 00 00 00 0c 00 00 00 8c 00 00 00 00 00 00 00 ....m.......L...................
1100 1b 00 00 00 4b 00 00 00 67 00 00 00 00 00 00 00 59 00 00 00 ce 00 00 00 08 00 00 00 00 00 00 00 ....K...g.......Y...............
1120 14 00 00 00 00 00 00 00 52 00 00 00 cc 00 00 00 56 00 00 00 00 00 00 00 0b 00 00 00 00 00 00 00 ........R.......V...............
1140 d1 00 00 00 8e 00 00 00 00 00 00 00 2c 00 00 00 44 00 00 00 5d 00 00 00 d9 00 00 00 c6 00 00 00 ............,...D...]...........
1160 6a 00 00 00 3b 00 00 00 00 00 00 00 00 00 00 00 1f 00 00 00 d5 00 00 00 30 00 00 00 ac 00 00 00 j...;...................0.......
1180 29 00 00 00 79 00 00 00 5c 00 00 00 00 00 00 00 33 00 00 00 95 00 00 00 c8 00 00 00 b0 00 00 00 )...y...\.......3...............
11a0 19 00 00 00 ad 00 00 00 63 00 00 00 b8 00 00 00 96 00 00 00 77 00 00 00 b5 00 00 00 a6 00 00 00 ........c...........w...........
11c0 00 00 00 00 da 00 00 00 00 00 00 00 b7 00 00 00 48 00 00 00 bf 00 00 00 84 00 00 00 55 00 00 00 ................H...........U...
11e0 b3 00 00 00 00 00 00 00 17 00 00 00 bb 00 00 00 00 00 00 00 2d 00 00 00 93 00 00 00 9a 00 00 00 ....................-...........
1200 00 00 00 00 a7 00 00 00 d0 00 00 00 3d 00 00 00 00 00 00 00 c2 00 00 00 00 00 00 00 cd 00 00 00 ............=...................
1220 0a 00 00 00 8d 00 00 00 b1 00 00 00 00 00 00 00 22 00 00 00 00 00 00 00 d7 00 00 00 00 00 00 00 ................"...............
1240 7f 00 00 00 37 00 00 00 00 00 00 00 3e 00 00 00 68 00 00 00 00 00 00 00 2a 00 00 00 07 00 00 00 ....7.......>...h.......*.......
1260 a2 00 00 00 00 00 00 00 00 00 00 00 12 00 00 00 be 00 00 00 21 00 00 00 df 00 00 00 00 00 00 00 ....................!...........
1280 dc 00 00 00 49 00 00 00 00 00 00 00 64 00 00 00 ae 00 00 00 00 00 00 00 32 00 00 00 00 00 00 00 ....I.......d...........2.......
12a0 00 00 00 00 70 00 00 00 61 00 00 00 20 00 00 00 13 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ....p...a.......................
12c0 97 00 00 00 99 00 00 00 00 00 00 00 8b 00 00 00 00 00 00 00 00 00 00 00 9b 00 00 00 00 00 00 00 ................................
12e0 2b 00 00 00 69 00 00 00 00 00 00 00 43 00 00 00 00 00 00 00 42 00 00 00 00 2a 2a 4e 4f 54 45 2a +...i.......C.......B....**NOTE*
1300 2a 3a 20 62 65 20 63 61 72 65 66 75 6c 6c 20 77 68 69 6c 65 20 63 6f 70 79 69 6e 67 20 61 6e 64 *:.be.carefull.while.copying.and
1320 20 70 61 73 74 69 6e 67 20 70 72 65 76 69 6f 75 73 20 63 6f 6d 6d 61 6e 64 73 2e 20 44 6f 62 6c .pasting.previous.commands..Dobl
1340 65 20 71 75 6f 74 65 73 20 6d 61 79 20 6e 65 65 64 20 74 6f 20 62 65 20 63 6f 72 72 65 63 74 65 e.quotes.may.need.to.be.correcte
1360 64 2e 00 2a 2a 6d 65 74 61 2d 64 61 74 61 2a 2a 3a 20 65 6d 70 74 79 20 66 69 6c 65 20 28 72 65 d..**meta-data**:.empty.file.(re
1380 71 75 69 72 65 64 29 2e 00 2a 2a 6e 65 74 77 6f 72 6b 2d 63 6f 6e 66 69 67 2a 2a 20 66 69 6c 65 quired)..**network-config**.file
13a0 20 6f 6e 6c 79 20 68 61 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 74 68 61 74 20 64 69 73 .only.has.configuration.that.dis
13c0 61 62 6c 65 73 20 74 68 65 20 61 75 74 6f 6d 61 74 69 63 20 64 68 63 70 20 63 6c 69 65 6e 74 20 ables.the.automatic.dhcp.client.
13e0 6f 6e 20 66 69 72 73 74 20 69 6e 74 65 72 66 61 63 65 2e 00 2a 2a 6e 65 74 77 6f 72 6b 2d 63 6f on.first.interface..**network-co
1400 6e 66 69 67 2a 2a 3a 20 66 69 6c 65 20 74 68 61 74 20 77 69 6c 6c 20 69 6e 64 69 63 61 74 65 20 nfig**:.file.that.will.indicate.
1420 74 6f 20 61 76 6f 69 64 20 64 68 63 70 20 63 6c 69 65 6e 74 20 6f 6e 20 66 69 72 73 74 20 69 6e to.avoid.dhcp.client.on.first.in
1440 74 65 72 66 61 63 65 2e 00 2a 2a 75 73 65 72 2d 64 61 74 61 2a 2a 20 66 69 6c 65 20 6d 75 73 74 terface..**user-data**.file.must
1460 20 73 74 61 72 74 20 77 69 74 68 20 60 60 23 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 60 60 20 61 6e .start.with.``#cloud-config``.an
1480 64 20 63 6f 6e 74 61 69 6e 73 20 76 79 6f 73 2d 63 6f 6d 6d 61 6e 64 73 2e 20 46 6f 72 20 65 78 d.contains.vyos-commands..For.ex
14a0 61 6d 70 6c 65 3a 00 2a 2a 75 73 65 72 2d 64 61 74 61 2a 2a 3a 20 69 6e 63 6c 75 64 65 73 20 76 ample:.**user-data**:.includes.v
14c0 79 6f 73 2d 63 6f 6d 6d 61 6e 64 73 2e 00 2f 63 6f 6e 66 69 67 2d 66 69 6c 65 00 2f 63 6f 6e 66 yos-commands../config-file./conf
14e0 69 67 75 72 65 00 2f 67 65 6e 65 72 61 74 65 00 2f 69 6d 61 67 65 00 2f 70 6f 77 65 72 6f 66 66 igure./generate./image./poweroff
1500 00 2f 72 65 62 6f 6f 74 00 2f 72 65 73 65 74 00 2f 72 65 74 72 69 65 76 65 00 2f 73 68 6f 77 00 ./reboot./reset./retrieve./show.
1520 41 20 56 79 4f 53 20 71 63 6f 77 20 69 6d 61 67 65 20 77 69 74 68 20 63 6c 6f 75 64 2d 69 6e 69 A.VyOS.qcow.image.with.cloud-ini
1540 74 20 6f 70 74 69 6f 6e 73 20 69 73 20 6e 65 65 64 65 64 2e 20 54 68 69 73 20 63 61 6e 20 62 65 t.options.is.needed..This.can.be
1560 20 6f 62 74 61 69 6e 65 64 20 75 73 69 6e 67 20 60 76 79 6f 73 2d 76 6d 2d 69 6d 61 67 65 73 60 .obtained.using.`vyos-vm-images`
1580 5f 20 72 65 70 6f 2e 20 41 66 74 65 72 20 63 6c 6f 6e 6e 69 6e 67 20 74 68 65 20 72 65 70 6f 2c _.repo..After.clonning.the.repo,
15a0 20 65 64 69 74 20 74 68 65 20 66 69 6c 65 20 2a 2a 71 65 6d 75 2e 79 6d 6c 2a 2a 20 61 6e 64 20 .edit.the.file.**qemu.yml**.and.
15c0 63 6f 6d 6d 65 6e 74 20 74 68 65 20 2a 2a 64 6f 77 6e 6c 6f 61 64 2d 69 73 6f 2a 2a 20 72 6f 6c comment.the.**download-iso**.rol
15e0 65 2e 00 41 20 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 20 64 6f 63 75 6d 65 6e 74 20 69 73 20 77 72 e..A.cloud-config.document.is.wr
1600 69 74 74 65 6e 20 69 6e 20 59 41 4d 4c 2e 20 54 68 65 20 66 69 6c 65 20 6d 75 73 74 20 62 65 67 itten.in.YAML..The.file.must.beg
1620 69 6e 20 77 69 74 68 20 60 60 23 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 60 60 20 6c 69 6e 65 2e 20 in.with.``#cloud-config``.line..
1640 54 68 65 20 6f 6e 6c 79 20 73 75 70 70 6f 72 74 65 64 20 74 6f 70 2d 6c 65 76 65 6c 20 6b 65 79 The.only.supported.top-level.key
1660 73 20 61 72 65 20 60 60 76 79 6f 73 5f 63 6f 6e 66 69 67 5f 63 6f 6d 6d 61 6e 64 73 60 60 20 61 s.are.``vyos_config_commands``.a
1680 6e 64 20 60 60 77 72 69 74 65 5f 66 69 6c 65 73 60 60 2e 20 54 68 65 20 75 73 65 20 6f 66 20 74 nd.``write_files``..The.use.of.t
16a0 68 65 73 65 20 6b 65 79 73 20 69 73 20 64 65 73 63 72 69 62 65 64 20 69 6e 20 74 68 65 20 66 6f hese.keys.is.described.in.the.fo
16c0 6c 6c 6f 77 69 6e 67 20 74 77 6f 20 73 65 63 74 69 6f 6e 73 2e 00 41 20 73 69 6d 70 6c 65 20 65 llowing.two.sections..A.simple.e
16e0 78 61 6d 70 6c 65 20 69 73 20 73 68 6f 77 6e 20 62 65 6c 6f 77 2c 20 77 68 65 72 65 20 74 68 65 xample.is.shown.below,.where.the
1700 20 6f 70 73 20 63 6f 6d 6d 61 6e 64 20 65 78 65 63 75 74 65 64 20 69 6e 20 74 68 65 20 70 6f 73 .ops.command.executed.in.the.pos
1720 74 2d 68 6f 6f 6b 20 73 63 72 69 70 74 20 69 73 20 22 73 68 6f 77 20 69 6e 74 65 72 66 61 63 65 t-hook.script.is."show.interface
1740 73 22 2e 00 41 20 73 69 6e 67 6c 65 2d 71 75 6f 74 65 20 73 79 6d 62 6f 6c 20 69 73 20 6e 6f 74 s"..A.single-quote.symbol.is.not
1760 20 61 6c 6c 6f 77 65 64 20 69 6e 73 69 64 65 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 76 61 6c 75 65 .allowed.inside.command.or.value
1780 2e 00 41 50 49 20 45 6e 64 70 6f 69 6e 74 73 00 41 63 63 65 70 74 20 6d 69 6e 69 6f 6e 20 6b 65 ..API.Endpoints.Accept.minion.ke
17a0 79 00 41 6c 6c 20 65 6e 64 70 6f 69 6e 74 73 20 6f 6e 6c 79 20 6c 69 73 74 65 6e 20 6f 6e 20 48 y.All.endpoints.only.listen.on.H
17c0 54 54 50 20 50 4f 53 54 20 72 65 71 75 65 73 74 73 20 61 6e 64 20 74 68 65 20 41 50 49 20 4b 45 TTP.POST.requests.and.the.API.KE
17e0 59 20 6d 75 73 74 20 73 65 74 20 61 73 20 60 60 6b 65 79 60 60 20 69 6e 20 74 68 65 20 66 6f 72 Y.must.set.as.``key``.in.the.for
1800 6d 64 61 74 61 2e 00 41 6c 6c 20 6f 66 20 74 68 65 73 65 20 63 61 6e 20 62 65 20 6f 76 65 72 72 mdata..All.of.these.can.be.overr
1820 69 64 64 65 6e 20 75 73 69 6e 67 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 6e idden.using.the.configuration.in
1840 20 75 73 65 72 2d 64 61 74 61 2e 00 41 6c 73 6f 2c 20 74 68 69 73 20 6c 61 62 20 63 6f 6e 73 69 .user-data..Also,.this.lab.consi
1860 64 65 72 73 3a 00 41 6e 73 69 62 6c 65 00 41 6e 79 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e 73 20 ders:.Ansible.Any.modifications.
1880 77 65 72 65 20 64 6f 6e 65 20 74 6f 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20 75 6e 66 69 78 65 64 were.done.to.work.around.unfixed
18a0 20 62 75 67 73 20 61 6e 64 20 69 6d 70 6c 65 6d 65 6e 74 20 65 6e 68 61 6e 63 65 6d 65 6e 74 73 .bugs.and.implement.enhancements
18c0 20 74 68 61 74 20 61 72 65 20 6e 6f 74 20 63 6f 6d 70 6c 65 74 65 20 69 6e 20 74 68 65 20 56 79 .that.are.not.complete.in.the.Vy
18e0 4f 53 20 73 79 73 74 65 6d 20 63 61 6e 20 62 65 20 70 6c 61 63 65 64 20 68 65 72 65 2e 00 41 74 OS.system.can.be.placed.here..At
1900 20 74 68 69 73 20 73 74 65 70 20 77 65 20 63 61 6e 20 67 65 74 20 73 6f 6d 65 20 6f 70 2d 6d 6f .this.step.we.can.get.some.op-mo
1920 64 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 56 79 4f 53 20 6e 6f 64 65 73 3a 00 de.information.from.VyOS.nodes:.
1940 41 75 74 68 65 6e 74 69 63 61 74 69 6f 6e 00 42 65 66 6f 72 65 20 73 74 61 72 74 69 6e 67 2c 20 Authentication.Before.starting,.
1960 70 6c 65 61 73 65 20 72 65 66 65 72 20 74 6f 20 63 6c 6f 75 64 2d 69 6e 69 74 20 60 6e 65 74 77 please.refer.to.cloud-init.`netw
1980 6f 72 6b 2d 63 6f 6e 66 69 67 2d 64 6f 63 73 60 5f 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 6b 6e ork-config-docs`_.in.order.to.kn
19a0 6f 77 20 68 6f 77 20 74 6f 20 69 6d 70 6f 72 74 20 75 73 65 72 20 61 6e 64 20 6e 65 74 77 6f 72 ow.how.to.import.user.and.networ
19c0 6b 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 73 2e 00 42 65 6c 6f 77 20 73 65 65 20 6f 6e 65 20 k.configurations..Below.see.one.
19e0 65 78 61 6d 70 6c 65 20 66 6f 72 20 63 75 72 6c 20 61 6e 64 20 6f 6e 65 20 66 6f 72 20 70 79 74 example.for.curl.and.one.for.pyt
1a00 68 6f 6e 2e 20 54 68 65 20 72 65 73 74 20 6f 66 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 hon..The.rest.of.the.documentati
1a20 6f 6e 20 69 73 20 72 65 64 75 63 65 64 20 74 6f 20 63 75 72 6c 2e 00 43 68 65 63 6b 20 73 61 6c on.is.reduced.to.curl..Check.sal
1a40 74 2d 6b 65 79 73 20 6f 6e 20 74 68 65 20 73 61 6c 74 20 6d 61 73 74 65 72 00 43 68 65 63 6b 20 t-keys.on.the.salt.master.Check.
1a60 74 68 61 74 20 70 72 6f 78 79 20 6d 69 6e 69 6f 6e 20 69 73 20 61 6c 69 76 65 3a 00 43 68 65 63 that.proxy.minion.is.alive:.Chec
1a80 6b 20 74 68 61 74 20 73 61 6c 74 20 6d 61 73 74 65 72 20 63 61 6e 20 63 6f 6d 6d 75 6e 69 63 61 k.that.salt.master.can.communica
1aa0 74 65 20 77 69 74 68 20 6d 69 6e 69 6f 6e 73 00 43 6c 6f 75 64 20 61 6e 64 20 76 69 72 74 75 61 te.with.minions.Cloud.and.virtua
1ac0 6c 69 7a 65 64 20 69 6e 73 74 61 6e 63 65 73 20 6f 66 20 56 79 4f 53 20 61 72 65 20 69 6e 69 74 lized.instances.of.VyOS.are.init
1ae0 69 61 6c 69 7a 65 64 20 75 73 69 6e 67 20 74 68 65 20 69 6e 64 75 73 74 72 79 2d 73 74 61 6e 64 ialized.using.the.industry-stand
1b00 61 72 64 20 63 6c 6f 75 64 2d 69 6e 69 74 2e 20 56 69 61 20 63 6c 6f 75 64 2d 69 6e 69 74 2c 20 ard.cloud-init..Via.cloud-init,.
1b20 74 68 65 20 73 79 73 74 65 6d 20 70 65 72 66 6f 72 6d 73 20 74 61 73 6b 73 20 73 75 63 68 20 61 the.system.performs.tasks.such.a
1b40 73 20 69 6e 6a 65 63 74 69 6e 67 20 53 53 48 20 6b 65 79 73 20 61 6e 64 20 63 6f 6e 66 69 67 75 s.injecting.SSH.keys.and.configu
1b60 72 69 6e 67 20 74 68 65 20 6e 65 74 77 6f 72 6b 2e 20 49 6e 20 61 64 64 69 74 69 6f 6e 2c 20 74 ring.the.network..In.addition,.t
1b80 68 65 20 75 73 65 72 20 63 61 6e 20 73 75 70 70 6c 79 20 61 20 63 75 73 74 6f 6d 20 63 6f 6e 66 he.user.can.supply.a.custom.conf
1ba0 69 67 75 72 61 74 69 6f 6e 20 61 74 20 74 68 65 20 74 69 6d 65 20 6f 66 20 69 6e 73 74 61 6e 63 iguration.at.the.time.of.instanc
1bc0 65 20 6c 61 75 6e 63 68 2e 00 43 6c 6f 75 64 2d 63 6f 6e 66 69 67 20 6d 6f 64 75 6c 65 73 00 43 e.launch..Cloud-config.modules.C
1be0 6c 6f 75 64 2d 69 6e 69 74 20 60 6e 65 74 77 6f 72 6b 2d 63 6f 6e 66 69 67 2d 64 6f 63 73 60 5f loud-init.`network-config-docs`_
1c00 2e 00 43 6c 6f 75 64 2d 69 6e 69 74 20 6f 6e 20 50 72 6f 78 6d 6f 78 00 43 6f 6d 6d 61 6e 64 20 ..Cloud-init.on.Proxmox.Command.
1c20 45 78 65 63 75 74 69 6f 6e 20 61 74 20 49 6e 69 74 69 61 6c 20 42 6f 6f 74 00 43 6f 6d 6d 61 6e Execution.at.Initial.Boot.Comman
1c40 64 20 53 63 72 69 70 74 69 6e 67 00 43 6f 6d 6d 61 6e 64 20 66 6f 72 20 67 65 6e 65 72 61 74 69 d.Scripting.Command.for.generati
1c60 6e 67 20 60 60 73 65 65 64 2e 69 73 6f 60 60 00 43 6f 6d 6d 61 6e 64 73 20 72 65 71 75 69 72 65 ng.``seed.iso``.Commands.require
1c80 6d 65 6e 74 73 3a 00 43 6f 6e 66 69 67 20 53 6f 75 72 63 65 73 00 43 6f 6e 66 69 67 75 72 61 74 ments:.Config.Sources.Configurat
1ca0 69 6f 6e 00 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 65 ion.Configuration.commands.are.e
1cc0 78 65 63 75 74 65 64 20 6a 75 73 74 20 6c 69 6b 65 20 66 72 6f 6d 20 61 20 6e 6f 72 6d 61 6c 20 xecuted.just.like.from.a.normal.
1ce0 63 6f 6e 66 69 67 20 73 65 73 73 69 6f 6e 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 config.session..For.example,.if.
1d00 79 6f 75 20 77 61 6e 74 20 74 6f 20 64 69 73 61 62 6c 65 20 61 20 42 47 50 20 70 65 65 72 20 6f you.want.to.disable.a.BGP.peer.o
1d20 6e 20 56 52 52 50 20 74 72 61 6e 73 69 74 69 6f 6e 20 74 6f 20 62 61 63 6b 75 70 3a 00 43 6f 6e n.VRRP.transition.to.backup:.Con
1d40 66 69 67 75 72 65 2c 20 74 68 65 6e 20 44 65 6c 65 74 65 20 4f 62 6a 65 63 74 00 43 6f 6e 66 69 figure,.then.Delete.Object.Confi
1d60 67 75 72 65 2c 20 74 68 65 6e 20 4c 6f 61 64 20 46 69 6c 65 00 43 6f 6e 66 69 67 75 72 65 2c 20 gure,.then.Load.File.Configure,.
1d80 74 68 65 6e 20 53 61 76 65 00 43 6f 6e 66 69 67 75 72 65 2c 20 74 68 65 6e 20 53 61 76 65 20 46 then.Save.Configure,.then.Save.F
1da0 69 6c 65 00 43 6f 6e 66 69 67 75 72 65 2c 20 74 68 65 6e 20 53 65 74 00 43 6f 6e 66 69 67 75 72 ile.Configure,.then.Set.Configur
1dc0 65 2c 20 74 68 65 6e 20 53 68 6f 77 20 4f 62 6a 65 63 74 00 43 6f 6e 66 69 67 75 72 65 2c 20 74 e,.then.Show.Object.Configure,.t
1de0 68 65 6e 20 53 68 6f 77 20 61 20 53 69 6e 67 6c 65 20 4f 62 6a 65 63 74 20 56 61 6c 75 65 00 43 hen.Show.a.Single.Object.Value.C
1e00 6f 6e 74 65 6e 74 20 6f 66 20 63 6f 6d 6d 61 6e 64 73 2e 63 6f 6e 66 00 43 6f 6e 74 65 6e 74 20 ontent.of.commands.conf.Content.
1e20 6f 66 20 6e 65 74 77 6f 72 6b 2d 63 6f 6e 66 69 67 20 66 69 6c 65 3a 00 43 72 65 61 74 65 20 73 of.network-config.file:.Create.s
1e40 65 65 64 2e 69 73 6f 00 43 72 65 61 74 65 20 74 65 78 74 20 66 69 6c 65 73 20 6e 61 6d 65 64 20 eed.iso.Create.text.files.named.
1e60 75 73 65 72 2d 64 61 74 61 20 61 6e 64 20 6d 65 74 61 2d 64 61 74 61 2e 20 4f 6e 20 6c 69 6e 75 user-data.and.meta-data..On.linu
1e80 78 2d 62 61 73 65 64 20 73 79 73 74 65 6d 73 2c 20 74 68 65 20 6d 6b 69 73 6f 66 73 20 75 74 69 x-based.systems,.the.mkisofs.uti
1ea0 6c 69 74 79 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 74 68 65 20 73 lity.can.be.used.to.create.the.s
1ec0 65 65 64 20 49 53 4f 2e 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 79 6e 74 61 78 20 77 69 eed.ISO..The.following.syntax.wi
1ee0 6c 6c 20 61 64 64 20 74 68 65 73 65 20 66 69 6c 65 73 20 74 6f 20 74 68 65 20 49 53 4f 20 39 36 ll.add.these.files.to.the.ISO.96
1f00 36 30 20 66 69 6c 65 20 73 79 73 74 65 6d 2e 00 43 72 65 61 74 69 6e 67 20 74 68 65 20 56 4d 00 60.file.system..Creating.the.VM.
1f20 43 75 73 74 6f 6d 20 73 63 72 69 70 74 73 20 61 72 65 20 6e 6f 74 20 65 78 65 63 75 74 65 64 20 Custom.scripts.are.not.executed.
1f40 77 69 74 68 20 72 6f 6f 74 20 70 72 69 76 69 6c 65 67 65 73 20 28 55 73 65 20 73 75 64 6f 20 69 with.root.privileges.(Use.sudo.i
1f60 6e 73 69 64 65 20 69 66 20 74 68 69 73 20 69 73 20 6e 65 63 65 73 73 61 72 79 29 2e 00 44 48 43 nside.if.this.is.necessary)..DHC
1f80 50 20 6f 6e 20 66 69 72 73 74 20 45 74 68 65 72 6e 65 74 20 69 6e 74 65 72 66 61 63 65 20 69 66 P.on.first.Ethernet.interface.if
1fa0 20 6e 6f 20 6e 65 74 77 6f 72 6b 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 73 20 70 72 6f .no.network.configuration.is.pro
1fc0 76 69 64 65 64 2e 00 45 78 61 6d 70 6c 65 00 45 78 61 6d 70 6c 65 20 6f 66 20 63 6f 6e 66 69 67 vided..Example.Example.of.config
1fe0 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 66 72 6f 6d 20 74 68 65 20 66 69 6c 65 20 22 uration.commands.from.the.file."
2000 2f 73 72 76 2f 73 61 6c 74 2f 73 74 61 74 65 73 2f 63 6f 6d 6d 61 6e 64 73 2e 74 78 74 22 00 45 /srv/salt/states/commands.txt".E
2020 78 61 6d 70 6c 65 20 6f 66 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3a 00 45 78 61 6d 70 6c 65 xample.of.configuration:.Example
2040 20 6f 66 20 6f 70 2d 6d 6f 64 65 3a 00 45 78 61 6d 70 6c 65 73 00 45 78 65 63 75 74 69 6e 67 20 .of.op-mode:.Examples.Executing.
2060 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 53 63 72 69 70 74 73 00 45 78 65 63 75 74 69 6e 67 20 Configuration.Scripts.Executing.
2080 70 72 65 2d 68 6f 6f 6b 73 2f 70 6f 73 74 2d 68 6f 6f 6b 73 20 53 63 72 69 70 74 73 00 46 69 6c pre-hooks/post-hooks.Scripts.Fil
20a0 65 20 63 6f 6e 74 65 6e 74 73 00 46 69 6c 65 20 67 65 6e 65 72 61 74 65 64 20 77 69 74 68 20 70 e.contents.File.generated.with.p
20c0 72 65 76 69 6f 75 73 20 63 6f 6d 6d 61 6e 64 3a 20 60 60 2f 74 6d 70 2f 76 79 6f 73 2d 31 2e 33 revious.command:.``/tmp/vyos-1.3
20e0 2e 30 2d 63 6c 6f 75 64 2d 69 6e 69 74 2d 31 30 47 2d 71 65 6d 75 2e 71 63 6f 77 32 60 60 00 46 .0-cloud-init-10G-qemu.qcow2``.F
2100 69 6e 61 6c 79 2c 20 66 69 6c 65 20 2a 2a 6d 65 74 61 2d 64 61 74 61 2a 2a 20 68 61 73 20 6e 6f inaly,.file.**meta-data**.has.no
2120 20 63 6f 6e 74 65 6e 74 2c 20 62 75 74 20 69 74 27 73 20 72 65 71 75 69 72 65 64 2e 00 46 6f 72 .content,.but.it's.required..For
2140 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 65 6e 61 62 6c 69 6e 67 20 74 68 65 20 .configuration.and.enabling.the.
2160 41 50 49 20 73 65 65 20 3a 72 65 66 3a 60 68 74 74 70 2d 61 70 69 60 00 46 6f 72 20 63 6f 6e 66 API.see.:ref:`http-api`.For.conf
2180 69 67 75 72 61 74 69 6f 6e 2f 75 70 67 72 61 64 65 20 6d 61 6e 61 67 65 6d 65 6e 74 20 69 73 73 iguration/upgrade.management.iss
21a0 75 65 73 2c 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e 20 6f 66 20 74 68 69 73 20 73 63 72 69 70 74 ues,.modification.of.this.script
21c0 20 73 68 6f 75 6c 64 20 62 65 20 74 68 65 20 6c 61 73 74 20 6f 70 74 69 6f 6e 2e 20 41 6c 77 61 .should.be.the.last.option..Alwa
21e0 79 73 20 74 72 79 20 74 6f 20 66 69 6e 64 20 73 6f 6c 75 74 69 6f 6e 73 20 62 61 73 65 64 20 6f ys.try.to.find.solutions.based.o
2200 6e 20 43 4c 49 20 63 6f 6d 6d 61 6e 64 73 20 66 69 72 73 74 2e 00 46 6f 72 20 65 78 61 6d 70 6c n.CLI.commands.first..For.exampl
2220 65 2c 20 67 65 74 20 74 68 65 20 61 64 64 72 65 73 73 65 73 20 6f 66 20 61 20 60 60 64 75 6d 30 e,.get.the.addresses.of.a.``dum0
2240 60 60 20 69 6e 74 65 72 66 61 63 65 2e 00 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 73 68 6f 77 20 ``.interface..For.example,.show.
2260 77 68 69 63 68 20 69 6d 61 67 65 73 20 61 72 65 20 69 6e 73 74 61 6c 6c 65 64 2e 00 46 6f 72 20 which.images.are.installed..For.
2280 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20 4e 6f 43 6c 6f 75 64 20 more.information.on.the.NoCloud.
22a0 64 61 74 61 20 73 6f 75 72 63 65 2c 20 76 69 73 69 74 20 69 74 73 20 60 70 61 67 65 20 3c 68 74 data.source,.visit.its.`page.<ht
22c0 74 70 73 3a 2f 2f 63 6c 6f 75 64 69 6e 69 74 2e 72 65 61 64 74 68 65 64 6f 63 73 2e 69 6f 2f 65 tps://cloudinit.readthedocs.io/e
22e0 6e 2f 6c 61 74 65 73 74 2f 72 65 66 65 72 65 6e 63 65 2f 64 61 74 61 73 6f 75 72 63 65 73 2f 6e n/latest/reference/datasources/n
2300 6f 63 6c 6f 75 64 2e 68 74 6d 6c 3e 60 5f 20 69 6e 20 74 68 65 20 63 6c 6f 75 64 2d 69 6e 69 74 ocloud.html>`_.in.the.cloud-init
2320 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e 00 46 72 6f 6d 20 63 6c 69 20 6f 72 20 47 55 49 2c .documentation..From.cli.or.GUI,
2340 20 70 6f 77 65 72 20 6f 6e 20 56 4d 2c 20 61 6e 64 20 61 66 74 65 72 20 69 74 20 62 6f 6f 74 73 .power.on.VM,.and.after.it.boots
2360 2c 20 76 65 72 69 66 79 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 00 47 65 6e 65 72 61 74 65 20 ,.verify.configuration.Generate.
2380 4f 62 6a 65 63 74 00 47 65 6e 65 72 61 74 65 20 71 63 6f 77 20 69 6d 61 67 65 00 47 65 74 74 69 Object.Generate.qcow.image.Getti
23a0 6e 67 20 53 74 61 72 74 65 64 00 48 65 72 65 20 69 73 20 61 20 73 69 6d 70 6c 65 20 65 78 61 6d ng.Started.Here.is.a.simple.exam
23c0 70 6c 65 3a 00 48 65 72 65 20 69 73 20 61 6e 20 65 78 61 6d 70 6c 65 20 63 6c 6f 75 64 2d 63 6f ple:.Here.is.an.example.cloud-co
23e0 6e 66 69 67 20 74 68 61 74 20 61 70 70 65 6e 64 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 nfig.that.appends.configuration.
2400 61 74 20 74 68 65 20 74 69 6d 65 20 6f 66 20 66 69 72 73 74 20 62 6f 6f 74 2e 00 49 53 4f 20 66 at.the.time.of.first.boot..ISO.f
2420 69 6c 65 73 20 73 74 6f 72 61 67 65 3a 20 60 60 6c 6f 63 61 6c 60 60 20 76 6f 6c 75 6d 65 20 69 iles.storage:.``local``.volume.i
2440 73 20 75 73 65 64 20 66 6f 72 20 60 60 2e 69 73 6f 60 60 20 66 69 6c 65 20 73 74 6f 72 61 67 65 s.used.for.``.iso``.file.storage
2460 2e 20 49 6e 20 74 68 69 73 20 73 63 65 6e 61 72 69 6f 20 60 60 6c 6f 63 61 6c 60 60 20 76 6f 6c ..In.this.scenario.``local``.vol
2480 75 6d 65 20 74 79 70 65 20 69 73 20 73 65 74 20 74 6f 20 2a 2a 64 69 72 65 63 74 6f 72 79 2a 2a ume.type.is.set.to.**directory**
24a0 2c 20 61 62 64 20 61 74 74 61 63 68 65 64 20 74 6f 20 60 60 2f 76 61 72 2f 6c 69 62 2f 76 7a 60 ,.abd.attached.to.``/var/lib/vz`
24c0 60 2e 00 49 66 20 63 6f 6d 6d 61 6e 64 20 65 6e 64 73 20 69 6e 20 61 20 76 61 6c 75 65 2c 20 69 `..If.command.ends.in.a.value,.i
24e0 74 20 6d 75 73 74 20 62 65 20 69 6e 73 69 64 65 20 73 69 6e 67 6c 65 20 71 75 6f 74 65 73 2e 00 t.must.be.inside.single.quotes..
2500 49 66 20 6e 6f 20 6e 65 74 77 6f 72 6b 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 If.no.networking.configuration.i
2520 73 20 70 72 6f 76 69 64 65 64 2c 20 74 68 65 6e 20 64 68 63 70 20 63 6c 69 65 6e 74 20 69 73 20 s.provided,.then.dhcp.client.is.
2540 67 6f 69 6e 67 20 74 6f 20 62 65 20 65 6e 61 62 6c 65 64 20 6f 6e 20 66 69 72 73 74 20 69 6e 74 going.to.be.enabled.on.first.int
2560 65 72 66 61 63 65 2e 20 42 61 72 65 20 69 6e 20 6d 69 6e 64 20 74 68 61 74 20 74 68 69 73 20 63 erface..Bare.in.mind.that.this.c
2580 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 77 69 6c 6c 20 62 65 20 69 6e 79 65 63 74 65 64 20 61 74 onfiguration.will.be.inyected.at
25a0 20 61 6e 20 4f 53 20 6c 65 76 65 6c 2c 20 73 6f 20 64 6f 6e 27 74 20 65 78 70 65 63 74 20 74 6f .an.OS.level,.so.don't.expect.to
25c0 20 66 69 6e 64 20 64 68 63 70 20 63 6c 69 65 6e 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 .find.dhcp.client.configuration.
25e0 6f 6e 20 76 79 6f 73 20 63 6c 69 2e 20 42 65 63 61 75 73 65 20 6f 66 20 74 68 69 73 20 62 65 68 on.vyos.cli..Because.of.this.beh
2600 61 76 69 6f 72 2c 20 69 6e 20 6e 65 78 74 20 65 78 61 6d 70 6c 65 20 6c 61 62 20 77 65 20 77 69 avior,.in.next.example.lab.we.wi
2620 6c 6c 20 64 69 73 61 62 6c 65 20 64 68 63 70 2d 63 6c 69 65 6e 74 20 63 6f 6e 66 69 67 75 72 61 ll.disable.dhcp-client.configura
2640 74 69 6f 6e 20 6f 6e 20 65 74 68 30 2e 00 49 66 20 79 6f 75 20 65 6e 63 6f 75 6e 74 65 72 20 70 tion.on.eth0..If.you.encounter.p
2660 72 6f 62 6c 65 6d 73 2c 20 76 65 72 69 66 79 20 74 68 61 74 20 74 68 65 20 63 6c 6f 75 64 2d 63 roblems,.verify.that.the.cloud-c
2680 6f 6e 66 69 67 20 64 6f 63 75 6d 65 6e 74 20 63 6f 6e 74 61 69 6e 73 20 76 61 6c 69 64 20 59 41 onfig.document.contains.valid.YA
26a0 4d 4c 2e 20 4f 6e 6c 69 6e 65 20 72 65 73 6f 75 72 63 65 73 20 73 75 63 68 20 61 73 20 68 74 74 ML..Online.resources.such.as.htt
26c0 70 73 3a 2f 2f 77 77 77 2e 79 61 6d 6c 6c 69 6e 74 2e 63 6f 6d 2f 20 70 72 6f 76 69 64 65 20 61 ps://www.yamllint.com/.provide.a
26e0 20 73 69 6d 70 6c 65 20 74 6f 6f 6c 20 66 6f 72 20 76 61 6c 69 64 61 74 69 6e 67 20 59 41 4d 4c .simple.tool.for.validating.YAML
2700 2e 00 49 66 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 67 61 74 68 65 72 20 69 6e 66 6f 72 6d 61 74 ..If.you.need.to.gather.informat
2720 69 6f 6e 20 66 72 6f 6d 20 6c 69 6e 75 78 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 63 6f 6e 66 69 ion.from.linux.commands.to.confi
2740 67 75 72 65 20 56 79 4f 53 2c 20 79 6f 75 20 63 61 6e 20 65 78 65 63 75 74 65 20 63 6f 6d 6d 61 gure.VyOS,.you.can.execute.comma
2760 6e 64 73 20 61 6e 64 20 74 68 65 6e 20 63 6f 6e 66 69 67 75 72 65 20 56 79 4f 53 20 69 6e 20 74 nds.and.then.configure.VyOS.in.t
2780 68 65 20 73 61 6d 65 20 73 63 72 69 70 74 2e 00 49 66 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 73 he.same.script..If.you.want.to.s
27a0 63 72 69 70 74 20 74 68 65 20 63 6f 6e 66 69 67 73 20 69 6e 20 61 20 6c 61 6e 67 75 61 67 65 20 cript.the.configs.in.a.language.
27c0 6f 74 68 65 72 20 74 68 61 6e 20 62 61 73 68 20 79 6f 75 20 63 61 6e 20 68 61 76 65 20 79 6f 75 other.than.bash.you.can.have.you
27e0 72 20 73 63 72 69 70 74 20 6f 75 74 70 75 74 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 20 74 68 65 r.script.output.commands.and.the
2800 6e 20 73 6f 75 72 63 65 20 74 68 65 6d 20 69 6e 20 61 20 62 61 73 68 20 73 63 72 69 70 74 2e 00 n.source.them.in.a.bash.script..
2820 49 6d 70 6f 72 74 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 20 57 61 72 6e 69 6e 67 73 Importing.and.Disabling.Warnings
2840 20 66 6f 72 20 76 65 72 69 66 79 3d 46 61 6c 73 65 00 49 6e 20 50 72 6f 78 6d 6f 78 20 73 65 72 .for.verify=False.In.Proxmox.ser
2860 76 65 72 20 74 68 72 65 65 20 66 69 6c 65 73 20 61 72 65 20 67 6f 69 6e 67 20 74 6f 20 62 65 20 ver.three.files.are.going.to.be.
2880 75 73 65 64 20 66 6f 72 20 74 68 69 73 20 73 65 74 75 70 3a 00 49 6e 20 56 79 4f 53 2c 20 62 79 used.for.this.setup:.In.VyOS,.by
28a0 20 64 65 66 61 75 6c 74 2c 20 65 6e 61 62 6c 65 73 20 6f 6e 6c 79 20 74 77 6f 20 6d 6f 64 75 6c .default,.enables.only.two.modul
28c0 65 73 3a 00 49 6e 20 74 68 69 73 20 6c 61 62 2c 20 61 6c 6c 20 66 69 6c 65 73 20 61 72 65 20 6c es:.In.this.lab,.all.files.are.l
28e0 6f 63 61 74 65 64 20 69 6e 20 60 60 2f 74 6d 70 2f 60 60 2e 20 53 6f 2c 20 62 65 66 6f 72 65 20 ocated.in.``/tmp/``..So,.before.
2900 67 6f 69 6e 67 20 6f 6e 2c 20 6c 65 74 73 20 6d 6f 76 65 20 74 6f 20 74 68 61 74 20 64 69 72 65 going.on,.lets.move.to.that.dire
2920 63 74 6f 72 79 3a 00 49 6e 20 74 68 69 73 20 6c 61 62 2c 20 77 65 20 61 72 65 20 75 73 69 6e 67 ctory:.In.this.lab,.we.are.using
2940 20 31 2e 33 2e 30 20 56 79 4f 53 20 76 65 72 73 69 6f 6e 20 61 6e 64 20 73 65 74 74 69 6e 67 20 .1.3.0.VyOS.version.and.setting.
2960 61 20 64 69 73 6b 20 6f 66 20 31 30 47 2e 20 44 6f 77 6e 6c 6f 61 64 20 56 79 4f 53 20 2e 69 73 a.disk.of.10G..Download.VyOS..is
2980 6f 20 66 69 6c 65 20 61 6e 64 20 73 61 76 65 20 69 74 20 61 73 20 60 60 2f 74 6d 70 2f 76 79 6f o.file.and.save.it.as.``/tmp/vyo
29a0 73 2e 69 73 6f 60 60 2e 20 43 6f 6d 6d 61 6e 64 20 75 73 65 64 20 66 6f 72 20 67 65 6e 65 72 61 s.iso``..Command.used.for.genera
29c0 74 69 6e 67 20 71 63 6f 77 20 69 6d 61 67 65 3a 00 49 6e 69 74 69 61 6c 20 43 6f 6e 66 69 67 75 ting.qcow.image:.Initial.Configu
29e0 72 61 74 69 6f 6e 00 49 6e 69 74 69 61 6c 69 7a 69 6e 67 20 61 20 56 79 44 65 76 69 63 65 20 4f ration.Initializing.a.VyDevice.O
2a00 62 6a 65 63 74 00 49 6e 6a 65 63 74 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 64 61 bject.Injecting.configuration.da
2a20 74 61 20 69 73 20 6e 6f 74 20 6c 69 6d 69 74 65 64 20 74 6f 20 63 6c 6f 75 64 20 70 6c 61 74 66 ta.is.not.limited.to.cloud.platf
2a40 6f 72 6d 73 2e 20 55 73 65 72 73 20 63 61 6e 20 65 6d 70 6c 6f 79 20 74 68 65 20 4e 6f 43 6c 6f orms..Users.can.employ.the.NoClo
2a60 75 64 20 64 61 74 61 20 73 6f 75 72 63 65 20 74 6f 20 69 6e 6a 65 63 74 20 75 73 65 72 2d 64 61 ud.data.source.to.inject.user-da
2a80 74 61 20 61 6e 64 20 6d 65 74 61 2d 64 61 74 61 20 6f 6e 20 76 69 72 74 75 61 6c 69 7a 61 74 69 ta.and.meta-data.on.virtualizati
2aa0 6f 6e 20 70 6c 61 74 66 6f 72 6d 73 20 73 75 63 68 20 61 73 20 56 4d 77 61 72 65 2c 20 48 79 70 on.platforms.such.as.VMware,.Hyp
2ac0 65 72 2d 56 20 61 6e 64 20 4b 56 4d 2e 00 49 6e 73 74 61 6c 6c 20 60 60 6e 61 70 61 6c 6d 2d 76 er-V.and.KVM..Install.``napalm-v
2ae0 79 6f 73 60 60 20 6d 6f 64 75 6c 65 00 49 6e 73 74 61 6c 6c 61 74 69 6f 6e 00 49 74 20 69 73 20 yos``.module.Installation.It.is.
2b00 70 6f 73 73 69 62 6c 65 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 56 79 4f 53 20 76 69 61 20 6e possible.to.configure.VyOS.via.n
2b20 65 74 6d 69 6b 6f 5f 20 70 72 6f 78 79 20 6d 6f 64 75 6c 65 2e 20 49 74 20 72 65 71 75 69 72 65 etmiko_.proxy.module..It.require
2b40 73 20 61 20 6d 69 6e 69 6f 6e 20 77 69 74 68 20 69 6e 73 74 61 6c 6c 65 64 20 70 61 63 6b 65 74 s.a.minion.with.installed.packet
2b60 20 20 60 60 70 79 74 68 6f 6e 33 2d 6e 65 74 6d 69 6b 6f 60 60 20 6d 6f 64 75 6c 65 20 77 68 6f ..``python3-netmiko``.module.who
2b80 20 68 61 73 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 56 79 4f 53 20 6e 6f 64 65 73 2e .has.a.connection.to.VyOS.nodes.
2ba0 20 53 61 6c 74 2d 6d 69 6e 69 6f 6e 20 68 61 76 65 20 74 6f 20 63 6f 6d 6d 75 6e 69 63 61 74 65 .Salt-minion.have.to.communicate
2bc0 20 77 69 74 68 20 73 61 6c 74 20 6d 61 73 74 65 72 00 4d 61 6a 6f 72 20 63 6c 6f 75 64 20 70 72 .with.salt.master.Major.cloud.pr
2be0 6f 76 69 64 65 72 73 20 6f 66 66 65 72 20 61 20 6d 65 61 6e 73 20 6f 66 20 70 72 6f 76 69 64 69 oviders.offer.a.means.of.providi
2c00 6e 67 20 75 73 65 72 2d 64 61 74 61 20 61 74 20 74 68 65 20 74 69 6d 65 20 6f 66 20 69 6e 73 74 ng.user-data.at.the.time.of.inst
2c20 61 6e 63 65 20 6c 61 75 6e 63 68 2e 20 49 74 20 63 61 6e 20 62 65 20 70 72 6f 76 69 64 65 64 20 ance.launch..It.can.be.provided.
2c40 61 73 20 70 6c 61 69 6e 20 74 65 78 74 20 6f 72 20 61 73 20 62 61 73 65 36 34 2d 65 6e 63 6f 64 as.plain.text.or.as.base64-encod
2c60 65 64 20 74 65 78 74 2c 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 63 6c 6f 75 64 20 70 72 6f 76 ed.text,.depending.on.cloud.prov
2c80 69 64 65 72 2e 20 41 6c 73 6f 2c 20 69 74 20 63 61 6e 20 62 65 20 63 6f 6d 70 72 65 73 73 65 64 ider..Also,.it.can.be.compressed
2ca0 20 75 73 69 6e 67 20 67 7a 69 70 2c 20 77 68 69 63 68 20 6d 61 6b 65 73 20 73 65 6e 73 65 20 77 .using.gzip,.which.makes.sense.w
2cc0 69 74 68 20 61 20 6c 6f 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 ith.a.long.configuration.command
2ce0 73 20 6c 69 73 74 2c 20 62 65 63 61 75 73 65 20 6f 66 20 74 68 65 20 68 61 72 64 20 6c 69 6d 69 s.list,.because.of.the.hard.limi
2d00 74 20 74 6f 20 7e 31 36 33 38 34 20 62 79 74 65 73 20 66 6f 72 20 74 68 65 20 77 68 6f 6c 65 20 t.to.~16384.bytes.for.the.whole.
2d20 75 73 65 72 2d 64 61 74 61 2e 00 4d 65 74 61 64 61 74 61 20 2d 20 4d 65 74 61 64 61 74 61 20 69 user-data..Metadata.-.Metadata.i
2d40 73 20 73 6f 75 72 63 65 64 20 62 79 20 74 68 65 20 63 6c 6f 75 64 20 70 6c 61 74 66 6f 72 6d 20 s.sourced.by.the.cloud.platform.
2d60 6f 72 20 68 79 70 65 72 76 69 73 6f 72 2e 20 49 6e 20 73 6f 6d 65 20 63 6c 6f 75 64 73 2c 20 74 or.hypervisor..In.some.clouds,.t
2d80 68 65 72 65 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 61 73 20 61 6e 20 48 54 54 50 20 65 here.is.implemented.as.an.HTTP.e
2da0 6e 64 70 6f 69 6e 74 20 61 74 20 60 60 68 74 74 70 3a 2f 2f 31 36 39 2e 32 35 34 2e 31 36 39 2e ndpoint.at.``http://169.254.169.
2dc0 32 35 34 60 60 2e 00 4d 6f 73 74 20 69 6d 70 6f 72 74 61 6e 74 20 6b 65 79 73 20 74 68 61 74 20 254``..Most.important.keys.that.
2de0 6e 65 65 64 73 20 74 6f 20 62 65 20 63 6f 6e 73 69 64 65 72 65 64 3a 00 4e 61 70 61 6c 6d 00 4e needs.to.be.considered:.Napalm.N
2e00 65 74 6d 69 6b 6f 00 4e 65 74 6d 69 6b 6f 2d 70 72 6f 78 79 00 4e 65 74 77 6f 72 6b 20 63 6f 6e etmiko.Netmiko-proxy.Network.con
2e20 66 69 67 75 72 61 74 69 6f 6e 20 2d 20 54 68 69 73 20 63 6f 6e 66 69 67 20 73 6f 75 72 63 65 20 figuration.-.This.config.source.
2e40 69 6e 66 6f 72 6d 73 20 74 68 65 20 73 79 73 74 65 6d 20 61 62 6f 75 74 20 74 68 65 20 6e 65 74 informs.the.system.about.the.net
2e60 77 6f 72 6b 20 73 65 74 74 69 6e 67 73 20 6c 69 6b 65 20 49 50 20 61 64 64 72 65 73 73 65 73 2c work.settings.like.IP.addresses,
2e80 20 72 6f 75 74 65 73 2c 20 44 4e 53 2e 20 41 76 61 69 6c 61 62 6c 65 20 6f 6e 6c 79 20 69 6e 20 .routes,.DNS..Available.only.in.
2ea0 73 65 76 65 72 61 6c 20 63 6c 6f 75 64 20 61 6e 64 20 76 69 72 74 75 61 6c 69 7a 61 74 69 6f 6e several.cloud.and.virtualization
2ec0 20 70 6c 61 74 66 6f 72 6d 73 2e 00 4e 65 74 77 6f 72 6b 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 .platforms..Networking.configura
2ee0 74 69 6f 6e 73 20 73 68 6f 75 6c 64 6e 27 74 20 62 65 20 70 61 73 73 65 64 20 69 6e 20 75 73 65 tions.shouldn't.be.passed.in.use
2f00 72 2d 64 61 74 61 20 66 69 6c 65 2e 00 4e 6f 43 6c 6f 75 64 00 4e 6f 72 6e 69 72 00 4e 6f 74 65 r-data.file..NoCloud.Nornir.Note
2f20 20 74 68 61 74 20 74 68 65 20 2f 6f 70 74 2f 76 79 61 74 74 61 2f 65 74 63 2f 63 6f 6e 66 69 67 .that.the./opt/vyatta/etc/config
2f40 20 69 73 20 75 73 65 64 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 65 20 2f 63 6f 6e 66 69 67 2f .is.used.instead.of.the./config/
2f60 73 63 72 69 70 74 73 20 64 69 72 65 63 74 6f 72 79 20 72 65 66 65 72 65 6e 63 65 64 20 69 6e 20 scripts.directory.referenced.in.
2f80 74 68 65 20 3a 72 65 66 3a 60 63 6f 6d 6d 61 6e 64 2d 73 63 72 69 70 74 69 6e 67 60 20 73 65 63 the.:ref:`command-scripting`.sec
2fa0 74 69 6f 6e 20 6f 66 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 62 65 63 61 75 73 tion.of.the.documentation.becaus
2fc0 65 20 74 68 65 20 2f 63 6f 6e 66 69 67 2f 73 63 72 69 70 74 20 64 69 72 65 63 74 6f 72 79 20 69 e.the./config/script.directory.i
2fe0 73 6e 27 74 20 6d 6f 75 6e 74 65 64 20 77 68 65 6e 20 74 68 65 20 60 60 77 72 69 74 65 5f 66 69 sn't.mounted.when.the.``write_fi
3000 6c 65 73 60 60 20 6d 6f 64 75 6c 65 20 65 78 65 63 75 74 65 73 2e 00 4e 6f 74 65 73 20 66 6f 72 les``.module.executes..Notes.for
3020 20 74 68 69 73 20 70 61 72 74 69 63 75 6c 61 72 20 65 78 61 6d 70 6c 65 2c 20 74 68 61 74 20 6d .this.particular.example,.that.m
3040 61 79 20 6e 65 65 64 20 74 6f 20 62 65 20 6d 6f 64 69 66 69 65 64 20 69 6e 20 6f 74 68 65 72 20 ay.need.to.be.modified.in.other.
3060 73 65 74 75 70 73 3a 00 4e 6f 77 2c 20 74 68 61 74 20 66 69 6c 65 20 6e 65 65 64 73 20 74 6f 20 setups:.Now,.that.file.needs.to.
3080 62 65 20 63 6f 70 69 65 64 20 74 6f 20 70 72 6f 78 6d 6f 78 20 73 65 72 76 65 72 3a 00 4f 6e 20 be.copied.to.proxmox.server:.On.
30a0 56 79 4f 53 20 74 68 69 73 20 77 69 6c 6c 20 63 61 75 73 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 VyOS.this.will.cause.the.followi
30c0 6e 67 20 70 72 6f 62 6c 65 6d 3a 20 41 66 74 65 72 20 6d 6f 64 69 66 79 69 6e 67 20 74 68 65 20 ng.problem:.After.modifying.the.
30e0 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 76 69 61 20 73 63 72 69 70 74 20 6c 69 6b 65 20 74 68 configuration.via.script.like.th
3100 69 73 20 6f 6e 63 65 2c 20 69 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 6d is.once,.it.is.not.possible.to.m
3120 61 6e 75 61 6c 6c 79 20 6d 6f 64 69 66 79 20 74 68 65 20 63 6f 6e 66 69 67 20 61 6e 79 6d 6f 72 anually.modify.the.config.anymor
3140 65 3a 00 4f 6e 20 70 72 6f 78 6d 6f 78 20 73 65 72 76 65 72 3a 00 4f 6e 63 65 20 74 68 65 20 74 e:.On.proxmox.server:.Once.the.t
3160 68 72 65 65 20 66 69 6c 65 73 20 77 65 72 65 20 63 72 65 61 74 65 64 2c 20 69 74 27 73 20 74 69 hree.files.were.created,.it's.ti
3180 6d 65 20 74 6f 20 67 65 6e 65 72 61 74 65 20 74 68 65 20 60 60 73 65 65 64 2e 69 73 6f 60 60 20 me.to.generate.the.``seed.iso``.
31a0 69 6d 61 67 65 2c 20 77 68 69 63 68 20 6e 65 65 64 73 20 74 6f 20 62 65 20 6d 6f 75 6e 74 65 64 image,.which.needs.to.be.mounted
31c0 20 74 6f 20 74 68 65 20 6e 65 77 20 56 4d 20 61 73 20 61 20 63 64 2e 00 4f 6e 65 20 63 6f 6d 6d .to.the.new.VM.as.a.cd..One.comm
31e0 61 6e 64 20 70 65 72 20 6c 69 6e 65 2e 00 4f 70 2d 6d 6f 64 65 00 4f 74 68 65 72 20 73 63 72 69 and.per.line..Op-mode.Other.scri
3200 70 74 20 6c 61 6e 67 75 61 67 65 73 00 4f 75 74 70 75 74 00 4f 75 74 70 75 74 20 6f 70 2d 6d 6f pt.languages.Output.Output.op-mo
3220 64 65 00 50 6c 65 61 73 65 20 74 61 6b 65 20 61 20 6c 6f 6f 6b 20 61 74 20 74 68 65 20 43 6f 6e de.Please.take.a.look.at.the.Con
3240 74 72 69 62 75 74 69 6e 67 20 47 75 69 64 65 20 66 6f 72 20 6f 75 72 20 3a 72 65 66 3a 60 64 6f tributing.Guide.for.our.:ref:`do
3260 63 75 6d 65 6e 74 61 74 69 6f 6e 60 2e 00 50 6f 73 74 63 6f 6e 66 69 67 20 6f 6e 20 62 6f 6f 74 cumentation`..Postconfig.on.boot
3280 00 50 6f 77 65 72 20 6f 6e 20 56 4d 20 61 6e 64 20 76 65 72 69 66 69 63 61 74 69 6f 6e 73 00 50 .Power.on.VM.and.verifications.P
32a0 72 65 63 6f 6e 66 69 67 20 6f 6e 20 62 6f 6f 74 00 50 72 65 70 61 72 65 20 63 6c 6f 75 64 2d 69 reconfig.on.boot.Prepare.cloud-i
32c0 6e 69 74 20 66 69 6c 65 73 00 50 72 6f 78 6d 6f 78 20 49 50 20 61 64 64 72 65 73 73 3a 20 2a 2a nit.files.Proxmox.IP.address:.**
32e0 31 39 32 2e 31 36 38 2e 30 2e 32 35 33 2f 32 34 2a 2a 00 50 72 6f 78 6d 6f 78 20 60 43 6c 6f 75 192.168.0.253/24**.Proxmox.`Clou
3300 64 2d 69 6e 69 74 2d 53 75 70 70 6f 72 74 60 5f 2e 00 50 79 56 79 4f 53 00 50 79 56 79 4f 53 20 d-init-Support`_..PyVyOS.PyVyOS.
3320 69 73 20 61 20 50 79 74 68 6f 6e 20 6c 69 62 72 61 72 79 20 66 6f 72 20 69 6e 74 65 72 61 63 74 is.a.Python.library.for.interact
3340 69 6e 67 20 77 69 74 68 20 56 79 4f 53 20 64 65 76 69 63 65 73 20 76 69 61 20 74 68 65 69 72 20 ing.with.VyOS.devices.via.their.
3360 41 50 49 2e 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 67 75 69 64 65 73 20 79 API..This.documentation.guides.y
3380 6f 75 20 6f 6e 20 75 73 69 6e 67 20 50 79 56 79 4f 53 20 74 6f 20 6d 61 6e 61 67 65 20 79 6f 75 ou.on.using.PyVyOS.to.manage.you
33a0 72 20 56 79 4f 53 20 64 65 76 69 63 65 73 20 70 72 6f 67 72 61 6d 6d 61 74 69 63 61 6c 6c 79 2e r.VyOS.devices.programmatically.
33c0 20 54 68 65 20 63 6f 6d 70 6c 65 74 65 20 50 79 56 79 4f 53 20 64 6f 63 75 6d 65 6e 74 61 74 69 .The.complete.PyVyOS.documentati
33e0 6f 6e 20 69 73 20 61 76 61 69 6c 61 62 6c 65 20 6f 6e 20 5b 52 65 61 64 20 74 68 65 20 44 6f 63 on.is.available.on.[Read.the.Doc
3400 73 5d 28 68 74 74 70 73 3a 2f 2f 70 79 76 79 6f 73 2e 72 65 61 64 74 68 65 64 6f 63 73 2e 69 6f s](https://pyvyos.readthedocs.io
3420 2f 65 6e 2f 6c 61 74 65 73 74 2f 29 2c 20 61 6e 64 20 74 68 65 20 6c 69 62 72 61 72 79 20 63 61 /en/latest/),.and.the.library.ca
3440 6e 20 62 65 20 66 6f 75 6e 64 20 6f 6e 20 5b 47 69 74 48 75 62 5d 28 68 74 74 70 73 3a 2f 2f 67 n.be.found.on.[GitHub](https://g
3460 69 74 68 75 62 2e 63 6f 6d 2f 72 6f 62 65 72 74 6f 62 65 72 74 6f 2f 70 79 76 79 6f 73 29 20 61 ithub.com/robertoberto/pyvyos).a
3480 6e 64 20 5b 50 79 50 49 5d 28 68 74 74 70 73 3a 2f 2f 70 79 70 69 2e 6f 72 67 2f 70 72 6f 6a 65 nd.[PyPI](https://pypi.org/proje
34a0 63 74 2f 70 79 76 79 6f 73 2f 29 2e 00 52 65 66 65 72 65 6e 63 65 73 00 52 65 6d 6f 76 65 20 64 ct/pyvyos/)..References.Remove.d
34c0 65 66 61 75 6c 74 20 64 68 63 70 20 63 6c 69 65 6e 74 20 6f 6e 20 66 69 72 73 74 20 69 6e 74 65 efault.dhcp.client.on.first.inte
34e0 72 66 61 63 65 2c 20 61 6e 64 20 6c 6f 61 64 20 6f 74 68 65 72 20 63 6f 6e 66 69 67 75 72 61 74 rface,.and.load.other.configurat
3500 69 6f 6e 20 64 75 72 69 6e 67 20 66 69 72 73 74 20 62 6f 6f 74 2c 20 75 73 69 6e 67 20 63 6c 6f ion.during.first.boot,.using.clo
3520 75 64 2d 69 6e 69 74 2e 00 52 65 73 65 74 20 4f 62 6a 65 63 74 00 52 75 6e 20 61 6e 73 69 62 6c ud-init..Reset.Object.Run.ansibl
3540 65 00 52 75 6e 20 63 6f 6d 6d 61 6e 64 73 20 72 65 6d 6f 74 65 6c 79 00 52 75 6e 20 63 6f 6e 66 e.Run.commands.remotely.Run.conf
3560 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 00 52 75 6e 20 6f 70 65 72 61 74 69 6f 6e iguration.commands.Run.operation
3580 61 6c 20 63 6f 6d 6d 61 6e 64 73 00 53 53 48 20 69 73 20 63 6f 6e 66 69 67 75 72 65 64 20 6f 6e al.commands.SSH.is.configured.on
35a0 20 70 6f 72 74 20 32 32 2e 00 53 61 6c 74 00 53 61 6c 74 20 6d 61 73 74 65 72 20 63 6f 6e 66 69 .port.22..Salt.Salt.master.confi
35c0 67 75 72 61 74 69 6f 6e 3a 00 53 61 76 65 20 61 20 72 75 6e 6e 69 6e 67 20 63 6f 6e 66 69 67 75 guration:.Save.a.running.configu
35e0 72 61 74 69 6f 6e 20 74 6f 20 61 20 66 69 6c 65 2e 00 53 61 76 65 20 61 20 72 75 6e 6e 69 6e 67 ration.to.a.file..Save.a.running
3600 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 74 6f 20 74 68 65 20 73 74 61 72 74 75 70 20 63 6f .configuration.to.the.startup.co
3620 6e 66 69 67 75 72 61 74 69 6f 6e 2e 20 57 68 65 6e 20 79 6f 75 20 64 6f 6e 27 74 20 73 70 65 63 nfiguration..When.you.don't.spec
3640 69 66 79 20 74 68 65 20 66 69 6c 65 20 77 68 65 6e 20 73 61 76 69 6e 67 2c 20 69 74 20 73 61 76 ify.the.file.when.saving,.it.sav
3660 65 73 20 74 6f 20 60 60 2f 63 6f 6e 66 69 67 2f 63 6f 6e 66 69 67 2e 62 6f 6f 74 60 60 2e 00 53 es.to.``/config/config.boot``..S
3680 63 72 69 70 74 20 76 79 6f 73 2d 6e 61 70 61 6c 6d 2e 70 79 00 53 63 72 69 70 74 73 20 61 72 65 cript.vyos-napalm.py.Scripts.are
36a0 20 72 75 6e 20 69 6e 20 61 6c 70 68 61 62 65 74 69 63 61 6c 20 6f 72 64 65 72 2e 20 54 68 65 69 .run.in.alphabetical.order..Thei
36c0 72 20 6e 61 6d 65 73 20 6d 75 73 74 20 63 6f 6e 73 69 73 74 20 65 6e 74 69 72 65 6c 79 20 6f 66 r.names.must.consist.entirely.of
36e0 20 41 53 43 49 49 20 75 70 70 65 72 2d 20 61 6e 64 20 6c 6f 77 65 72 2d 63 61 73 65 20 6c 65 74 .ASCII.upper-.and.lower-case.let
3700 74 65 72 73 2c 41 53 43 49 49 20 64 69 67 69 74 73 2c 20 41 53 43 49 49 20 75 6e 64 65 72 73 63 ters,ASCII.digits,.ASCII.undersc
3720 6f 72 65 73 2c 20 61 6e 64 20 41 53 43 49 49 20 6d 69 6e 75 73 2d 68 79 70 68 65 6e 73 2e 4e 6f ores,.and.ASCII.minus-hyphens.No
3740 20 6f 74 68 65 72 20 63 68 61 72 61 63 74 65 72 73 20 61 72 65 20 61 6c 6c 6f 77 65 64 2e 00 53 .other.characters.are.allowed..S
3760 68 6f 77 20 4f 62 6a 65 63 74 00 53 6f 6d 65 74 69 6d 65 73 20 79 6f 75 20 73 69 6d 70 6c 79 20 how.Object.Sometimes.you.simply.
3780 77 61 6e 27 74 20 74 6f 20 65 78 65 63 75 74 65 20 61 20 62 75 6e 63 68 20 6f 66 20 6f 70 2d 6d wan't.to.execute.a.bunch.of.op-m
37a0 6f 64 65 20 63 6f 6d 6d 61 6e 64 73 20 76 69 61 20 53 53 48 20 6f 6e 20 61 20 72 65 6d 6f 74 65 ode.commands.via.SSH.on.a.remote
37c0 20 56 79 4f 53 20 73 79 73 74 65 6d 2e 00 53 74 6f 72 61 67 65 64 20 75 73 65 64 3a 20 76 6f 6c .VyOS.system..Storaged.used:.vol
37e0 75 6d 65 20 6c 6f 63 61 6c 2c 20 77 68 69 63 68 20 69 73 20 6d 6f 75 6e 74 65 64 20 6f 6e 20 64 ume.local,.which.is.mounted.on.d
3800 69 72 65 63 74 6f 72 79 20 2a 2a 2f 76 61 72 2f 6c 69 62 2f 76 7a 2a 2a 2c 20 61 6e 64 20 63 6f irectory.**/var/lib/vz**,.and.co
3820 6e 74 61 69 6e 73 20 61 6c 6c 20 74 79 70 65 20 6f 66 20 63 6f 6e 74 65 6e 74 2c 20 69 6e 63 6c ntains.all.type.of.content,.incl
3840 75 64 69 6e 67 20 73 6e 69 70 70 65 74 73 2e 00 53 74 72 75 63 74 75 72 65 20 6f 66 20 2f 73 72 uding.snippets..Structure.of./sr
3860 76 2f 73 61 6c 74 3a 00 53 74 72 75 63 74 75 72 65 20 6f 66 20 66 69 6c 65 73 00 53 79 73 74 65 v/salt:.Structure.of.files.Syste
3880 6d 20 44 65 66 61 75 6c 74 73 2f 46 61 6c 6c 62 61 63 6b 73 00 54 68 65 20 41 50 49 20 70 75 73 m.Defaults/Fallbacks.The.API.pus
38a0 68 65 73 20 65 76 65 72 79 20 72 65 71 75 65 73 74 20 74 6f 20 61 20 73 65 73 73 69 6f 6e 20 61 hes.every.request.to.a.session.a
38c0 6e 64 20 63 6f 6d 6d 69 74 20 69 74 2e 20 42 75 74 20 73 6f 6d 65 20 6f 66 20 56 79 4f 53 20 63 nd.commit.it..But.some.of.VyOS.c
38e0 6f 6d 70 6f 6e 65 6e 74 73 20 6c 69 6b 65 20 44 48 43 50 20 61 6e 64 20 50 50 50 6f 45 20 53 65 omponents.like.DHCP.and.PPPoE.Se
3900 72 76 65 72 73 2c 20 49 50 53 65 63 2c 20 56 58 4c 41 4e 2c 20 61 6e 64 20 6f 74 68 65 72 20 74 rvers,.IPSec,.VXLAN,.and.other.t
3920 75 6e 6e 65 6c 73 20 72 65 71 75 69 72 65 20 66 75 6c 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f unnels.require.full.configuratio
3940 6e 20 66 6f 72 20 63 6f 6d 6d 69 74 2e 20 54 68 65 20 65 6e 64 70 6f 69 6e 74 20 77 69 6c 6c 20 n.for.commit..The.endpoint.will.
3960 70 72 6f 63 65 73 73 20 6d 75 6c 74 69 70 6c 65 20 63 6f 6d 6d 61 6e 64 73 20 77 68 65 6e 20 79 process.multiple.commands.when.y
3980 6f 75 20 70 61 73 73 20 74 68 65 6d 20 61 73 20 61 20 6c 69 73 74 20 74 6f 20 74 68 65 20 60 60 ou.pass.them.as.a.list.to.the.``
39a0 64 61 74 61 60 60 20 66 69 65 6c 64 2e 00 54 68 65 20 60 60 2f 63 6f 6e 66 69 67 2f 73 63 72 69 data``.field..The.``/config/scri
39c0 70 74 73 2f 76 79 6f 73 2d 70 6f 73 74 63 6f 6e 66 69 67 2d 62 6f 6f 74 75 70 2e 73 63 72 69 70 pts/vyos-postconfig-bootup.scrip
39e0 74 60 60 20 73 63 72 69 70 74 20 69 73 20 63 61 6c 6c 65 64 20 6f 6e 20 62 6f 6f 74 20 61 66 74 t``.script.is.called.on.boot.aft
3a00 65 72 20 74 68 65 20 56 79 4f 53 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 73 20 66 75 6c er.the.VyOS.configuration.is.ful
3a20 6c 79 20 61 70 70 6c 69 65 64 2e 00 54 68 65 20 60 60 2f 63 6f 6e 66 69 67 2f 73 63 72 69 70 74 ly.applied..The.``/config/script
3a40 73 2f 76 79 6f 73 2d 70 72 65 63 6f 6e 66 69 67 2d 62 6f 6f 74 75 70 2e 73 63 72 69 70 74 60 60 s/vyos-preconfig-bootup.script``
3a60 20 73 63 72 69 70 74 20 69 73 20 63 61 6c 6c 65 64 20 6f 6e 20 62 6f 6f 74 20 62 65 66 6f 72 65 .script.is.called.on.boot.before
3a80 20 74 68 65 20 56 79 4f 53 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 64 75 72 69 6e 67 20 62 .the.VyOS.configuration.during.b
3aa0 6f 6f 74 20 70 72 6f 63 65 73 73 2e 00 54 68 65 20 60 60 2f 73 68 6f 77 60 60 20 65 6e 64 70 6f oot.process..The.``/show``.endpo
3ac0 69 6e 74 20 69 73 20 74 6f 20 73 68 6f 77 20 65 76 65 72 79 74 68 69 6e 67 20 69 6e 20 74 68 65 int.is.to.show.everything.in.the
3ae0 20 6f 70 65 72 61 74 69 6f 6e 61 6c 20 6d 6f 64 65 2e 00 54 68 65 20 60 60 67 65 6e 65 72 61 74 .operational.mode..The.``generat
3b00 65 60 60 20 65 6e 64 70 6f 69 6e 74 20 72 75 6e 20 61 20 60 60 67 65 6e 65 72 61 74 65 60 60 20 e``.endpoint.run.a.``generate``.
3b20 63 6f 6d 6d 61 6e 64 2e 00 54 68 65 20 60 60 72 65 73 65 74 60 60 20 65 6e 64 70 6f 69 6e 74 20 command..The.``reset``.endpoint.
3b40 72 75 6e 20 61 20 60 60 72 65 73 65 74 60 60 20 63 6f 6d 6d 61 6e 64 2e 00 54 68 65 20 63 6f 6d run.a.``reset``.command..The.com
3b60 6d 61 6e 64 73 20 6c 69 73 74 20 70 72 6f 64 75 63 65 64 20 62 79 20 74 68 65 20 60 60 73 68 6f mands.list.produced.by.the.``sho
3b80 77 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 60 60 20 63 6f 6d 6d 61 w.configuration.commands``.comma
3ba0 6e 64 20 6f 6e 20 61 20 56 79 4f 53 20 72 6f 75 74 65 72 20 73 68 6f 75 6c 64 20 63 6f 6d 70 6c nd.on.a.VyOS.router.should.compl
3bc0 79 20 77 69 74 68 20 61 6c 6c 20 74 68 65 20 72 65 71 75 69 72 65 6d 65 6e 74 73 2c 20 73 6f 20 y.with.all.the.requirements,.so.
3be0 69 74 20 69 73 20 65 61 73 79 20 74 6f 20 67 65 74 20 61 20 70 72 6f 70 65 72 20 63 6f 6d 6d 61 it.is.easy.to.get.a.proper.comma
3c00 6e 64 73 20 6c 69 73 74 20 62 79 20 63 6f 70 79 69 6e 67 20 69 74 20 66 72 6f 6d 20 61 6e 6f 74 nds.list.by.copying.it.from.anot
3c20 68 65 72 20 72 6f 75 74 65 72 2e 00 54 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 73 70 her.router..The.configuration.sp
3c40 65 63 69 66 69 65 64 20 69 6e 20 74 68 65 20 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 20 64 6f 63 75 ecified.in.the.cloud-config.docu
3c60 6d 65 6e 74 20 6f 76 65 72 77 72 69 74 65 73 20 64 65 66 61 75 6c 74 20 63 6f 6e 66 69 67 75 72 ment.overwrites.default.configur
3c80 61 74 69 6f 6e 20 76 61 6c 75 65 73 20 61 6e 64 20 76 61 6c 75 65 73 20 63 6f 6e 66 69 67 75 72 ation.values.and.values.configur
3ca0 65 64 20 76 69 61 20 4d 65 74 61 64 61 74 61 2e 00 54 68 65 20 64 65 66 61 75 6c 74 20 64 69 72 ed.via.Metadata..The.default.dir
3cc0 65 63 74 6f 72 69 65 73 20 77 68 65 72 65 20 79 6f 75 72 20 63 75 73 74 6f 6d 20 53 63 72 69 70 ectories.where.your.custom.Scrip
3ce0 74 73 20 73 68 6f 75 6c 64 20 62 65 20 6c 6f 63 61 74 65 64 20 61 72 65 3a 00 54 68 65 20 64 65 ts.should.be.located.are:.The.de
3d00 66 61 75 6c 74 20 66 69 6c 65 20 6c 6f 6f 6b 73 20 6c 69 6b 65 20 74 68 69 73 3a 00 54 68 65 20 fault.file.looks.like.this:.The.
3d20 65 61 73 69 65 73 74 20 77 61 79 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 74 68 65 20 73 79 73 easiest.way.to.configure.the.sys
3d40 74 65 6d 20 76 69 61 20 75 73 65 72 2d 64 61 74 61 20 69 73 20 74 68 65 20 43 6c 6f 75 64 2d 63 tem.via.user-data.is.the.Cloud-c
3d60 6f 6e 66 69 67 20 73 79 6e 74 61 78 20 64 65 73 63 72 69 62 65 64 20 62 65 6c 6f 77 2e 00 54 68 onfig.syntax.described.below..Th
3d80 65 20 65 6e 64 70 6f 69 6e 74 20 60 60 2f 63 6f 6e 66 69 67 2d 66 69 6c 65 60 60 20 69 73 20 74 e.endpoint.``/config-file``.is.t
3da0 6f 20 73 61 76 65 20 6f 72 20 6c 6f 61 64 20 61 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 00 o.save.or.load.a.configuration..
3dc0 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 78 61 6d 70 6c 65 20 73 65 74 73 20 74 68 65 20 68 The.following.example.sets.the.h
3de0 6f 73 74 6e 61 6d 65 20 62 61 73 65 64 20 6f 6e 20 74 68 65 20 69 6e 73 74 61 6e 63 65 20 69 64 ostname.based.on.the.instance.id
3e00 65 6e 74 69 66 69 65 72 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 74 68 65 20 45 43 32 20 6d entifier.obtained.from.the.EC2.m
3e20 65 74 61 64 61 74 61 20 73 65 72 76 69 63 65 2e 00 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 etadata.service..The.following.e
3e40 78 61 6d 70 6c 65 20 73 68 6f 77 73 20 68 6f 77 20 74 6f 20 65 78 65 63 75 74 65 20 63 6f 6d 6d xample.shows.how.to.execute.comm
3e60 61 6e 64 73 20 61 66 74 65 72 20 74 68 65 20 69 6e 69 74 69 61 6c 20 63 6f 6e 66 69 67 75 72 61 ands.after.the.initial.configura
3e80 74 69 6f 6e 2e 00 54 68 65 20 6b 65 79 20 75 73 65 64 20 74 6f 20 64 65 73 69 67 6e 61 74 65 20 tion..The.key.used.to.designate.
3ea0 61 20 56 79 4f 53 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 73 20 60 60 76 79 6f 73 5f 63 a.VyOS.configuration.is.``vyos_c
3ec0 6f 6e 66 69 67 5f 63 6f 6d 6d 61 6e 64 73 60 60 2e 20 57 68 61 74 20 66 6f 6c 6c 6f 77 73 20 69 onfig_commands``..What.follows.i
3ee0 73 20 56 79 4f 53 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 75 73 69 6e 67 20 74 68 65 20 22 s.VyOS.configuration.using.the."
3f00 73 65 74 2d 73 74 79 6c 65 22 20 73 79 6e 74 61 78 2e 20 42 6f 74 68 20 22 73 65 74 22 20 61 6e set-style".syntax..Both."set".an
3f20 64 20 22 64 65 6c 65 74 65 22 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 73 75 70 70 6f 72 74 65 d."delete".commands.are.supporte
3f40 64 2e 00 54 68 65 20 73 65 65 64 2e 69 73 6f 20 66 69 6c 65 20 63 61 6e 20 62 65 20 61 74 74 61 d..The.seed.iso.file.can.be.atta
3f60 63 68 65 64 20 74 6f 20 74 68 65 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 2e 20 41 73 20 ched.to.the.virtual.machine..As.
3f80 61 6e 20 65 78 61 6d 70 6c 65 2c 20 74 68 65 20 6d 65 74 68 6f 64 20 77 69 74 68 20 4b 56 4d 20 an.example,.the.method.with.KVM.
3fa0 74 6f 20 61 74 74 61 63 68 20 74 68 65 20 49 53 4f 20 61 73 20 61 20 43 44 20 64 72 69 76 65 20 to.attach.the.ISO.as.a.CD.drive.
3fc0 66 6f 6c 6c 6f 77 73 2e 00 54 68 65 72 65 20 69 73 20 61 20 70 69 74 66 61 6c 6c 20 77 68 65 6e follows..There.is.a.pitfall.when
3fe0 20 77 6f 72 6b 69 6e 67 20 77 69 74 68 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 73 63 72 69 .working.with.configuration.scri
4000 70 74 73 2e 20 49 74 20 69 73 20 74 65 6d 70 74 69 6e 67 20 74 6f 20 63 61 6c 6c 20 63 6f 6e 66 pts..It.is.tempting.to.call.conf
4020 69 67 75 72 61 74 69 6f 6e 20 73 63 72 69 70 74 73 20 77 69 74 68 20 22 73 75 64 6f 22 20 28 69 iguration.scripts.with."sudo".(i
4040 2e 65 2e 2c 20 74 65 6d 70 6f 72 61 72 79 20 72 6f 6f 74 20 70 65 72 6d 69 73 73 69 6f 6e 73 29 .e.,.temporary.root.permissions)
4060 2c 20 62 65 63 61 75 73 65 20 74 68 61 74 27 73 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 77 61 79 20 ,.because.that's.the.common.way.
4080 6f 6e 20 6d 6f 73 74 20 4c 69 6e 75 78 20 70 6c 61 74 66 6f 72 6d 73 20 74 6f 20 63 61 6c 6c 20 on.most.Linux.platforms.to.call.
40a0 73 79 73 74 65 6d 20 63 6f 6d 6d 61 6e 64 73 2e 00 54 68 65 73 65 20 61 72 65 20 74 68 65 20 56 system.commands..These.are.the.V
40c0 79 4f 53 20 64 65 66 61 75 6c 74 73 20 61 6e 64 20 66 61 6c 6c 62 61 63 6b 73 2e 00 54 68 69 73 yOS.defaults.and.fallbacks..This
40e0 20 73 65 63 74 69 6f 6e 20 6e 65 65 64 73 20 69 6d 70 72 6f 76 65 6d 65 6e 74 73 2c 20 65 78 61 .section.needs.improvements,.exa
4100 6d 70 6c 65 73 20 61 6e 64 20 65 78 70 6c 61 6e 61 74 69 6f 6e 73 2e 00 54 68 69 73 20 77 69 6c mples.and.explanations..This.wil
4120 6c 20 72 65 73 75 6c 74 20 69 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 72 72 6f 72 20 l.result.in.the.following.error.
4140 6d 65 73 73 61 67 65 3a 20 60 60 53 65 74 20 66 61 69 6c 65 64 60 60 20 49 66 20 74 68 69 73 20 message:.``Set.failed``.If.this.
4160 68 61 70 70 65 6e 73 2c 20 61 20 72 65 62 6f 6f 74 20 69 73 20 72 65 71 75 69 72 65 64 20 74 6f happens,.a.reboot.is.required.to
4180 20 62 65 20 61 62 6c 65 20 74 6f 20 65 64 69 74 20 74 68 65 20 63 6f 6e 66 69 67 20 6d 61 6e 75 .be.able.to.edit.the.config.manu
41a0 61 6c 6c 79 20 61 67 61 69 6e 2e 00 54 6f 20 4c 6f 61 64 20 61 20 63 6f 6e 66 69 67 75 72 61 74 ally.again..To.Load.a.configurat
41c0 69 6f 6e 20 66 69 6c 65 2e 00 54 6f 20 61 64 64 20 6f 72 20 64 65 6c 65 74 65 20 61 6e 20 69 6d ion.file..To.add.or.delete.an.im
41e0 61 67 65 2c 20 75 73 65 20 74 68 65 20 60 60 2f 69 6d 61 67 65 60 60 20 65 6e 64 70 6f 69 6e 74 age,.use.the.``/image``.endpoint
4200 2e 00 54 6f 20 61 76 6f 69 64 20 74 68 65 73 65 20 70 72 6f 62 6c 65 6d 73 2c 20 74 68 65 20 70 ..To.avoid.these.problems,.the.p
4220 72 6f 70 65 72 20 77 61 79 20 69 73 20 74 6f 20 63 61 6c 6c 20 61 20 73 63 72 69 70 74 20 77 69 roper.way.is.to.call.a.script.wi
4240 74 68 20 74 68 65 20 60 60 76 79 61 74 74 61 63 66 67 60 60 20 67 72 6f 75 70 2c 20 65 2e 67 2e th.the.``vyattacfg``.group,.e.g.
4260 2c 20 62 79 20 75 73 69 6e 67 20 74 68 65 20 60 60 73 67 60 60 20 28 73 77 69 74 63 68 20 67 72 ,.by.using.the.``sg``.(switch.gr
4280 6f 75 70 29 20 63 6f 6d 6d 61 6e 64 3a 00 54 6f 20 67 65 74 20 74 68 65 20 77 68 6f 6c 65 20 63 oup).command:.To.get.the.whole.c
42a0 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2c 20 70 61 73 73 20 61 6e 20 65 6d 70 74 79 20 6c 69 73 74 onfiguration,.pass.an.empty.list
42c0 20 74 6f 20 74 68 65 20 60 60 70 61 74 68 60 60 20 66 69 65 6c 64 00 54 6f 20 69 6e 63 6c 75 64 .to.the.``path``.field.To.includ
42e0 65 20 56 79 4f 53 20 73 70 65 63 69 66 69 63 20 66 75 6e 63 74 69 6f 6e 73 20 61 6e 64 20 61 6c e.VyOS.specific.functions.and.al
4300 69 61 73 65 73 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 60 60 73 6f 75 72 63 65 20 2f 6f 70 74 2f iases.you.need.to.``source./opt/
4320 76 79 61 74 74 61 2f 65 74 63 2f 66 75 6e 63 74 69 6f 6e 73 2f 73 63 72 69 70 74 2d 74 65 6d 70 vyatta/etc/functions/script-temp
4340 6c 61 74 65 60 60 20 66 69 6c 65 73 20 61 74 20 74 68 65 20 74 6f 70 20 6f 66 20 79 6f 75 72 20 late``.files.at.the.top.of.your.
4360 73 63 72 69 70 74 2e 00 54 6f 20 69 6e 69 74 69 61 74 65 20 61 20 72 65 62 6f 6f 74 20 75 73 65 script..To.initiate.a.reboot.use
4380 20 74 68 65 20 60 60 72 65 62 6f 6f 74 60 60 20 65 6e 64 70 6f 69 6e 74 2e 00 54 6f 20 6d 61 6b .the.``reboot``.endpoint..To.mak
43a0 65 20 73 75 72 65 20 74 68 61 74 20 61 20 73 63 72 69 70 74 20 69 73 20 6e 6f 74 20 61 63 63 69 e.sure.that.a.script.is.not.acci
43c0 64 65 6e 74 61 6c 6c 79 20 63 61 6c 6c 65 64 20 77 69 74 68 6f 75 74 20 74 68 65 20 60 60 76 79 dentally.called.without.the.``vy
43e0 61 74 74 61 63 66 67 60 60 20 67 72 6f 75 70 2c 20 74 68 65 20 73 63 72 69 70 74 20 63 61 6e 20 attacfg``.group,.the.script.can.
4400 62 65 20 73 61 66 65 67 75 61 72 64 65 64 20 6c 69 6b 65 20 74 68 69 73 3a 00 54 6f 20 6f 6e 6c be.safeguarded.like.this:.To.onl
4420 79 20 67 65 74 20 61 20 70 61 72 74 20 6f 66 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f y.get.a.part.of.the.configuratio
4440 6e 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 20 60 60 73 79 73 74 65 6d 20 73 79 73 6c 6f 67 60 60 n,.for.example.``system.syslog``
4460 2e 00 54 6f 20 70 6f 77 65 72 20 6f 66 66 20 74 68 65 20 73 79 73 74 65 6d 20 75 73 65 20 74 68 ..To.power.off.the.system.use.th
4480 65 20 60 60 70 6f 77 65 72 6f 66 66 60 60 20 65 6e 64 70 6f 69 6e 74 2e 00 54 72 6f 75 62 6c 65 e.``poweroff``.endpoint..Trouble
44a0 73 68 6f 6f 74 69 6e 67 00 55 6e 6c 69 6b 65 20 61 20 6e 6f 72 6d 61 6c 20 63 6f 6e 66 69 67 75 shooting.Unlike.a.normal.configu
44c0 72 61 74 69 6f 6e 20 73 65 73 73 69 6f 6e 2c 20 61 6c 6c 20 6f 70 65 72 61 74 69 6f 6e 61 6c 20 ration.session,.all.operational.
44e0 63 6f 6d 6d 61 6e 64 73 20 6d 75 73 74 20 62 65 20 70 72 65 70 65 6e 64 65 64 20 77 69 74 68 20 commands.must.be.prepended.with.
4500 60 60 72 75 6e 60 60 2c 20 65 76 65 6e 20 69 66 20 79 6f 75 20 68 61 76 65 6e 27 74 20 63 72 65 ``run``,.even.if.you.haven't.cre
4520 61 74 65 64 20 61 20 73 65 73 73 69 6f 6e 20 77 69 74 68 20 63 6f 6e 66 69 67 75 72 65 2e 00 55 ated.a.session.with.configure..U
4540 73 65 72 2d 64 61 74 61 00 55 73 65 72 2d 64 61 74 61 20 2d 20 55 73 65 72 2d 64 61 74 61 20 69 ser-data.User-data.-.User-data.i
4560 73 20 73 70 65 63 69 66 69 65 64 20 62 79 20 74 68 65 20 75 73 65 72 2e 20 54 68 69 73 20 63 6f s.specified.by.the.user..This.co
4580 6e 66 69 67 20 73 6f 75 72 63 65 20 6f 66 66 65 72 73 20 74 68 65 20 61 62 69 6c 69 74 79 20 74 nfig.source.offers.the.ability.t
45a0 6f 20 69 6e 73 65 72 74 20 61 6e 79 20 43 4c 49 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 o.insert.any.CLI.configuration.c
45c0 6f 6d 6d 61 6e 64 73 20 69 6e 74 6f 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 62 ommands.into.the.configuration.b
45e0 65 66 6f 72 65 20 74 68 65 20 66 69 72 73 74 20 62 6f 6f 74 2e 00 55 73 69 6e 67 20 41 50 49 20 efore.the.first.boot..Using.API.
4600 52 65 73 70 6f 6e 73 65 20 43 6c 61 73 73 00 55 73 69 6e 67 20 50 79 56 79 4f 53 00 56 4d 20 49 Response.Class.Using.PyVyOS.VM.I
4620 44 3a 20 69 6e 20 74 68 69 73 20 65 78 61 6d 70 6c 65 2c 20 56 4d 20 49 44 20 75 73 65 64 20 69 D:.in.this.example,.VM.ID.used.i
4640 73 20 35 35 35 2e 00 56 4d 20 52 65 73 6f 75 72 63 65 73 3a 20 74 68 65 73 65 20 70 61 72 61 6d s.555..VM.Resources:.these.param
4660 65 74 65 72 73 20 63 61 6e 20 62 65 20 6d 6f 64 69 66 69 65 64 20 61 73 20 6e 65 65 64 65 64 2e eters.can.be.modified.as.needed.
4680 00 56 4d 20 53 74 6f 72 61 67 65 3a 20 60 60 6c 6f 63 61 6c 60 60 20 76 6f 6c 75 6d 65 20 69 73 .VM.Storage:.``local``.volume.is
46a0 20 75 73 65 64 2e 00 56 79 4f 53 20 41 50 49 00 56 79 4f 53 20 41 75 74 6f 6d 61 74 69 6f 6e 00 .used..VyOS.API.VyOS.Automation.
46c0 56 79 4f 53 20 60 63 6c 6f 75 64 2d 69 6e 69 74 2d 64 6f 63 73 60 5f 2e 00 56 79 4f 53 20 63 6c VyOS.`cloud-init-docs`_..VyOS.cl
46e0 6f 75 64 2d 69 6e 69 74 00 56 79 4f 53 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d oud-init.VyOS.configuration.comm
4700 61 6e 64 73 20 61 72 65 20 64 65 66 69 6e 65 64 20 69 6e 20 75 73 65 72 2d 64 61 74 61 20 66 69 ands.are.defined.in.user-data.fi
4720 6c 65 2e 00 56 79 4f 53 20 68 61 73 20 74 68 65 20 61 62 69 6c 69 74 79 20 74 6f 20 72 75 6e 20 le..VyOS.has.the.ability.to.run.
4740 63 75 73 74 6f 6d 20 20 73 63 72 69 70 74 73 20 62 65 66 6f 72 65 20 61 6e 64 20 61 66 74 65 72 custom..scripts.before.and.after
4760 20 65 61 63 68 20 63 6f 6d 6d 69 74 00 56 79 4f 53 20 73 75 70 70 6f 72 74 20 74 68 72 65 65 20 .each.commit.VyOS.support.three.
4780 74 79 70 65 73 20 6f 66 20 63 6f 6e 66 69 67 20 73 6f 75 72 63 65 73 2e 00 56 79 4f 53 20 73 75 types.of.config.sources..VyOS.su
47a0 70 70 6f 72 74 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 76 69 61 20 61 6e 73 69 62 6c 65 pports.configuration.via.ansible
47c0 2e 20 4e 65 65 64 20 74 6f 20 69 6e 73 74 61 6c 6c 20 60 60 61 6e 73 69 62 6c 65 60 60 20 61 6e ..Need.to.install.``ansible``.an
47e0 64 20 60 60 70 79 74 68 6f 6e 33 2d 70 61 72 61 6d 69 6b 6f 60 60 20 6d 6f 64 75 6c 65 00 56 79 d.``python3-paramiko``.module.Vy
4800 4f 53 20 73 75 70 70 6f 72 74 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 76 69 61 20 6e 65 OS.supports.configuration.via.ne
4820 74 6d 69 6b 6f 5f 2e 20 49 74 20 72 65 71 75 69 72 65 73 20 74 6f 20 69 6e 73 74 61 6c 6c 20 60 tmiko_..It.requires.to.install.`
4840 60 70 79 74 68 6f 6e 33 2d 6e 65 74 6d 69 6b 6f 60 60 20 6d 6f 64 75 6c 65 2e 00 56 79 4f 53 20 `python3-netmiko``.module..VyOS.
4860 73 75 70 70 6f 72 74 73 20 65 78 65 63 75 74 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e supports.executing.configuration
4880 20 61 6e 64 20 6f 70 65 72 61 74 69 6f 6e 61 6c 20 63 6f 6d 6d 61 6e 64 73 20 6e 6f 6e 2d 69 6e .and.operational.commands.non-in
48a0 74 65 72 61 63 74 69 76 65 6c 79 20 66 72 6f 6d 20 73 68 65 6c 6c 20 73 63 72 69 70 74 73 2e 00 teractively.from.shell.scripts..
48c0 56 79 4f 53 20 73 75 70 70 6f 72 74 73 20 6f 70 2d 6d 6f 64 65 20 61 6e 64 20 63 6f 6e 66 69 67 VyOS.supports.op-mode.and.config
48e0 75 72 61 74 69 6f 6e 20 76 69 61 20 73 61 6c 74 5f 2e 00 56 79 4f 53 20 73 75 70 70 6f 72 74 73 uration.via.salt_..VyOS.supports
4900 20 73 6f 6d 65 20 6e 61 70 61 6c 6d 5f 20 66 75 6e 63 74 69 6f 6e 73 20 66 6f 72 20 63 6f 6e 66 .some.napalm_.functions.for.conf
4920 69 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 6f 70 2d 6d 6f 64 65 2e 20 49 74 20 72 65 71 75 69 72 iguration.and.op-mode..It.requir
4940 65 73 20 6d 6f 72 65 20 74 65 73 74 73 2e 00 56 79 4f 53 20 73 75 70 70 6f 72 74 73 20 74 68 65 es.more.tests..VyOS.supports.the
4960 20 65 78 65 63 75 74 69 6f 6e 20 6f 66 20 6f 70 65 72 61 74 69 6f 6e 61 6c 20 63 6f 6d 6d 61 6e .execution.of.operational.comman
4980 64 73 20 61 6e 64 20 6c 69 6e 75 78 20 63 6f 6d 6d 61 6e 64 73 20 61 74 20 69 6e 69 74 69 61 6c ds.and.linux.commands.at.initial
49a0 20 62 6f 6f 74 2e 20 54 68 69 73 20 69 73 20 61 63 63 6f 6d 70 6c 69 73 68 65 64 20 75 73 69 6e .boot..This.is.accomplished.usin
49c0 67 20 60 60 77 72 69 74 65 5f 66 69 6c 65 73 60 60 20 74 6f 20 63 65 72 74 61 69 6e 20 66 69 6c g.``write_files``.to.certain.fil
49e0 65 73 20 69 6e 20 74 68 65 20 2f 6f 70 74 2f 76 79 61 74 74 61 2f 65 74 63 2f 63 6f 6e 66 69 67 es.in.the./opt/vyatta/etc/config
4a00 2f 73 63 72 69 70 74 73 20 64 69 72 65 63 74 6f 72 79 2e 20 43 6f 6d 6d 61 6e 64 73 20 73 70 65 /scripts.directory..Commands.spe
4a20 63 69 66 69 65 64 20 69 6e 20 6f 70 74 2f 76 79 61 74 74 61 2f 65 74 63 2f 63 6f 6e 66 69 67 2f cified.in.opt/vyatta/etc/config/
4a40 73 63 72 69 70 74 73 2f 76 79 6f 73 2d 70 72 65 63 6f 6e 66 69 67 2d 62 6f 6f 74 75 70 2e 73 63 scripts/vyos-preconfig-bootup.sc
4a60 72 69 70 74 20 61 72 65 20 65 78 65 63 75 74 65 64 20 70 72 69 6f 72 20 74 6f 20 63 6f 6e 66 69 ript.are.executed.prior.to.confi
4a80 67 75 72 61 74 69 6f 6e 2e 20 54 68 65 20 2f 6f 70 74 2f 76 79 61 74 74 61 2f 65 74 63 2f 63 6f guration..The./opt/vyatta/etc/co
4aa0 6e 66 69 67 2f 73 63 72 69 70 74 73 2f 76 79 6f 73 2d 70 6f 73 74 63 6f 6e 66 69 67 2d 62 6f 6f nfig/scripts/vyos-postconfig-boo
4ac0 74 75 70 2e 73 63 72 69 70 74 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 73 20 63 6f 6d 6d 61 6e 64 tup.script.file.contains.command
4ae0 73 20 74 6f 20 62 65 20 65 78 65 63 75 74 65 64 20 61 66 74 65 72 20 63 6f 6e 66 69 67 75 72 61 s.to.be.executed.after.configura
4b00 74 69 6f 6e 2e 20 49 6e 20 62 6f 74 68 20 63 61 73 65 73 2c 20 63 6f 6d 6d 61 6e 64 73 20 61 72 tion..In.both.cases,.commands.ar
4b20 65 20 65 78 65 63 75 74 65 64 20 61 73 20 74 68 65 20 72 6f 6f 74 20 75 73 65 72 2e 00 57 65 20 e.executed.as.the.root.user..We.
4b40 6e 65 65 64 20 32 20 66 69 6c 65 73 2c 20 63 6f 6d 6d 61 6e 64 73 2e 63 6f 6e 66 20 61 6e 64 20 need.2.files,.commands.conf.and.
4b60 73 63 72 69 70 74 20 69 74 73 65 6c 66 2e 00 57 68 69 6c 65 20 6f 74 68 65 72 20 6d 65 74 68 6f script.itself..While.other.metho
4b80 64 73 20 65 78 69 73 74 2c 20 74 68 65 20 6d 6f 73 74 20 73 74 72 61 69 67 68 74 66 6f 72 77 61 ds.exist,.the.most.straightforwa
4ba0 72 64 20 6d 65 74 68 6f 64 20 66 6f 72 20 75 73 69 6e 67 20 74 68 65 20 4e 6f 43 6c 6f 75 64 20 rd.method.for.using.the.NoCloud.
4bc0 64 61 74 61 20 73 6f 75 72 63 65 20 69 73 20 63 72 65 61 74 69 6e 67 20 61 20 73 65 65 64 20 49 data.source.is.creating.a.seed.I
4be0 53 4f 20 61 6e 64 20 61 74 74 61 63 68 69 6e 67 20 69 74 20 74 6f 20 74 68 65 20 76 69 72 74 75 SO.and.attaching.it.to.the.virtu
4c00 61 6c 20 6d 61 63 68 69 6e 65 20 61 73 20 61 20 43 44 20 64 72 69 76 65 2e 20 54 68 65 20 76 6f al.machine.as.a.CD.drive..The.vo
4c20 6c 75 6d 65 20 6d 75 73 74 20 62 65 20 66 6f 72 6d 61 74 74 65 64 20 61 73 20 61 20 76 66 61 74 lume.must.be.formatted.as.a.vfat
4c40 20 6f 72 20 49 53 4f 20 39 36 36 30 20 66 69 6c 65 20 73 79 73 74 65 6d 20 77 69 74 68 20 74 68 .or.ISO.9660.file.system.with.th
4c60 65 20 6c 61 62 65 6c 20 22 63 69 64 61 74 61 22 20 6f 72 20 22 43 49 44 41 54 41 22 2e 00 57 69 e.label."cidata".or."CIDATA"..Wi
4c80 6c 6c 20 72 65 74 75 72 6e 3a 00 57 69 74 68 20 74 68 65 20 60 60 72 65 74 72 69 65 76 65 60 60 ll.return:.With.the.``retrieve``
4ca0 20 65 6e 64 70 6f 69 6e 74 20 79 6f 75 20 67 65 74 20 70 61 72 74 73 20 6f 72 20 74 68 65 20 77 .endpoint.you.get.parts.or.the.w
4cc0 68 6f 6c 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 00 57 69 74 68 6f 75 74 20 70 72 6f 78 hole.configuration..Without.prox
4ce0 79 20 69 74 20 72 65 71 75 69 72 65 73 20 56 79 4f 53 20 6d 69 6e 69 6f 6e 20 63 6f 6e 66 69 67 y.it.requires.VyOS.minion.config
4d00 75 72 61 74 69 6f 6e 20 61 6e 64 20 73 75 70 70 6f 72 74 20 6f 70 2d 6d 6f 64 65 20 64 61 74 61 uration.and.support.op-mode.data
4d20 3a 00 57 69 74 68 6f 75 74 20 70 72 6f 78 79 20 69 74 20 72 65 71 75 69 72 65 73 20 56 79 4f 53 :.Without.proxy.it.requires.VyOS
4d40 20 6d 69 6e 69 6f 6e 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 73 75 70 70 6f 72 .minion.configuration.and.suppor
4d60 74 73 20 6f 70 2d 6d 6f 64 65 20 64 61 74 61 3a 00 59 6f 75 20 63 61 6e 20 69 6e 73 74 61 6c 6c ts.op-mode.data:.You.can.install
4d80 20 50 79 56 79 4f 53 20 75 73 69 6e 67 20 70 69 70 3a 00 59 6f 75 20 63 61 6e 20 70 61 73 73 20 .PyVyOS.using.pip:.You.can.pass.
4da0 61 20 60 60 73 65 74 60 60 2c 20 60 60 64 65 6c 65 74 65 60 60 20 6f 72 20 60 60 63 6f 6d 6d 65 a.``set``,.``delete``.or.``comme
4dc0 6e 74 60 60 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 74 68 65 20 60 60 2f 63 6f 6e 66 69 67 75 72 65 nt``.command.to.the.``/configure
4de0 60 60 20 65 6e 64 70 6f 69 6e 74 2e 00 60 60 64 65 6c 65 74 65 60 60 20 61 20 73 69 6e 67 6c 65 ``.endpoint..``delete``.a.single
4e00 20 63 6f 6d 6d 61 6e 64 00 60 60 73 65 65 64 2e 69 73 6f 60 60 20 77 61 73 20 70 72 65 76 69 6f .command.``seed.iso``.was.previo
4e20 75 73 6c 79 20 63 72 65 61 74 65 64 20 69 6e 20 64 69 72 65 63 74 6f 72 79 20 60 60 2f 74 6d 70 usly.created.in.directory.``/tmp
4e40 2f 60 60 2e 20 49 74 27 73 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 6d 6f 76 65 20 69 74 20 74 /``..It's.necessary.to.move.it.t
4e60 6f 20 60 60 2f 76 61 72 2f 6c 69 62 2f 76 7a 2f 74 65 6d 70 6c 61 74 65 2f 69 73 6f 60 60 00 60 o.``/var/lib/vz/template/iso``.`
4e80 60 73 65 74 60 60 20 61 20 73 69 6e 67 6c 65 20 63 6f 6d 6d 61 6e 64 00 60 60 76 79 6f 73 5f 75 `set``.a.single.command.``vyos_u
4ea0 73 65 72 64 61 74 61 60 60 20 2d 20 74 68 65 20 6d 6f 64 75 6c 65 20 61 63 63 65 70 74 73 20 61 serdata``.-.the.module.accepts.a
4ec0 20 6c 69 73 74 20 6f 66 20 43 4c 49 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 .list.of.CLI.configuration.comma
4ee0 6e 64 73 20 69 6e 20 61 20 60 60 76 79 6f 73 5f 63 6f 6e 66 69 67 5f 63 6f 6d 6d 61 6e 64 73 60 nds.in.a.``vyos_config_commands`
4f00 60 20 73 65 63 74 69 6f 6e 2c 20 77 68 69 63 68 20 67 69 76 65 73 20 61 6e 20 65 61 73 79 20 77 `.section,.which.gives.an.easy.w
4f20 61 79 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 74 68 65 20 73 79 73 74 65 6d 20 64 75 72 69 6e ay.to.configure.the.system.durin
4f40 67 20 64 65 70 6c 6f 79 6d 65 6e 74 2e 00 60 60 76 79 6f 73 60 60 2f 60 60 76 79 6f 73 60 60 20 g.deployment..``vyos``/``vyos``.
4f60 63 72 65 64 65 6e 74 69 61 6c 73 20 69 66 20 6e 6f 20 6f 74 68 65 72 73 20 73 70 65 63 69 66 69 credentials.if.no.others.specifi
4f80 65 64 20 62 79 20 64 61 74 61 20 73 6f 75 72 63 65 2e 00 60 60 77 72 69 74 65 5f 66 69 6c 65 73 ed.by.data.source..``write_files
4fa0 60 60 20 2d 20 74 68 69 73 20 6d 6f 64 75 6c 65 20 61 6c 6c 6f 77 73 20 74 6f 20 69 6e 73 65 72 ``.-.this.module.allows.to.inser
4fc0 74 20 61 6e 79 20 66 69 6c 65 73 20 69 6e 74 6f 20 74 68 65 20 66 69 6c 65 73 79 73 74 65 6d 20 t.any.files.into.the.filesystem.
4fe0 62 65 66 6f 72 65 20 74 68 65 20 66 69 72 73 74 20 62 6f 6f 74 2c 20 66 6f 72 20 65 78 61 6d 70 before.the.first.boot,.for.examp
5000 6c 65 2c 20 70 72 65 2d 67 65 6e 65 72 61 74 65 64 20 65 6e 63 72 79 70 74 69 6f 6e 20 6b 65 79 le,.pre-generated.encryption.key
5020 73 2c 20 63 65 72 74 69 66 69 63 61 74 65 73 2c 20 6f 72 20 65 76 65 6e 20 61 20 77 68 6f 6c 65 s,.certificates,.or.even.a.whole
5040 20 60 60 63 6f 6e 66 69 67 2e 62 6f 6f 74 60 60 20 66 69 6c 65 2e 20 54 68 65 20 66 6f 72 6d 61 .``config.boot``.file..The.forma
5060 74 20 69 73 20 64 65 73 63 72 69 62 65 64 20 69 6e 20 74 68 65 20 63 6c 6f 75 64 69 6e 69 74 20 t.is.described.in.the.cloudinit.
5080 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 60 43 6c 6f 75 64 2d 69 6e 69 74 2d 77 72 69 74 65 5f documentation.`Cloud-init-write_
50a0 66 69 6c 65 73 60 5f 2e 00 61 64 64 20 61 6e 20 69 6d 61 67 65 00 61 6e 73 69 62 6c 65 2e 63 66 files`_..add.an.image.ansible.cf
50c0 67 00 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 20 66 69 6c 65 20 66 6f 72 6d 61 74 00 63 6c 6f 75 64 g.cloud-config.file.format.cloud
50e0 2d 69 6e 69 74 20 6c 6f 67 73 20 74 6f 20 2f 76 61 72 2f 6c 6f 67 2f 63 6c 6f 75 64 2d 69 6e 69 -init.logs.to./var/log/cloud-ini
5100 74 2e 6c 6f 67 2e 20 54 68 69 73 20 66 69 6c 65 20 63 61 6e 20 62 65 20 68 65 6c 70 66 75 6c 20 t.log..This.file.can.be.helpful.
5120 69 6e 20 64 65 74 65 72 6d 69 6e 69 6e 67 20 77 68 79 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 in.determining.why.the.configura
5140 74 69 6f 6e 20 76 61 72 69 65 73 20 66 72 6f 6d 20 77 68 61 74 20 79 6f 75 20 65 78 70 65 63 74 tion.varies.from.what.you.expect
5160 2e 20 59 6f 75 20 63 61 6e 20 66 65 74 63 68 20 74 68 65 20 6d 6f 73 74 20 69 6d 70 6f 72 74 61 ..You.can.fetch.the.most.importa
5180 6e 74 20 64 61 74 61 20 66 69 6c 74 65 72 69 6e 67 20 6f 75 74 70 75 74 20 66 6f 72 20 60 60 76 nt.data.filtering.output.for.``v
51a0 79 6f 73 60 60 20 6b 65 79 77 6f 72 64 3a 00 63 6f 6d 6d 61 6e 64 73 2e 74 78 74 00 64 65 6c 65 yos``.keyword:.commands.txt.dele
51c0 74 65 20 61 6e 20 69 6d 61 67 65 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 20 60 60 31 2e 33 2d 72 te.an.image,.for.example.``1.3-r
51e0 6f 6c 6c 69 6e 67 2d 32 30 32 30 30 36 30 37 30 31 31 37 60 60 00 68 6f 73 74 73 00 69 64 5f 72 olling-202006070117``.hosts.id_r
5200 73 61 5f 64 6f 63 6b 65 72 2e 70 75 62 2e 20 4e 65 65 64 73 20 74 6f 20 64 65 63 6c 61 72 65 20 sa_docker.pub..Needs.to.declare.
5220 6f 6e 6c 79 20 70 75 62 6c 69 63 20 6b 65 79 20 65 78 61 63 74 6c 79 2e 00 69 66 20 79 6f 75 20 only.public.key.exactly..if.you.
5240 6a 75 73 74 20 77 61 6e 74 20 74 68 65 20 56 61 6c 75 65 20 6f 66 20 61 20 6d 75 6c 74 69 2d 76 just.want.the.Value.of.a.multi-v
5260 61 6c 75 65 64 20 6e 6f 64 65 2c 20 75 73 65 20 74 68 65 20 60 60 72 65 74 75 72 6e 56 61 6c 75 alued.node,.use.the.``returnValu
5280 65 73 60 60 20 6f 70 65 72 61 74 69 6f 6e 2e 00 6d 61 69 6e 2e 79 6d 6c 00 72 31 31 2d 70 72 6f es``.operation..main.yml.r11-pro
52a0 78 79 2e 73 6c 73 20 49 6e 63 6c 75 64 65 73 20 70 61 72 61 6d 65 74 65 72 73 20 66 6f 72 20 63 xy.sls.Includes.parameters.for.c
52c0 6f 6e 6e 65 63 74 69 6e 67 20 74 6f 20 73 61 6c 74 2d 70 72 6f 78 79 20 6d 69 6e 69 6f 6e 00 73 onnecting.to.salt-proxy.minion.s
52e0 74 61 72 74 75 70 20 73 63 72 69 70 74 73 00 74 6f 70 2e 73 6c 73 00 4d 49 4d 45 2d 56 65 72 73 tartup.scripts.top.sls.MIME-Vers
5300 69 6f 6e 3a 20 31 2e 30 0a 43 6f 6e 74 65 6e 74 2d 54 79 70 65 3a 20 74 65 78 74 2f 70 6c 61 69 ion:.1.0.Content-Type:.text/plai
5320 6e 3b 20 63 68 61 72 73 65 74 3d 55 54 46 2d 38 0a 43 6f 6e 74 65 6e 74 2d 54 72 61 6e 73 66 65 n;.charset=UTF-8.Content-Transfe
5340 72 2d 45 6e 63 6f 64 69 6e 67 3a 20 38 62 69 74 0a 58 2d 47 65 6e 65 72 61 74 6f 72 3a 20 4c 6f r-Encoding:.8bit.X-Generator:.Lo
5360 63 61 6c 61 7a 79 20 28 68 74 74 70 73 3a 2f 2f 6c 6f 63 61 6c 61 7a 79 2e 63 6f 6d 29 0a 50 72 calazy.(https://localazy.com).Pr
5380 6f 6a 65 63 74 2d 49 64 2d 56 65 72 73 69 6f 6e 3a 20 0a 4c 61 6e 67 75 61 67 65 3a 20 70 74 0a oject-Id-Version:..Language:.pt.
53a0 50 6c 75 72 61 6c 2d 46 6f 72 6d 73 3a 20 6e 70 6c 75 72 61 6c 73 3d 32 3b 20 70 6c 75 72 61 6c Plural-Forms:.nplurals=2;.plural
53c0 3d 28 6e 3e 3d 30 20 26 26 20 6e 3c 3d 31 29 20 3f 20 30 20 3a 20 31 3b 0a 00 2a 2a 4e 4f 54 45 =(n>=0.&&.n<=1).?.0.:.1;..**NOTE
53e0 2a 2a 3a 20 62 65 20 63 61 72 65 66 75 6c 6c 20 77 68 69 6c 65 20 63 6f 70 79 69 6e 67 20 61 6e **:.be.carefull.while.copying.an
5400 64 20 70 61 73 74 69 6e 67 20 70 72 65 76 69 6f 75 73 20 63 6f 6d 6d 61 6e 64 73 2e 20 44 6f 62 d.pasting.previous.commands..Dob
5420 6c 65 20 71 75 6f 74 65 73 20 6d 61 79 20 6e 65 65 64 20 74 6f 20 62 65 20 63 6f 72 72 65 63 74 le.quotes.may.need.to.be.correct
5440 65 64 2e 00 2a 2a 6d 65 74 61 2d 64 61 74 61 2a 2a 3a 20 65 6d 70 74 79 20 66 69 6c 65 20 28 72 ed..**meta-data**:.empty.file.(r
5460 65 71 75 69 72 65 64 29 2e 00 2a 2a 6e 65 74 77 6f 72 6b 2d 63 6f 6e 66 69 67 2a 2a 20 66 69 6c equired)..**network-config**.fil
5480 65 20 6f 6e 6c 79 20 68 61 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 74 68 61 74 20 64 69 e.only.has.configuration.that.di
54a0 73 61 62 6c 65 73 20 74 68 65 20 61 75 74 6f 6d 61 74 69 63 20 64 68 63 70 20 63 6c 69 65 6e 74 sables.the.automatic.dhcp.client
54c0 20 6f 6e 20 66 69 72 73 74 20 69 6e 74 65 72 66 61 63 65 2e 00 2a 2a 6e 65 74 77 6f 72 6b 2d 63 .on.first.interface..**network-c
54e0 6f 6e 66 69 67 2a 2a 3a 20 66 69 6c 65 20 74 68 61 74 20 77 69 6c 6c 20 69 6e 64 69 63 61 74 65 onfig**:.file.that.will.indicate
5500 20 74 6f 20 61 76 6f 69 64 20 64 68 63 70 20 63 6c 69 65 6e 74 20 6f 6e 20 66 69 72 73 74 20 69 .to.avoid.dhcp.client.on.first.i
5520 6e 74 65 72 66 61 63 65 2e 00 2a 2a 75 73 65 72 2d 64 61 74 61 2a 2a 20 66 69 6c 65 20 6d 75 73 nterface..**user-data**.file.mus
5540 74 20 73 74 61 72 74 20 77 69 74 68 20 60 60 23 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 60 60 20 61 t.start.with.``#cloud-config``.a
5560 6e 64 20 63 6f 6e 74 61 69 6e 73 20 76 79 6f 73 2d 63 6f 6d 6d 61 6e 64 73 2e 20 46 6f 72 20 65 nd.contains.vyos-commands..For.e
5580 78 61 6d 70 6c 65 3a 00 2a 2a 75 73 65 72 2d 64 61 74 61 2a 2a 3a 20 69 6e 63 6c 75 64 65 73 20 xample:.**user-data**:.includes.
55a0 76 79 6f 73 2d 63 6f 6d 6d 61 6e 64 73 2e 00 2f 63 6f 6e 66 69 67 2d 66 69 6c 65 00 2f 63 6f 6e vyos-commands../config-file./con
55c0 66 69 67 75 72 65 00 2f 67 65 6e 65 72 61 74 65 00 2f 69 6d 61 67 65 00 2f 70 6f 77 65 72 6f 66 figure./generate./image./powerof
55e0 66 00 2f 72 65 62 6f 6f 74 00 2f 72 65 73 65 74 00 2f 72 65 74 72 69 65 76 65 00 2f 73 68 6f 77 f./reboot./reset./retrieve./show
5600 00 41 20 56 79 4f 53 20 71 63 6f 77 20 69 6d 61 67 65 20 77 69 74 68 20 63 6c 6f 75 64 2d 69 6e .A.VyOS.qcow.image.with.cloud-in
5620 69 74 20 6f 70 74 69 6f 6e 73 20 69 73 20 6e 65 65 64 65 64 2e 20 54 68 69 73 20 63 61 6e 20 62 it.options.is.needed..This.can.b
5640 65 20 6f 62 74 61 69 6e 65 64 20 75 73 69 6e 67 20 60 76 79 6f 73 2d 76 6d 2d 69 6d 61 67 65 73 e.obtained.using.`vyos-vm-images
5660 60 5f 20 72 65 70 6f 2e 20 41 66 74 65 72 20 63 6c 6f 6e 6e 69 6e 67 20 74 68 65 20 72 65 70 6f `_.repo..After.clonning.the.repo
5680 2c 20 65 64 69 74 20 74 68 65 20 66 69 6c 65 20 2a 2a 71 65 6d 75 2e 79 6d 6c 2a 2a 20 61 6e 64 ,.edit.the.file.**qemu.yml**.and
56a0 20 63 6f 6d 6d 65 6e 74 20 74 68 65 20 2a 2a 64 6f 77 6e 6c 6f 61 64 2d 69 73 6f 2a 2a 20 72 6f .comment.the.**download-iso**.ro
56c0 6c 65 2e 00 41 20 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 20 64 6f 63 75 6d 65 6e 74 20 69 73 20 77 le..A.cloud-config.document.is.w
56e0 72 69 74 74 65 6e 20 69 6e 20 59 41 4d 4c 2e 20 54 68 65 20 66 69 6c 65 20 6d 75 73 74 20 62 65 ritten.in.YAML..The.file.must.be
5700 67 69 6e 20 77 69 74 68 20 60 60 23 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 60 60 20 6c 69 6e 65 2e gin.with.``#cloud-config``.line.
5720 20 54 68 65 20 6f 6e 6c 79 20 73 75 70 70 6f 72 74 65 64 20 74 6f 70 2d 6c 65 76 65 6c 20 6b 65 .The.only.supported.top-level.ke
5740 79 73 20 61 72 65 20 60 60 76 79 6f 73 5f 63 6f 6e 66 69 67 5f 63 6f 6d 6d 61 6e 64 73 60 60 20 ys.are.``vyos_config_commands``.
5760 61 6e 64 20 60 60 77 72 69 74 65 5f 66 69 6c 65 73 60 60 2e 20 54 68 65 20 75 73 65 20 6f 66 20 and.``write_files``..The.use.of.
5780 74 68 65 73 65 20 6b 65 79 73 20 69 73 20 64 65 73 63 72 69 62 65 64 20 69 6e 20 74 68 65 20 66 these.keys.is.described.in.the.f
57a0 6f 6c 6c 6f 77 69 6e 67 20 74 77 6f 20 73 65 63 74 69 6f 6e 73 2e 00 41 20 73 69 6d 70 6c 65 20 ollowing.two.sections..A.simple.
57c0 65 78 61 6d 70 6c 65 20 69 73 20 73 68 6f 77 6e 20 62 65 6c 6f 77 2c 20 77 68 65 72 65 20 74 68 example.is.shown.below,.where.th
57e0 65 20 6f 70 73 20 63 6f 6d 6d 61 6e 64 20 65 78 65 63 75 74 65 64 20 69 6e 20 74 68 65 20 70 6f e.ops.command.executed.in.the.po
5800 73 74 2d 68 6f 6f 6b 20 73 63 72 69 70 74 20 69 73 20 22 73 68 6f 77 20 69 6e 74 65 72 66 61 63 st-hook.script.is."show.interfac
5820 65 73 22 2e 00 41 20 73 69 6e 67 6c 65 2d 71 75 6f 74 65 20 73 79 6d 62 6f 6c 20 69 73 20 6e 6f es"..A.single-quote.symbol.is.no
5840 74 20 61 6c 6c 6f 77 65 64 20 69 6e 73 69 64 65 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 76 61 6c 75 t.allowed.inside.command.or.valu
5860 65 2e 00 41 50 49 20 45 6e 64 70 6f 69 6e 74 73 00 41 63 63 65 70 74 20 6d 69 6e 69 6f 6e 20 6b e..API.Endpoints.Accept.minion.k
5880 65 79 00 41 6c 6c 20 65 6e 64 70 6f 69 6e 74 73 20 6f 6e 6c 79 20 6c 69 73 74 65 6e 20 6f 6e 20 ey.All.endpoints.only.listen.on.
58a0 48 54 54 50 20 50 4f 53 54 20 72 65 71 75 65 73 74 73 20 61 6e 64 20 74 68 65 20 41 50 49 20 4b HTTP.POST.requests.and.the.API.K
58c0 45 59 20 6d 75 73 74 20 73 65 74 20 61 73 20 60 60 6b 65 79 60 60 20 69 6e 20 74 68 65 20 66 6f EY.must.set.as.``key``.in.the.fo
58e0 72 6d 64 61 74 61 2e 00 41 6c 6c 20 6f 66 20 74 68 65 73 65 20 63 61 6e 20 62 65 20 6f 76 65 72 rmdata..All.of.these.can.be.over
5900 72 69 64 64 65 6e 20 75 73 69 6e 67 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 ridden.using.the.configuration.i
5920 6e 20 75 73 65 72 2d 64 61 74 61 2e 00 41 6c 73 6f 2c 20 74 68 69 73 20 6c 61 62 20 63 6f 6e 73 n.user-data..Also,.this.lab.cons
5940 69 64 65 72 73 3a 00 41 6e 73 69 62 6c 65 00 41 6e 79 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e 73 iders:.Ansible.Any.modifications
5960 20 77 65 72 65 20 64 6f 6e 65 20 74 6f 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20 75 6e 66 69 78 65 .were.done.to.work.around.unfixe
5980 64 20 62 75 67 73 20 61 6e 64 20 69 6d 70 6c 65 6d 65 6e 74 20 65 6e 68 61 6e 63 65 6d 65 6e 74 d.bugs.and.implement.enhancement
59a0 73 20 74 68 61 74 20 61 72 65 20 6e 6f 74 20 63 6f 6d 70 6c 65 74 65 20 69 6e 20 74 68 65 20 56 s.that.are.not.complete.in.the.V
59c0 79 4f 53 20 73 79 73 74 65 6d 20 63 61 6e 20 62 65 20 70 6c 61 63 65 64 20 68 65 72 65 2e 00 41 yOS.system.can.be.placed.here..A
59e0 74 20 74 68 69 73 20 73 74 65 70 20 77 65 20 63 61 6e 20 67 65 74 20 73 6f 6d 65 20 6f 70 2d 6d t.this.step.we.can.get.some.op-m
5a00 6f 64 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 56 79 4f 53 20 6e 6f 64 65 73 3a ode.information.from.VyOS.nodes:
5a20 00 41 75 74 68 65 6e 74 69 63 61 74 69 6f 6e 00 42 65 66 6f 72 65 20 73 74 61 72 74 69 6e 67 2c .Authentication.Before.starting,
5a40 20 70 6c 65 61 73 65 20 72 65 66 65 72 20 74 6f 20 63 6c 6f 75 64 2d 69 6e 69 74 20 60 6e 65 74 .please.refer.to.cloud-init.`net
5a60 77 6f 72 6b 2d 63 6f 6e 66 69 67 2d 64 6f 63 73 60 5f 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 6b work-config-docs`_.in.order.to.k
5a80 6e 6f 77 20 68 6f 77 20 74 6f 20 69 6d 70 6f 72 74 20 75 73 65 72 20 61 6e 64 20 6e 65 74 77 6f now.how.to.import.user.and.netwo
5aa0 72 6b 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 73 2e 00 42 65 6c 6f 77 20 73 65 65 20 6f 6e 65 rk.configurations..Below.see.one
5ac0 20 65 78 61 6d 70 6c 65 20 66 6f 72 20 63 75 72 6c 20 61 6e 64 20 6f 6e 65 20 66 6f 72 20 70 79 .example.for.curl.and.one.for.py
5ae0 74 68 6f 6e 2e 20 54 68 65 20 72 65 73 74 20 6f 66 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 thon..The.rest.of.the.documentat
5b00 69 6f 6e 20 69 73 20 72 65 64 75 63 65 64 20 74 6f 20 63 75 72 6c 2e 00 43 68 65 63 6b 20 73 61 ion.is.reduced.to.curl..Check.sa
5b20 6c 74 2d 6b 65 79 73 20 6f 6e 20 74 68 65 20 73 61 6c 74 20 6d 61 73 74 65 72 00 43 68 65 63 6b lt-keys.on.the.salt.master.Check
5b40 20 74 68 61 74 20 70 72 6f 78 79 20 6d 69 6e 69 6f 6e 20 69 73 20 61 6c 69 76 65 3a 00 43 68 65 .that.proxy.minion.is.alive:.Che
5b60 63 6b 20 74 68 61 74 20 73 61 6c 74 20 6d 61 73 74 65 72 20 63 61 6e 20 63 6f 6d 6d 75 6e 69 63 ck.that.salt.master.can.communic
5b80 61 74 65 20 77 69 74 68 20 6d 69 6e 69 6f 6e 73 00 43 6c 6f 75 64 20 61 6e 64 20 76 69 72 74 75 ate.with.minions.Cloud.and.virtu
5ba0 61 6c 69 7a 65 64 20 69 6e 73 74 61 6e 63 65 73 20 6f 66 20 56 79 4f 53 20 61 72 65 20 69 6e 69 alized.instances.of.VyOS.are.ini
5bc0 74 69 61 6c 69 7a 65 64 20 75 73 69 6e 67 20 74 68 65 20 69 6e 64 75 73 74 72 79 2d 73 74 61 6e tialized.using.the.industry-stan
5be0 64 61 72 64 20 63 6c 6f 75 64 2d 69 6e 69 74 2e 20 56 69 61 20 63 6c 6f 75 64 2d 69 6e 69 74 2c dard.cloud-init..Via.cloud-init,
5c00 20 74 68 65 20 73 79 73 74 65 6d 20 70 65 72 66 6f 72 6d 73 20 74 61 73 6b 73 20 73 75 63 68 20 .the.system.performs.tasks.such.
5c20 61 73 20 69 6e 6a 65 63 74 69 6e 67 20 53 53 48 20 6b 65 79 73 20 61 6e 64 20 63 6f 6e 66 69 67 as.injecting.SSH.keys.and.config
5c40 75 72 69 6e 67 20 74 68 65 20 6e 65 74 77 6f 72 6b 2e 20 49 6e 20 61 64 64 69 74 69 6f 6e 2c 20 uring.the.network..In.addition,.
5c60 74 68 65 20 75 73 65 72 20 63 61 6e 20 73 75 70 70 6c 79 20 61 20 63 75 73 74 6f 6d 20 63 6f 6e the.user.can.supply.a.custom.con
5c80 66 69 67 75 72 61 74 69 6f 6e 20 61 74 20 74 68 65 20 74 69 6d 65 20 6f 66 20 69 6e 73 74 61 6e figuration.at.the.time.of.instan
5ca0 63 65 20 6c 61 75 6e 63 68 2e 00 43 6c 6f 75 64 2d 63 6f 6e 66 69 67 20 6d 6f 64 75 6c 65 73 00 ce.launch..Cloud-config.modules.
5cc0 43 6c 6f 75 64 2d 69 6e 69 74 20 60 6e 65 74 77 6f 72 6b 2d 63 6f 6e 66 69 67 2d 64 6f 63 73 60 Cloud-init.`network-config-docs`
5ce0 5f 2e 00 43 6c 6f 75 64 2d 69 6e 69 74 20 6f 6e 20 50 72 6f 78 6d 6f 78 00 43 6f 6d 6d 61 6e 64 _..Cloud-init.on.Proxmox.Command
5d00 20 45 78 65 63 75 74 69 6f 6e 20 61 74 20 49 6e 69 74 69 61 6c 20 42 6f 6f 74 00 43 6f 6d 6d 61 .Execution.at.Initial.Boot.Comma
5d20 6e 64 20 53 63 72 69 70 74 69 6e 67 00 43 6f 6d 6d 61 6e 64 20 66 6f 72 20 67 65 6e 65 72 61 74 nd.Scripting.Command.for.generat
5d40 69 6e 67 20 60 60 73 65 65 64 2e 69 73 6f 60 60 00 43 6f 6d 6d 61 6e 64 73 20 72 65 71 75 69 72 ing.``seed.iso``.Commands.requir
5d60 65 6d 65 6e 74 73 3a 00 43 6f 6e 66 69 67 20 53 6f 75 72 63 65 73 00 43 6f 6e 66 69 67 75 72 61 ements:.Config.Sources.Configura
5d80 74 69 6f 6e 00 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 tion.Configuration.commands.are.
5da0 65 78 65 63 75 74 65 64 20 6a 75 73 74 20 6c 69 6b 65 20 66 72 6f 6d 20 61 20 6e 6f 72 6d 61 6c executed.just.like.from.a.normal
5dc0 20 63 6f 6e 66 69 67 20 73 65 73 73 69 6f 6e 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 66 .config.session..For.example,.if
5de0 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 64 69 73 61 62 6c 65 20 61 20 42 47 50 20 70 65 65 72 20 .you.want.to.disable.a.BGP.peer.
5e00 6f 6e 20 56 52 52 50 20 74 72 61 6e 73 69 74 69 6f 6e 20 74 6f 20 62 61 63 6b 75 70 3a 00 43 6f on.VRRP.transition.to.backup:.Co
5e20 6e 66 69 67 75 72 65 2c 20 74 68 65 6e 20 44 65 6c 65 74 65 20 4f 62 6a 65 63 74 00 43 6f 6e 66 nfigure,.then.Delete.Object.Conf
5e40 69 67 75 72 65 2c 20 74 68 65 6e 20 4c 6f 61 64 20 46 69 6c 65 00 43 6f 6e 66 69 67 75 72 65 2c igure,.then.Load.File.Configure,
5e60 20 74 68 65 6e 20 53 61 76 65 00 43 6f 6e 66 69 67 75 72 65 2c 20 74 68 65 6e 20 53 61 76 65 20 .then.Save.Configure,.then.Save.
5e80 46 69 6c 65 00 43 6f 6e 66 69 67 75 72 65 2c 20 74 68 65 6e 20 53 65 74 00 43 6f 6e 66 69 67 75 File.Configure,.then.Set.Configu
5ea0 72 65 2c 20 74 68 65 6e 20 53 68 6f 77 20 4f 62 6a 65 63 74 00 43 6f 6e 66 69 67 75 72 65 2c 20 re,.then.Show.Object.Configure,.
5ec0 74 68 65 6e 20 53 68 6f 77 20 61 20 53 69 6e 67 6c 65 20 4f 62 6a 65 63 74 20 56 61 6c 75 65 00 then.Show.a.Single.Object.Value.
5ee0 43 6f 6e 74 65 6e 74 20 6f 66 20 63 6f 6d 6d 61 6e 64 73 2e 63 6f 6e 66 00 43 6f 6e 74 65 6e 74 Content.of.commands.conf.Content
5f00 20 6f 66 20 6e 65 74 77 6f 72 6b 2d 63 6f 6e 66 69 67 20 66 69 6c 65 3a 00 43 72 65 61 74 65 20 .of.network-config.file:.Create.
5f20 73 65 65 64 2e 69 73 6f 00 43 72 65 61 74 65 20 74 65 78 74 20 66 69 6c 65 73 20 6e 61 6d 65 64 seed.iso.Create.text.files.named
5f40 20 75 73 65 72 2d 64 61 74 61 20 61 6e 64 20 6d 65 74 61 2d 64 61 74 61 2e 20 4f 6e 20 6c 69 6e .user-data.and.meta-data..On.lin
5f60 75 78 2d 62 61 73 65 64 20 73 79 73 74 65 6d 73 2c 20 74 68 65 20 6d 6b 69 73 6f 66 73 20 75 74 ux-based.systems,.the.mkisofs.ut
5f80 69 6c 69 74 79 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 74 68 65 20 ility.can.be.used.to.create.the.
5fa0 73 65 65 64 20 49 53 4f 2e 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 79 6e 74 61 78 20 77 seed.ISO..The.following.syntax.w
5fc0 69 6c 6c 20 61 64 64 20 74 68 65 73 65 20 66 69 6c 65 73 20 74 6f 20 74 68 65 20 49 53 4f 20 39 ill.add.these.files.to.the.ISO.9
5fe0 36 36 30 20 66 69 6c 65 20 73 79 73 74 65 6d 2e 00 43 72 65 61 74 69 6e 67 20 74 68 65 20 56 4d 660.file.system..Creating.the.VM
6000 00 43 75 73 74 6f 6d 20 73 63 72 69 70 74 73 20 61 72 65 20 6e 6f 74 20 65 78 65 63 75 74 65 64 .Custom.scripts.are.not.executed
6020 20 77 69 74 68 20 72 6f 6f 74 20 70 72 69 76 69 6c 65 67 65 73 20 28 55 73 65 20 73 75 64 6f 20 .with.root.privileges.(Use.sudo.
6040 69 6e 73 69 64 65 20 69 66 20 74 68 69 73 20 69 73 20 6e 65 63 65 73 73 61 72 79 29 2e 00 44 48 inside.if.this.is.necessary)..DH
6060 43 50 20 6f 6e 20 66 69 72 73 74 20 45 74 68 65 72 6e 65 74 20 69 6e 74 65 72 66 61 63 65 20 69 CP.on.first.Ethernet.interface.i
6080 66 20 6e 6f 20 6e 65 74 77 6f 72 6b 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 73 20 70 72 f.no.network.configuration.is.pr
60a0 6f 76 69 64 65 64 2e 00 45 78 61 6d 70 6c 65 00 45 78 61 6d 70 6c 65 20 6f 66 20 63 6f 6e 66 69 ovided..Example.Example.of.confi
60c0 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 66 72 6f 6d 20 74 68 65 20 66 69 6c 65 20 guration.commands.from.the.file.
60e0 22 2f 73 72 76 2f 73 61 6c 74 2f 73 74 61 74 65 73 2f 63 6f 6d 6d 61 6e 64 73 2e 74 78 74 22 00 "/srv/salt/states/commands.txt".
6100 45 78 61 6d 70 6c 65 20 6f 66 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3a 00 45 78 61 6d 70 6c Example.of.configuration:.Exampl
6120 65 20 6f 66 20 6f 70 2d 6d 6f 64 65 3a 00 45 78 61 6d 70 6c 65 73 00 45 78 65 63 75 74 69 6e 67 e.of.op-mode:.Examples.Executing
6140 20 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 53 63 72 69 70 74 73 00 45 78 65 63 75 74 69 6e 67 .Configuration.Scripts.Executing
6160 20 70 72 65 2d 68 6f 6f 6b 73 2f 70 6f 73 74 2d 68 6f 6f 6b 73 20 53 63 72 69 70 74 73 00 46 69 .pre-hooks/post-hooks.Scripts.Fi
6180 6c 65 20 63 6f 6e 74 65 6e 74 73 00 46 69 6c 65 20 67 65 6e 65 72 61 74 65 64 20 77 69 74 68 20 le.contents.File.generated.with.
61a0 70 72 65 76 69 6f 75 73 20 63 6f 6d 6d 61 6e 64 3a 20 60 60 2f 74 6d 70 2f 76 79 6f 73 2d 31 2e previous.command:.``/tmp/vyos-1.
61c0 33 2e 30 2d 63 6c 6f 75 64 2d 69 6e 69 74 2d 31 30 47 2d 71 65 6d 75 2e 71 63 6f 77 32 60 60 00 3.0-cloud-init-10G-qemu.qcow2``.
61e0 46 69 6e 61 6c 79 2c 20 66 69 6c 65 20 2a 2a 6d 65 74 61 2d 64 61 74 61 2a 2a 20 68 61 73 20 6e Finaly,.file.**meta-data**.has.n
6200 6f 20 63 6f 6e 74 65 6e 74 2c 20 62 75 74 20 69 74 27 73 20 72 65 71 75 69 72 65 64 2e 00 46 6f o.content,.but.it's.required..Fo
6220 72 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 65 6e 61 62 6c 69 6e 67 20 74 68 65 r.configuration.and.enabling.the
6240 20 41 50 49 20 73 65 65 20 3a 72 65 66 3a 60 68 74 74 70 2d 61 70 69 60 00 46 6f 72 20 63 6f 6e .API.see.:ref:`http-api`.For.con
6260 66 69 67 75 72 61 74 69 6f 6e 2f 75 70 67 72 61 64 65 20 6d 61 6e 61 67 65 6d 65 6e 74 20 69 73 figuration/upgrade.management.is
6280 73 75 65 73 2c 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e 20 6f 66 20 74 68 69 73 20 73 63 72 69 70 sues,.modification.of.this.scrip
62a0 74 20 73 68 6f 75 6c 64 20 62 65 20 74 68 65 20 6c 61 73 74 20 6f 70 74 69 6f 6e 2e 20 41 6c 77 t.should.be.the.last.option..Alw
62c0 61 79 73 20 74 72 79 20 74 6f 20 66 69 6e 64 20 73 6f 6c 75 74 69 6f 6e 73 20 62 61 73 65 64 20 ays.try.to.find.solutions.based.
62e0 6f 6e 20 43 4c 49 20 63 6f 6d 6d 61 6e 64 73 20 66 69 72 73 74 2e 00 46 6f 72 20 65 78 61 6d 70 on.CLI.commands.first..For.examp
6300 6c 65 2c 20 67 65 74 20 74 68 65 20 61 64 64 72 65 73 73 65 73 20 6f 66 20 61 20 60 60 64 75 6d le,.get.the.addresses.of.a.``dum
6320 30 60 60 20 69 6e 74 65 72 66 61 63 65 2e 00 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 73 68 6f 77 0``.interface..For.example,.show
6340 20 77 68 69 63 68 20 69 6d 61 67 65 73 20 61 72 65 20 69 6e 73 74 61 6c 6c 65 64 2e 00 46 6f 72 .which.images.are.installed..For
6360 20 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20 4e 6f 43 6c 6f 75 64 .more.information.on.the.NoCloud
6380 20 64 61 74 61 20 73 6f 75 72 63 65 2c 20 76 69 73 69 74 20 69 74 73 20 60 70 61 67 65 20 3c 68 .data.source,.visit.its.`page.<h
63a0 74 74 70 73 3a 2f 2f 63 6c 6f 75 64 69 6e 69 74 2e 72 65 61 64 74 68 65 64 6f 63 73 2e 69 6f 2f ttps://cloudinit.readthedocs.io/
63c0 65 6e 2f 6c 61 74 65 73 74 2f 72 65 66 65 72 65 6e 63 65 2f 64 61 74 61 73 6f 75 72 63 65 73 2f en/latest/reference/datasources/
63e0 6e 6f 63 6c 6f 75 64 2e 68 74 6d 6c 3e 60 5f 20 69 6e 20 74 68 65 20 63 6c 6f 75 64 2d 69 6e 69 nocloud.html>`_.in.the.cloud-ini
6400 74 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e 00 46 72 6f 6d 20 63 6c 69 20 6f 72 20 47 55 49 t.documentation..From.cli.or.GUI
6420 2c 20 70 6f 77 65 72 20 6f 6e 20 56 4d 2c 20 61 6e 64 20 61 66 74 65 72 20 69 74 20 62 6f 6f 74 ,.power.on.VM,.and.after.it.boot
6440 73 2c 20 76 65 72 69 66 79 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 00 47 65 6e 65 72 61 74 65 s,.verify.configuration.Generate
6460 20 4f 62 6a 65 63 74 00 47 65 6e 65 72 61 74 65 20 71 63 6f 77 20 69 6d 61 67 65 00 47 65 74 74 .Object.Generate.qcow.image.Gett
6480 69 6e 67 20 53 74 61 72 74 65 64 00 48 65 72 65 20 69 73 20 61 20 73 69 6d 70 6c 65 20 65 78 61 ing.Started.Here.is.a.simple.exa
64a0 6d 70 6c 65 3a 00 48 65 72 65 20 69 73 20 61 6e 20 65 78 61 6d 70 6c 65 20 63 6c 6f 75 64 2d 63 mple:.Here.is.an.example.cloud-c
64c0 6f 6e 66 69 67 20 74 68 61 74 20 61 70 70 65 6e 64 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e onfig.that.appends.configuration
64e0 20 61 74 20 74 68 65 20 74 69 6d 65 20 6f 66 20 66 69 72 73 74 20 62 6f 6f 74 2e 00 49 53 4f 20 .at.the.time.of.first.boot..ISO.
6500 66 69 6c 65 73 20 73 74 6f 72 61 67 65 3a 20 60 60 6c 6f 63 61 6c 60 60 20 76 6f 6c 75 6d 65 20 files.storage:.``local``.volume.
6520 69 73 20 75 73 65 64 20 66 6f 72 20 60 60 2e 69 73 6f 60 60 20 66 69 6c 65 20 73 74 6f 72 61 67 is.used.for.``.iso``.file.storag
6540 65 2e 20 49 6e 20 74 68 69 73 20 73 63 65 6e 61 72 69 6f 20 60 60 6c 6f 63 61 6c 60 60 20 76 6f e..In.this.scenario.``local``.vo
6560 6c 75 6d 65 20 74 79 70 65 20 69 73 20 73 65 74 20 74 6f 20 2a 2a 64 69 72 65 63 74 6f 72 79 2a lume.type.is.set.to.**directory*
6580 2a 2c 20 61 62 64 20 61 74 74 61 63 68 65 64 20 74 6f 20 60 60 2f 76 61 72 2f 6c 69 62 2f 76 7a *,.abd.attached.to.``/var/lib/vz
65a0 60 60 2e 00 49 66 20 63 6f 6d 6d 61 6e 64 20 65 6e 64 73 20 69 6e 20 61 20 76 61 6c 75 65 2c 20 ``..If.command.ends.in.a.value,.
65c0 69 74 20 6d 75 73 74 20 62 65 20 69 6e 73 69 64 65 20 73 69 6e 67 6c 65 20 71 75 6f 74 65 73 2e it.must.be.inside.single.quotes.
65e0 00 49 66 20 6e 6f 20 6e 65 74 77 6f 72 6b 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 .If.no.networking.configuration.
6600 69 73 20 70 72 6f 76 69 64 65 64 2c 20 74 68 65 6e 20 64 68 63 70 20 63 6c 69 65 6e 74 20 69 73 is.provided,.then.dhcp.client.is
6620 20 67 6f 69 6e 67 20 74 6f 20 62 65 20 65 6e 61 62 6c 65 64 20 6f 6e 20 66 69 72 73 74 20 69 6e .going.to.be.enabled.on.first.in
6640 74 65 72 66 61 63 65 2e 20 42 61 72 65 20 69 6e 20 6d 69 6e 64 20 74 68 61 74 20 74 68 69 73 20 terface..Bare.in.mind.that.this.
6660 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 77 69 6c 6c 20 62 65 20 69 6e 79 65 63 74 65 64 20 61 configuration.will.be.inyected.a
6680 74 20 61 6e 20 4f 53 20 6c 65 76 65 6c 2c 20 73 6f 20 64 6f 6e 27 74 20 65 78 70 65 63 74 20 74 t.an.OS.level,.so.don't.expect.t
66a0 6f 20 66 69 6e 64 20 64 68 63 70 20 63 6c 69 65 6e 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e o.find.dhcp.client.configuration
66c0 20 6f 6e 20 76 79 6f 73 20 63 6c 69 2e 20 42 65 63 61 75 73 65 20 6f 66 20 74 68 69 73 20 62 65 .on.vyos.cli..Because.of.this.be
66e0 68 61 76 69 6f 72 2c 20 69 6e 20 6e 65 78 74 20 65 78 61 6d 70 6c 65 20 6c 61 62 20 77 65 20 77 havior,.in.next.example.lab.we.w
6700 69 6c 6c 20 64 69 73 61 62 6c 65 20 64 68 63 70 2d 63 6c 69 65 6e 74 20 63 6f 6e 66 69 67 75 72 ill.disable.dhcp-client.configur
6720 61 74 69 6f 6e 20 6f 6e 20 65 74 68 30 2e 00 49 66 20 79 6f 75 20 65 6e 63 6f 75 6e 74 65 72 20 ation.on.eth0..If.you.encounter.
6740 70 72 6f 62 6c 65 6d 73 2c 20 76 65 72 69 66 79 20 74 68 61 74 20 74 68 65 20 63 6c 6f 75 64 2d problems,.verify.that.the.cloud-
6760 63 6f 6e 66 69 67 20 64 6f 63 75 6d 65 6e 74 20 63 6f 6e 74 61 69 6e 73 20 76 61 6c 69 64 20 59 config.document.contains.valid.Y
6780 41 4d 4c 2e 20 4f 6e 6c 69 6e 65 20 72 65 73 6f 75 72 63 65 73 20 73 75 63 68 20 61 73 20 68 74 AML..Online.resources.such.as.ht
67a0 74 70 73 3a 2f 2f 77 77 77 2e 79 61 6d 6c 6c 69 6e 74 2e 63 6f 6d 2f 20 70 72 6f 76 69 64 65 20 tps://www.yamllint.com/.provide.
67c0 61 20 73 69 6d 70 6c 65 20 74 6f 6f 6c 20 66 6f 72 20 76 61 6c 69 64 61 74 69 6e 67 20 59 41 4d a.simple.tool.for.validating.YAM
67e0 4c 2e 00 49 66 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 67 61 74 68 65 72 20 69 6e 66 6f 72 6d 61 L..If.you.need.to.gather.informa
6800 74 69 6f 6e 20 66 72 6f 6d 20 6c 69 6e 75 78 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 63 6f 6e 66 tion.from.linux.commands.to.conf
6820 69 67 75 72 65 20 56 79 4f 53 2c 20 79 6f 75 20 63 61 6e 20 65 78 65 63 75 74 65 20 63 6f 6d 6d igure.VyOS,.you.can.execute.comm
6840 61 6e 64 73 20 61 6e 64 20 74 68 65 6e 20 63 6f 6e 66 69 67 75 72 65 20 56 79 4f 53 20 69 6e 20 ands.and.then.configure.VyOS.in.
6860 74 68 65 20 73 61 6d 65 20 73 63 72 69 70 74 2e 00 49 66 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 the.same.script..If.you.want.to.
6880 73 63 72 69 70 74 20 74 68 65 20 63 6f 6e 66 69 67 73 20 69 6e 20 61 20 6c 61 6e 67 75 61 67 65 script.the.configs.in.a.language
68a0 20 6f 74 68 65 72 20 74 68 61 6e 20 62 61 73 68 20 79 6f 75 20 63 61 6e 20 68 61 76 65 20 79 6f .other.than.bash.you.can.have.yo
68c0 75 72 20 73 63 72 69 70 74 20 6f 75 74 70 75 74 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 20 74 68 ur.script.output.commands.and.th
68e0 65 6e 20 73 6f 75 72 63 65 20 74 68 65 6d 20 69 6e 20 61 20 62 61 73 68 20 73 63 72 69 70 74 2e en.source.them.in.a.bash.script.
6900 00 49 6d 70 6f 72 74 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 20 57 61 72 6e 69 6e 67 .Importing.and.Disabling.Warning
6920 73 20 66 6f 72 20 76 65 72 69 66 79 3d 46 61 6c 73 65 00 49 6e 20 50 72 6f 78 6d 6f 78 20 73 65 s.for.verify=False.In.Proxmox.se
6940 72 76 65 72 20 74 68 72 65 65 20 66 69 6c 65 73 20 61 72 65 20 67 6f 69 6e 67 20 74 6f 20 62 65 rver.three.files.are.going.to.be
6960 20 75 73 65 64 20 66 6f 72 20 74 68 69 73 20 73 65 74 75 70 3a 00 49 6e 20 56 79 4f 53 2c 20 62 .used.for.this.setup:.In.VyOS,.b
6980 79 20 64 65 66 61 75 6c 74 2c 20 65 6e 61 62 6c 65 73 20 6f 6e 6c 79 20 74 77 6f 20 6d 6f 64 75 y.default,.enables.only.two.modu
69a0 6c 65 73 3a 00 49 6e 20 74 68 69 73 20 6c 61 62 2c 20 61 6c 6c 20 66 69 6c 65 73 20 61 72 65 20 les:.In.this.lab,.all.files.are.
69c0 6c 6f 63 61 74 65 64 20 69 6e 20 60 60 2f 74 6d 70 2f 60 60 2e 20 53 6f 2c 20 62 65 66 6f 72 65 located.in.``/tmp/``..So,.before
69e0 20 67 6f 69 6e 67 20 6f 6e 2c 20 6c 65 74 73 20 6d 6f 76 65 20 74 6f 20 74 68 61 74 20 64 69 72 .going.on,.lets.move.to.that.dir
6a00 65 63 74 6f 72 79 3a 00 49 6e 20 74 68 69 73 20 6c 61 62 2c 20 77 65 20 61 72 65 20 75 73 69 6e ectory:.In.this.lab,.we.are.usin
6a20 67 20 31 2e 33 2e 30 20 56 79 4f 53 20 76 65 72 73 69 6f 6e 20 61 6e 64 20 73 65 74 74 69 6e 67 g.1.3.0.VyOS.version.and.setting
6a40 20 61 20 64 69 73 6b 20 6f 66 20 31 30 47 2e 20 44 6f 77 6e 6c 6f 61 64 20 56 79 4f 53 20 2e 69 .a.disk.of.10G..Download.VyOS..i
6a60 73 6f 20 66 69 6c 65 20 61 6e 64 20 73 61 76 65 20 69 74 20 61 73 20 60 60 2f 74 6d 70 2f 76 79 so.file.and.save.it.as.``/tmp/vy
6a80 6f 73 2e 69 73 6f 60 60 2e 20 43 6f 6d 6d 61 6e 64 20 75 73 65 64 20 66 6f 72 20 67 65 6e 65 72 os.iso``..Command.used.for.gener
6aa0 61 74 69 6e 67 20 71 63 6f 77 20 69 6d 61 67 65 3a 00 49 6e 69 74 69 61 6c 20 43 6f 6e 66 69 67 ating.qcow.image:.Initial.Config
6ac0 75 72 61 74 69 6f 6e 00 49 6e 69 74 69 61 6c 69 7a 69 6e 67 20 61 20 56 79 44 65 76 69 63 65 20 uration.Initializing.a.VyDevice.
6ae0 4f 62 6a 65 63 74 00 49 6e 6a 65 63 74 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 64 Object.Injecting.configuration.d
6b00 61 74 61 20 69 73 20 6e 6f 74 20 6c 69 6d 69 74 65 64 20 74 6f 20 63 6c 6f 75 64 20 70 6c 61 74 ata.is.not.limited.to.cloud.plat
6b20 66 6f 72 6d 73 2e 20 55 73 65 72 73 20 63 61 6e 20 65 6d 70 6c 6f 79 20 74 68 65 20 4e 6f 43 6c forms..Users.can.employ.the.NoCl
6b40 6f 75 64 20 64 61 74 61 20 73 6f 75 72 63 65 20 74 6f 20 69 6e 6a 65 63 74 20 75 73 65 72 2d 64 oud.data.source.to.inject.user-d
6b60 61 74 61 20 61 6e 64 20 6d 65 74 61 2d 64 61 74 61 20 6f 6e 20 76 69 72 74 75 61 6c 69 7a 61 74 ata.and.meta-data.on.virtualizat
6b80 69 6f 6e 20 70 6c 61 74 66 6f 72 6d 73 20 73 75 63 68 20 61 73 20 56 4d 77 61 72 65 2c 20 48 79 ion.platforms.such.as.VMware,.Hy
6ba0 70 65 72 2d 56 20 61 6e 64 20 4b 56 4d 2e 00 49 6e 73 74 61 6c 6c 20 60 60 6e 61 70 61 6c 6d 2d per-V.and.KVM..Install.``napalm-
6bc0 76 79 6f 73 60 60 20 6d 6f 64 75 6c 65 00 49 6e 73 74 61 6c 6c 61 74 69 6f 6e 00 49 74 20 69 73 vyos``.module.Installation.It.is
6be0 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 56 79 4f 53 20 76 69 61 20 .possible.to.configure.VyOS.via.
6c00 6e 65 74 6d 69 6b 6f 5f 20 70 72 6f 78 79 20 6d 6f 64 75 6c 65 2e 20 49 74 20 72 65 71 75 69 72 netmiko_.proxy.module..It.requir
6c20 65 73 20 61 20 6d 69 6e 69 6f 6e 20 77 69 74 68 20 69 6e 73 74 61 6c 6c 65 64 20 70 61 63 6b 65 es.a.minion.with.installed.packe
6c40 74 20 20 60 60 70 79 74 68 6f 6e 33 2d 6e 65 74 6d 69 6b 6f 60 60 20 6d 6f 64 75 6c 65 20 77 68 t..``python3-netmiko``.module.wh
6c60 6f 20 68 61 73 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 56 79 4f 53 20 6e 6f 64 65 73 o.has.a.connection.to.VyOS.nodes
6c80 2e 20 53 61 6c 74 2d 6d 69 6e 69 6f 6e 20 68 61 76 65 20 74 6f 20 63 6f 6d 6d 75 6e 69 63 61 74 ..Salt-minion.have.to.communicat
6ca0 65 20 77 69 74 68 20 73 61 6c 74 20 6d 61 73 74 65 72 00 4d 61 6a 6f 72 20 63 6c 6f 75 64 20 70 e.with.salt.master.Major.cloud.p
6cc0 72 6f 76 69 64 65 72 73 20 6f 66 66 65 72 20 61 20 6d 65 61 6e 73 20 6f 66 20 70 72 6f 76 69 64 roviders.offer.a.means.of.provid
6ce0 69 6e 67 20 75 73 65 72 2d 64 61 74 61 20 61 74 20 74 68 65 20 74 69 6d 65 20 6f 66 20 69 6e 73 ing.user-data.at.the.time.of.ins
6d00 74 61 6e 63 65 20 6c 61 75 6e 63 68 2e 20 49 74 20 63 61 6e 20 62 65 20 70 72 6f 76 69 64 65 64 tance.launch..It.can.be.provided
6d20 20 61 73 20 70 6c 61 69 6e 20 74 65 78 74 20 6f 72 20 61 73 20 62 61 73 65 36 34 2d 65 6e 63 6f .as.plain.text.or.as.base64-enco
6d40 64 65 64 20 74 65 78 74 2c 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 63 6c 6f 75 64 20 70 72 6f ded.text,.depending.on.cloud.pro
6d60 76 69 64 65 72 2e 20 41 6c 73 6f 2c 20 69 74 20 63 61 6e 20 62 65 20 63 6f 6d 70 72 65 73 73 65 vider..Also,.it.can.be.compresse
6d80 64 20 75 73 69 6e 67 20 67 7a 69 70 2c 20 77 68 69 63 68 20 6d 61 6b 65 73 20 73 65 6e 73 65 20 d.using.gzip,.which.makes.sense.
6da0 77 69 74 68 20 61 20 6c 6f 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e with.a.long.configuration.comman
6dc0 64 73 20 6c 69 73 74 2c 20 62 65 63 61 75 73 65 20 6f 66 20 74 68 65 20 68 61 72 64 20 6c 69 6d ds.list,.because.of.the.hard.lim
6de0 69 74 20 74 6f 20 7e 31 36 33 38 34 20 62 79 74 65 73 20 66 6f 72 20 74 68 65 20 77 68 6f 6c 65 it.to.~16384.bytes.for.the.whole
6e00 20 75 73 65 72 2d 64 61 74 61 2e 00 4d 65 74 61 64 61 74 61 20 2d 20 4d 65 74 61 64 61 74 61 20 .user-data..Metadata.-.Metadata.
6e20 69 73 20 73 6f 75 72 63 65 64 20 62 79 20 74 68 65 20 63 6c 6f 75 64 20 70 6c 61 74 66 6f 72 6d is.sourced.by.the.cloud.platform
6e40 20 6f 72 20 68 79 70 65 72 76 69 73 6f 72 2e 20 49 6e 20 73 6f 6d 65 20 63 6c 6f 75 64 73 2c 20 .or.hypervisor..In.some.clouds,.
6e60 74 68 65 72 65 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 61 73 20 61 6e 20 48 54 54 50 20 there.is.implemented.as.an.HTTP.
6e80 65 6e 64 70 6f 69 6e 74 20 61 74 20 60 60 68 74 74 70 3a 2f 2f 31 36 39 2e 32 35 34 2e 31 36 39 endpoint.at.``http://169.254.169
6ea0 2e 32 35 34 60 60 2e 00 4d 6f 73 74 20 69 6d 70 6f 72 74 61 6e 74 20 6b 65 79 73 20 74 68 61 74 .254``..Most.important.keys.that
6ec0 20 6e 65 65 64 73 20 74 6f 20 62 65 20 63 6f 6e 73 69 64 65 72 65 64 3a 00 4e 61 70 61 6c 6d 00 .needs.to.be.considered:.Napalm.
6ee0 4e 65 74 6d 69 6b 6f 00 4e 65 74 6d 69 6b 6f 2d 70 72 6f 78 79 00 4e 65 74 77 6f 72 6b 20 63 6f Netmiko.Netmiko-proxy.Network.co
6f00 6e 66 69 67 75 72 61 74 69 6f 6e 20 2d 20 54 68 69 73 20 63 6f 6e 66 69 67 20 73 6f 75 72 63 65 nfiguration.-.This.config.source
6f20 20 69 6e 66 6f 72 6d 73 20 74 68 65 20 73 79 73 74 65 6d 20 61 62 6f 75 74 20 74 68 65 20 6e 65 .informs.the.system.about.the.ne
6f40 74 77 6f 72 6b 20 73 65 74 74 69 6e 67 73 20 6c 69 6b 65 20 49 50 20 61 64 64 72 65 73 73 65 73 twork.settings.like.IP.addresses
6f60 2c 20 72 6f 75 74 65 73 2c 20 44 4e 53 2e 20 41 76 61 69 6c 61 62 6c 65 20 6f 6e 6c 79 20 69 6e ,.routes,.DNS..Available.only.in
6f80 20 73 65 76 65 72 61 6c 20 63 6c 6f 75 64 20 61 6e 64 20 76 69 72 74 75 61 6c 69 7a 61 74 69 6f .several.cloud.and.virtualizatio
6fa0 6e 20 70 6c 61 74 66 6f 72 6d 73 2e 00 4e 65 74 77 6f 72 6b 69 6e 67 20 63 6f 6e 66 69 67 75 72 n.platforms..Networking.configur
6fc0 61 74 69 6f 6e 73 20 73 68 6f 75 6c 64 6e 27 74 20 62 65 20 70 61 73 73 65 64 20 69 6e 20 75 73 ations.shouldn't.be.passed.in.us
6fe0 65 72 2d 64 61 74 61 20 66 69 6c 65 2e 00 4e 6f 43 6c 6f 75 64 00 4e 6f 72 6e 69 72 00 4e 6f 74 er-data.file..NoCloud.Nornir.Not
7000 65 20 74 68 61 74 20 74 68 65 20 2f 6f 70 74 2f 76 79 61 74 74 61 2f 65 74 63 2f 63 6f 6e 66 69 e.that.the./opt/vyatta/etc/confi
7020 67 20 69 73 20 75 73 65 64 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 65 20 2f 63 6f 6e 66 69 67 g.is.used.instead.of.the./config
7040 2f 73 63 72 69 70 74 73 20 64 69 72 65 63 74 6f 72 79 20 72 65 66 65 72 65 6e 63 65 64 20 69 6e /scripts.directory.referenced.in
7060 20 74 68 65 20 3a 72 65 66 3a 60 63 6f 6d 6d 61 6e 64 2d 73 63 72 69 70 74 69 6e 67 60 20 73 65 .the.:ref:`command-scripting`.se
7080 63 74 69 6f 6e 20 6f 66 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 62 65 63 61 75 ction.of.the.documentation.becau
70a0 73 65 20 74 68 65 20 2f 63 6f 6e 66 69 67 2f 73 63 72 69 70 74 20 64 69 72 65 63 74 6f 72 79 20 se.the./config/script.directory.
70c0 69 73 6e 27 74 20 6d 6f 75 6e 74 65 64 20 77 68 65 6e 20 74 68 65 20 60 60 77 72 69 74 65 5f 66 isn't.mounted.when.the.``write_f
70e0 69 6c 65 73 60 60 20 6d 6f 64 75 6c 65 20 65 78 65 63 75 74 65 73 2e 00 4e 6f 74 65 73 20 66 6f iles``.module.executes..Notes.fo
7100 72 20 74 68 69 73 20 70 61 72 74 69 63 75 6c 61 72 20 65 78 61 6d 70 6c 65 2c 20 74 68 61 74 20 r.this.particular.example,.that.
7120 6d 61 79 20 6e 65 65 64 20 74 6f 20 62 65 20 6d 6f 64 69 66 69 65 64 20 69 6e 20 6f 74 68 65 72 may.need.to.be.modified.in.other
7140 20 73 65 74 75 70 73 3a 00 4e 6f 77 2c 20 74 68 61 74 20 66 69 6c 65 20 6e 65 65 64 73 20 74 6f .setups:.Now,.that.file.needs.to
7160 20 62 65 20 63 6f 70 69 65 64 20 74 6f 20 70 72 6f 78 6d 6f 78 20 73 65 72 76 65 72 3a 00 4f 6e .be.copied.to.proxmox.server:.On
7180 20 56 79 4f 53 20 74 68 69 73 20 77 69 6c 6c 20 63 61 75 73 65 20 74 68 65 20 66 6f 6c 6c 6f 77 .VyOS.this.will.cause.the.follow
71a0 69 6e 67 20 70 72 6f 62 6c 65 6d 3a 20 41 66 74 65 72 20 6d 6f 64 69 66 79 69 6e 67 20 74 68 65 ing.problem:.After.modifying.the
71c0 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 76 69 61 20 73 63 72 69 70 74 20 6c 69 6b 65 20 74 .configuration.via.script.like.t
71e0 68 69 73 20 6f 6e 63 65 2c 20 69 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 his.once,.it.is.not.possible.to.
7200 6d 61 6e 75 61 6c 6c 79 20 6d 6f 64 69 66 79 20 74 68 65 20 63 6f 6e 66 69 67 20 61 6e 79 6d 6f manually.modify.the.config.anymo
7220 72 65 3a 00 4f 6e 20 70 72 6f 78 6d 6f 78 20 73 65 72 76 65 72 3a 00 4f 6e 63 65 20 74 68 65 20 re:.On.proxmox.server:.Once.the.
7240 74 68 72 65 65 20 66 69 6c 65 73 20 77 65 72 65 20 63 72 65 61 74 65 64 2c 20 69 74 27 73 20 74 three.files.were.created,.it's.t
7260 69 6d 65 20 74 6f 20 67 65 6e 65 72 61 74 65 20 74 68 65 20 60 60 73 65 65 64 2e 69 73 6f 60 60 ime.to.generate.the.``seed.iso``
7280 20 69 6d 61 67 65 2c 20 77 68 69 63 68 20 6e 65 65 64 73 20 74 6f 20 62 65 20 6d 6f 75 6e 74 65 .image,.which.needs.to.be.mounte
72a0 64 20 74 6f 20 74 68 65 20 6e 65 77 20 56 4d 20 61 73 20 61 20 63 64 2e 00 4f 6e 65 20 63 6f 6d d.to.the.new.VM.as.a.cd..One.com
72c0 6d 61 6e 64 20 70 65 72 20 6c 69 6e 65 2e 00 4f 70 2d 6d 6f 64 65 00 4f 74 68 65 72 20 73 63 72 mand.per.line..Op-mode.Other.scr
72e0 69 70 74 20 6c 61 6e 67 75 61 67 65 73 00 4f 75 74 70 75 74 00 4f 75 74 70 75 74 20 6f 70 2d 6d ipt.languages.Output.Output.op-m
7300 6f 64 65 00 50 6c 65 61 73 65 20 74 61 6b 65 20 61 20 6c 6f 6f 6b 20 61 74 20 74 68 65 20 43 6f ode.Please.take.a.look.at.the.Co
7320 6e 74 72 69 62 75 74 69 6e 67 20 47 75 69 64 65 20 66 6f 72 20 6f 75 72 20 3a 72 65 66 3a 60 64 ntributing.Guide.for.our.:ref:`d
7340 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 60 2e 00 50 6f 73 74 63 6f 6e 66 69 67 20 6f 6e 20 62 6f 6f ocumentation`..Postconfig.on.boo
7360 74 00 50 6f 77 65 72 20 6f 6e 20 56 4d 20 61 6e 64 20 76 65 72 69 66 69 63 61 74 69 6f 6e 73 00 t.Power.on.VM.and.verifications.
7380 50 72 65 63 6f 6e 66 69 67 20 6f 6e 20 62 6f 6f 74 00 50 72 65 70 61 72 65 20 63 6c 6f 75 64 2d Preconfig.on.boot.Prepare.cloud-
73a0 69 6e 69 74 20 66 69 6c 65 73 00 50 72 6f 78 6d 6f 78 20 49 50 20 61 64 64 72 65 73 73 3a 20 2a init.files.Proxmox.IP.address:.*
73c0 2a 31 39 32 2e 31 36 38 2e 30 2e 32 35 33 2f 32 34 2a 2a 00 50 72 6f 78 6d 6f 78 20 60 43 6c 6f *192.168.0.253/24**.Proxmox.`Clo
73e0 75 64 2d 69 6e 69 74 2d 53 75 70 70 6f 72 74 60 5f 2e 00 50 79 56 79 4f 53 00 50 79 56 79 4f 53 ud-init-Support`_..PyVyOS.PyVyOS
7400 20 69 73 20 61 20 50 79 74 68 6f 6e 20 6c 69 62 72 61 72 79 20 66 6f 72 20 69 6e 74 65 72 61 63 .is.a.Python.library.for.interac
7420 74 69 6e 67 20 77 69 74 68 20 56 79 4f 53 20 64 65 76 69 63 65 73 20 76 69 61 20 74 68 65 69 72 ting.with.VyOS.devices.via.their
7440 20 41 50 49 2e 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 67 75 69 64 65 73 20 .API..This.documentation.guides.
7460 79 6f 75 20 6f 6e 20 75 73 69 6e 67 20 50 79 56 79 4f 53 20 74 6f 20 6d 61 6e 61 67 65 20 79 6f you.on.using.PyVyOS.to.manage.yo
7480 75 72 20 56 79 4f 53 20 64 65 76 69 63 65 73 20 70 72 6f 67 72 61 6d 6d 61 74 69 63 61 6c 6c 79 ur.VyOS.devices.programmatically
74a0 2e 20 54 68 65 20 63 6f 6d 70 6c 65 74 65 20 50 79 56 79 4f 53 20 64 6f 63 75 6d 65 6e 74 61 74 ..The.complete.PyVyOS.documentat
74c0 69 6f 6e 20 69 73 20 61 76 61 69 6c 61 62 6c 65 20 6f 6e 20 5b 52 65 61 64 20 74 68 65 20 44 6f ion.is.available.on.[Read.the.Do
74e0 63 73 5d 28 68 74 74 70 73 3a 2f 2f 70 79 76 79 6f 73 2e 72 65 61 64 74 68 65 64 6f 63 73 2e 69 cs](https://pyvyos.readthedocs.i
7500 6f 2f 65 6e 2f 6c 61 74 65 73 74 2f 29 2c 20 61 6e 64 20 74 68 65 20 6c 69 62 72 61 72 79 20 63 o/en/latest/),.and.the.library.c
7520 61 6e 20 62 65 20 66 6f 75 6e 64 20 6f 6e 20 5b 47 69 74 48 75 62 5d 28 68 74 74 70 73 3a 2f 2f an.be.found.on.[GitHub](https://
7540 67 69 74 68 75 62 2e 63 6f 6d 2f 72 6f 62 65 72 74 6f 62 65 72 74 6f 2f 70 79 76 79 6f 73 29 20 github.com/robertoberto/pyvyos).
7560 61 6e 64 20 5b 50 79 50 49 5d 28 68 74 74 70 73 3a 2f 2f 70 79 70 69 2e 6f 72 67 2f 70 72 6f 6a and.[PyPI](https://pypi.org/proj
7580 65 63 74 2f 70 79 76 79 6f 73 2f 29 2e 00 52 65 66 65 72 65 6e 63 65 73 00 52 65 6d 6f 76 65 20 ect/pyvyos/)..References.Remove.
75a0 64 65 66 61 75 6c 74 20 64 68 63 70 20 63 6c 69 65 6e 74 20 6f 6e 20 66 69 72 73 74 20 69 6e 74 default.dhcp.client.on.first.int
75c0 65 72 66 61 63 65 2c 20 61 6e 64 20 6c 6f 61 64 20 6f 74 68 65 72 20 63 6f 6e 66 69 67 75 72 61 erface,.and.load.other.configura
75e0 74 69 6f 6e 20 64 75 72 69 6e 67 20 66 69 72 73 74 20 62 6f 6f 74 2c 20 75 73 69 6e 67 20 63 6c tion.during.first.boot,.using.cl
7600 6f 75 64 2d 69 6e 69 74 2e 00 52 65 73 65 74 20 4f 62 6a 65 63 74 00 52 75 6e 20 61 6e 73 69 62 oud-init..Reset.Object.Run.ansib
7620 6c 65 00 52 75 6e 20 63 6f 6d 6d 61 6e 64 73 20 72 65 6d 6f 74 65 6c 79 00 52 75 6e 20 63 6f 6e le.Run.commands.remotely.Run.con
7640 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 00 52 75 6e 20 6f 70 65 72 61 74 69 6f figuration.commands.Run.operatio
7660 6e 61 6c 20 63 6f 6d 6d 61 6e 64 73 00 53 53 48 20 69 73 20 63 6f 6e 66 69 67 75 72 65 64 20 6f nal.commands.SSH.is.configured.o
7680 6e 20 70 6f 72 74 20 32 32 2e 00 53 61 6c 74 00 53 61 6c 74 20 6d 61 73 74 65 72 20 63 6f 6e 66 n.port.22..Salt.Salt.master.conf
76a0 69 67 75 72 61 74 69 6f 6e 3a 00 53 61 76 65 20 61 20 72 75 6e 6e 69 6e 67 20 63 6f 6e 66 69 67 iguration:.Save.a.running.config
76c0 75 72 61 74 69 6f 6e 20 74 6f 20 61 20 66 69 6c 65 2e 00 53 61 76 65 20 61 20 72 75 6e 6e 69 6e uration.to.a.file..Save.a.runnin
76e0 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 74 6f 20 74 68 65 20 73 74 61 72 74 75 70 20 63 g.configuration.to.the.startup.c
7700 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 20 57 68 65 6e 20 79 6f 75 20 64 6f 6e 27 74 20 73 70 65 onfiguration..When.you.don't.spe
7720 63 69 66 79 20 74 68 65 20 66 69 6c 65 20 77 68 65 6e 20 73 61 76 69 6e 67 2c 20 69 74 20 73 61 cify.the.file.when.saving,.it.sa
7740 76 65 73 20 74 6f 20 60 60 2f 63 6f 6e 66 69 67 2f 63 6f 6e 66 69 67 2e 62 6f 6f 74 60 60 2e 00 ves.to.``/config/config.boot``..
7760 53 63 72 69 70 74 20 76 79 6f 73 2d 6e 61 70 61 6c 6d 2e 70 79 00 53 63 72 69 70 74 73 20 61 72 Script.vyos-napalm.py.Scripts.ar
7780 65 20 72 75 6e 20 69 6e 20 61 6c 70 68 61 62 65 74 69 63 61 6c 20 6f 72 64 65 72 2e 20 54 68 65 e.run.in.alphabetical.order..The
77a0 69 72 20 6e 61 6d 65 73 20 6d 75 73 74 20 63 6f 6e 73 69 73 74 20 65 6e 74 69 72 65 6c 79 20 6f ir.names.must.consist.entirely.o
77c0 66 20 41 53 43 49 49 20 75 70 70 65 72 2d 20 61 6e 64 20 6c 6f 77 65 72 2d 63 61 73 65 20 6c 65 f.ASCII.upper-.and.lower-case.le
77e0 74 74 65 72 73 2c 41 53 43 49 49 20 64 69 67 69 74 73 2c 20 41 53 43 49 49 20 75 6e 64 65 72 73 tters,ASCII.digits,.ASCII.unders
7800 63 6f 72 65 73 2c 20 61 6e 64 20 41 53 43 49 49 20 6d 69 6e 75 73 2d 68 79 70 68 65 6e 73 2e 4e cores,.and.ASCII.minus-hyphens.N
7820 6f 20 6f 74 68 65 72 20 63 68 61 72 61 63 74 65 72 73 20 61 72 65 20 61 6c 6c 6f 77 65 64 2e 00 o.other.characters.are.allowed..
7840 53 68 6f 77 20 4f 62 6a 65 63 74 00 53 6f 6d 65 74 69 6d 65 73 20 79 6f 75 20 73 69 6d 70 6c 79 Show.Object.Sometimes.you.simply
7860 20 77 61 6e 27 74 20 74 6f 20 65 78 65 63 75 74 65 20 61 20 62 75 6e 63 68 20 6f 66 20 6f 70 2d .wan't.to.execute.a.bunch.of.op-
7880 6d 6f 64 65 20 63 6f 6d 6d 61 6e 64 73 20 76 69 61 20 53 53 48 20 6f 6e 20 61 20 72 65 6d 6f 74 mode.commands.via.SSH.on.a.remot
78a0 65 20 56 79 4f 53 20 73 79 73 74 65 6d 2e 00 53 74 6f 72 61 67 65 64 20 75 73 65 64 3a 20 76 6f e.VyOS.system..Storaged.used:.vo
78c0 6c 75 6d 65 20 6c 6f 63 61 6c 2c 20 77 68 69 63 68 20 69 73 20 6d 6f 75 6e 74 65 64 20 6f 6e 20 lume.local,.which.is.mounted.on.
78e0 64 69 72 65 63 74 6f 72 79 20 2a 2a 2f 76 61 72 2f 6c 69 62 2f 76 7a 2a 2a 2c 20 61 6e 64 20 63 directory.**/var/lib/vz**,.and.c
7900 6f 6e 74 61 69 6e 73 20 61 6c 6c 20 74 79 70 65 20 6f 66 20 63 6f 6e 74 65 6e 74 2c 20 69 6e 63 ontains.all.type.of.content,.inc
7920 6c 75 64 69 6e 67 20 73 6e 69 70 70 65 74 73 2e 00 53 74 72 75 63 74 75 72 65 20 6f 66 20 2f 73 luding.snippets..Structure.of./s
7940 72 76 2f 73 61 6c 74 3a 00 53 74 72 75 63 74 75 72 65 20 6f 66 20 66 69 6c 65 73 00 53 79 73 74 rv/salt:.Structure.of.files.Syst
7960 65 6d 20 44 65 66 61 75 6c 74 73 2f 46 61 6c 6c 62 61 63 6b 73 00 54 68 65 20 41 50 49 20 70 75 em.Defaults/Fallbacks.The.API.pu
7980 73 68 65 73 20 65 76 65 72 79 20 72 65 71 75 65 73 74 20 74 6f 20 61 20 73 65 73 73 69 6f 6e 20 shes.every.request.to.a.session.
79a0 61 6e 64 20 63 6f 6d 6d 69 74 20 69 74 2e 20 42 75 74 20 73 6f 6d 65 20 6f 66 20 56 79 4f 53 20 and.commit.it..But.some.of.VyOS.
79c0 63 6f 6d 70 6f 6e 65 6e 74 73 20 6c 69 6b 65 20 44 48 43 50 20 61 6e 64 20 50 50 50 6f 45 20 53 components.like.DHCP.and.PPPoE.S
79e0 65 72 76 65 72 73 2c 20 49 50 53 65 63 2c 20 56 58 4c 41 4e 2c 20 61 6e 64 20 6f 74 68 65 72 20 ervers,.IPSec,.VXLAN,.and.other.
7a00 74 75 6e 6e 65 6c 73 20 72 65 71 75 69 72 65 20 66 75 6c 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 tunnels.require.full.configurati
7a20 6f 6e 20 66 6f 72 20 63 6f 6d 6d 69 74 2e 20 54 68 65 20 65 6e 64 70 6f 69 6e 74 20 77 69 6c 6c on.for.commit..The.endpoint.will
7a40 20 70 72 6f 63 65 73 73 20 6d 75 6c 74 69 70 6c 65 20 63 6f 6d 6d 61 6e 64 73 20 77 68 65 6e 20 .process.multiple.commands.when.
7a60 79 6f 75 20 70 61 73 73 20 74 68 65 6d 20 61 73 20 61 20 6c 69 73 74 20 74 6f 20 74 68 65 20 60 you.pass.them.as.a.list.to.the.`
7a80 60 64 61 74 61 60 60 20 66 69 65 6c 64 2e 00 54 68 65 20 60 60 2f 63 6f 6e 66 69 67 2f 73 63 72 `data``.field..The.``/config/scr
7aa0 69 70 74 73 2f 76 79 6f 73 2d 70 6f 73 74 63 6f 6e 66 69 67 2d 62 6f 6f 74 75 70 2e 73 63 72 69 ipts/vyos-postconfig-bootup.scri
7ac0 70 74 60 60 20 73 63 72 69 70 74 20 69 73 20 63 61 6c 6c 65 64 20 6f 6e 20 62 6f 6f 74 20 61 66 pt``.script.is.called.on.boot.af
7ae0 74 65 72 20 74 68 65 20 56 79 4f 53 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 73 20 66 75 ter.the.VyOS.configuration.is.fu
7b00 6c 6c 79 20 61 70 70 6c 69 65 64 2e 00 54 68 65 20 60 60 2f 63 6f 6e 66 69 67 2f 73 63 72 69 70 lly.applied..The.``/config/scrip
7b20 74 73 2f 76 79 6f 73 2d 70 72 65 63 6f 6e 66 69 67 2d 62 6f 6f 74 75 70 2e 73 63 72 69 70 74 60 ts/vyos-preconfig-bootup.script`
7b40 60 20 73 63 72 69 70 74 20 69 73 20 63 61 6c 6c 65 64 20 6f 6e 20 62 6f 6f 74 20 62 65 66 6f 72 `.script.is.called.on.boot.befor
7b60 65 20 74 68 65 20 56 79 4f 53 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 64 75 72 69 6e 67 20 e.the.VyOS.configuration.during.
7b80 62 6f 6f 74 20 70 72 6f 63 65 73 73 2e 00 54 68 65 20 60 60 2f 73 68 6f 77 60 60 20 65 6e 64 70 boot.process..The.``/show``.endp
7ba0 6f 69 6e 74 20 69 73 20 74 6f 20 73 68 6f 77 20 65 76 65 72 79 74 68 69 6e 67 20 69 6e 20 74 68 oint.is.to.show.everything.in.th
7bc0 65 20 6f 70 65 72 61 74 69 6f 6e 61 6c 20 6d 6f 64 65 2e 00 54 68 65 20 60 60 67 65 6e 65 72 61 e.operational.mode..The.``genera
7be0 74 65 60 60 20 65 6e 64 70 6f 69 6e 74 20 72 75 6e 20 61 20 60 60 67 65 6e 65 72 61 74 65 60 60 te``.endpoint.run.a.``generate``
7c00 20 63 6f 6d 6d 61 6e 64 2e 00 54 68 65 20 60 60 72 65 73 65 74 60 60 20 65 6e 64 70 6f 69 6e 74 .command..The.``reset``.endpoint
7c20 20 72 75 6e 20 61 20 60 60 72 65 73 65 74 60 60 20 63 6f 6d 6d 61 6e 64 2e 00 54 68 65 20 63 6f .run.a.``reset``.command..The.co
7c40 6d 6d 61 6e 64 73 20 6c 69 73 74 20 70 72 6f 64 75 63 65 64 20 62 79 20 74 68 65 20 60 60 73 68 mmands.list.produced.by.the.``sh
7c60 6f 77 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 60 60 20 63 6f 6d 6d ow.configuration.commands``.comm
7c80 61 6e 64 20 6f 6e 20 61 20 56 79 4f 53 20 72 6f 75 74 65 72 20 73 68 6f 75 6c 64 20 63 6f 6d 70 and.on.a.VyOS.router.should.comp
7ca0 6c 79 20 77 69 74 68 20 61 6c 6c 20 74 68 65 20 72 65 71 75 69 72 65 6d 65 6e 74 73 2c 20 73 6f ly.with.all.the.requirements,.so
7cc0 20 69 74 20 69 73 20 65 61 73 79 20 74 6f 20 67 65 74 20 61 20 70 72 6f 70 65 72 20 63 6f 6d 6d .it.is.easy.to.get.a.proper.comm
7ce0 61 6e 64 73 20 6c 69 73 74 20 62 79 20 63 6f 70 79 69 6e 67 20 69 74 20 66 72 6f 6d 20 61 6e 6f ands.list.by.copying.it.from.ano
7d00 74 68 65 72 20 72 6f 75 74 65 72 2e 00 54 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 73 ther.router..The.configuration.s
7d20 70 65 63 69 66 69 65 64 20 69 6e 20 74 68 65 20 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 20 64 6f 63 pecified.in.the.cloud-config.doc
7d40 75 6d 65 6e 74 20 6f 76 65 72 77 72 69 74 65 73 20 64 65 66 61 75 6c 74 20 63 6f 6e 66 69 67 75 ument.overwrites.default.configu
7d60 72 61 74 69 6f 6e 20 76 61 6c 75 65 73 20 61 6e 64 20 76 61 6c 75 65 73 20 63 6f 6e 66 69 67 75 ration.values.and.values.configu
7d80 72 65 64 20 76 69 61 20 4d 65 74 61 64 61 74 61 2e 00 54 68 65 20 64 65 66 61 75 6c 74 20 64 69 red.via.Metadata..The.default.di
7da0 72 65 63 74 6f 72 69 65 73 20 77 68 65 72 65 20 79 6f 75 72 20 63 75 73 74 6f 6d 20 53 63 72 69 rectories.where.your.custom.Scri
7dc0 70 74 73 20 73 68 6f 75 6c 64 20 62 65 20 6c 6f 63 61 74 65 64 20 61 72 65 3a 00 54 68 65 20 64 pts.should.be.located.are:.The.d
7de0 65 66 61 75 6c 74 20 66 69 6c 65 20 6c 6f 6f 6b 73 20 6c 69 6b 65 20 74 68 69 73 3a 00 54 68 65 efault.file.looks.like.this:.The
7e00 20 65 61 73 69 65 73 74 20 77 61 79 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 74 68 65 20 73 79 .easiest.way.to.configure.the.sy
7e20 73 74 65 6d 20 76 69 61 20 75 73 65 72 2d 64 61 74 61 20 69 73 20 74 68 65 20 43 6c 6f 75 64 2d stem.via.user-data.is.the.Cloud-
7e40 63 6f 6e 66 69 67 20 73 79 6e 74 61 78 20 64 65 73 63 72 69 62 65 64 20 62 65 6c 6f 77 2e 00 54 config.syntax.described.below..T
7e60 68 65 20 65 6e 64 70 6f 69 6e 74 20 60 60 2f 63 6f 6e 66 69 67 2d 66 69 6c 65 60 60 20 69 73 20 he.endpoint.``/config-file``.is.
7e80 74 6f 20 73 61 76 65 20 6f 72 20 6c 6f 61 64 20 61 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e to.save.or.load.a.configuration.
7ea0 00 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 78 61 6d 70 6c 65 20 73 65 74 73 20 74 68 65 20 .The.following.example.sets.the.
7ec0 68 6f 73 74 6e 61 6d 65 20 62 61 73 65 64 20 6f 6e 20 74 68 65 20 69 6e 73 74 61 6e 63 65 20 69 hostname.based.on.the.instance.i
7ee0 64 65 6e 74 69 66 69 65 72 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 74 68 65 20 45 43 32 20 dentifier.obtained.from.the.EC2.
7f00 6d 65 74 61 64 61 74 61 20 73 65 72 76 69 63 65 2e 00 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 metadata.service..The.following.
7f20 65 78 61 6d 70 6c 65 20 73 68 6f 77 73 20 68 6f 77 20 74 6f 20 65 78 65 63 75 74 65 20 63 6f 6d example.shows.how.to.execute.com
7f40 6d 61 6e 64 73 20 61 66 74 65 72 20 74 68 65 20 69 6e 69 74 69 61 6c 20 63 6f 6e 66 69 67 75 72 mands.after.the.initial.configur
7f60 61 74 69 6f 6e 2e 00 54 68 65 20 6b 65 79 20 75 73 65 64 20 74 6f 20 64 65 73 69 67 6e 61 74 65 ation..The.key.used.to.designate
7f80 20 61 20 56 79 4f 53 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 73 20 60 60 76 79 6f 73 5f .a.VyOS.configuration.is.``vyos_
7fa0 63 6f 6e 66 69 67 5f 63 6f 6d 6d 61 6e 64 73 60 60 2e 20 57 68 61 74 20 66 6f 6c 6c 6f 77 73 20 config_commands``..What.follows.
7fc0 69 73 20 56 79 4f 53 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 75 73 69 6e 67 20 74 68 65 20 is.VyOS.configuration.using.the.
7fe0 22 73 65 74 2d 73 74 79 6c 65 22 20 73 79 6e 74 61 78 2e 20 42 6f 74 68 20 22 73 65 74 22 20 61 "set-style".syntax..Both."set".a
8000 6e 64 20 22 64 65 6c 65 74 65 22 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 73 75 70 70 6f 72 74 nd."delete".commands.are.support
8020 65 64 2e 00 54 68 65 20 73 65 65 64 2e 69 73 6f 20 66 69 6c 65 20 63 61 6e 20 62 65 20 61 74 74 ed..The.seed.iso.file.can.be.att
8040 61 63 68 65 64 20 74 6f 20 74 68 65 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 2e 20 41 73 ached.to.the.virtual.machine..As
8060 20 61 6e 20 65 78 61 6d 70 6c 65 2c 20 74 68 65 20 6d 65 74 68 6f 64 20 77 69 74 68 20 4b 56 4d .an.example,.the.method.with.KVM
8080 20 74 6f 20 61 74 74 61 63 68 20 74 68 65 20 49 53 4f 20 61 73 20 61 20 43 44 20 64 72 69 76 65 .to.attach.the.ISO.as.a.CD.drive
80a0 20 66 6f 6c 6c 6f 77 73 2e 00 54 68 65 72 65 20 69 73 20 61 20 70 69 74 66 61 6c 6c 20 77 68 65 .follows..There.is.a.pitfall.whe
80c0 6e 20 77 6f 72 6b 69 6e 67 20 77 69 74 68 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 73 63 72 n.working.with.configuration.scr
80e0 69 70 74 73 2e 20 49 74 20 69 73 20 74 65 6d 70 74 69 6e 67 20 74 6f 20 63 61 6c 6c 20 63 6f 6e ipts..It.is.tempting.to.call.con
8100 66 69 67 75 72 61 74 69 6f 6e 20 73 63 72 69 70 74 73 20 77 69 74 68 20 22 73 75 64 6f 22 20 28 figuration.scripts.with."sudo".(
8120 69 2e 65 2e 2c 20 74 65 6d 70 6f 72 61 72 79 20 72 6f 6f 74 20 70 65 72 6d 69 73 73 69 6f 6e 73 i.e.,.temporary.root.permissions
8140 29 2c 20 62 65 63 61 75 73 65 20 74 68 61 74 27 73 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 77 61 79 ),.because.that's.the.common.way
8160 20 6f 6e 20 6d 6f 73 74 20 4c 69 6e 75 78 20 70 6c 61 74 66 6f 72 6d 73 20 74 6f 20 63 61 6c 6c .on.most.Linux.platforms.to.call
8180 20 73 79 73 74 65 6d 20 63 6f 6d 6d 61 6e 64 73 2e 00 54 68 65 73 65 20 61 72 65 20 74 68 65 20 .system.commands..These.are.the.
81a0 56 79 4f 53 20 64 65 66 61 75 6c 74 73 20 61 6e 64 20 66 61 6c 6c 62 61 63 6b 73 2e 00 54 68 69 VyOS.defaults.and.fallbacks..Thi
81c0 73 20 73 65 63 74 69 6f 6e 20 6e 65 65 64 73 20 69 6d 70 72 6f 76 65 6d 65 6e 74 73 2c 20 65 78 s.section.needs.improvements,.ex
81e0 61 6d 70 6c 65 73 20 61 6e 64 20 65 78 70 6c 61 6e 61 74 69 6f 6e 73 2e 00 54 68 69 73 20 77 69 amples.and.explanations..This.wi
8200 6c 6c 20 72 65 73 75 6c 74 20 69 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 72 72 6f 72 ll.result.in.the.following.error
8220 20 6d 65 73 73 61 67 65 3a 20 60 60 53 65 74 20 66 61 69 6c 65 64 60 60 20 49 66 20 74 68 69 73 .message:.``Set.failed``.If.this
8240 20 68 61 70 70 65 6e 73 2c 20 61 20 72 65 62 6f 6f 74 20 69 73 20 72 65 71 75 69 72 65 64 20 74 .happens,.a.reboot.is.required.t
8260 6f 20 62 65 20 61 62 6c 65 20 74 6f 20 65 64 69 74 20 74 68 65 20 63 6f 6e 66 69 67 20 6d 61 6e o.be.able.to.edit.the.config.man
8280 75 61 6c 6c 79 20 61 67 61 69 6e 2e 00 54 6f 20 4c 6f 61 64 20 61 20 63 6f 6e 66 69 67 75 72 61 ually.again..To.Load.a.configura
82a0 74 69 6f 6e 20 66 69 6c 65 2e 00 54 6f 20 61 64 64 20 6f 72 20 64 65 6c 65 74 65 20 61 6e 20 69 tion.file..To.add.or.delete.an.i
82c0 6d 61 67 65 2c 20 75 73 65 20 74 68 65 20 60 60 2f 69 6d 61 67 65 60 60 20 65 6e 64 70 6f 69 6e mage,.use.the.``/image``.endpoin
82e0 74 2e 00 54 6f 20 61 76 6f 69 64 20 74 68 65 73 65 20 70 72 6f 62 6c 65 6d 73 2c 20 74 68 65 20 t..To.avoid.these.problems,.the.
8300 70 72 6f 70 65 72 20 77 61 79 20 69 73 20 74 6f 20 63 61 6c 6c 20 61 20 73 63 72 69 70 74 20 77 proper.way.is.to.call.a.script.w
8320 69 74 68 20 74 68 65 20 60 60 76 79 61 74 74 61 63 66 67 60 60 20 67 72 6f 75 70 2c 20 65 2e 67 ith.the.``vyattacfg``.group,.e.g
8340 2e 2c 20 62 79 20 75 73 69 6e 67 20 74 68 65 20 60 60 73 67 60 60 20 28 73 77 69 74 63 68 20 67 .,.by.using.the.``sg``.(switch.g
8360 72 6f 75 70 29 20 63 6f 6d 6d 61 6e 64 3a 00 54 6f 20 67 65 74 20 74 68 65 20 77 68 6f 6c 65 20 roup).command:.To.get.the.whole.
8380 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2c 20 70 61 73 73 20 61 6e 20 65 6d 70 74 79 20 6c 69 73 configuration,.pass.an.empty.lis
83a0 74 20 74 6f 20 74 68 65 20 60 60 70 61 74 68 60 60 20 66 69 65 6c 64 00 54 6f 20 69 6e 63 6c 75 t.to.the.``path``.field.To.inclu
83c0 64 65 20 56 79 4f 53 20 73 70 65 63 69 66 69 63 20 66 75 6e 63 74 69 6f 6e 73 20 61 6e 64 20 61 de.VyOS.specific.functions.and.a
83e0 6c 69 61 73 65 73 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 60 60 73 6f 75 72 63 65 20 2f 6f 70 74 liases.you.need.to.``source./opt
8400 2f 76 79 61 74 74 61 2f 65 74 63 2f 66 75 6e 63 74 69 6f 6e 73 2f 73 63 72 69 70 74 2d 74 65 6d /vyatta/etc/functions/script-tem
8420 70 6c 61 74 65 60 60 20 66 69 6c 65 73 20 61 74 20 74 68 65 20 74 6f 70 20 6f 66 20 79 6f 75 72 plate``.files.at.the.top.of.your
8440 20 73 63 72 69 70 74 2e 00 54 6f 20 69 6e 69 74 69 61 74 65 20 61 20 72 65 62 6f 6f 74 20 75 73 .script..To.initiate.a.reboot.us
8460 65 20 74 68 65 20 60 60 72 65 62 6f 6f 74 60 60 20 65 6e 64 70 6f 69 6e 74 2e 00 54 6f 20 6d 61 e.the.``reboot``.endpoint..To.ma
8480 6b 65 20 73 75 72 65 20 74 68 61 74 20 61 20 73 63 72 69 70 74 20 69 73 20 6e 6f 74 20 61 63 63 ke.sure.that.a.script.is.not.acc
84a0 69 64 65 6e 74 61 6c 6c 79 20 63 61 6c 6c 65 64 20 77 69 74 68 6f 75 74 20 74 68 65 20 60 60 76 identally.called.without.the.``v
84c0 79 61 74 74 61 63 66 67 60 60 20 67 72 6f 75 70 2c 20 74 68 65 20 73 63 72 69 70 74 20 63 61 6e yattacfg``.group,.the.script.can
84e0 20 62 65 20 73 61 66 65 67 75 61 72 64 65 64 20 6c 69 6b 65 20 74 68 69 73 3a 00 54 6f 20 6f 6e .be.safeguarded.like.this:.To.on
8500 6c 79 20 67 65 74 20 61 20 70 61 72 74 20 6f 66 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 ly.get.a.part.of.the.configurati
8520 6f 6e 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 20 60 60 73 79 73 74 65 6d 20 73 79 73 6c 6f 67 60 on,.for.example.``system.syslog`
8540 60 2e 00 54 6f 20 70 6f 77 65 72 20 6f 66 66 20 74 68 65 20 73 79 73 74 65 6d 20 75 73 65 20 74 `..To.power.off.the.system.use.t
8560 68 65 20 60 60 70 6f 77 65 72 6f 66 66 60 60 20 65 6e 64 70 6f 69 6e 74 2e 00 54 72 6f 75 62 6c he.``poweroff``.endpoint..Troubl
8580 65 73 68 6f 6f 74 69 6e 67 00 55 6e 6c 69 6b 65 20 61 20 6e 6f 72 6d 61 6c 20 63 6f 6e 66 69 67 eshooting.Unlike.a.normal.config
85a0 75 72 61 74 69 6f 6e 20 73 65 73 73 69 6f 6e 2c 20 61 6c 6c 20 6f 70 65 72 61 74 69 6f 6e 61 6c uration.session,.all.operational
85c0 20 63 6f 6d 6d 61 6e 64 73 20 6d 75 73 74 20 62 65 20 70 72 65 70 65 6e 64 65 64 20 77 69 74 68 .commands.must.be.prepended.with
85e0 20 60 60 72 75 6e 60 60 2c 20 65 76 65 6e 20 69 66 20 79 6f 75 20 68 61 76 65 6e 27 74 20 63 72 .``run``,.even.if.you.haven't.cr
8600 65 61 74 65 64 20 61 20 73 65 73 73 69 6f 6e 20 77 69 74 68 20 63 6f 6e 66 69 67 75 72 65 2e 00 eated.a.session.with.configure..
8620 55 73 65 72 2d 64 61 74 61 00 55 73 65 72 2d 64 61 74 61 20 2d 20 55 73 65 72 2d 64 61 74 61 20 User-data.User-data.-.User-data.
8640 69 73 20 73 70 65 63 69 66 69 65 64 20 62 79 20 74 68 65 20 75 73 65 72 2e 20 54 68 69 73 20 63 is.specified.by.the.user..This.c
8660 6f 6e 66 69 67 20 73 6f 75 72 63 65 20 6f 66 66 65 72 73 20 74 68 65 20 61 62 69 6c 69 74 79 20 onfig.source.offers.the.ability.
8680 74 6f 20 69 6e 73 65 72 74 20 61 6e 79 20 43 4c 49 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 to.insert.any.CLI.configuration.
86a0 63 6f 6d 6d 61 6e 64 73 20 69 6e 74 6f 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 commands.into.the.configuration.
86c0 62 65 66 6f 72 65 20 74 68 65 20 66 69 72 73 74 20 62 6f 6f 74 2e 00 55 73 69 6e 67 20 41 50 49 before.the.first.boot..Using.API
86e0 20 52 65 73 70 6f 6e 73 65 20 43 6c 61 73 73 00 55 73 69 6e 67 20 50 79 56 79 4f 53 00 56 4d 20 .Response.Class.Using.PyVyOS.VM.
8700 49 44 3a 20 69 6e 20 74 68 69 73 20 65 78 61 6d 70 6c 65 2c 20 56 4d 20 49 44 20 75 73 65 64 20 ID:.in.this.example,.VM.ID.used.
8720 69 73 20 35 35 35 2e 00 56 4d 20 52 65 73 6f 75 72 63 65 73 3a 20 74 68 65 73 65 20 70 61 72 61 is.555..VM.Resources:.these.para
8740 6d 65 74 65 72 73 20 63 61 6e 20 62 65 20 6d 6f 64 69 66 69 65 64 20 61 73 20 6e 65 65 64 65 64 meters.can.be.modified.as.needed
8760 2e 00 56 4d 20 53 74 6f 72 61 67 65 3a 20 60 60 6c 6f 63 61 6c 60 60 20 76 6f 6c 75 6d 65 20 69 ..VM.Storage:.``local``.volume.i
8780 73 20 75 73 65 64 2e 00 56 79 4f 53 20 41 50 49 00 56 79 4f 53 20 41 75 74 6f 6d 61 74 69 6f 6e s.used..VyOS.API.VyOS.Automation
87a0 00 56 79 4f 53 20 60 63 6c 6f 75 64 2d 69 6e 69 74 2d 64 6f 63 73 60 5f 2e 00 56 79 4f 53 20 63 .VyOS.`cloud-init-docs`_..VyOS.c
87c0 6c 6f 75 64 2d 69 6e 69 74 00 56 79 4f 53 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d loud-init.VyOS.configuration.com
87e0 6d 61 6e 64 73 20 61 72 65 20 64 65 66 69 6e 65 64 20 69 6e 20 75 73 65 72 2d 64 61 74 61 20 66 mands.are.defined.in.user-data.f
8800 69 6c 65 2e 00 56 79 4f 53 20 68 61 73 20 74 68 65 20 61 62 69 6c 69 74 79 20 74 6f 20 72 75 6e ile..VyOS.has.the.ability.to.run
8820 20 63 75 73 74 6f 6d 20 20 73 63 72 69 70 74 73 20 62 65 66 6f 72 65 20 61 6e 64 20 61 66 74 65 .custom..scripts.before.and.afte
8840 72 20 65 61 63 68 20 63 6f 6d 6d 69 74 00 56 79 4f 53 20 73 75 70 70 6f 72 74 20 74 68 72 65 65 r.each.commit.VyOS.support.three
8860 20 74 79 70 65 73 20 6f 66 20 63 6f 6e 66 69 67 20 73 6f 75 72 63 65 73 2e 00 56 79 4f 53 20 73 .types.of.config.sources..VyOS.s
8880 75 70 70 6f 72 74 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 76 69 61 20 61 6e 73 69 62 6c upports.configuration.via.ansibl
88a0 65 2e 20 4e 65 65 64 20 74 6f 20 69 6e 73 74 61 6c 6c 20 60 60 61 6e 73 69 62 6c 65 60 60 20 61 e..Need.to.install.``ansible``.a
88c0 6e 64 20 60 60 70 79 74 68 6f 6e 33 2d 70 61 72 61 6d 69 6b 6f 60 60 20 6d 6f 64 75 6c 65 00 56 nd.``python3-paramiko``.module.V
88e0 79 4f 53 20 73 75 70 70 6f 72 74 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 76 69 61 20 6e yOS.supports.configuration.via.n
8900 65 74 6d 69 6b 6f 5f 2e 20 49 74 20 72 65 71 75 69 72 65 73 20 74 6f 20 69 6e 73 74 61 6c 6c 20 etmiko_..It.requires.to.install.
8920 60 60 70 79 74 68 6f 6e 33 2d 6e 65 74 6d 69 6b 6f 60 60 20 6d 6f 64 75 6c 65 2e 00 56 79 4f 53 ``python3-netmiko``.module..VyOS
8940 20 73 75 70 70 6f 72 74 73 20 65 78 65 63 75 74 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f .supports.executing.configuratio
8960 6e 20 61 6e 64 20 6f 70 65 72 61 74 69 6f 6e 61 6c 20 63 6f 6d 6d 61 6e 64 73 20 6e 6f 6e 2d 69 n.and.operational.commands.non-i
8980 6e 74 65 72 61 63 74 69 76 65 6c 79 20 66 72 6f 6d 20 73 68 65 6c 6c 20 73 63 72 69 70 74 73 2e nteractively.from.shell.scripts.
89a0 00 56 79 4f 53 20 73 75 70 70 6f 72 74 73 20 6f 70 2d 6d 6f 64 65 20 61 6e 64 20 63 6f 6e 66 69 .VyOS.supports.op-mode.and.confi
89c0 67 75 72 61 74 69 6f 6e 20 76 69 61 20 73 61 6c 74 5f 2e 00 56 79 4f 53 20 73 75 70 70 6f 72 74 guration.via.salt_..VyOS.support
89e0 73 20 73 6f 6d 65 20 6e 61 70 61 6c 6d 5f 20 66 75 6e 63 74 69 6f 6e 73 20 66 6f 72 20 63 6f 6e s.some.napalm_.functions.for.con
8a00 66 69 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 6f 70 2d 6d 6f 64 65 2e 20 49 74 20 72 65 71 75 69 figuration.and.op-mode..It.requi
8a20 72 65 73 20 6d 6f 72 65 20 74 65 73 74 73 2e 00 56 79 4f 53 20 73 75 70 70 6f 72 74 73 20 74 68 res.more.tests..VyOS.supports.th
8a40 65 20 65 78 65 63 75 74 69 6f 6e 20 6f 66 20 6f 70 65 72 61 74 69 6f 6e 61 6c 20 63 6f 6d 6d 61 e.execution.of.operational.comma
8a60 6e 64 73 20 61 6e 64 20 6c 69 6e 75 78 20 63 6f 6d 6d 61 6e 64 73 20 61 74 20 69 6e 69 74 69 61 nds.and.linux.commands.at.initia
8a80 6c 20 62 6f 6f 74 2e 20 54 68 69 73 20 69 73 20 61 63 63 6f 6d 70 6c 69 73 68 65 64 20 75 73 69 l.boot..This.is.accomplished.usi
8aa0 6e 67 20 60 60 77 72 69 74 65 5f 66 69 6c 65 73 60 60 20 74 6f 20 63 65 72 74 61 69 6e 20 66 69 ng.``write_files``.to.certain.fi
8ac0 6c 65 73 20 69 6e 20 74 68 65 20 2f 6f 70 74 2f 76 79 61 74 74 61 2f 65 74 63 2f 63 6f 6e 66 69 les.in.the./opt/vyatta/etc/confi
8ae0 67 2f 73 63 72 69 70 74 73 20 64 69 72 65 63 74 6f 72 79 2e 20 43 6f 6d 6d 61 6e 64 73 20 73 70 g/scripts.directory..Commands.sp
8b00 65 63 69 66 69 65 64 20 69 6e 20 6f 70 74 2f 76 79 61 74 74 61 2f 65 74 63 2f 63 6f 6e 66 69 67 ecified.in.opt/vyatta/etc/config
8b20 2f 73 63 72 69 70 74 73 2f 76 79 6f 73 2d 70 72 65 63 6f 6e 66 69 67 2d 62 6f 6f 74 75 70 2e 73 /scripts/vyos-preconfig-bootup.s
8b40 63 72 69 70 74 20 61 72 65 20 65 78 65 63 75 74 65 64 20 70 72 69 6f 72 20 74 6f 20 63 6f 6e 66 cript.are.executed.prior.to.conf
8b60 69 67 75 72 61 74 69 6f 6e 2e 20 54 68 65 20 2f 6f 70 74 2f 76 79 61 74 74 61 2f 65 74 63 2f 63 iguration..The./opt/vyatta/etc/c
8b80 6f 6e 66 69 67 2f 73 63 72 69 70 74 73 2f 76 79 6f 73 2d 70 6f 73 74 63 6f 6e 66 69 67 2d 62 6f onfig/scripts/vyos-postconfig-bo
8ba0 6f 74 75 70 2e 73 63 72 69 70 74 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 73 20 63 6f 6d 6d 61 6e otup.script.file.contains.comman
8bc0 64 73 20 74 6f 20 62 65 20 65 78 65 63 75 74 65 64 20 61 66 74 65 72 20 63 6f 6e 66 69 67 75 72 ds.to.be.executed.after.configur
8be0 61 74 69 6f 6e 2e 20 49 6e 20 62 6f 74 68 20 63 61 73 65 73 2c 20 63 6f 6d 6d 61 6e 64 73 20 61 ation..In.both.cases,.commands.a
8c00 72 65 20 65 78 65 63 75 74 65 64 20 61 73 20 74 68 65 20 72 6f 6f 74 20 75 73 65 72 2e 00 57 65 re.executed.as.the.root.user..We
8c20 20 6e 65 65 64 20 32 20 66 69 6c 65 73 2c 20 63 6f 6d 6d 61 6e 64 73 2e 63 6f 6e 66 20 61 6e 64 .need.2.files,.commands.conf.and
8c40 20 73 63 72 69 70 74 20 69 74 73 65 6c 66 2e 00 57 68 69 6c 65 20 6f 74 68 65 72 20 6d 65 74 68 .script.itself..While.other.meth
8c60 6f 64 73 20 65 78 69 73 74 2c 20 74 68 65 20 6d 6f 73 74 20 73 74 72 61 69 67 68 74 66 6f 72 77 ods.exist,.the.most.straightforw
8c80 61 72 64 20 6d 65 74 68 6f 64 20 66 6f 72 20 75 73 69 6e 67 20 74 68 65 20 4e 6f 43 6c 6f 75 64 ard.method.for.using.the.NoCloud
8ca0 20 64 61 74 61 20 73 6f 75 72 63 65 20 69 73 20 63 72 65 61 74 69 6e 67 20 61 20 73 65 65 64 20 .data.source.is.creating.a.seed.
8cc0 49 53 4f 20 61 6e 64 20 61 74 74 61 63 68 69 6e 67 20 69 74 20 74 6f 20 74 68 65 20 76 69 72 74 ISO.and.attaching.it.to.the.virt
8ce0 75 61 6c 20 6d 61 63 68 69 6e 65 20 61 73 20 61 20 43 44 20 64 72 69 76 65 2e 20 54 68 65 20 76 ual.machine.as.a.CD.drive..The.v
8d00 6f 6c 75 6d 65 20 6d 75 73 74 20 62 65 20 66 6f 72 6d 61 74 74 65 64 20 61 73 20 61 20 76 66 61 olume.must.be.formatted.as.a.vfa
8d20 74 20 6f 72 20 49 53 4f 20 39 36 36 30 20 66 69 6c 65 20 73 79 73 74 65 6d 20 77 69 74 68 20 74 t.or.ISO.9660.file.system.with.t
8d40 68 65 20 6c 61 62 65 6c 20 22 63 69 64 61 74 61 22 20 6f 72 20 22 43 49 44 41 54 41 22 2e 00 57 he.label."cidata".or."CIDATA"..W
8d60 69 6c 6c 20 72 65 74 75 72 6e 3a 00 57 69 74 68 20 74 68 65 20 60 60 72 65 74 72 69 65 76 65 60 ill.return:.With.the.``retrieve`
8d80 60 20 65 6e 64 70 6f 69 6e 74 20 79 6f 75 20 67 65 74 20 70 61 72 74 73 20 6f 72 20 74 68 65 20 `.endpoint.you.get.parts.or.the.
8da0 77 68 6f 6c 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 00 57 69 74 68 6f 75 74 20 70 72 6f whole.configuration..Without.pro
8dc0 78 79 20 69 74 20 72 65 71 75 69 72 65 73 20 56 79 4f 53 20 6d 69 6e 69 6f 6e 20 63 6f 6e 66 69 xy.it.requires.VyOS.minion.confi
8de0 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 73 75 70 70 6f 72 74 20 6f 70 2d 6d 6f 64 65 20 64 61 74 guration.and.support.op-mode.dat
8e00 61 3a 00 57 69 74 68 6f 75 74 20 70 72 6f 78 79 20 69 74 20 72 65 71 75 69 72 65 73 20 56 79 4f a:.Without.proxy.it.requires.VyO
8e20 53 20 6d 69 6e 69 6f 6e 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 73 75 70 70 6f S.minion.configuration.and.suppo
8e40 72 74 73 20 6f 70 2d 6d 6f 64 65 20 64 61 74 61 3a 00 59 6f 75 20 63 61 6e 20 69 6e 73 74 61 6c rts.op-mode.data:.You.can.instal
8e60 6c 20 50 79 56 79 4f 53 20 75 73 69 6e 67 20 70 69 70 3a 00 59 6f 75 20 63 61 6e 20 70 61 73 73 l.PyVyOS.using.pip:.You.can.pass
8e80 20 61 20 60 60 73 65 74 60 60 2c 20 60 60 64 65 6c 65 74 65 60 60 20 6f 72 20 60 60 63 6f 6d 6d .a.``set``,.``delete``.or.``comm
8ea0 65 6e 74 60 60 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 74 68 65 20 60 60 2f 63 6f 6e 66 69 67 75 72 ent``.command.to.the.``/configur
8ec0 65 60 60 20 65 6e 64 70 6f 69 6e 74 2e 00 60 60 64 65 6c 65 74 65 60 60 20 61 20 73 69 6e 67 6c e``.endpoint..``delete``.a.singl
8ee0 65 20 63 6f 6d 6d 61 6e 64 00 60 60 73 65 65 64 2e 69 73 6f 60 60 20 77 61 73 20 70 72 65 76 69 e.command.``seed.iso``.was.previ
8f00 6f 75 73 6c 79 20 63 72 65 61 74 65 64 20 69 6e 20 64 69 72 65 63 74 6f 72 79 20 60 60 2f 74 6d ously.created.in.directory.``/tm
8f20 70 2f 60 60 2e 20 49 74 27 73 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 6d 6f 76 65 20 69 74 20 p/``..It's.necessary.to.move.it.
8f40 74 6f 20 60 60 2f 76 61 72 2f 6c 69 62 2f 76 7a 2f 74 65 6d 70 6c 61 74 65 2f 69 73 6f 60 60 00 to.``/var/lib/vz/template/iso``.
8f60 60 60 73 65 74 60 60 20 61 20 73 69 6e 67 6c 65 20 63 6f 6d 6d 61 6e 64 00 60 60 76 79 6f 73 5f ``set``.a.single.command.``vyos_
8f80 75 73 65 72 64 61 74 61 60 60 20 2d 20 74 68 65 20 6d 6f 64 75 6c 65 20 61 63 63 65 70 74 73 20 userdata``.-.the.module.accepts.
8fa0 61 20 6c 69 73 74 20 6f 66 20 43 4c 49 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d a.list.of.CLI.configuration.comm
8fc0 61 6e 64 73 20 69 6e 20 61 20 60 60 76 79 6f 73 5f 63 6f 6e 66 69 67 5f 63 6f 6d 6d 61 6e 64 73 ands.in.a.``vyos_config_commands
8fe0 60 60 20 73 65 63 74 69 6f 6e 2c 20 77 68 69 63 68 20 67 69 76 65 73 20 61 6e 20 65 61 73 79 20 ``.section,.which.gives.an.easy.
9000 77 61 79 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 74 68 65 20 73 79 73 74 65 6d 20 64 75 72 69 way.to.configure.the.system.duri
9020 6e 67 20 64 65 70 6c 6f 79 6d 65 6e 74 2e 00 60 60 76 79 6f 73 60 60 2f 60 60 76 79 6f 73 60 60 ng.deployment..``vyos``/``vyos``
9040 20 63 72 65 64 65 6e 74 69 61 6c 73 20 69 66 20 6e 6f 20 6f 74 68 65 72 73 20 73 70 65 63 69 66 .credentials.if.no.others.specif
9060 69 65 64 20 62 79 20 64 61 74 61 20 73 6f 75 72 63 65 2e 00 60 60 77 72 69 74 65 5f 66 69 6c 65 ied.by.data.source..``write_file
9080 73 60 60 20 2d 20 74 68 69 73 20 6d 6f 64 75 6c 65 20 61 6c 6c 6f 77 73 20 74 6f 20 69 6e 73 65 s``.-.this.module.allows.to.inse
90a0 72 74 20 61 6e 79 20 66 69 6c 65 73 20 69 6e 74 6f 20 74 68 65 20 66 69 6c 65 73 79 73 74 65 6d rt.any.files.into.the.filesystem
90c0 20 62 65 66 6f 72 65 20 74 68 65 20 66 69 72 73 74 20 62 6f 6f 74 2c 20 66 6f 72 20 65 78 61 6d .before.the.first.boot,.for.exam
90e0 70 6c 65 2c 20 70 72 65 2d 67 65 6e 65 72 61 74 65 64 20 65 6e 63 72 79 70 74 69 6f 6e 20 6b 65 ple,.pre-generated.encryption.ke
9100 79 73 2c 20 63 65 72 74 69 66 69 63 61 74 65 73 2c 20 6f 72 20 65 76 65 6e 20 61 20 77 68 6f 6c ys,.certificates,.or.even.a.whol
9120 65 20 60 60 63 6f 6e 66 69 67 2e 62 6f 6f 74 60 60 20 66 69 6c 65 2e 20 54 68 65 20 66 6f 72 6d e.``config.boot``.file..The.form
9140 61 74 20 69 73 20 64 65 73 63 72 69 62 65 64 20 69 6e 20 74 68 65 20 63 6c 6f 75 64 69 6e 69 74 at.is.described.in.the.cloudinit
9160 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 60 43 6c 6f 75 64 2d 69 6e 69 74 2d 77 72 69 74 65 .documentation.`Cloud-init-write
9180 5f 66 69 6c 65 73 60 5f 2e 00 61 64 64 20 61 6e 20 69 6d 61 67 65 00 61 6e 73 69 62 6c 65 2e 63 _files`_..add.an.image.ansible.c
91a0 66 67 00 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 20 66 69 6c 65 20 66 6f 72 6d 61 74 00 63 6c 6f 75 fg.cloud-config.file.format.clou
91c0 64 2d 69 6e 69 74 20 6c 6f 67 73 20 74 6f 20 2f 76 61 72 2f 6c 6f 67 2f 63 6c 6f 75 64 2d 69 6e d-init.logs.to./var/log/cloud-in
91e0 69 74 2e 6c 6f 67 2e 20 54 68 69 73 20 66 69 6c 65 20 63 61 6e 20 62 65 20 68 65 6c 70 66 75 6c it.log..This.file.can.be.helpful
9200 20 69 6e 20 64 65 74 65 72 6d 69 6e 69 6e 67 20 77 68 79 20 74 68 65 20 63 6f 6e 66 69 67 75 72 .in.determining.why.the.configur
9220 61 74 69 6f 6e 20 76 61 72 69 65 73 20 66 72 6f 6d 20 77 68 61 74 20 79 6f 75 20 65 78 70 65 63 ation.varies.from.what.you.expec
9240 74 2e 20 59 6f 75 20 63 61 6e 20 66 65 74 63 68 20 74 68 65 20 6d 6f 73 74 20 69 6d 70 6f 72 74 t..You.can.fetch.the.most.import
9260 61 6e 74 20 64 61 74 61 20 66 69 6c 74 65 72 69 6e 67 20 6f 75 74 70 75 74 20 66 6f 72 20 60 60 ant.data.filtering.output.for.``
9280 76 79 6f 73 60 60 20 6b 65 79 77 6f 72 64 3a 00 63 6f 6d 6d 61 6e 64 73 2e 74 78 74 00 64 65 6c vyos``.keyword:.commands.txt.del
92a0 65 74 65 20 61 6e 20 69 6d 61 67 65 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 20 60 60 31 2e 33 2d ete.an.image,.for.example.``1.3-
92c0 72 6f 6c 6c 69 6e 67 2d 32 30 32 30 30 36 30 37 30 31 31 37 60 60 00 68 6f 73 74 73 00 69 64 5f rolling-202006070117``.hosts.id_
92e0 72 73 61 5f 64 6f 63 6b 65 72 2e 70 75 62 2e 20 4e 65 65 64 73 20 74 6f 20 64 65 63 6c 61 72 65 rsa_docker.pub..Needs.to.declare
9300 20 6f 6e 6c 79 20 70 75 62 6c 69 63 20 6b 65 79 20 65 78 61 63 74 6c 79 2e 00 69 66 20 79 6f 75 .only.public.key.exactly..if.you
9320 20 6a 75 73 74 20 77 61 6e 74 20 74 68 65 20 56 61 6c 75 65 20 6f 66 20 61 20 6d 75 6c 74 69 2d .just.want.the.Value.of.a.multi-
9340 76 61 6c 75 65 64 20 6e 6f 64 65 2c 20 75 73 65 20 74 68 65 20 60 60 72 65 74 75 72 6e 56 61 6c valued.node,.use.the.``returnVal
9360 75 65 73 60 60 20 6f 70 65 72 61 74 69 6f 6e 2e 00 6d 61 69 6e 2e 79 6d 6c 00 72 31 31 2d 70 72 ues``.operation..main.yml.r11-pr
9380 6f 78 79 2e 73 6c 73 20 49 6e 63 6c 75 64 65 73 20 70 61 72 61 6d 65 74 65 72 73 20 66 6f 72 20 oxy.sls.Includes.parameters.for.
93a0 63 6f 6e 6e 65 63 74 69 6e 67 20 74 6f 20 73 61 6c 74 2d 70 72 6f 78 79 20 6d 69 6e 69 6f 6e 00 connecting.to.salt-proxy.minion.
93c0 73 74 61 72 74 75 70 20 73 63 72 69 70 74 73 00 74 6f 70 2e 73 6c 73 00 startup.scripts.top.sls.