Introduction

You are able to create a new service by uploading it as code. Using this ‘as code’ functionality, you can create an exact replica of a service you've already created or use your existing service as a template to create a new one. When creating new services, each name must be unique. 

Your Service as Code

To access your service as code, click on the green globe icon to open the navigation menu. From there, click on Manage AppWANs and select Manage Services from the list at the top of the page. From this menu, you are able to select one, or all, of your services to download as a CSV file. Highlight each service you'd like to download or click the circle next to 'Service Name' to highlight all services. Next, locate the ellipses menu to the right of 'Port Range' information. From there you are able to download a CSV file that contains information on your service(s). 

Your CSV file will look something like what is below, depending on how many services you've created and select to download. This file will have all the information pertaining to your service from name, to IP Address, to port range, and so on. This CSV will not have any endpoint details (gateways, clients, etc.). This information will need to be added before uploading your services as code CSV file. A template CSV can be found in the 'Import Your Client as Code' wizard that has all variables listed that you will need for 'as code' creation. More information below. 

Create a New Service as Code

Creating services as code must happen after all endpoints (gateways and clients) have been created for you network. See Introduction to Client Endpoints and Introduction to Gateway Endpoints to create those endpoints before continuing with your service creation. 

The steps to create your new client as code are similar to the usual steps for creating a new client. Navigate to the Manage AppWANs -> Manage Services page. Click the blue plus-sign icon in the upper-right hand corner of the page to open the ‘Create a New Service' menu. From the four options present find 'Import Your Client as Code' near the bottom and click 'Create Service.'

A new screen will appear with options to download a template client CSV or import your CSV file. As mentioned previously, the CSV you download from Manage Services will not have all the  information needed to create a service as code - it is missing the endpoint information. Select 'Download an Example File' to view what variables are necessary and make edits directly to the template if you'd like. Reminder: all new services must have a unique name. Any service with a duplicate name will be skipped during the process.  

Below are all of the variables needed to create a new gateway as code. You will need to manually input your endpoint and gateway cluster information. All variables to the right of Endpoint (Gateway Cluster, Transparency, Enable Permanent Connection, etc.) are optional to fill in or leave blank. 

When you are ready to import your CSV file, search your computer library or drag and drop the file into the upload box. Next, click create to fully import your CSV and begin creating your new service as code. 

Details about your services' progress will be displayed once the process has started. Up to three service names will be displayed, followed by an ellipsis if you are creating more than three new services as code. This process may take a few minutes to complete, depending on how many services you are creating. You can click 'escape' at any time and continue with other work while your service(s) is/are being created. Navigate to your network dashboard or Manage Services to see if any errors occurred.