Εγκατάσταση του στοιχείου Edge Gateway για Docker¶
Εισαγωγή της εικόνας Docker¶
Για να μπορέσετε να δημιουργήσετε ένα κοντέινερ Edge Gateway για Docker, πρέπει να εισαγάγετε την εικόνα Docker. Για τον σκοπό αυτό, ανοίξτε ένα κέλυφος από το οποίο έχετε στη διάθεσή σας τις εντολές Docker, καθώς και το αρχείο cleanroom-gateway-4.6.1-33-v4.tgz. Από το κέλυφος, εκτελέστε την ακόλουθη εντολή, προσαρμόζοντας τη διαδρομή προς το αρχείο TGZ εάν δεν βρίσκεται στον τρέχοντα κατάλογο:
1 | |
Στη συνέχεια, ελέγξτε ότι η εισαγωγή ήταν επιτυχής με την ακόλουθη εντολή:
1 | |
Η αναμενόμενη έξοδος είναι η ακόλουθη (το αναγνωριστικό SHA256 μπορεί να διαφέρει ανάλογα με το λειτουργικό σύστημα στο οποίο είναι εγκατεστημένη η πλατφόρμα Docker· τα παραδείγματα προέρχονται από Debian 13). Εάν δεν συμβαίνει αυτό, η εισαγωγή απέτυχε:
1 2 3 4 5 6 | |
Πλήρης έξοδος
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 74 75 76 77 78 79 80 81 82 83 | |
Διαμόρφωση του κοντέινερ¶
Μεταβλητές περιβάλλοντος¶
Μεταβλητές για ανάπτυξη μέσω σύζευξης¶
| Όνομα | Υποχρεωτικό | Προεπιλεγμένη τιμή | Σχόλιο |
|---|---|---|---|
ENV_MEDIATION |
ΝΑΙ | Χρησιμοποιείται για τη σύνδεση μέσω σύζευξης. Όνομα DNS ή διεύθυνση IP για τη σύνδεση στο περιβάλλον web μιας πλατφόρμας CyberElements Bastion. |
|
ENV_TOKEN |
ΝΑΙ | Χρησιμοποιείται για τη σύνδεση μέσω σύζευξης. Υποδεικνύει το διακριτικό σύζευξης που θα χρησιμοποιηθεί για τη σύνδεση με την υπηρεσία Mediation Controller. |
|
ENV_NO_CHECK_CERT |
ΟΧΙ | false |
Χρησιμοποιείται για τις συνδέσεις μέσω σύζευξης. Καθορίζει αν θα απενεργοποιηθεί ή όχι ο έλεγχος του πιστοποιητικού web του στοιχείου Mediation Controller· χρήσιμο με το CyberElements Bastion κατά την πρόσβαση μέσω διεύθυνσης IP ή όταν το πιστοποιητικό web δεν είναι πιστοποιητικό αναγνωρισμένο από τις προεπιλεγμένες δημόσιες αρχές έκδοσης πιστοποιητικών. Αποδεκτές τιμές: true ή false. |
Μεταβλητές για χειροκίνητη ανάπτυξη¶
| Όνομα | Υποχρεωτικό | Προεπιλεγμένη τιμή | Σχόλιο |
|---|---|---|---|
ENV_GW_CERT_NAME |
ΝΑΙ | Χρησιμοποιείται για τη σύνδεση με χειροκίνητη διαμόρφωση. Όνομα του αρχείου πιστοποιητικού για τη σύνδεση με το στοιχείο SSL Router. |
|
ENV_GW_CERT_PASSWORD |
ΝΑΙ | Χρησιμοποιείται για τη σύνδεση με χειροκίνητη διαμόρφωση. Κωδικός πρόσβασης του αρχείου πιστοποιητικού για τη σύνδεση με το στοιχείο SSL Router. |
|
ENV_CARE_CERT_NAME |
ΟΧΙ | Τιμή της μεταβλητής ENV_GW_CERT_NAME |
Χρησιμοποιείται για τη σύνδεση με χειροκίνητη διαμόρφωση. Όνομα του αρχείου πιστοποιητικού της υπηρεσίας εγγραφής. |
ENV_CARE_CERT_PASSWORD |
ΟΧΙ | Τιμή της μεταβλητής ENV_GW_CERT_PASSWORD |
Χρησιμοποιείται για τη σύνδεση με χειροκίνητη διαμόρφωση. Κωδικός πρόσβασης του αρχείου πιστοποιητικού της υπηρεσίας εγγραφής. |
ENV_SSL_ROUTER_IP |
ΝΑΙ | Χρησιμοποιείται για τη σύνδεση με χειροκίνητη διαμόρφωση. Διεύθυνση IP ή όνομα DNS του στοιχείου SSL Router με το οποίο θα συνδεθεί το στοιχείο Edge Gateway. |
|
ENV_SSL_ROUTER_PORT |
ΟΧΙ | 443 |
Χρησιμοποιείται για τη σύνδεση με χειροκίνητη διαμόρφωση. Θύρα του στοιχείου SSL Router στην οποία θα συνδεθεί το στοιχείο Edge Gateway. |
Διάφορες μεταβλητές¶
| Όνομα | Υποχρεωτικό | Προεπιλεγμένη τιμή | Σχόλιο |
|---|---|---|---|
ENV_DISABLE_RSYSLOG |
ΟΧΙ | false |
Απενεργοποίηση της υπηρεσίας rsyslog.Αποδεκτές τιμές: true ή false. |
ENV_KERBEROS_CONFIG_ENABLE |
ΟΧΙ | false |
Ενεργοποιεί τις ρυθμίσεις Kerberos ώστε οι εφαρμογές RDP να μπορούν να πραγματοποιούν έλεγχο ταυτότητας σε λειτουργία χωρίς παράγοντα με χρήση Kerberos. Αποδεκτές τιμές: true ή false.Εάν η τιμή είναι false, οι υπόλοιπες μεταβλητές Kerberos θα αγνοούνται. |
ENV_KERBEROS_DEFAULT_REALM |
ΝΑΙ (εάν είναι ενεργοποιημένη η διαμόρφωση Kerberos) |
Όνομα της περιοχής (realm) Kerberos. | |
ENV_KERBEROS_DEFAULT_DOMAIN |
ΝΑΙ (εάν είναι ενεργοποιημένη η διαμόρφωση Kerberos) |
Όνομα του τομέα Kerberos. | |
ENV_KERBEROS_CONTROLLER_ADDRESS |
ΝΑΙ (εάν είναι ενεργοποιημένη η διαμόρφωση Kerberos) |
Διεύθυνση σύνδεσης στον ελεγκτή Kerberos. |
Τόμοι¶
| Τόμος | Σχόλιο |
|---|---|
/etc/ipdiva/ |
Τόμος διαμόρφωσης του στοιχείου Edge Gateway. Συνιστούμε την προσάρτησή του σε έναν επώνυμο τόμο ή στο σύστημα αρχείων του κεντρικού υπολογιστή. |
/opt/certificates/ |
Τόμος που περιέχει τα πιστοποιητικά του στοιχείου Edge Gateway σε διαμόρφωση χωρίς σύζευξη. |
/var/lib/ipdiva/carerecord/archives/ |
Τόμος που περιέχει τις γραφικές αρχειοθετήσεις. Συνιστούμε την προσάρτησή του σε έναν επώνυμο τόμο ή στο σύστημα αρχείων του κεντρικού υπολογιστή. |
/var/ipdiva/care/sshrecord/ |
Τόμος που περιέχει τις αρχειοθετήσεις SSH. Συνιστούμε την προσάρτησή του σε έναν επώνυμο τόμο ή στο σύστημα αρχείων του κεντρικού υπολογιστή. |
/var/log/ |
Τόμος που περιέχει τα αρχεία καταγραφής του στοιχείου Edge Gateway. |
Θύρες¶
| Θύρα | Σχόλιο |
|---|---|
2222 (ή οποιαδήποτε άλλη διαθέσιμη θύρα επιλέξει ο διαχειριστής) |
Θύρα ακρόασης της υπηρεσίας άμεσης πρόσβασης SSH/SFTP. |
3389 |
Θύρα ακρόασης της υπηρεσίας άμεσης πρόσβασης RDP. |
8443 |
Θύρα ακρόασης της υπηρεσίας εγγραφής, που πρέπει να εκτεθεί όταν χρησιμοποιείται ο παράγοντας εγγραφής για Windows. |
Ανάπτυξη του στοιχείου Edge Gateway για Docker¶
Ανάπτυξη με σύζευξη¶
Προαπαιτούμενα
Πριν από την ανάπτυξη του στοιχείου Edge Gateway για Docker, πρέπει να αποκτήσετε ένα διακριτικό σύζευξης.
Η ανάπτυξη που περιγράφεται παρακάτω θα χρησιμοποιεί όλους τους διαθέσιμους τόμους (εκτός από τον /opt/certificates/, ο οποίος δεν είναι χρήσιμος σε αυτή την περίπτωση) και θα εκθέτει όλες τις θύρες.
Οι τόμοι θα προσαρτηθούν στο σύστημα αρχείων του κεντρικού υπολογιστή στη θέση EDGE_GATEWAY_REP. Μέσα σε αυτή τη θέση βρίσκονται οι ακόλουθοι υποκατάλογοι:
- config
- graphical_archives
- ssh_archives
- log
Μπορείτε να προσαρμόσετε τις μεταβλητές για τις ακόλουθες εντολές:
| Προσαρμοσμένη τιμή | Μεταβλητή | Σχόλιο |
|---|---|---|
DOCKER_NAME |
Όνομα του κοντέινερ Docker. | |
EDGE_GATEWAY_REP |
Θέση στο σύστημα αρχείων όπου θα προσαρτηθούν οι τόμοι. | |
ENV_MEDIATION_VALUE |
Τιμή της μεταβλητής περιβάλλοντος ENV_MEDIATION. |
|
ENV_TOKEN_VALUE |
Τιμή της μεταβλητής περιβάλλοντος ENV_TOKEN. |
|
ENV_NO_CHECK_CERT_VALUE |
Τιμή της μεταβλητής περιβάλλοντος ENV_NO_CHECK_CERT. |
|
ENV_KERBEROS_CONFIG_ENABLE_VALUE |
Τιμή της μεταβλητής περιβάλλοντος ENV_KERBEROS_CONFIG_ENABLE. |
|
ENV_KERBEROS_DEFAULT_REALM_VALUE |
Τιμή της μεταβλητής περιβάλλοντος ENV_KERBEROS_DEFAULT_REALM. |
|
ENV_KERBEROS_DEFAULT_DOMAIN_VALUE |
Τιμή της μεταβλητής περιβάλλοντος ENV_KERBEROS_DEFAULT_DOMAIN. |
|
ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE |
Τιμή της μεταβλητής περιβάλλοντος ENV_KERBEROS_CONTROLLER_ADDRESS. |
Δημιουργήστε το δέντρο καταλόγων που απαιτείται για την προσάρτηση των τόμων στο σύστημα αρχείων:
1 2 3 4 | |
1 | |
Και, τέλος, εκκινήστε ένα νέο κοντέινερ:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | |
Τα αρχεία καταγραφής του κοντέινερ μπορούν να προβληθούν με την ακόλουθη εντολή:
1 | |
Μη αυτόματη ανάπτυξη¶
Προαπαιτούμενα
Πριν από την ανάπτυξη του στοιχείου Edge Gateway για Docker, πρέπει να διαθέτετε τα απαιτούμενα πιστοποιητικά για το στοιχείο Edge Gateway και για την υπηρεσία εγγραφής.
Κωδικοί πρόσβασης ορατοί με το docker inspect
Οι μεταβλητές περιβάλλοντος ενός κοντέινερ, συμπεριλαμβανομένων των κωδικών πρόσβασης των πιστοποιητικών, παραμένουν αναγνώσιμες από οποιονδήποτε μπορεί να εκτελέσει το docker inspect στον διακομιστή Docker. Επομένως, θα πρέπει να προτιμάται η ανάπτυξη με σύζευξη, η οποία δεν χρησιμοποιεί κωδικό πρόσβασης πιστοποιητικού.
Η ανάπτυξη που περιγράφεται παρακάτω θα χρησιμοποιήσει όλους τους διαθέσιμους τόμους και θα καταστήσει διαθέσιμες όλες τις θύρες.
Οι τόμοι θα προσαρτηθούν στο σύστημα αρχείων του κεντρικού υπολογιστή, στη θέση MANUAL_REP. Μέσα σε αυτή τη θέση βρίσκονται οι ακόλουθοι υποφάκελοι:
- config
- graphical_archives
- ssh_archives
- log
- certificates
Μπορείτε να προσαρμόσετε τις μεταβλητές για τις ακόλουθες εντολές:
| Προσαρμοσμένη τιμή | Μεταβλητή | Σχόλιο |
|---|---|---|
MANUAL_NAME |
Όνομα του κοντέινερ Docker. | |
MANUAL_REP |
Θέση στο σύστημα αρχείων όπου προσαρτώνται οι τόμοι. | |
ENV_GW_CERT_NAME_VALUE |
Τιμή της μεταβλητής περιβάλλοντος ENV_GW_CERT_NAME. |
|
ENV_CARE_CERT_NAME_VALUE |
Τιμή της μεταβλητής περιβάλλοντος ENV_CARE_CERT_NAME. |
|
ENV_SSL_ROUTER_IP_VALUE |
Τιμή της μεταβλητής περιβάλλοντος ENV_SSL_ROUTER_IP. |
|
ENV_SSL_ROUTER_PORT_VALUE |
Τιμή της μεταβλητής περιβάλλοντος ENV_SSL_ROUTER_PORT. |
|
ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE |
Τιμή της μεταβλητής περιβάλλοντος ENV_KERBEROS_CONFIG_ENABLE. |
|
ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE |
Τιμή της μεταβλητής περιβάλλοντος ENV_KERBEROS_DEFAULT_REALM. |
|
ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE |
Τιμή της μεταβλητής περιβάλλοντος ENV_KERBEROS_DEFAULT_DOMAIN. |
|
ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE |
Τιμή της μεταβλητής περιβάλλοντος ENV_KERBEROS_CONTROLLER_ADDRESS. |
Δημιουργήστε το δέντρο καταλόγων που απαιτείται για την προσάρτηση των τόμων στο σύστημα αρχείων:
1 2 3 4 5 | |
1 | |
Στη συνέχεια, τοποθετήστε τα πιστοποιητικά για το στοιχείο Edge Gateway και για την υπηρεσία εγγραφής στο MANUAL_REP/certificates.
Για να μη διατηρούνται οι κωδικοί πρόσβασης των πιστοποιητικών στο ιστορικό του shell, εισαγάγετέ τους σε μεταβλητές περιβάλλοντος της τρέχουσας περιόδου λειτουργίας (η πληκτρολόγηση δεν εμφανίζεται):
1 2 3 | |
1 2 | |
Τέλος, εκκινήστε ένα νέο κοντέινερ:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | |
Μόλις εκκινηθεί το κοντέινερ, καταργήστε αυτές τις μεταβλητές από την περίοδο λειτουργίας:
1 | |
1 | |
Τα αρχεία καταγραφής του κοντέινερ μπορούν να προβληθούν με την ακόλουθη εντολή:
1 | |