Setting up virtual hosting
- Prepare your cloud
- Create a cloud network
- Reserve a static public IP address
- Create security groups
- Import TLS certificates of the sites to Certificate Manager
- Create instance groups for the sites
- Upload the site files to the VMs
- Create backend groups
- Create and configure HTTP routers
- Create an L7 load balancer
- Configure DNS for the sites
- Test the hosting
- Delete the resources you created
This use case describes how to set up virtual hosting, i.e., how to use Yandex Application Load Balancer to host multiple websites with different domain names on the same IP address.
As examples, we are going to use these three domain names: site-a.com
, site-b.com
, and default.com
.
To create a virtual hosting:
- Prepare your cloud.
- Create a cloud network.
- Reserve a static public IP address.
- Create security groups.
- Import TLS certificates of the sites to Yandex Certificate Manager.
- Create instance groups for websites.
- Upload the site files to the VMs.
- Create backend groups.
- Create and configure HTTP routers.
- Create an L7 load balancer.
- Configure DNS for the sites.
- Test the hosting.
If you no longer need the resources you created, delete them.
Prepare your cloud
Sign up for Yandex Cloud and create a billing account:
- Go to the management console
and log in to Yandex Cloud or create an account if you do not have one yet. - On the Yandex Cloud Billing
page, make sure you have a billing account linked and it has theACTIVE
orTRIAL_ACTIVE
status. If you do not have a billing account, create one.
If you have an active billing account, you can go to the cloud page
Learn more about clouds and folders.
Required paid resources
The cost of virtual hosting includes:
- Fee for continuously running VMs (see Yandex Compute Cloud pricing).
- Fee for using a public static IP address (see Yandex Virtual Private Cloud pricing).
- Fee for using computing resources of the L7 load balancer (see Application Load Balancer pricing).
- Fee for public DNS queries and DNS zones if using Yandex Cloud DNS (see Cloud DNS pricing).
Create a cloud network
All the resources created in the use case will belong to the same cloud network.
To create a network:
- In the management console
, select Virtual Private Cloud. - Click Create network.
- Specify the Name of the network:
vhosting-network
. - In the Advanced field, select Create subnets.
- Click Create network.
Reserve a static public IP address
For your virtual hosting to run, you need to assign a static public IP address to the L7 load balancer.
To reserve an IP address:
- In the management console
, select Virtual Private Cloud. - In the left-hand panel, select
IP addresses. Click Reserve address. - In the window that opens, select the
ru-central1-d
availability zone. Click ** Reserve**.
Create security groups
Security groups include rules that allow the load balancer to receive incoming traffic and redirect it to the VMs so they can receive the traffic. In this use case, we will create two security groups: one for the load balancer and another one for all VMs.
To create security groups:
-
In the management console
, select Virtual Private Cloud. -
In the left-hand panel, select
Security groups. -
Create a security group for the load balancer:
-
Click Create security group.
-
Specify the group Name:
vhosting-sg-balancer
. -
Select Network:
vhosting-network
. -
Under Rules, create the following rules using the instructions below the table:
Traffic
directionDescription Port range Protocol Source /
targetCIDR blocks Outgoing
any
All
Any
CIDR
0.0.0.0/0
Incoming
ext-http
80
TCP
CIDR
0.0.0.0/0
Incoming
ext-https
443
TCP
CIDR
0.0.0.0/0
Incoming
healthchecks
30080
TCP
Load balancer healthchecks
— -
Select the Egress or Ingress tab.
-
Click Add rule.
-
In the Port range field of the window that opens, specify a single port or a range of ports that traffic will come to or from.
-
In the Protocol field, specify the appropriate protocol or leave
Any
to allow traffic transmission over any protocol. -
In the Destination name or Source field, select the purpose of the rule:
CIDR
: Rule will apply to the range of IP addresses. In the CIDR blocks field, specify the CIDR and masks of subnets that traffic will come to or from. To add multiple CIDRs, click Add CIDR.Security group
: Rule will apply to the VMs from the current group or the selected security group.Load balancer healthchecks
: Rule allowing a load balancer to health check VMs.
-
Click Save. Repeat the steps to create all the rules from the table.
-
Click Save.
-
-
Similarly, create a security group for the VM named
vhosting-sg-vms
with the samevhosting-network
and the following rules:Traffic
directionDescription Port range Protocol Source CIDR blocks Incoming
balancer
80
TCP
Security group
vhosting-sg-balancer
Incoming
ssh
22
TCP
CIDR
0.0.0.0/0
Import TLS certificates of the sites to Certificate Manager
To enable user access to the sites using the secure HTTPS protocol (HTTP over TLS), you must have TLS certificates for the sites. To use certificates in the L7 load balancer, import the certificates to Certificate Manager.
If your sites do not have certificates, you can obtain them from Certificate Manager Let's Encrypt®. You do not need to do anything else after creating certificates this way, because the certificates are imported automatically.
To import an existing certificate for site-a.com
:
- In the management console
, select Certificate Manager. - Click Add certificate and select the User certificate option.
- Specify the certificate's Name:
vhosting-cert-a
. - In the Certificate field, click Add certificate. Upload the File with your certificate or enter its Content and click Add.
- If your certificate is issued by a third-party certificate authority, click Add chain in the Intermediate certificate chain field. Upload the File with the certificate chain or enter its Content and click Add.
- In the Private key field, click Add private key. Upload the File with the key or enter its Content and click Add.
- Click Create.
Similarly, import the certificates for site-b.com
and default.com
, their names being vhosting-cert-b
and vhosting-cert-default
, respectively.
Create instance groups for the sites
Compute Cloud VMs will act as web servers for the two websites: one group of multiple identical instances for each website. In this use case, the servers will be deployed based on the LEMP stack (Linux, NGINX, MySQL®, PHP). For more information, see this tutorial on LAMP or LEMP-based website.
To create an instance group for site-a.com
:
-
In the management console
, select Compute Cloud. -
In the left-hand panel, select
Instance groups. Click Create group of virtual machines. -
Enter the instance group name:
vhosting-ig-a
. -
Under Allocation, select multiple availability zones to ensure fault tolerance of your hosting.
-
Under Instance template, click Define.
-
Under Boot disk image, open the Marketplace tab and click Show all Marketplace products. Select LEMP and click Use.
-
Under Computing resources:
- Choose a VM platform.
- Specify the required number of vCPUs and the amount of RAM.
This minimum configuration is enough for functional website testing:
- Platform:
Intel Ice Lake
. - Guaranteed vCPU performance:
20%
. - vCPU:
2
. - RAM:
1 GB
.
-
Under Network settings, select the Network named
vhosting-network
you created earlier and its subnets. -
In the Public address field, select
Auto
. -
Select the
vhosting-sg-vms
security group created earlier. -
Specify the VM access data:
-
Under Login, enter the username.
-
In the SSH key field, paste the contents of the public key file.
You need to create a key pair for the SSH connection yourself. To learn how, see Connecting to a VM via SSH.
Alert
Once created, the VM gets an IP address and a host name (FQDN) for connections. If you selected
No address
in the Public address field, you will not be able to access the VM from the internet. -
-
Click Save.
-
Under Scaling, specify the instance group Size:
2
. -
Under Integration with Application Load Balancer, select Create target group and enter
vhosting-tg-a
as the group name. You can read more about target groups here. -
Click Create.
Follow the same steps to create a second instance group named vhosting-ig-b
and a target group named vhosting-tg-b
for site-b.com
.
It may take a few minutes to create an instance group. As soon as the group changes its status to RUNNING
and the status all its VMs to RUNNING_ACTUAL
, you can upload the website files to them.
Upload the site files to the VMs
To test your web servers, upload index.html
files with different contents to the VMs: one content version for the vhosting-ig-a
instance group VMs, and another for the vhosting-ig-b
instance group VMs.
Example of the index.html file for the vhosting-ig-a group
<!DOCTYPE html>
<html>
<head>
<title>Site A</title>
</head>
<body>
<p>This is site A</p>
</body>
</html>
Example of the index.html file for the vhosting-ig-b group
<!DOCTYPE html>
<html>
<head>
<title>Site B</title>
</head>
<body>
<p>This is site B</p>
</body>
</html>
To upload a file to a VM:
-
Go to the VM page of the management console
. In the Network section, find the VM's public IP address. -
Connect to the VM over SSH.
-
Grant your user write access to the
/var/www/html
directory:UbuntuCentOSsudo chown -R "$USER":www-data /var/www/html
sudo chown -R "$USER":apache /var/www/html
-
Upload the website files to the VM via SCP
.Linux/macOSWindowsUse the
scp
command-line utility:scp -r <path_to_file_directory> <VM_username>@<VM_IP_address>:/var/www/html
Use WinSCP
to copy the local file directory to/var/www/html
on the VM.
Repeat the above steps for the files you want to upload to each VM in the vhosting-ig-a
and vhosting-ig-b
groups.
Create backend groups
Target groups created together with instance groups must be linked to the backend groups that define the traffic allocation settings.
For the backends, groups will implement health checks: the load balancer will periodically send health check requests to the VMs and expect a response after a certain delay.
To create a backend group for site-a.com
:
- In the management console
, select Application Load Balancer. - In the left-hand panel, select
Backend groups. Click Create backend group. - Enter the backend group Name:
vhosting-bg-a
. - Under Backends, click Add.
- Enter the backend Name:
vhosting-backend-a
. - In the Target groups field, select the
vhosting-tg-a
group. - Specify Port backend VMs will use to receive incoming traffic from the load balancer at:
80
. - Click Add health check.
- Specify Port the backend VMs will use to accept health check connections:
80
. - Specify Path the load balancer will use for health checks:
/
. - Click Create.
Follow the same steps to create a second backend group named vhosting-bg-b
for site-b.com
. In this group, create the vhosting-backend-b
backend and link the vhosting-tg-b
target group to it.
Create and configure HTTP routers
Backend groups must be linked to HTTP routers that define the HTTP request routing rules. In this use case, you will create two routers for the main sites (site-a.com
and site-b.com
) and the default router for default.com
, which will respond to each request with the 404 Not Found
HTTP status code.
Create HTTP routers for sites
To create an HTTP router for site-a.com
:
- In the management console
, select Application Load Balancer. - In the left-hand panel, select
HTTP routers. Click Create HTTP router. - Specify the HTTP router Name:
vhosting-router-a
. - Click Add virtual host.
- Specify the virtual host Name:
vhosting-host-a
. - In the Authority field, specify the site domain name:
site-a.com
. - Click Add route.
- Specify the route Name:
vhosting-route-a
. - In the Backend group field, select the
vhosting-bg-a
group. - Click Create.
Follow the same steps to create the vhosting-router-b
HTTP router for site-b.com
and link the vhosting-bg-b
backend group to it.
Create the "default" HTTP router
To create an HTTP router for default.com
:
-
In the management console
, select Application Load Balancer. -
In the left-hand panel, select
HTTP routers. Click Create HTTP router. -
Specify the HTTP router Name:
vhosting-router-default
. -
Click Add virtual host.
-
Specify the virtual host Name:
vhosting-host-default
. -
In the Authority field, specify the site domain name:
default.com
. -
Click Add route.
-
Specify the route Name:
vhosting-route-a
. -
In the Action field, select
Response
. -
In the HTTP status code field, select
404 Not Found
. -
In the Response body field, click Select. Select the
Text
method and enter the following in the Content field:404 Not Found This is the default site.
Click Add.
-
Click Create.
Create an L7 load balancer
To create a load balancer:
- In the management console
, select Application Load Balancer. - Click Create L7 load balancer.
- Enter the load balancer Name:
vhosting-alb
. - Under Network settings, select the
vhosting-sg-balancer
security group you created earlier. - Create a listener to redirect HTTP requests to HTTPS:
- Under Listeners, click Add listener.
- Enter the listener Name:
vhosting-listener-http
. - Under Public IP address, select
List
for type and the IP address you reserved earlier. - In the Protocol field, select
Redirect to HTTPS
.
- Create an HTTPS request listener:
- Click Add listener again.
- Enter the listener Name:
vhosting-listener-https
. - Under Public IP address, select
List
for type and the IP address you reserved earlier. - In the Protocol field, select
HTTPS
. - Under Main listener, select
vhosting-cert-default
for certificate andvhosting-router-default
for HTTP router. - Add a SNI match for
site-a.com
:- Click Add SNI match.
- Specify the Name for the SNI match:
vhosting-sni-a
. - In the Server names field, specify
site-a.com
. - Select
vhosting-cert-a
for certificate andvhosting-router-a
for HTTP router.
- Similarly, add a SNI match for
site-b.com
withvhosting-sni-b
for name,site-b.com
for server name,vhosting-cert-b
for certificate, andvhosting-router-b
for HTTP router.
- Click Create.
Configure DNS for the sites
The site-a.com
, site-b.com
, and default.com
domain names must be linked to the L7 load balancer's IP address via DNS records.
To configure DNS for site-a.com
:
-
In the management console
, select Application Load Balancer. -
Copy the IP address of the load balancer that you created.
-
On the site of your DNS hosting provider, go to the DNS settings.
-
Create or edit an A record for
site-a.com
so that it refers to the copied IP address:site-a.com. A <L7_load_balancer_IP_address>
If you use Yandex Cloud DNS, follow this guide to configure the record:
Configuring DNS records for Cloud DNS
Management console- In the management console
, select Cloud DNS. - If you do not have a public DNS zone, create one:
- Click Create zone.
- Specify the zone Name:
vhosting-dns-a
. - In the Zone field, enter the website's domain name with a trailing dot:
site-a.com.
. - Select a Type of the zone:
Public
. - Click Create.
- Create a record in the zone:
- In the list of zones, click
vhosting-dns-a
. - Click Create record.
- Leave the Name field empty for the record to match the
site-a.com
domain name (rather than a name with a subdomain, e.g.,www.site-a.com
). - Select the record Type: A.
- In the Data field, paste the copied IP address of the load balancer.
- Click Create.
- In the list of zones, click
- In the management console
Follow the same steps to configure DNS for site-b.com
and default.com
, using the same IP address.
You can test your sites 15-20 minutes after you have configured DNS.
Test the hosting
To test the hosting, open each of the three sites in your browser:
- For
https://site-a.com
andhttps://site-b.com
, you should see the pages you uploaded to the VMs. - For
https://default.com
, you should see the404 Not Found
error page configured when creating the HTTP router.
Delete the resources you created
To shut down the hosting and stop paying for the created resources: