Skip to content

Latest commit

 

History

History
90 lines (67 loc) · 4.48 KB

local_installation.md

File metadata and controls

90 lines (67 loc) · 4.48 KB
Raw
page_title
Local Installation

Terraform Version 0.12 Local Installation

One-liner download for macOS / Linux:

mkdir -p ~/.terraform.d/plugins &&
      curl -Ls https://api.github.com/repos/Cox-Automotive/terraform-provider-alks/releases/latest |
      jq -r ".assets[] | select(.browser_download_url | contains(\"$(uname -s | tr A-Z a-z)\")) | select(.browser_download_url | contains(\"amd64\")) | .browser_download_url" |
            xargs -n 1 curl -Lo ~/.terraform.d/plugins/terraform-provider-alks.zip &&
      pushd ~/.terraform.d/plugins/ &&
      unzip ~/.terraform.d/plugins/terraform-provider-alks.zip -d terraform-provider-alks-tmp &&
      mv terraform-provider-alks-tmp/terraform-provider-alks* . &&
      chmod +x terraform-provider-alks* &&
      rm -rf terraform-provider-alks-tmp &&
      rm -rf terraform-provider-alks.zip &&
      popd

Manual Installation:

  • Download ALKS Provider binary for your platform from Releases

  • Configure Terraform to use this plugin by placing the binary in .terraform.d/plugins/ on MacOS/Linux or terraform.d\plugins\ in your user's "Application Data" directory on Windows.

  • Note: If you've used a previous version of the ALKS provider and created a .terraformrc file in your home directory you'll want to remove it prior to updating.

  • Finally, configure Terraform.

    • In your versions.tf or main.tf file you'll want to add the new ALKS provider as such:
    provider "alks" {
   url       = "https://alks.coxautoinc.com/rest"
   version   = "YOUR_VERSION_HERE"
}

Terraform Version 0.13+ Local Installation

One-liner download for macOS / Linux:

mkdir -p ~/.terraform.d/plugins/Cox-Automotive/engineering-enablement/alks/2.0.5/darwin_amd64 &&
      curl -Ls https://api.github.com/repos/Cox-Automotive/terraform-provider-alks/releases | jq -r --arg release "v2.0.5" --arg arch "$(uname -s | tr A-Z a-z)" '.[] | select(.tag_name | contains($release)) | .assets[]| select(.browser_download_url | contains($arch)) | select(.browser_download_url | contains("amd64")) | .browser_download_url' |
            xargs -n 1 curl -Lo ~/.terraform.d/plugins/Cox-Automotive/engineering-enablement/alks/2.0.5/darwin_amd64/terraform-provider-alks.zip &&
      pushd ~/.terraform.d/plugins/Cox-Automotive/engineering-enablement/alks/2.0.5/darwin_amd64 &&
      unzip ~/.terraform.d/plugins/Cox-Automotive/engineering-enablement/alks/2.0.5/darwin_amd64/terraform-provider-alks.zip -d terraform-provider-alks-tmp &&
      mv terraform-provider-alks-tmp/terraform-provider-alks* . &&
      chmod +x terraform-provider-alks* &&
      rm -rf terraform-provider-alks-tmp &&
      rm -rf terraform-provider-alks.zip &&
      popd

!> Warning: Your binary has been placed in /.terraform.d/plugins/Cox-Automotive/engineering-enablement/alks/1.5.12/darwin_amd64. For more information on WHY, read here.

Manual Installation:

  • Download ALKS Provider binary for your platform from Releases

  • Go into the Terraform plugins path; .terraform.d/plugins/ on MacOS/Linux or terraform.d\plugins\ in your user's "Application Data" directory on Windows.

  • Create the following directories: coxautoinc.com/engineering-enablement/alks/<VERSION>/<OS>_<ARCH> and put the binary into the <OS>_<ARCH>/ directory.

    • Note: This <OS>_<ARCH> will vary depending on your system. For example, 64-bit MacOS will be: darwin_amd64 while 64-bit Windows 10 will be: windows_amd64

  • Place / mv the downloaded binary into the directory above.

  • Finally, configure Terraform.

    • In your versions.tf or main.tf file you'll want to add the new ALKS provider as such:
    terraform {
    required_version = ">= 0.13"
    required_providers {
        alks = {
          source  = "Cox-Automotive/engineering-enablement/alks"
          version = "YOUR_VERSION_HERE"
        }
    }
}

  • Note: If you've previously installed our provider, and it is stored in your remote state: you may need to run the replace-provider command.