HTML5 Gateway Docker įdiegimas¶
Docker atvaizdo importavimas¶
Prieš kurdami HTML5 Gateway Docker konteinerį, turite importuoti Docker atvaizdą. Tam atidarykite apvalkalą, kuriame jums pasiekiamos Docker komandos ir failas cleanroom-html5-4.6.1-33-v2.tgz. Apvalkale paleiskite šią komandą, pakoreguodami kelią iki TGZ failo, jei jo nėra dabartiniame kataloge:
1 | |
Tada šia komanda patikrinkite, ar importavimas pavyko:
1 | |
Laukiama išvestis yra tokia. Jei taip nėra, importuoti nepavyko:
1 2 3 4 5 6 | |
Visa išvestis
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 | |
Konteinerio konfigūracija¶
Aplinkos kintamieji¶
Kintamieji diegimui naudojant pairing¶
| Pavadinimas | Privaloma | Numatytoji reikšmė | Komentaras |
|---|---|---|---|
ENV_MEDIATION |
TAIP | Naudojamas jungiantis per pairing. Nurodo DNS vardą arba IP adresą, skirtą prisijungti prie CyberElements Bastion platformos žiniatinklio sąsajos. |
|
ENV_TOKEN |
TAIP | Naudojama pairing ryšiui. Nurodo pairing tokeną, naudotiną jungiantis prie Mediation Controller. |
|
ENV_NO_CHECK_CERT |
NE | false |
Naudojamas jungiantis per pairing. Ar išjungti Mediation Controller žiniatinklio sertifikato tikrinimą; naudinga su CyberElements Bastion, kai jungiamasi per IP adresą arba kai žiniatinklio sertifikato nepripažįsta numatytosios viešosios sertifikavimo institucijos. Priimamos reikšmės: true arba false. |
Kintamieji rankiniam diegimui¶
| Pavadinimas | Privaloma | Numatytoji reikšmė | Komentaras |
|---|---|---|---|
ENV_GW_CERT_NAME |
TAIP | Naudojama ryšiui su rankine konfigūracija. Sertifikato failo, skirto jungtis prie SSL Router, pavadinimas. |
|
ENV_GW_CERT_PASSWORD |
TAIP | Naudojama ryšiui su rankine konfigūracija. Sertifikato failo, skirto jungtis prie SSL Router, slaptažodis. |
|
ENV_SSL_ROUTER_IP |
TAIP | Naudojamas jungiantis su rankine konfigūracija. Komponento SSL Router, prie kurio jungsis HTML5 Gateway, IP adresas arba DNS vardas. |
|
ENV_SSL_ROUTER_PORT |
NE | 443 |
Naudojamas jungiantis su rankine konfigūracija. Komponento SSL Router, prie kurio jungsis HTML5 Gateway, prievadas. |
Įvairūs kintamieji¶
| Pavadinimas | Privaloma | Numatytoji reikšmė | Komentaras |
|---|---|---|---|
ENV_DISABLE_RSYSLOG |
NE | false |
Paslaugos rsyslog išjungimas.Leistinos reikšmės: true arba false. |
Tomai¶
| Tomas | Komentaras |
|---|---|
/etc/ipdiva/ |
HTML5 Gateway konfigūracijos tomas. Rekomenduojame jį prijungti prie įvardytojo tomo arba pagrindinio kompiuterio failų sistemos. |
/opt/certificates/ |
Tomas, kuriame yra HTML5 Gateway sertifikatas (-ai), kai konfigūruojama be pairing. |
/var/log/ |
Tomas, kuriame yra HTML5 Gateway žurnalai. |
Prievadai¶
| Prievadas | Komentaras |
|---|---|
8080 |
HTML5 paslaugos klausymo prievadas. |
HTML5 Gateway Docker diegimas¶
Diegimas naudojant pairing¶
Būtinosios sąlygos
Prieš diegdami HTML5 Gateway Docker, turite gauti pairing tokeną.
Toliau aprašytam diegimui bus naudojami visi galimi tomai (išskyrus /opt/certificates/, kuris šiame kontekste nenaudingas) ir bus atverti visi prievadai.
Tomai bus prijungti prie pagrindinio kompiuterio failų sistemos vietoje HTML5_GATEWAY_REP. Šioje vietoje yra šie pakatalogiai:
- config
- log
Galite pritaikyti toliau pateiktų komandų kintamuosius:
| Pasirinktinė reikšmė | Kintamasis | Komentaras |
|---|---|---|
DOCKER_NAME |
Docker konteinerio pavadinimas. | |
HTML5_GATEWAY_REP |
Failų sistemos vieta, kurioje bus prijungti tomai. | |
ENV_MEDIATION_VALUE |
Aplinkos kintamojo ENV_MEDIATION reikšmė. |
|
ENV_TOKEN_VALUE |
Aplinkos kintamojo ENV_TOKEN reikšmė. |
|
ENV_NO_CHECK_CERT_VALUE |
Aplinkos kintamojo ENV_NO_CHECK_CERT reikšmė. |
Sukurkite katalogų medį, reikalingą tomams prijungti failų sistemoje:
1 2 | |
1 | |
Ir galiausiai paleiskite naują konteinerį:
1 2 3 4 5 6 7 8 | |
1 2 3 4 5 6 7 8 | |
Konteinerio žurnalus galima peržiūrėti naudojant šią komandą:
1 | |
Rankinis diegimas¶
Būtinosios sąlygos
Prieš diegdami HTML5 Gateway Docker, turite turėti HTML5 Gateway reikalingą sertifikatą.
Slaptažodžiai, matomi naudojant docker inspect
Konteinerio aplinkos kintamieji, įskaitant sertifikatų slaptažodžius, lieka perskaitomi kiekvienam, kam leidžiama vykdyti docker inspect Docker serveryje. Todėl pirmenybę reikėtų teikti diegimui su pairing, kuriam nereikia jokio sertifikato slaptažodžio.
Toliau aprašytas diegimas naudos visus galimus tomus ir atvers visus prievadus.
Tomai bus prijungti prie pagrindinio kompiuterio failų sistemos vietoje MANUAL_REP. Šioje vietoje yra šie pakatalogiai:
- config
- log
- certificates
Galite pritaikyti toliau pateiktų komandų kintamuosius:
| Pasirinktinė reikšmė | Kintamasis | Komentaras |
|---|---|---|
MANUAL_NAME |
Docker konteinerio pavadinimas. | |
MANUAL_REP |
Failų sistemos vieta, kurioje prijungiami tomai. | |
ENV_GW_CERT_NAME_VALUE |
Aplinkos kintamojo ENV_GW_CERT_NAME reikšmė. |
|
ENV_SSL_ROUTER_IP_VALUE |
Aplinkos kintamojo ENV_SSL_ROUTER_IP reikšmė. |
|
ENV_SSL_ROUTER_PORT_VALUE |
Aplinkos kintamojo ENV_SSL_ROUTER_PORT reikšmė. |
Sukurkite katalogų medį, reikalingą tomams prijungti failų sistemoje:
1 2 3 | |
1 | |
Tada HTML5 Gateway ir įrašymo paslaugos sertifikatus įdėkite į MANUAL_REP/certificates.
Kad sertifikatų slaptažodžiai nebūtų išsaugoti apvalkalo istorijoje, įveskite juos į dabartinio seanso aplinkos kintamuosius (įvestis nerodoma):
1 2 | |
1 | |
Galiausiai paleiskite naują konteinerį:
1 2 3 4 5 6 7 8 9 10 | |
1 2 3 4 5 6 7 8 9 10 | |
Kai konteineris bus paleistas, pašalinkite šiuos kintamuosius iš seanso:
1 | |
1 | |
Konteinerio žurnalus galima peržiūrėti naudojant šią komandą:
1 | |
Mediation Controller konfigūravimas¶
Kad naujasis HTML5 Gateway Docker veiktų, dar reikia sukonfigūruoti Mediation Controller serverį per SSH arba konsolės prieigą su root leidimais.
Šis paskutinis parametras būtinas, kad Mediation Controller galėtų palaikyti ryšį su HTML5 paslauga.
Tačiau ši konfigūracija skiriasi priklausomai nuo HTML5 Gateway Docker vietos:
Bendroji schema yra tokia:
flowchart LR
subgraph DMZ
direction TB
HTML5(HTML5 Gateway Docker)
MED(Mediation Controller)
end
subgraph LAN
GW(Edge Gateway)
end
MED -.-> |Ryšys su HTML5 paslauga ; TCP 8080| HTML5
HTML5 --> |TLS Tunnel| MED
MED ~~~ GW
GW --> |TLS Tunnel| MED
GW ~~~ MED
linkStyle 0 stroke:#d22,color;
Šiuo atveju reikės pridėti toliau pateiktą informaciją į failą /etc/ipdiva/httpd/commonParameters.extra.conf arba jį sukurti.
Parametrus galima pritaikyti:
| Pasirinktinė reikšmė | Kintamasis | Komentaras |
|---|---|---|
HTML5_URL_DMZ |
URL, sukonfigūruotas deklaruojant HTML5 Gateway administravimo konsolėje. | |
HTML5_IP_DMZ |
Docker serverio, kuriame veikia HTML5 Gateway Docker, DNS vardas arba IP adresas. | |
HTML5_PORT_DMZ |
Prievadas, kurį Docker serveris publikuoja HTML5 Gateway Docker. |
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
Bendroji schema yra tokia:
flowchart LR
subgraph DMZ
direction TB
MED(Mediation Controller)
end
subgraph LAN
HTML5(HTML5 Gateway Docker)
GW(Edge Gateway)
end
MED -.- | Ryšys su HTML5 paslauga ; per TLS tunelį| GW -.-> |Ryšys su HTML5 paslauga ; TCP 8080| HTML5
HTML5 --> |TLS Tunnel| MED
GW --> |TLS Tunnel| MED
linkStyle 0,1 stroke:#d22,color;
Šiuo atveju reikės pridėti toliau pateiktą informaciją į failą /etc/ipdiva/httpd/commonParameters.extra.conf arba jį sukurti.
Parametrus galima pritaikyti:
| Pasirinktinė reikšmė | Kintamasis | Komentaras |
|---|---|---|
HTML5_URL_LAN |
URL, sukonfigūruotas deklaruojant HTML5 Gateway administravimo konsolėje. | |
GW_NAME_LAN |
Edge Gateway, naudojamo prisijungti prie HTML5 paslaugos, pavadinimas. Vertikalios linijos simbolį eilutės pabaigoje būtina palikti. | |
ORGANIZATION_NAME_LAN |
Organizacijos, prie kurios jungiasi Edge Gateway, pavadinimas. | |
HTML5_IP_LAN |
Docker serverio, kuriame veikia HTML5 Gateway Docker, DNS vardas arba IP adresas. | |
HTML5_PORT_LAN |
Prievadas, kurį Docker serveris publikuoja HTML5 Gateway Docker. |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | |
Patarimas
Šią konfigūraciją taip pat galima naudoti toliau nurodytu atveju, kai Docker Edge Gateway ir Docker HTML5 Gateway veikia tame pačiame Docker tinkle:
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 -.- | Ryšys su HTML5 paslauga ; per TLS tunelį| GW -.-> |Ryšys su HTML5 paslauga ; TCP 8080 per Docker tinklą| HTML5
HTML5 --> |TLS Tunnel| MED
GW --> |TLS Tunnel| MED
linkStyle 0,1 stroke:#d22,color;
Pavyzdys
Šiame pavyzdyje tame pačiame Docker serveryje įdiegsime Edge Gateway ir HTML5 Gateway.
Pavyzdyje naudojama infrastruktūra yra tokia:
- Mediation Controller serveris
- Žiniatinklio IP adresas:
10.0.10.10 - Organizacijos pavadinimas:
my-organization-name - Edge Gateway tokenas:
YJ5N-JN05-N5LS-N26H-7JHA-HZ9R-BGJF-MAVH - HTML5 Gateway tokenas:
ATCW-OMVR-0RY4-LW1M-D9G9-H5VF-WPX5-YCXF - URL, skirtas pasiekti HTML5 paslaugą:
HTML5_DOCKER
- Žiniatinklio IP adresas:
- Docker serveris
- Docker tinklo pavadinimas:
cyberelements-cleanroom-network - Edge Gateway
- Pavadinimas:
my-edge-gateway-docker - Šakninė vieta failų sistemoje:
/opt/my-edge-gateway-docker
- Pavadinimas:
- HTML5 Gateway
- Pavadinimas:
my-html5-gateway-docker - Šakninė vieta failų sistemoje:
/opt/my-html5-gateway-docker
- Pavadinimas:
- Docker tinklo pavadinimas:
Pirmiausia Docker serveryje turite sukurti katalogų medį Docker tomams prijungti:
1 2 3 4 5 6 | |
Tada sukurkite bridge tipo Docker tinklą, kad abu konteineriai galėtų palaikyti ryšį tarpusavyje:
1 | |
Tada paleiskite Edge Gateway konteinerį. Atkreipkite dėmesį, kad pavyzdyje ryšys užmezgamas per pairing, Mediation Controller pasiekiamas per jo IP adresą, o sertifikatas netikrinamas. Be to, pridedamas parametras --network, nurodantis, kad naudojamas anksčiau sukurtas Docker tinklas:
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
Tada paleiskite HTML5 Gateway konteinerį. Atkreipkite dėmesį, kad pavyzdyje ryšys užmezgamas per pairing, Mediation Controller pasiekiamas per jo IP adresą, o sertifikatas netikrinamas. Be to, pridedamas parametras --network, nurodantis, kad naudojamas anksčiau sukurtas Docker tinklas, o kadangi HTML5 paslauga bus pasiekiama per Docker tinklą, publikuoti prievado 8080 nebūtina:
1 2 3 4 5 6 7 8 | |
Galiausiai reikia sukonfigūruoti Mediation Controller serverio (-ių) failą /etc/ipdiva/httpd/commonParameters.extra.conf. Reikia pridėti šį skyrių:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | |
Prieš pritaikydami naujus parametrus, turite patikrinti, ar nauja konfigūracija nesukelia jokių blokuojančių Apache2 žiniatinklio serverio klaidų.
Norėdami tai padaryti, vykdykite šią komandą:
1 | |
Jei grąžinama Syntax OK, pakeitimus galima pritaikyti toliau pateikta komanda. Priešingu atveju patikrinkite savo failo /etc/ipdiva/httpd/commonParameters.extra.conf konfigūraciją.
1 | |