HTML5 Gateway Docker instalēšana¶
Docker attēla importēšana¶
Pirms varat izveidot HTML5 Gateway Docker konteineru, ir jāimportē Docker attēls. Lai to izdarītu, atveriet čaulu, kurā jums ir pieejamas Docker komandas, kā arī fails cleanroom-html5-4.6.1-33-v2.tgz. Čaulā izpildiet šo komandu, pielāgojot ceļu uz TGZ failu, ja tas neatrodas pašreizējā direktorijā:
1 | |
Pēc tam ar šo komandu pārbaudiet, vai importēšana bija sekmīga:
1 | |
Paredzamā izvade ir šāda. Ja tā nav, importēšana nav izdevusies:
1 2 3 4 5 6 | |
Pilna izvade
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 | |
Konteinera konfigurācija¶
Vides mainīgie¶
Mainīgie izvietošanai, izmantojot pairing¶
| Nosaukums | Obligāts | Noklusējuma vērtība | Komentārs |
|---|---|---|---|
ENV_MEDIATION |
JĀ | Tiek izmantots pairing savienojumam. Norāda DNS nosaukumu vai IP adresi savienojumam ar CyberElements Bastion platformas tīmekļa saskarni. |
|
ENV_TOKEN |
JĀ | Tiek izmantots pairing savienojumam. Norāda pairing marķieri, kas jāizmanto savienojumam ar Mediation Controller. |
|
ENV_NO_CHECK_CERT |
NĒ | false |
Tiek izmantots pairing savienojumiem. Norāda, vai atspējot Mediation Controller tīmekļa sertifikāta pārbaudi; noder ar CyberElements Bastion, ja piekļuve notiek, izmantojot IP adresi, vai ja tīmekļa sertifikāts nav sertifikāts, ko atpazīst noklusējuma publiskās sertificēšanas iestādes. Pieņemtās vērtības: true vai false. |
Mainīgie manuālai izvietošanai¶
| Nosaukums | Obligāts | Noklusējuma vērtība | Komentārs |
|---|---|---|---|
ENV_GW_CERT_NAME |
JĀ | Tiek izmantots savienojumam ar manuālu konfigurāciju. Sertifikāta faila nosaukums savienojumam ar SSL Router. |
|
ENV_GW_CERT_PASSWORD |
JĀ | Tiek izmantots savienojumam ar manuālu konfigurāciju. Sertifikāta faila parole savienojumam ar SSL Router. |
|
ENV_SSL_ROUTER_IP |
JĀ | Tiek izmantots savienojumam ar manuālu konfigurāciju. Komponenta SSL Router IP adrese vai DNS nosaukums, ar kuru izveidos savienojumu HTML5 Gateway. |
|
ENV_SSL_ROUTER_PORT |
NĒ | 443 |
Tiek izmantots savienojumam ar manuālu konfigurāciju. Komponenta SSL Router ports, ar kuru izveidos savienojumu HTML5 Gateway. |
Dažādi mainīgie¶
| Nosaukums | Obligāts | Noklusējuma vērtība | Komentārs |
|---|---|---|---|
ENV_DISABLE_RSYSLOG |
NĒ | false |
Pakalpojuma rsyslog atspējošana.Pieņemamās vērtības: true vai false. |
Sējumi¶
| Sējums | Komentārs |
|---|---|
/etc/ipdiva/ |
HTML5 Gateway konfigurācijas sējums. Ieteicams to uzstādīt nosauktā sējumā vai resursdatora failu sistēmā. |
/opt/certificates/ |
Sējums, kurā ir HTML5 Gateway sertifikāts(-i), ja konfigurē bez pairing. |
/var/log/ |
Sējums, kurā ir HTML5 Gateway žurnāli. |
Porti¶
| Ports | Komentārs |
|---|---|
8080 |
HTML5 pakalpojuma klausīšanās ports. |
HTML5 Gateway Docker izvietošana¶
Izvietošana, izmantojot pairing¶
Priekšnosacījumi
Pirms HTML5 Gateway Docker izvietošanas ir jāiegūst pairing marķieris.
Tālāk aprakstītajā izvietošanā tiks izmantoti visi pieejamie sējumi (izņemot /opt/certificates/, kas šajā kontekstā nav noderīgs) un padarīti pieejami visi porti.
Sējumi tiks uzstādīti resursdatora failu sistēmā atrašanās vietā HTML5_GATEWAY_REP. Šajā atrašanās vietā ir šādi apakšdirektoriji:
- config
- log
Tālāk norādīto komandu mainīgos varat pielāgot:
| Pielāgotā vērtība | Mainīgais | Komentārs |
|---|---|---|
DOCKER_NAME |
Docker konteinera nosaukums. | |
HTML5_GATEWAY_REP |
Atrašanās vieta failu sistēmā, kurā uzstādīt sējumus. | |
ENV_MEDIATION_VALUE |
Vides mainīgā ENV_MEDIATION vērtība. |
|
ENV_TOKEN_VALUE |
Vides mainīgā ENV_TOKEN vērtība. |
|
ENV_NO_CHECK_CERT_VALUE |
Vides mainīgā ENV_NO_CHECK_CERT vērtība. |
Izveidojiet direktoriju koku, kas nepieciešams sējumu piemontēšanai failu sistēmā:
1 2 | |
1 | |
Un visbeidzot palaidiet jaunu konteineru:
1 2 3 4 5 6 7 8 | |
1 2 3 4 5 6 7 8 | |
Konteinera žurnālus var skatīt, izmantojot šo komandu:
1 | |
Manuāla izvietošana¶
Priekšnosacījumi
Pirms HTML5 Gateway Docker izvietošanas jums ir jābūt HTML5 Gateway nepieciešamajam sertifikātam.
Paroles, kas redzamas ar docker inspect
Konteinera vides mainīgos, tostarp sertifikātu paroles, var nolasīt ikviens, kam Docker serverī ir atļauts izpildīt docker inspect. Tāpēc ieteicams izmantot izvietošanu ar pairing, kurai nav vajadzīga sertifikāta parole.
Tālāk aprakstītā izvietošana izmantos visus pieejamos sējumus un padarīs pieejamus visus portus.
Sējumi tiks pievienoti resursdatora failu sistēmā vietā MANUAL_REP. Šajā vietā atrodas šādas apakšmapes:
- config
- log
- certificates
Tālāk norādīto komandu mainīgos varat pielāgot:
| Pielāgotā vērtība | Mainīgais | Komentārs |
|---|---|---|
MANUAL_NAME |
Docker konteinera nosaukums. | |
MANUAL_REP |
Vieta failu sistēmā, kur pievienot sējumus. | |
ENV_GW_CERT_NAME_VALUE |
Vides mainīgā ENV_GW_CERT_NAME vērtība. |
|
ENV_SSL_ROUTER_IP_VALUE |
Vides mainīgā ENV_SSL_ROUTER_IP vērtība. |
|
ENV_SSL_ROUTER_PORT_VALUE |
Vides mainīgā ENV_SSL_ROUTER_PORT vērtība. |
Izveidojiet direktoriju koku, kas nepieciešams sējumu piemontēšanai failu sistēmā:
1 2 3 | |
1 | |
Pēc tam ievietojiet HTML5 Gateway un ierakstīšanas pakalpojuma sertifikātus direktorijā MANUAL_REP/certificates.
Lai sertifikātu paroles netiktu saglabātas čaulas vēsturē, ievadiet tās pašreizējās sesijas vides mainīgajos (ievadītais netiek rādīts):
1 2 | |
1 | |
Visbeidzot palaidiet jaunu konteineru:
1 2 3 4 5 6 7 8 9 10 | |
1 2 3 4 5 6 7 8 9 10 | |
Kad konteiners ir palaists, noņemiet šos mainīgos no sesijas:
1 | |
1 | |
Konteinera žurnālus var skatīt, izmantojot šo komandu:
1 | |
Mediation Controller konfigurēšana¶
Lai jaunais HTML5 Gateway Docker būtu darbspējīgs, vēl ir jākonfigurē Mediation Controller serveris, izmantojot SSH vai konsoles piekļuvi un root atļaujas.
Šis pēdējais iestatījums ir nepieciešams, lai komponents Mediation Controller varētu sazināties ar HTML5 pakalpojumu.
Tomēr šī konfigurācija atšķiras atkarībā no HTML5 Gateway Docker atrašanās vietas:
Vispārējā shēma ir šāda:
flowchart LR
subgraph DMZ
direction TB
HTML5(HTML5 Gateway Docker)
MED(Mediation Controller)
end
subgraph LAN
GW(Edge Gateway)
end
MED -.-> |Savienojums ar HTML5 pakalpojumu ; TCP 8080| HTML5
HTML5 --> |TLS Tunnel| MED
MED ~~~ GW
GW --> |TLS Tunnel| MED
GW ~~~ MED
linkStyle 0 stroke:#d22,color;
Šajā kontekstā tālāk sniegtā informācija būs jāpievieno failam /etc/ipdiva/httpd/commonParameters.extra.conf vai šis fails jāizveido.
Iestatījumus var pielāgot:
| Pielāgotā vērtība | Mainīgais | Komentārs |
|---|---|---|
HTML5_URL_DMZ |
URL, kas konfigurēts, deklarējot HTML5 Gateway administrēšanas konsolē. | |
HTML5_IP_DMZ |
Tā Docker servera DNS nosaukums vai IP adrese, kurā ir aktīvs HTML5 Gateway Docker. | |
HTML5_PORT_DMZ |
Ports, ko Docker serveris publicē HTML5 Gateway Docker vajadzībām. |
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
Vispārējā shēma ir šāda:
flowchart LR
subgraph DMZ
direction TB
MED(Mediation Controller)
end
subgraph LAN
HTML5(HTML5 Gateway Docker)
GW(Edge Gateway)
end
MED -.- | Savienojums ar HTML5 pakalpojumu ; caur TLS tuneli| GW -.-> |Savienojums ar HTML5 pakalpojumu ; TCP 8080| HTML5
HTML5 --> |TLS Tunnel| MED
GW --> |TLS Tunnel| MED
linkStyle 0,1 stroke:#d22,color;
Šajā kontekstā tālāk sniegtā informācija būs jāpievieno failam /etc/ipdiva/httpd/commonParameters.extra.conf vai šis fails jāizveido.
Iestatījumus var pielāgot:
| Pielāgotā vērtība | Mainīgais | Komentārs |
|---|---|---|
HTML5_URL_LAN |
URL, kas konfigurēts, deklarējot HTML5 Gateway administrēšanas konsolē. | |
GW_NAME_LAN |
Tā Edge Gateway nosaukums, ko izmanto savienojumam ar HTML5 pakalpojumu. Vertikālās joslas rakstzīme rindas beigās ir jāsaglabā. | |
ORGANIZATION_NAME_LAN |
Tās organizācijas nosaukums, ar kuru izveido savienojumu Edge Gateway. | |
HTML5_IP_LAN |
Tā Docker servera DNS nosaukums vai IP adrese, kurā ir aktīvs HTML5 Gateway Docker. | |
HTML5_PORT_LAN |
Ports, ko Docker serveris publicē HTML5 Gateway Docker vajadzībām. |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | |
Padoms
Šo konfigurāciju var izmantot arī tālāk aprakstītajā situācijā, kad Docker Edge Gateway un Docker HTML5 Gateway darbojas vienā Docker tīklā:
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 -.- | Savienojums ar HTML5 pakalpojumu ; caur TLS tuneli| GW -.-> |Savienojums ar HTML5 pakalpojumu ; TCP 8080 caur Docker tīklu| HTML5
HTML5 --> |TLS Tunnel| MED
GW --> |TLS Tunnel| MED
linkStyle 0,1 stroke:#d22,color;
Piemērs
Šajā piemērā mēs izvietosim Edge Gateway un HTML5 Gateway vienā Docker serverī.
Piemērā izmantotā infrastruktūra ir šāda:
- Mediation Controller serveris
- Tīmekļa IP adrese:
10.0.10.10 - Organizācijas nosaukums:
my-organization-name - Edge Gateway marķieris:
YJ5N-JN05-N5LS-N26H-7JHA-HZ9R-BGJF-MAVH - HTML5 Gateway marķieris:
ATCW-OMVR-0RY4-LW1M-D9G9-H5VF-WPX5-YCXF - URL piekļuvei HTML5 pakalpojumam:
HTML5_DOCKER
- Tīmekļa IP adrese:
- Docker serveris
- Docker tīkla nosaukums:
cyberelements-cleanroom-network - Edge Gateway
- Nosaukums:
my-edge-gateway-docker - Saknes atrašanās vieta failu sistēmā:
/opt/my-edge-gateway-docker
- Nosaukums:
- HTML5 Gateway
- Nosaukums:
my-html5-gateway-docker - Saknes atrašanās vieta failu sistēmā:
/opt/my-html5-gateway-docker
- Nosaukums:
- Docker tīkla nosaukums:
Vispirms Docker serverī ir jāizveido direktoriju struktūra Docker sējumu uzstādīšanai:
1 2 3 4 5 6 | |
Pēc tam izveidojiet bridge tipa Docker tīklu, lai abi konteineri varētu savstarpēji sazināties:
1 | |
Pēc tam startējiet Edge Gateway konteineru. Ņemiet vērā, ka piemērā savienojums tiek izveidots, izmantojot pairing, ar piekļuvi komponentam Mediation Controller, izmantojot tā IP adresi, un bez sertifikāta pārbaudes. Turklāt tiek pievienots parametrs --network, lai norādītu iepriekš izveidotā Docker tīkla izmantošanu:
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
Pēc tam startējiet HTML5 Gateway konteineru. Ņemiet vērā, ka piemērā savienojums tiek izveidots, izmantojot pairing, ar piekļuvi komponentam Mediation Controller, izmantojot tā IP adresi, un bez sertifikāta pārbaudes. Turklāt tiek pievienots parametrs --network, lai norādītu iepriekš izveidotā Docker tīkla izmantošanu, un, tā kā piekļuve HTML5 pakalpojumam notiks caur Docker tīklu, porta 8080 publicēšana nav nepieciešama:
1 2 3 4 5 6 7 8 | |
Visbeidzot ir jākonfigurē fails /etc/ipdiva/httpd/commonParameters.extra.conf Mediation Controller serverī(-os). Jāpievieno šāda sadaļa:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | |
Pirms jauno iestatījumu lietošanas jāpārbauda, vai jaunā konfigurācija neizraisa Apache2 tīmekļa servera bloķējošas kļūdas.
Lai to izdarītu, izpildiet šādu komandu:
1 | |
Ja tiek atgriezts Syntax OK, izmaiņas var lietot ar tālāk norādīto komandu. Pretējā gadījumā pārbaudiet sava faila /etc/ipdiva/httpd/commonParameters.extra.conf konfigurāciju.
1 | |