Skip to content

Latest commit

 

History

History
87 lines (61 loc) · 3.95 KB

README.md

File metadata and controls

87 lines (61 loc) · 3.95 KB
Raw

speech-to-text Infrastructure-as-Code

==============================

A Terraform configuration for deploying a speech-to-text app on IBM Container Service.

This configuration template is tested for IBM Cloud Provider version v0.6.0

Follow the instructions on the Getting Started with IBM Cloud Schematics documentation page.

Setting Description
Source control URL Enter the GitHub URL where you forked the configuration.
Environment Enter a unique name to assign to your environment.
Variables You can define variables in the service or override the environment variables that are in your .tf files. You can mask sensitive variables when you click the eye icon. Masking variables prevents other users from seeing the hidden values in the environment details page.
Add the following variables and values to work with the configuration:
bluemix_api_key - Enter your IBM Bluemix API key.

Usage with Terraform Binary on your local workstation

You will need to setup up IBM Cloud provider credentials on your local machine.

Prerequisite

  1. Download Terraform binary. Unzip it and keep the binary in path ex- /usr/local/bin.
  2. Download IBM Cloud Provider Plugin. Unzip it and keep the binary in path in the same directory where you placed Terraform binary in previous step. You can also build the binary yourself. Please look into documentation.

To run this project locally execute the following steps:

  • You can override default values that are in your variables.tf file.
  • terraform apply: this will create actual infrastructure
  • terraform destroy: this will destroy all infrastructure which has been created

Setting up Provider Credentials

To setup the IBM Cloud provider to work with this example there are a few options for managing credentials safely; here we'll cover the preferred method using environment variables. Other methods can be used, please see the Terraform Getting Started Variable documentation for further details.

Environment Variables using IBMid credentials

You'll need to export the following environment variables:

  • TF_VAR_bluemix_api_key - your Bluemix api key
  • TF_VAR_space - provide Bluemix space
  • TF_VAR_org - provide Bluemix org
  • TF_VAR_private_vlan_id - provide private vlan id
  • TF_VAR_public_vlan_id - provide public vlan id
  • TF_VAR_subnet_id - provide subnet id

On OS X this is achieved by entering the following into your terminal, replacing the <value> characters with the actual values (remove the <>:

  • export TF_VAR_bluemix_api_key=<value>
  • export TF_VAR_space=<value>
  • export TF_VAR_org=<value>
  • export TF_VAR_private_vlan_id=<value>
  • export TF_VAR_public_vlan_id=<value>
  • export TF_VAR_subnet_id=<value>

Variables

Variable Name Description Default Value
space Bluemix Space
org Bluemix Org
region eu-de
datacenter ams03
machine_type u2c.2x4
isolation public
private_vlan_id
public_vlan_id
subnet_id
service_instance_name speech-to-text-service
service_key myservicekey
service_offering speech_to_text
plan standard
cluster_name speech-to-text

Output

Upon completion, terraform will output the url of the application, e.g.:

app_url = "<url>"

Use this url to access your application