cli-terraform

README

Akamai CLI for Akamai Terraform Provider

An Akamai CLI package for administering and managing Akamai Terraform configurations

Getting Started

Creating authentication credentials

Before you can use this CLI, you need to Create authentication credentials.

Installing

To install this package, use Akamai CLI:

$ akamai install terraform

You may also use this as a stand-alone command by downloading the latest release binary for your system, or by cloning this repository and compiling it yourself.

Compiling from Source

If you want to compile it from source, you will need Go 1.12 or later:

1. Fetch the package:
   go get github.com/akamai/cli-terraform
2. Change to the package directory:
   cd $GOPATH/src/github.com/akamai/cli-terraform
3. Compile the binary:

• Linux/macOS/*nix: go build -o akamai-terraform
• Windows: go build -o akamai-terraform.exe

1. Move the binary (akamai-terraform or akamai-terraform.exe) in to your PATH

General Usage

  akamai terraform [global flags] command [command flags] [arguments...]

Description:
   Administer and manage available Akamai resources with Terraform

Built-In Commands:
  export-domain (alias: create-domain)
  export-zone (alias: create-zone)
  export-appsec (alias: create-appsec)
  export-property (alias: create-property)
  export-cloudlets-policy (alias: create-cloudlets-policy)
  export-edgekv (alias: create-edgekv)
  export-edgeworker (alias: create-edgeworker)
  export-iam (alias: create-iam)
  export-imaging (alias: create-imaging)
  list
  help

Global Flags:
   --help                                   show help (default: false)
   --edgerc value, -e value                 Location of the credentials file (default: "/home/user/.edgerc") [$AKAMAI_EDGERC]
   --section value, -s value                Section of the credentials file (default: "default") [$AKAMAI_EDGERC_SECTION]
   --accountkey value, --account-key value  Account switch key [$AKAMAI_EDGERC_ACCOUNT_KEY]
   --version                                Output CLI version (default: false)

GTM Domains

Usage

   akamai terraform [global flags] export-domain [flags] <domain>

Flags:
   --tfworkpath path       Directory used to store files created when running commands. (default: current directory)
   --resources             Creates a JSON-formatted resource file for import: <domain>_resources.json. The createconfig flag uses this file as an input. (default: false)
   --createconfig          Creates these Terraform configuration files based on the values in <domain>_resources.json: <domain>.tf and gtmvars.tf. Also creates this import script: <domain>_import.script. (default: false)

Export list of all domain objects. Written in json format to _resources.json

$ akamai terraform export-domain --resources example.akadns.net

Generate Terraform GTM Domain configuration file .tf, vars config file, gtmvars.tf, and import script, _resource_import.script

$ akamai terraform export-domain --createconfig example.akadns.net

Domain Notes:

1. Mapping GTM entity names to TF resource names may require normalization. Invalid TF resource name characters will be replaced by underscores, '_' in config generation.

EdgeDNS Zones

Usage

   akamai terraform [global flags] export-zone [flags] <zone>

Flags: 
   --tfworkpath path       Directory used to store files created when running commands. (default: current directory)
   --resources             Creates a JSON-formatted resource file for import: <zone>_resources.json. The createconfig flag uses this file as an input. (default: false)
   --createconfig          Creates these Terraform configuration files based on the values in <zone>_resources.json: <zone>.tf and dnsvars.tf. (default: false)
   --importscript          Creates import script for generated Terraform configuration script (<zone>_import.script) files. (default: false)
   --segmentconfig         Use with the createconfig flag to group and segment records by name into separate config files. (default: false)
   --configonly            Directive for createconfig. Create entire Terraform zone and recordsets configuration (<zone>.tf), dnsvars.tf. Saves zone config for 
                           importscript. Ignores any existing resource JSON file. (default: false)
   --namesonly             Directive for both resource gathering and config generation. All record set types assumed. (default: false)
   --recordname value      Used in resources gathering or with configonly to filter recordsets. Multiple recordname flags may be specified.

Export List of Zone Recordsets. Written in json format to _resources.json

$ akamai terraform export-zone --resources testprimaryzone.com

Generate Terraform Zone configuration file. Default args create .tf, vars config file, dnsvars.tf

$ akamai terraform export-zone --createconfig testprimaryzone.com

Generate Zone import script, _resource_import.script

$ akamai terraform export-zone --importscript testprimaryzone.com

Zone Notes

1. The resources directive generates a _resources.json file for consumption by createconfig
2. The createconfig directive generates a _zoneconfig.json file for consumption by importscript

Advanced options for --resources

1. recordname - filters generated resources list by record name(s)
2. namesonly - Generates resource file with recordset names only. All associated Types will be represented.

Advanced options for --createconfig

1. namesonly - Resources for all associated Types will be generated
2. segmentconfig - Generate a modularized configuration.
3. configonly - Generates a zone configuration without JSON itemization. The configuration generated varies based on which set of flags you use.

Appsec

Usage

   akamai terraform [global flags] export-appsec [flags] <name_of_security_config>
   
Flags:
   --tfworkpath path      Directory used to store files created when running commands. (default: current directory)

Property Manager Properties

Usage

   akamai terraform [global flags] export-property [flags] <property name>

Flags:
   --tfworkpath path      Directory used to store files created when running commands. (default: current directory)
   --version value        Property version to import  (default: LATEST)

Export property manager property configuration.

$ akamai terraform export-property

Cloudlets

Usage

   akamai terraform [global flags] export-cloudlets-policy [flags] <policy_name>

Flags:
   --tfworkpath path      Directory used to store files created when running commands. (default: current directory)

Export Cloudlets Policy configuration.

$ akamai terraform export-cloudlets-policy

Edgeworkers

Export EdgeKV Usage

   akamai terraform [global flags] export-edgekv [flags] <namespace_name> <network>

Flags:
   --tfworkpath path      Directory used to store files created when running commands. (default: current directory)

Export edgekv configuration.

$ akamai terraform export-edgekv

Export EdgeWorker Usage

   akamai terraform [global flags] export-edgeworker [flags] <edgeworker_id>

Flags:
   --bundlepath path      Path location for placement of EdgeWorkers tgz code bundle. Default: same value as tfworkpath
   --tfworkpath path      Directory used to store files created when running commands. (default: current directory)

Export edgeworker configuration.

$ akamai terraform export-edgekv

Identity and Access Management

Export Identity and Access Management usage

   akamai terraform [global flags] export-iam [subcommand]

Subcommands:
    all                     Exports all available Terraform Users, Groups and Roles
    group [group id]        Exports group by id with relevant users and their roles
    role [role id]          Exports role by id with relevant users and their groups
    user [user's email]     Exports user by email with relevant user's groups and roles

Flags:
   --tfworkpath path      Directory used to store files created when running commands. (default: current directory)

Export Identity and Access Management configuration.

$ akamai terraform export-iam

Image and Video Manager

Export Image and Video policy usage

   akamai terraform [global flags] export-imaging [flags] <contract_id> <policy_set_id>

Flags:
   --tfworkpath path         Directory used to store files created when running commands. (default: current directory)
   --policy-json-dir path    Path location for placement of policy jsons. Default: same value as tfworkpath

Export Image and Video policy configuration.

$ akamai terraform export-imaging

Certificate Provisioning System (CPS)

Export CPS usage

   akamai terraform [global flags] export-cps [flags] <enrollment_id> <contract_id>

Flags:
   --tfworkpath path                        Directory used to store files created when running commands. (default: current directory)

Export CPS configuration.

$ akamai terraform export-cps

General Notes

1. Terraform variable configuration is generated in a separately named TF file for each Akamai entity type. These files will need to be merged by the Admin in the case where multiple entities are managed concurrently with the Terraform client.

License

This package is licensed under the Apache 2.0 License. See LICENSE for details.

Documentation

Overview

Package main contains entry code for the application