Activating Your CDN Service with VergeCloud

The first step in utilizing our CDN service involves registering your domain within your VergeCloud account. This guide will walk you through the necessary steps to complete this process.

Glossary

• CDN (Content Delivery Network): A network of servers distributed across various locations that delivers web content to users based on their geographical location.
• Domain: A distinct address on the internet that users type into their browser to access a website.
• NS (Name Server): A server that manages the domain name system (DNS) for domain names.
• CNAME (Canonical Name Record): A type of DNS record that allows you to alias one domain name to another.
• API (Application Programming Interface): A set of rules that allows different software entities to communicate with each other.

Real Usage Scenarios

Consider a scenario where a business is launching a new website and wants to enhance its performance and reliability using VergeCloud’s CDN. By registering their domain with VergeCloud, they can ensure faster content delivery, improved load times, and enhanced user experiences across different regions.

Field/Option Descriptions

Follow these detailed steps to register your domain:

1. Accessing Your VergeCloud Account

   After registering on the VergeCloud website, log into your user panel.

   
   

2. Navigating to the CDN Section

   Locate the CDN section of your account, then click on Domain List and select Add New Domains.

   
   

3. Entering Your Domain

   Input your domain's address without "www" and click Continue. If you intend to transfer traffic from a subdomain, enter the subdomain's name instead.

   
   

4. Accepting Terms of Use

   Thoroughly read the service's terms of use and then click on the option to continue and accept the rules.

   
   

5. Selecting Domain Traffic Transfer Type

   If adding a subdomain, you will be prompted to choose your Domain Traffic Transfer type: NS Delegation or CNAME Setup.

   
   

6. Choosing a Plan

   Select a plan for your domain. Further details about plans can be found on our CDN pricing page.

   
   

7. Reviewing Domain Records

   A window will display your domain records. Verify these records and IPs, then click Continue.

   
   

8. Copying Domain Settings

   You can either clone settings from a previously registered domain or enter the domain's Zone File. Ensure that the A record values reflect your website’s hosting server IP.

   
   

9. Updating NS Records

   If you chose NS Delegation, update your NS records to VergeCloud's NS records after defining all related records in the "DNS records" section.

   
   

10. Adding CNAME Record

    If using CNAME Setup for a subdomain, input the CNAME record provided in your DNS service.

    
    

11. Domain Activation Timeframe

    Domain activation may take up to 24 hours based on your domain registrar.

    
    

API Examples

Here are sample requests for adding a domain and selecting a plan via API:

Adding a Domain via API

curl -X POST "https://api.vergecloud.com/v1/domains" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
    "domain": "yourdomain.com",
    "traffic_transfer_type": "CNAME"
}'

Selecting a Plan via API

curl -X POST "https://api.vergecloud.com/v1/domains/YOUR_DOMAIN_ID/plans" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
    "plan_id": "YOUR_PLAN_ID"
}'

Testing and Validation

To validate your configuration, you can use tools like dig or NSLookup. Here’s how to perform a basic test:

1. Using the dig Command

   Open your terminal and execute the following command:

   dig yourdomain.com

   This will return the DNS records for your domain.

2. Using NSLookup

   Alternatively, you can use NSLookup by typing:

   nslookup yourdomain.com

   This will also provide the domain's DNS information.