Skip to main content
Version: 4.6.1-saas

Quick Start

Get started with NetFUNNEL 4 Fastly Agent in 5-10 minutes with this quick start guide.

Prerequisites​

  • NetFUNNEL console access
  • Fastly account with Compute Services support
  • Fastly CLI installation
  • Fastly API token

Step 1: Get Client ID​

  1. Go to NetFUNNEL console
  2. Click the profile icon in the top right
  3. Select Integration Credentials menu
  4. Copy Client ID

Step 2: Install Fastly CLI​

Install Fastly CLI:

brew install fastly/tap/fastly

Step 3: Create Compute Service​

  1. Fastly console → Go to [Compute]
  2. Click [Create service] in the top right
  3. Select [+ Use starter kit]
  4. Enter Service name
  5. Enter domain to apply compute in Add your own domain
  6. Click [Next: Choose a starter kit]
  7. Select Default starter for Rust
  8. Click [Finalize and deploy]

Step 4: Register CNAME​

  1. After Deploy is complete, check Point your custom domain to Fastly in Additional setup
  2. Click [Issue TLS Certification]
  3. Select service where domain is registered in Your DNS provider
  4. Register CNAME in that service

Step 5: Configure Service Configuration​

  1. Click [Edit configuration] (or [Service configuration])
  2. Click [Clone version 1 (active) to edit]

Create nf_core host​

  1. Select Origins menu
  2. Enter serverUrl domain in Hostname
  3. Click [Add]
  4. Select created host → Go to Edit page
  5. Change Name to nf_core
  6. Click [Update]

Create nf_setting host​

  1. Click [+ Create a host]
  2. Enter settingUrl domain in Hostname
  3. Click [Add]
  4. Select created host → Go to Edit page
  5. Change Name to nf_setting
  6. Click [Update]

Create origin host​

  1. Click [+ Create a host]
  2. Enter origin address in Hostname
  3. Click [Add]
  4. Select created host → Go to Edit page
  5. Change Name to origin
  6. Click [Update]

Activate​

  1. Click [Activate] in the top right to save

Step 6: Config Store Configuration​

Create Config Store​

  1. Resources menu → Go to Config stores
  2. Click [+ Create store] in the top right
  3. Store name: Enter nf_config_store
  4. Click [Create]
  5. Click [Add item]
  6. Key: Enter CLIENT_ID, Value: Enter {'{CLIENT_ID}'}
  7. Click [Add]
  1. Select [Linked Services] in the top tab
  2. Click [Link service]
  3. Select Compute service created above
  4. Click [Next]
  5. Click [Link and activate]
  6. Click [Confirm and activate] in Active Service Versions window

Step 7: Create Token​

  1. Account → API tokens → Personal tokens
  2. Click [+ Create Token] in the top right
  3. Click [Continue] and log in again
  4. Enter Name
  5. Expiration: Select Never expire
  6. Click [Create Token]

Step 8: Deploy Agent​

Download Agent File​

Download netfunnel-fastly-agent.tar file from https://agent-lib.stclab.com/agents/cdn/fastly/netfunnel-fastly-agent-latest.tar

Modify toml File​

  1. Extract downloaded agent file
  2. Open fastly.toml file
  3. Copy compute service ID from Fastly console
  4. Enter copied ID in cloned_from and service_id:
authors = []
cloned_from = "{SERVICE_ID}"
description = "Fastly agent for NetFUNNEL - Rust implementation"
language = "rust"
manifest_version = 3
name = "NetFUNNEL-Fastly-Agent-Rust"
service_id = "{SERVICE_ID}"

Deploy Agent​

  1. Open terminal in netfunnel-fastly-agent folder
  2. Execute the following command:
fastly compute deploy

Next Steps​