HTML5 Gateway Docker versiooni installimine¶
Dockeri kujutise importimine¶
Enne HTML5 Gateway Docker konteineri loomist peate importima Dockeri kujutise. Selleks avage kest, kus teil on saadaval Dockeri käsud ja fail cleanroom-html5-4.6.1-33-v2.tgz. Käivitage kestas järgmine käsk, kohandades TGZ-faili teed, kui see pole praeguses kataloogis:
1 | |
Seejärel kontrollige järgmise käsuga, kas importimine õnnestus:
1 | |
Oodatav väljund on järgmine. Kui see nii pole, on importimine nurjunud:
1 2 3 4 5 6 | |
Täielik väljund
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 | |
Konteineri konfiguratsioon¶
Keskkonnamuutujad¶
Muutujad pairingu abil juurutamiseks¶
| Nimi | Kohustuslik | Vaikeväärtus | Kommentaar |
|---|---|---|---|
ENV_MEDIATION |
JAH | Kasutatakse pairingu ühenduse jaoks. Näitab DNS-nime või IP-aadressi CyberElements Bastion platvormi veebiliidesega ühenduse loomiseks. |
|
ENV_TOKEN |
JAH | Kasutatakse pairingu ühenduse puhul. Näitab pairingu tokenit, mida kasutatakse Mediation Controller teenusega ühenduse loomiseks. |
|
ENV_NO_CHECK_CERT |
EI | false |
Kasutatakse pairingu ühenduste jaoks. Kas Mediation Controller serveri veebisertifikaadi kontroll välja lülitada või mitte; kasulik CyberElements Bastion lahenduse puhul, kui juurdepääs toimub IP-aadressi kaudu või kui veebisertifikaat pole vaikimisi avalike sertifitseerimisasutuste tunnustatud sertifikaat. Aktsepteeritud väärtused: true või false. |
Muutujad käsitsi juurutamiseks¶
| Nimi | Kohustuslik | Vaikeväärtus | Kommentaar |
|---|---|---|---|
ENV_GW_CERT_NAME |
JAH | Kasutatakse käsitsi konfigureeritud ühenduse puhul. SSL Router teenusega ühenduse loomiseks kasutatava sertifikaadifaili nimi. |
|
ENV_GW_CERT_PASSWORD |
JAH | Kasutatakse käsitsi konfigureeritud ühenduse puhul. SSL Router teenusega ühenduse loomiseks kasutatava sertifikaadifaili parool. |
|
ENV_SSL_ROUTER_IP |
JAH | Kasutatakse käsitsi konfigureeritud ühenduse jaoks. Selle SSL Router komponendi IP-aadress või DNS-nimi, millega HTML5 Gateway ühenduse loob. |
|
ENV_SSL_ROUTER_PORT |
EI | 443 |
Kasutatakse käsitsi konfigureeritud ühenduse jaoks. Selle SSL Router komponendi port, millega HTML5 Gateway ühenduse loob. |
Muud muutujad¶
| Nimi | Kohustuslik | Vaikeväärtus | Kommentaar |
|---|---|---|---|
ENV_DISABLE_RSYSLOG |
EI | false |
Teenuse rsyslog väljalülitamine.Aktsepteeritud väärtused: true või false. |
Köited¶
| Köide | Kommentaar |
|---|---|
/etc/ipdiva/ |
HTML5 Gateway komponendi konfiguratsiooniköide. Soovitame selle ühendada nimega köitesse või hostarvuti failisüsteemi. |
/opt/certificates/ |
Köide, mis sisaldab HTML5 Gateway komponendi sertifikaati või sertifikaate, kui konfigureerimine toimub ilma pairinguta. |
/var/log/ |
Köide, mis sisaldab HTML5 Gateway komponendi logisid. |
Pordid¶
| Port | Kommentaar |
|---|---|
8080 |
HTML5-teenuse kuulamisport. |
HTML5 Gateway Docker versiooni juurutamine¶
Juurutamine pairingu abil¶
Eeltingimused
Enne HTML5 Gateway Docker versiooni juurutamist peate hankima pairingu tokeni.
Allpool kirjeldatud juurutamine kasutab kõiki saadaolevaid köiteid (välja arvatud /opt/certificates/, millest selles kontekstis kasu pole) ja avaldab kõik pordid.
Köited ühendatakse hostarvuti failisüsteemi asukohas HTML5_GATEWAY_REP. Selles asukohas on järgmised alamkataloogid:
- config
- log
Järgmiste käskude muutujaid saate kohandada:
| Kohandatud väärtus | Muutuja | Kommentaar |
|---|---|---|
DOCKER_NAME |
Dockeri konteineri nimi. | |
HTML5_GATEWAY_REP |
Failisüsteemi asukoht, kuhu köited ühendatakse. | |
ENV_MEDIATION_VALUE |
Keskkonnamuutuja ENV_MEDIATION väärtus. |
|
ENV_TOKEN_VALUE |
Keskkonnamuutuja ENV_TOKEN väärtus. |
|
ENV_NO_CHECK_CERT_VALUE |
Keskkonnamuutuja ENV_NO_CHECK_CERT väärtus. |
Looge kataloogipuu, mis on vajalik köidete ühendamiseks failisüsteemi:
1 2 | |
1 | |
Lõpuks käivitage uus konteiner:
1 2 3 4 5 6 7 8 | |
1 2 3 4 5 6 7 8 | |
Konteineri logisid saab vaadata järgmise käsuga:
1 | |
Käsitsi juurutamine¶
Eeltingimused
Enne HTML5 Gateway Docker versiooni juurutamist peab teil olema HTML5 Gateway komponendi jaoks nõutav sertifikaat.
Paroolid on nähtavad käsuga docker inspect
Konteineri keskkonnamuutujad, sh sertifikaatide paroolid, jäävad loetavaks kõigile, kellel on lubatud Dockeri serveris käivitada käsku docker inspect. Seetõttu tuleks eelistada pairingu abil juurutamist, mis ei kasuta sertifikaadi parooli.
Allpool kirjeldatud juurutamine kasutab kõiki saadaolevaid köiteid ja avab kõik pordid.
Köited ühendatakse hostarvuti failisüsteemi asukohta MANUAL_REP. Selles asukohas on järgmised alamkaustad:
- config
- log
- certificates
Järgmiste käskude muutujaid saate kohandada:
| Kohandatud väärtus | Muutuja | Kommentaar |
|---|---|---|
MANUAL_NAME |
Dockeri konteineri nimi. | |
MANUAL_REP |
Failisüsteemi asukoht, kuhu köited ühendatakse. | |
ENV_GW_CERT_NAME_VALUE |
Keskkonnamuutuja ENV_GW_CERT_NAME väärtus. |
|
ENV_SSL_ROUTER_IP_VALUE |
Keskkonnamuutuja ENV_SSL_ROUTER_IP väärtus. |
|
ENV_SSL_ROUTER_PORT_VALUE |
Keskkonnamuutuja ENV_SSL_ROUTER_PORT väärtus. |
Looge kataloogipuu, mis on vajalik köidete ühendamiseks failisüsteemi:
1 2 3 | |
1 | |
Seejärel paigutage HTML5 Gateway komponendi ja salvestusteenuse sertifikaadid kataloogi MANUAL_REP/certificates.
Et sertifikaatide paroolid kesta ajalukku ei jääks, sisestage need praeguse seansi keskkonnamuutujatesse (sisestust ei kuvata):
1 2 | |
1 | |
Lõpuks käivitage uus konteiner:
1 2 3 4 5 6 7 8 9 10 | |
1 2 3 4 5 6 7 8 9 10 | |
Kui konteiner on käivitunud, eemaldage need muutujad seansist:
1 | |
1 | |
Konteineri logisid saab vaadata järgmise käsuga:
1 | |
Mediation Controller serveri konfigureerimine¶
Selleks et uus HTML5 Gateway Docker oleks töövalmis, tuleb Mediation Controller server veel konfigureerida SSH- või konsoolijuurdepääsu kaudu root-lubadega.
See viimane säte on vajalik, et lubada Mediation Controller serveril HTML5-teenusega suhelda.
See konfiguratsioon erineb aga olenevalt HTML5 Gateway Docker versiooni asukohast:
Üldine skeem on järgmine:
flowchart LR
subgraph DMZ
direction TB
HTML5(HTML5 Gateway Docker)
MED(Mediation Controller)
end
subgraph LAN
GW(Edge Gateway)
end
MED -.-> |Ühendus HTML5-teenusega ; TCP 8080| HTML5
HTML5 --> |TLS Tunnel| MED
MED ~~~ GW
GW --> |TLS Tunnel| MED
GW ~~~ MED
linkStyle 0 stroke:#d22,color;
Selles kontekstis tuleb allpool toodud teave lisada faili /etc/ipdiva/httpd/commonParameters.extra.conf või see fail luua.
Sätteid saab kohandada:
| Kohandatud väärtus | Muutuja | Kommentaar |
|---|---|---|
HTML5_URL_DMZ |
URL, mis konfigureeriti HTML5 Gateway komponendi deklareerimisel halduskonsoolis. | |
HTML5_IP_DMZ |
Selle Dockeri serveri DNS-nimi või IP-aadress, millel HTML5 Gateway Docker on aktiivne. | |
HTML5_PORT_DMZ |
Port, mille Dockeri server HTML5 Gateway Docker versiooni jaoks avaldab. |
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
Üldine skeem on järgmine:
flowchart LR
subgraph DMZ
direction TB
MED(Mediation Controller)
end
subgraph LAN
HTML5(HTML5 Gateway Docker)
GW(Edge Gateway)
end
MED -.- | Ühendus HTML5-teenusega ; TLS-tunneli kaudu| GW -.-> |Ühendus HTML5-teenusega ; TCP 8080| HTML5
HTML5 --> |TLS Tunnel| MED
GW --> |TLS Tunnel| MED
linkStyle 0,1 stroke:#d22,color;
Selles kontekstis tuleb allpool toodud teave lisada faili /etc/ipdiva/httpd/commonParameters.extra.conf või see fail luua.
Sätteid saab kohandada:
| Kohandatud väärtus | Muutuja | Kommentaar |
|---|---|---|
HTML5_URL_LAN |
URL, mis konfigureeriti HTML5 Gateway komponendi deklareerimisel halduskonsoolis. | |
GW_NAME_LAN |
HTML5-teenusega ühenduse loomiseks kasutatava Edge Gateway komponendi nimi. Rea lõpus olev püstkriips tuleb säilitada. | |
ORGANIZATION_NAME_LAN |
Selle organisatsiooni nimi, millega Edge Gateway ühenduse loob. | |
HTML5_IP_LAN |
Selle Dockeri serveri DNS-nimi või IP-aadress, millel HTML5 Gateway Docker on aktiivne. | |
HTML5_PORT_LAN |
Port, mille Dockeri server HTML5 Gateway Docker versiooni jaoks avaldab. |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | |
Näpunäide
Seda konfiguratsiooni saab kasutada ka järgmises olukorras, kus Edge Gateway Docker ja HTML5 Gateway Docker töötavad samas Dockeri võrgus:
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 -.- | Ühendus HTML5-teenusega ; TLS-tunneli kaudu| GW -.-> |Ühendus HTML5-teenusega ; TCP 8080 Dockeri võrgu kaudu| HTML5
HTML5 --> |TLS Tunnel| MED
GW --> |TLS Tunnel| MED
linkStyle 0,1 stroke:#d22,color;
Näide
Selles näites juurutame samasse Dockeri serverisse Edge Gateway komponendi ja HTML5 Gateway komponendi.
Näites kasutatud infrastruktuur on järgmine:
- Mediation Controller server
- Veebi-IP-aadress:
10.0.10.10 - Organisatsiooni nimi:
my-organization-name - Edge Gateway komponendi token:
YJ5N-JN05-N5LS-N26H-7JHA-HZ9R-BGJF-MAVH - HTML5 Gateway komponendi token:
ATCW-OMVR-0RY4-LW1M-D9G9-H5VF-WPX5-YCXF - HTML5-teenusele juurdepääsu URL:
HTML5_DOCKER
- Veebi-IP-aadress:
- Dockeri server
- Dockeri võrgu nimi:
cyberelements-cleanroom-network - Edge Gateway
- Nimi:
my-edge-gateway-docker - Juurasukoht failisüsteemis:
/opt/my-edge-gateway-docker
- Nimi:
- HTML5 Gateway
- Nimi:
my-html5-gateway-docker - Juurasukoht failisüsteemis:
/opt/my-html5-gateway-docker
- Nimi:
- Dockeri võrgu nimi:
Esmalt peate Dockeri serveris looma Dockeri köidete ühendamiseks kataloogistruktuuri:
1 2 3 4 5 6 | |
Seejärel looge bridge-tüüpi Dockeri võrk, et kaks konteinerit saaksid omavahel suhelda:
1 | |
Järgmiseks käivitage Edge Gateway konteiner. Pange tähele, et näites luuakse ühendus pairingu abil, juurdepääsuga Mediation Controller serverile selle IP-aadressi kaudu ja ilma sertifikaadikontrollita. Lisaks lisatakse parameeter --network, et määrata eelnevalt loodud Dockeri võrgu kasutamine:
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
Järgmiseks käivitage HTML5 Gateway konteiner. Pange tähele, et näites luuakse ühendus pairingu abil, juurdepääsuga Mediation Controller serverile selle IP-aadressi kaudu ja ilma sertifikaadikontrollita. Lisaks lisatakse parameeter --network, et määrata eelnevalt loodud Dockeri võrgu kasutamine, ja kuna juurdepääs HTML5-teenusele toimub Dockeri võrgu kaudu, pole pordi 8080 avaldamine vajalik:
1 2 3 4 5 6 7 8 | |
Lõpuks tuleb Mediation Controller serveri(te)s konfigureerida fail /etc/ipdiva/httpd/commonParameters.extra.conf. Lisada tuleks järgmine jaotis:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | |
Enne uute sätete rakendamist peate kontrollima, et uus konfiguratsioon ei põhjusta veebiserverile Apache2 blokeerivaid tõrkeid.
Selleks käivitage järgmine käsk:
1 | |
Kui tagastatakse Syntax OK, saab muudatused rakendada alloleva käsuga. Vastasel juhul kontrollige oma faili /etc/ipdiva/httpd/commonParameters.extra.conf konfiguratsiooni.
1 | |