Suiteáil na comhpháirte HTML5 Gateway Docker¶
An íomhá Docker a iompórtáil¶
Sula mbeidh tú in ann coimeádán HTML5 Gateway Docker a chruthú, ní mór duit an íomhá Docker a iompórtáil. Chuige sin, oscail blaosc ina bhfuil na horduithe Docker ar fáil duit, chomh maith leis an gcomhad cleanroom-html5-4.6.1-33-v2.tgz. Ón mblaosc, rith an t-ordú seo a leanas, agus coigeartaigh an cosán chuig an gcomhad TGZ mura bhfuil sé sa chomhadlann reatha:
1 | |
Ansin seiceáil gur éirigh leis an iompórtáil leis an ordú seo a leanas:
1 | |
Seo é an t-aschur a bhfuiltear ag súil leis. Mura amhlaidh atá, theip ar an iompórtáil:
1 2 3 4 5 6 | |
Aschur iomlán
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 | |
Cumraíocht an choimeádáin¶
Athróga timpeallachta¶
Athróga le haghaidh imscartha trí phéireáil¶
| Ainm | Éigeantach | Luach réamhshocraithe | Trácht |
|---|---|---|---|
ENV_MEDIATION |
TÁ | Úsáidtear é le haghaidh ceangail trí phéireáil. Léiríonn sé an t-ainm DNS nó an seoladh IP chun ceangal le comhéadan gréasáin ardáin CyberElements Bastion. |
|
ENV_TOKEN |
TÁ | Úsáidtear é le haghaidh ceangail trí phéireáil. Léiríonn sé an comhartha péireála atá le húsáid chun ceangal leis an gcomhpháirt Mediation Controller. |
|
ENV_NO_CHECK_CERT |
NÍL | false |
Úsáidtear é le haghaidh ceangal trí phéireáil. Cé acu a dhíchumasaítear nó nach ndíchumasaítear an tseiceáil ar dheimhniú gréasáin na comhpháirte Mediation Controller; úsáideach le CyberElements Bastion nuair a fhaightear rochtain trí sheoladh IP nó nuair nach n-aithníonn na húdaráis deimhniúcháin phoiblí réamhshocraithe an deimhniú gréasáin. Luachanna a nglactar leo: true nó false. |
Athróga le haghaidh imscartha de láimh¶
| Ainm | Éigeantach | Luach réamhshocraithe | Trácht |
|---|---|---|---|
ENV_GW_CERT_NAME |
TÁ | Úsáidtear é le haghaidh ceangail le cumraíocht láimhe. Ainm an chomhaid deimhnithe chun ceangal leis an gcomhpháirt SSL Router. |
|
ENV_GW_CERT_PASSWORD |
TÁ | Úsáidtear é le haghaidh ceangail le cumraíocht láimhe. Pasfhocal an chomhaid deimhnithe chun ceangal leis an gcomhpháirt SSL Router. |
|
ENV_SSL_ROUTER_IP |
TÁ | Úsáidtear é le haghaidh ceangail le cumraíocht láimhe. Seoladh IP nó ainm DNS na comhpháirte SSL Router lena gceanglóidh an chomhpháirt HTML5 Gateway. |
|
ENV_SSL_ROUTER_PORT |
NÍL | 443 |
Úsáidtear é le haghaidh ceangail le cumraíocht láimhe. An port ar an gcomhpháirt SSL Router lena gceanglóidh an chomhpháirt HTML5 Gateway. |
Athróga éagsúla¶
| Ainm | Éigeantach | Luach réamhshocraithe | Trácht |
|---|---|---|---|
ENV_DISABLE_RSYSLOG |
NÍL | false |
Díchumasú na seirbhíse rsyslog.Luachanna a nglactar leo: true nó false. |
Imleabhair¶
| Imleabhar | Trácht |
|---|---|
/etc/ipdiva/ |
Imleabhar cumraíochta na comhpháirte HTML5 Gateway. Molaimid é a fheistiú ar imleabhar ainmnithe nó ar chóras comhad an óstríomhaire. |
/opt/certificates/ |
Imleabhar ina bhfuil deimhniú nó deimhnithe na comhpháirte HTML5 Gateway i gcumraíocht gan phéireáil. |
/var/log/ |
Imleabhar ina bhfuil logaí na comhpháirte HTML5 Gateway. |
Poirt¶
| Port | Trácht |
|---|---|
8080 |
Port éisteachta na seirbhíse HTML5. |
Imscaradh na comhpháirte HTML5 Gateway Docker¶
Imscaradh le péireáil¶
Réamhriachtanais
Sula n-imscarann tú an chomhpháirt HTML5 Gateway Docker, ní mór duit comhartha péireála a fháil.
Úsáidfidh an t-imscaradh a thuairiscítear thíos na himleabhair go léir atá ar fáil (seachas /opt/certificates/ nach bhfuil úsáideach sa chomhthéacs seo) agus nochtfaidh sé na poirt go léir.
Feisteofar na himleabhair ar chóras comhad an óstríomhaire ag an láthair HTML5_GATEWAY_REP. Laistigh den láthair seo tá na fochomhadlanna seo a leanas:
- config
- log
Is féidir leat na hathróga a shaincheapadh do na horduithe seo a leanas:
| Luach saincheaptha | Athróg | Nóta tráchta |
|---|---|---|
DOCKER_NAME |
Ainm an choimeádáin Docker. | |
HTML5_GATEWAY_REP |
An láthair ar an gcóras comhad ar a bhfeisteofar na himleabhair. | |
ENV_MEDIATION_VALUE |
Luach na hathróige timpeallachta ENV_MEDIATION. |
|
ENV_TOKEN_VALUE |
Luach na hathróige timpeallachta ENV_TOKEN. |
|
ENV_NO_CHECK_CERT_VALUE |
Luach na hathróige timpeallachta ENV_NO_CHECK_CERT. |
Cruthaigh an crann comhadlainne atá riachtanach chun imleabhair a fheistiú ar an gcóras comhad:
1 2 | |
1 | |
Agus ar deireadh, tosaigh coimeádán nua:
1 2 3 4 5 6 7 8 | |
1 2 3 4 5 6 7 8 | |
Is féidir logaí an choimeádáin a fheiceáil leis an ordú seo a leanas:
1 | |
Imscaradh de láimh¶
Réamhriachtanais
Sula n-imscarann tú an chomhpháirt HTML5 Gateway Docker, ní mór an deimhniú atá riachtanach don chomhpháirt HTML5 Gateway a bheith agat.
Pasfhocail infheicthe le docker inspect
Bíonn athróga timpeallachta coimeádáin, pasfhocail na ndeimhnithe san áireamh, inléite ag aon duine a bhfuil cead aige docker inspect a rith ar an bhfreastalaí Docker. Dá bhrí sin, is fearr an t-imscaradh le péireáil, nach n-úsáideann aon phasfhocal deimhnithe.
Úsáidfidh an t-imscaradh a thuairiscítear thíos na himleabhair uile atá ar fáil agus nochtfaidh sé na poirt uile.
Feisteofar na himleabhair ar chóras comhad an ríomhaire óstaigh sa láthair MANUAL_REP. Sa láthair seo, tá na fochomhadlanna seo a leanas:
- config
- log
- certificates
Is féidir leat na hathróga a shaincheapadh do na horduithe seo a leanas:
| Luach saincheaptha | Athróg | Nóta tráchta |
|---|---|---|
MANUAL_NAME |
Ainm an choimeádáin Docker. | |
MANUAL_REP |
Láthair ar an gcóras comhad ina bhfeisteofar na himleabhair. | |
ENV_GW_CERT_NAME_VALUE |
Luach na hathróige timpeallachta ENV_GW_CERT_NAME. |
|
ENV_SSL_ROUTER_IP_VALUE |
Luach na hathróige timpeallachta ENV_SSL_ROUTER_IP. |
|
ENV_SSL_ROUTER_PORT_VALUE |
Luach na hathróige timpeallachta ENV_SSL_ROUTER_PORT. |
Cruthaigh an crann comhadlainne atá riachtanach chun imleabhair a fheistiú ar an gcóras comhad:
1 2 3 | |
1 | |
Ansin cuir deimhnithe na comhpháirte HTML5 Gateway agus na seirbhíse taifeadta in MANUAL_REP/certificates.
Ionas nach gcoimeádfar pasfhocail na ndeimhnithe i stair na blaoisce, iontráil iad in athróga timpeallachta den seisiún reatha (ní thaispeántar an t-ionchur):
1 2 | |
1 | |
Ar deireadh, tosaigh coimeádán nua:
1 2 3 4 5 6 7 8 9 10 | |
1 2 3 4 5 6 7 8 9 10 | |
Nuair a bheidh an coimeádán tosaithe, bain na hathróga seo den seisiún:
1 | |
1 | |
Is féidir logaí an choimeádáin a fheiceáil leis an ordú seo a leanas:
1 | |
Cumraíocht na comhpháirte Mediation Controller¶
Le go mbeidh an chomhpháirt nua HTML5 Gateway Docker in ann feidhmiú, ní mór an freastalaí Mediation Controller a chumrú fós trí rochtain SSH nó consóil agus le ceadanna root.
Tá an socrú deireanach seo riachtanach chun go mbeidh an chomhpháirt Mediation Controller in ann cumarsáid a dhéanamh leis an tseirbhís HTML5.
Mar sin féin, braitheann an chumraíocht seo ar láthair na comhpháirte HTML5 Gateway Docker:
Seo a leanas an léaráid fhoriomlán:
flowchart LR
subgraph DMZ
direction TB
HTML5(HTML5 Gateway Docker)
MED(Mediation Controller)
end
subgraph LAN
GW(Edge Gateway)
end
MED -.-> |Ceangal leis an tseirbhís HTML5 ; TCP 8080| HTML5
HTML5 --> |TLS Tunnel| MED
MED ~~~ GW
GW --> |TLS Tunnel| MED
GW ~~~ MED
linkStyle 0 stroke:#d22,color;
Sa chomhthéacs seo, beidh gá an fhaisnéis thíos a chur leis an gcomhad /etc/ipdiva/httpd/commonParameters.extra.conf, nó an comhad sin a chruthú.
Is féidir na socruithe a shaincheapadh:
| Luach saincheaptha | Athróg | Nóta tráchta |
|---|---|---|
HTML5_URL_DMZ |
An URL a cumraíodh nuair a fógraíodh an chomhpháirt HTML5 Gateway sa chonsól riaracháin. | |
HTML5_IP_DMZ |
Ainm DNS nó seoladh IP an fhreastalaí Docker ar a bhfuil an chomhpháirt HTML5 Gateway Docker gníomhach. | |
HTML5_PORT_DMZ |
An port a fhoilsíonn an freastalaí Docker don chomhpháirt HTML5 Gateway Docker. |
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
Seo a leanas an léaráid fhoriomlán:
flowchart LR
subgraph DMZ
direction TB
MED(Mediation Controller)
end
subgraph LAN
HTML5(HTML5 Gateway Docker)
GW(Edge Gateway)
end
MED -.- | Ceangal leis an tseirbhís HTML5 ; trí thollán TLS| GW -.-> |Ceangal leis an tseirbhís HTML5 ; TCP 8080| HTML5
HTML5 --> |TLS Tunnel| MED
GW --> |TLS Tunnel| MED
linkStyle 0,1 stroke:#d22,color;
Sa chomhthéacs seo, beidh gá an fhaisnéis thíos a chur leis an gcomhad /etc/ipdiva/httpd/commonParameters.extra.conf, nó an comhad sin a chruthú.
Is féidir na socruithe a shaincheapadh:
| Luach saincheaptha | Athróg | Nóta tráchta |
|---|---|---|
HTML5_URL_LAN |
An URL a cumraíodh nuair a fógraíodh an chomhpháirt HTML5 Gateway sa chonsól riaracháin. | |
GW_NAME_LAN |
Ainm na comhpháirte Edge Gateway a úsáidtear chun ceangal leis an tseirbhís HTML5. Ní mór an carachtar píopa ag deireadh na líne a choinneáil. | |
ORGANIZATION_NAME_LAN |
Ainm na heagraíochta lena gceanglaíonn an chomhpháirt Edge Gateway. | |
HTML5_IP_LAN |
Ainm DNS nó seoladh IP an fhreastalaí Docker ar a bhfuil an chomhpháirt HTML5 Gateway Docker gníomhach. | |
HTML5_PORT_LAN |
An port a fhoilsíonn an freastalaí Docker don chomhpháirt HTML5 Gateway Docker. |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | |
Leid
Is féidir an chumraíocht seo a úsáid freisin sa chás seo a leanas, ina bhfuil comhpháirt Edge Gateway Docker agus comhpháirt HTML5 Gateway Docker ag rith sa líonra Docker céanna:
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 -.- | Ceangal leis an tseirbhís HTML5 ; trí thollán TLS| GW -.-> |Ceangal leis an tseirbhís HTML5 ; TCP 8080 trí líonra Docker| HTML5
HTML5 --> |TLS Tunnel| MED
GW --> |TLS Tunnel| MED
linkStyle 0,1 stroke:#d22,color;
Sampla
Sa sampla seo, imscarfaimid comhpháirt Edge Gateway agus comhpháirt HTML5 Gateway ar an bhfreastalaí Docker céanna.
Seo a leanas an bonneagar a úsáidtear don sampla:
- Freastalaí Mediation Controller
- Seoladh IP gréasáin:
10.0.10.10 - Ainm na heagraíochta:
my-organization-name - Comhartha don chomhpháirt Edge Gateway:
YJ5N-JN05-N5LS-N26H-7JHA-HZ9R-BGJF-MAVH - Comhartha don chomhpháirt HTML5 Gateway:
ATCW-OMVR-0RY4-LW1M-D9G9-H5VF-WPX5-YCXF - URL chun rochtain a fháil ar an tseirbhís HTML5:
HTML5_DOCKER
- Seoladh IP gréasáin:
- Freastalaí Docker
- Ainm an líonra Docker:
cyberelements-cleanroom-network - Edge Gateway
- Ainm:
my-edge-gateway-docker - Láthair fhréimhe ar an gcóras comhad:
/opt/my-edge-gateway-docker
- Ainm:
- HTML5 Gateway
- Ainm:
my-html5-gateway-docker - Láthair fhréimhe ar an gcóras comhad:
/opt/my-html5-gateway-docker
- Ainm:
- Ainm an líonra Docker:
Ar dtús, ar an bhfreastalaí Docker, ní mór duit an struchtúr crainn a chruthú chun na himleabhair Docker a fheistiú:
1 2 3 4 5 6 | |
Ansin cruthaigh líonra Docker den chineál bridge ionas gur féidir leis an dá choimeádán cumarsáid a dhéanamh lena chéile:
1 | |
Ansin, tosaigh coimeádán na comhpháirte Edge Gateway. Tabhair faoi deara go mbunaíonn an sampla ceangal trí phéireáil, le rochtain ar an gcomhpháirt Mediation Controller trína seoladh IP agus gan seiceáil deimhnithe. Ina theannta sin, cuirtear an paraiméadar --network leis chun úsáid an líonra Docker a cruthaíodh roimhe seo a shonrú:
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
Ansin, tosaigh coimeádán na comhpháirte HTML5 Gateway. Tabhair faoi deara go mbunaíonn an sampla ceangal trí phéireáil, le rochtain ar an gcomhpháirt Mediation Controller trína seoladh IP agus gan seiceáil deimhnithe. Ina theannta sin, cuirtear an paraiméadar --network leis chun úsáid an líonra Docker a cruthaíodh roimhe seo a shonrú, agus ós rud é go rachaidh an rochtain ar an tseirbhís HTML5 tríd an líonra Docker, níl gá port 8080 a fhoilsiú:
1 2 3 4 5 6 7 8 | |
Ar deireadh, ní mór an comhad /etc/ipdiva/httpd/commonParameters.extra.conf ar fhreastalaí nó ar fhreastalaithe Mediation Controller a chumrú. Ba cheart an chuid seo a leanas a chur leis:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | |
Sula gcuireann tú na socruithe nua i bhfeidhm, ní mór duit a sheiceáil nach gcruthaíonn an chumraíocht nua aon earráid bhlocála don fhreastalaí gréasáin Apache2.
Chun é seo a dhéanamh, rith an t-ordú seo a leanas:
1 | |
Más é Syntax OK an toradh, is féidir na hathruithe a chur i bhfeidhm leis an ordú thíos. Mura é, seiceáil cumraíocht do chomhaid /etc/ipdiva/httpd/commonParameters.extra.conf.
1 | |