Namestitev komponente HTML5 Gateway Docker¶
Uvoz slike Docker¶
Preden lahko ustvarite vsebnik HTML5 Gateway Docker, morate uvoziti sliko Docker. To naredite tako, da zaženete lupino, v kateri so vam na voljo ukazi Docker in datoteka cleanroom-html5-4.6.1-33-v2.tgz. V lupini zaženite naslednji ukaz in prilagodite pot do datoteke TGZ, če ta ni v trenutni mapi:
1 | |
Nato z naslednjim ukazom preverite, ali je bil uvoz uspešen:
1 | |
Pričakovani izpis je naslednji. Če ni tak, uvoz ni uspel:
1 2 3 4 5 6 | |
Celoten izhod
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 | |
Konfiguracija vsebnika¶
Okoljske spremenljivke¶
Spremenljivke za uvedbo s pairingom¶
| Ime | Obvezno | Privzeta vrednost | Opomba |
|---|---|---|---|
ENV_MEDIATION |
DA | Uporablja se za povezavo prek pairinga. Navaja ime DNS ali naslov IP za povezavo s spletnim vmesnikom platforme CyberElements Bastion. |
|
ENV_TOKEN |
DA | Uporablja se za povezavo s pairingom. Navedba tokena pairinga, ki se uporabi za povezavo s storitvijo Mediation Controller. |
|
ENV_NO_CHECK_CERT |
NE | false |
Uporablja se za povezave prek pairinga. Določa, ali se onemogoči preverjanje spletnega potrdila storitve Mediation Controller; uporabno s platformo CyberElements Bastion pri dostopu prek naslova IP ali kadar spletnega potrdila ne priznavajo privzeti javni overitelji potrdil. Sprejete vrednosti: true ali false. |
Spremenljivke za ročno uvedbo¶
| Ime | Obvezno | Privzeta vrednost | Opomba |
|---|---|---|---|
ENV_GW_CERT_NAME |
DA | Uporablja se za povezavo z ročno konfiguracijo. Ime datoteke potrdila za povezavo s komponento SSL Router. |
|
ENV_GW_CERT_PASSWORD |
DA | Uporablja se za povezavo z ročno konfiguracijo. Geslo datoteke potrdila za povezavo s komponento SSL Router. |
|
ENV_SSL_ROUTER_IP |
DA | Uporablja se za povezavo z ročno konfiguracijo. Naslov IP ali ime DNS komponente SSL Router, s katero se bo povezala komponenta HTML5 Gateway. |
|
ENV_SSL_ROUTER_PORT |
NE | 443 |
Uporablja se za povezavo z ročno konfiguracijo. Vrata komponente SSL Router, s katero se bo povezala komponenta HTML5 Gateway. |
Razne spremenljivke¶
| Ime | Obvezno | Privzeta vrednost | Opomba |
|---|---|---|---|
ENV_DISABLE_RSYSLOG |
NE | false |
Onemogočanje storitve rsyslog.Sprejete vrednosti: true ali false. |
Nosilci¶
| Nosilec | Opomba |
|---|---|
/etc/ipdiva/ |
Nosilec s konfiguracijo komponente HTML5 Gateway. Priporočamo, da ga vpnete v imenovani nosilec ali v datotečni sistem gostiteljskega računalnika. |
/opt/certificates/ |
Nosilec s potrdilom ali potrdili komponente HTML5 Gateway pri konfiguraciji brez pairinga. |
/var/log/ |
Nosilec z dnevniki komponente HTML5 Gateway. |
Vrata¶
| Vrata | Opomba |
|---|---|
8080 |
Vrata za poslušanje storitve HTML5. |
Uvedba komponente HTML5 Gateway Docker¶
Uvedba s pairingom¶
Predpogoji
Pred uvedbo komponente HTML5 Gateway Docker morate pridobiti token pairinga.
Spodaj opisana uvedba bo uporabila vse razpoložljive nosilce (razen /opt/certificates/, ki v tem kontekstu ni uporaben) in izpostavila vsa vrata.
Nosilci bodo vpeti v datotečni sistem gostiteljskega računalnika na lokaciji HTML5_GATEWAY_REP. Na tej lokaciji so naslednje podmape:
- config
- log
Spremenljivke za naslednje ukaze lahko prilagodite:
| Vrednost po meri | Spremenljivka | Komentar |
|---|---|---|
DOCKER_NAME |
Ime vsebnika Docker. | |
HTML5_GATEWAY_REP |
Lokacija v datotečnem sistemu, kamor bodo vpeti nosilci. | |
ENV_MEDIATION_VALUE |
Vrednost okoljske spremenljivke ENV_MEDIATION. |
|
ENV_TOKEN_VALUE |
Vrednost okoljske spremenljivke ENV_TOKEN. |
|
ENV_NO_CHECK_CERT_VALUE |
Vrednost okoljske spremenljivke ENV_NO_CHECK_CERT. |
Ustvarite drevo imenikov, potrebno za vpenjanje nosilcev v datotečni sistem:
1 2 | |
1 | |
In na koncu zaženite nov vsebnik:
1 2 3 4 5 6 7 8 | |
1 2 3 4 5 6 7 8 | |
Dnevnike vsebnika si lahko ogledate z naslednjim ukazom:
1 | |
Ročna uvedba¶
Predpogoji
Pred uvedbo komponente HTML5 Gateway Docker morate imeti potrdilo, ki ga zahteva komponenta HTML5 Gateway.
Gesla, vidna z ukazom docker inspect
Okoljske spremenljivke vsebnika, vključno z gesli potrdil, lahko prebere vsak, ki sme na strežniku Docker zagnati docker inspect. Zato je priporočljivo uporabiti uvedbo s pairingom, ki ne uporablja nobenega gesla potrdila.
Spodaj opisana uvedba bo uporabila vse razpoložljive nosilce in izpostavila vsa vrata.
Nosilci bodo vpeti v datotečni sistem gostiteljskega računalnika na mestu MANUAL_REP. Na tem mestu so naslednji podimeniki:
- config
- log
- certificates
Spremenljivke za naslednje ukaze lahko prilagodite:
| Vrednost po meri | Spremenljivka | Komentar |
|---|---|---|
MANUAL_NAME |
Ime vsebnika Docker. | |
MANUAL_REP |
Mesto v datotečnem sistemu, kamor se vpnejo nosilci. | |
ENV_GW_CERT_NAME_VALUE |
Vrednost okoljske spremenljivke ENV_GW_CERT_NAME. |
|
ENV_SSL_ROUTER_IP_VALUE |
Vrednost okoljske spremenljivke ENV_SSL_ROUTER_IP. |
|
ENV_SSL_ROUTER_PORT_VALUE |
Vrednost okoljske spremenljivke ENV_SSL_ROUTER_PORT. |
Ustvarite drevo imenikov, potrebno za vpenjanje nosilcev v datotečni sistem:
1 2 3 | |
1 | |
Nato potrdila za komponento HTML5 Gateway in storitev snemanja postavite v MANUAL_REP/certificates.
Da se gesla potrdil ne shranijo v zgodovino lupine, jih vnesite v okoljske spremenljivke trenutne seje (vnos ni prikazan):
1 2 | |
1 | |
Na koncu zaženite nov vsebnik:
1 2 3 4 5 6 7 8 9 10 | |
1 2 3 4 5 6 7 8 9 10 | |
Ko se vsebnik zažene, odstranite te spremenljivke iz seje:
1 | |
1 | |
Dnevnike vsebnika si lahko ogledate z naslednjim ukazom:
1 | |
Konfiguracija storitve Mediation Controller¶
Da bo novi HTML5 Gateway Docker deloval, morate prek SSH ali dostopa do konzole z dovoljenji root konfigurirati še strežnik Mediation Controller.
Ta zadnja nastavitev je potrebna, da lahko storitev Mediation Controller komunicira s storitvijo HTML5.
Ta konfiguracija pa se razlikuje glede na lokacijo komponente HTML5 Gateway Docker:
Splošni diagram je naslednji:
flowchart LR
subgraph DMZ
direction TB
HTML5(HTML5 Gateway Docker)
MED(Mediation Controller)
end
subgraph LAN
GW(Edge Gateway)
end
MED -.-> |Povezava s storitvijo HTML5 ; TCP 8080| HTML5
HTML5 --> |TLS Tunnel| MED
MED ~~~ GW
GW --> |TLS Tunnel| MED
GW ~~~ MED
linkStyle 0 stroke:#d22,color;
V tem kontekstu je treba spodnje informacije dodati v datoteko /etc/ipdiva/httpd/commonParameters.extra.conf ali to datoteko ustvariti.
Nastavitve lahko prilagodite:
| Vrednost po meri | Spremenljivka | Komentar |
|---|---|---|
HTML5_URL_DMZ |
URL, konfiguriran ob deklaraciji komponente HTML5 Gateway v skrbniški konzoli. | |
HTML5_IP_DMZ |
Ime DNS ali naslov IP strežnika Docker, na katerem je aktivna komponenta HTML5 Gateway Docker. | |
HTML5_PORT_DMZ |
Vrata, ki jih strežnik Docker objavi za komponento HTML5 Gateway Docker. |
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
Splošni diagram je naslednji:
flowchart LR
subgraph DMZ
direction TB
MED(Mediation Controller)
end
subgraph LAN
HTML5(HTML5 Gateway Docker)
GW(Edge Gateway)
end
MED -.- | Povezava s storitvijo HTML5 ; prek tunela TLS| GW -.-> |Povezava s storitvijo HTML5 ; TCP 8080| HTML5
HTML5 --> |TLS Tunnel| MED
GW --> |TLS Tunnel| MED
linkStyle 0,1 stroke:#d22,color;
V tem kontekstu je treba spodnje informacije dodati v datoteko /etc/ipdiva/httpd/commonParameters.extra.conf ali to datoteko ustvariti.
Nastavitve lahko prilagodite:
| Vrednost po meri | Spremenljivka | Komentar |
|---|---|---|
HTML5_URL_LAN |
URL, konfiguriran ob deklaraciji komponente HTML5 Gateway v skrbniški konzoli. | |
GW_NAME_LAN |
Ime komponente Edge Gateway, uporabljene za povezavo s storitvijo HTML5. Znak navpične črte na koncu vrstice je treba ohraniti. | |
ORGANIZATION_NAME_LAN |
Ime organizacije, s katero se povezuje komponenta Edge Gateway. | |
HTML5_IP_LAN |
Ime DNS ali naslov IP strežnika Docker, na katerem je aktivna komponenta HTML5 Gateway Docker. | |
HTML5_PORT_LAN |
Vrata, ki jih strežnik Docker objavi za komponento HTML5 Gateway Docker. |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | |
Nasvet
To konfiguracijo lahko uporabite tudi v naslednjem primeru, ko se komponenti Edge Gateway Docker in HTML5 Gateway Docker izvajata v istem omrežju Docker:
flowchart LR
subgraph DMZ
direction TB
MED(Mediation Controller)
end
subgraph LAN
subgraph docker[Docker Server]
HTML5([HTML5 Gateway Docker])
GW([Edge Gateway])
end
end
MED -.- | Povezava s storitvijo HTML5 ; prek tunela TLS| GW -.-> |Povezava s storitvijo HTML5 ; TCP 8080 prek omrežja Docker| HTML5
HTML5 --> |TLS Tunnel| MED
GW --> |TLS Tunnel| MED
linkStyle 0,1 stroke:#d22,color;
Primer
V tem primeru bomo na istem strežniku Docker uvedli komponenti Edge Gateway in HTML5 Gateway.
Infrastruktura, uporabljena v primeru, je naslednja:
- Strežnik Mediation Controller
- Spletni naslov IP:
10.0.10.10 - Ime organizacije:
my-organization-name - Token za Edge Gateway:
YJ5N-JN05-N5LS-N26H-7JHA-HZ9R-BGJF-MAVH - Token za HTML5 Gateway:
ATCW-OMVR-0RY4-LW1M-D9G9-H5VF-WPX5-YCXF - URL za dostop do storitve HTML5:
HTML5_DOCKER
- Spletni naslov IP:
- Strežnik Docker
- Ime omrežja Docker:
cyberelements-cleanroom-network - Edge Gateway
- Ime:
my-edge-gateway-docker - Korenska lokacija v datotečnem sistemu:
/opt/my-edge-gateway-docker
- Ime:
- HTML5 Gateway
- Ime:
my-html5-gateway-docker - Korenska lokacija v datotečnem sistemu:
/opt/my-html5-gateway-docker
- Ime:
- Ime omrežja Docker:
Najprej morate na strežniku Docker ustvariti drevesno strukturo map za vpenjanje nosilcev Docker:
1 2 3 4 5 6 | |
Nato ustvarite omrežje Docker vrste bridge, da lahko vsebnika komunicirata med seboj:
1 | |
Nato zaženite vsebnik Edge Gateway. Upoštevajte, da primer vzpostavi povezavo prek pairinga z dostopom do storitve Mediation Controller prek njenega naslova IP in brez preverjanja potrdila. Poleg tega je dodan parameter --network, ki določa uporabo prej ustvarjenega omrežja Docker:
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
Nato zaženite vsebnik HTML5 Gateway. Upoštevajte, da primer vzpostavi povezavo prek pairinga z dostopom do storitve Mediation Controller prek njenega naslova IP in brez preverjanja potrdila. Poleg tega je dodan parameter --network, ki določa uporabo prej ustvarjenega omrežja Docker, in ker bo dostop do storitve HTML5 potekal prek omrežja Docker, objava vrat 8080 ni potrebna:
1 2 3 4 5 6 7 8 | |
Na koncu morate konfigurirati datoteko /etc/ipdiva/httpd/commonParameters.extra.conf na strežniku ali strežnikih Mediation Controller. Dodati je treba naslednji razdelek:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | |
Preden uporabite nove nastavitve, morate preveriti, da nova konfiguracija ne povzroča blokirajočih napak za spletni strežnik Apache2.
To storite tako, da zaženete naslednji ukaz:
1 | |
Če je rezultat Syntax OK, lahko spremembe uveljavite s spodnjim ukazom. V nasprotnem primeru preverite konfiguracijo svoje datoteke /etc/ipdiva/httpd/commonParameters.extra.conf.
1 | |