Click on the Regions option in your JCA > Cluster menu section to see the hardware structure of the platform:
- Regions (or hardware regions) – independent hardware sets from different data centers; each region can contain multiple host groups
- Host Groups (or environment regions) – a separate set of servers (hosts) within the confines of a particular region with its own options, efficiency, and rules for resources charging
Here, all the crucial information on Regions is displayed through the following columns:
- Name of a hardware region or comprised host group(s)
- Domain assigned to the region
- SSL certificates configuration for the hardware region
- Subnet provided for the region
- Migration shows if users should be able to migrate environments from/to the current hardware region
- Status of a region/host group (could be either ACTIVE or under MAINTENANCE)
- Description with some optional information on a region or host group
Use the tools panel above the regions list to perform the following operations:
Add New Region
Follow the next steps to add a new hardware region to your Jelastic cluster:
1. Click the Add Region button at the top pane of the Regions section:
Within the opened Add Region frame, you need to fulfill the required details.
2. Within the first Region Setting section, specify the following information:
- Unique Name – unique identifier for the region (cannot be changed later)
- Display Name – changeable region alias, which is displayed in JCA (10 characters max)
- Domain – hostname assigned to a new region
Note: The appropriate domain name should be purchased beforehand using any preferred domain registrar.
- Status – the initial state should be set as MAINTENANCE to avoid false monitoring alerts during region addition
- Subnet – a dedicated internal subnet for the user nodes and traffic routing between different hardware regions
- Start and End IP – range of the IP addresses for containers created in this region (cannot exceed the specified subnet)
- Description – short information on the current hardware region displayed in JCA (optional)
- Allow migration from/to regions – tick the checkbox to allow environments migration from/to this region by end-users
3. In the Name Servers section, you need to state a pair (or several pairs) of Public IPv4 and Internal IPv4. These addresses will be used by shared load balancers as a region entrance point and, at the same time, its internal and external DNS server.
4. The last Docker Host Settings section configures a separate Docker Engine module for this particular hardware region:
- Host – domain or IP of your Docker Host
- SSH and TCP Port – ports for connections via the appropriate protocols
- Login and Password – access credentials for the Docker Host
Add New Host Group
To add a new host group, follow the instructions below.
1. Click the Add Host Group button at the top of the Regions panel.
2. Within the opened Add Host Group dialog, fill in the given fields to provide the required data:
- Unique Name – unique identifier for the host group (cannot be changed later)
- Display Name – changeable host group name displayed in JCA and at the end-users’ dashboard (10 characters max)
- Status – initial state of the host group, i.e. the one set after creation (ACTIVE or MAINTENANCE)
- Description – short information on the current host group displayed in JCA (optional)
- Region – hardware region this host group should be assigned to (use the drop-down list to select an existing one or to jump to the Add Region dialog)
Click Add to proceed.
3. After successfully adding a host group, it should be appropriately set up with the following steps:
Afterward, your host group will appear in the topology wizard of the Dev dashboard as a new environment region.
Edit Region/Host Group
You can adjust the existing regions and host groups by simply double-clicking on the required item or using the Edit button at the top of the Regions panel.
Within the corresponding region/host group Edit dialog, you can adjust everything (same as for the addition) except the Unique Name value.
SSL Certificates for Regions
Using the SSL column within the Regions section, you can Add Certificates for your hardware regions or manage the already configured ones:
- Edit – allows switching between the Let’s Encrypt and custom SSL certificates
- Update – provides a new LE certificate for the hardware region (this option is hidden for custom SSL)
- Remove – detaches certificate from the region
1. While adding or editing your certificate, you can choose between two options:
- Use Let’s Encrypt – automatically fetch and apply certificates from the Let’s Encrypt free and open Certificate Authority
- Upload Custom Certificates – upload valid RSA-based Server Key, Intermediate Certificate (CA), and Domain Certificate files to automatically apply them. Self-signed certificates can be used as well, e.g. for testing purposes
Click Save to confirm changes.
2. If needed, you can configure the Let’s Encrypt certificates provisioning via the certain System Settings:
- jelastic.letsencrypt.renewal.days – displays an alert at JCA if any of the SSL certificates are valid for fewer days than a provided value (21, by default)
- qjob.ssl_checker.cron_schedule – checks the status of the Let’s Encrypt SSL certificates for hardware regions and automatically updates those, which are valid for fewer days than specified in the jelastic.letsencrypt.renewal.days setting; the default value is 0 0 15 * * ?, i.e. this job is run daily at 15:00
- hcore.platform.admin.username – sets platform admin email address, which, in case any issue occurs, receives notification from Let’s Encrypt
Remove Region/Host Group
No longer needed regions and host groups can be deleted with the help of the Remove button at the top tools panel.