Skip to content
This repository has been archived by the owner on Nov 26, 2024. It is now read-only.

Latest commit

 

History

History
96 lines (67 loc) · 4.36 KB

init-softlayer.md

File metadata and controls

96 lines (67 loc) · 4.36 KB
Raw

This document shows how to create a new environment on IBM Cloud Infrastructure (previously called SoftLayer).

Step 1: Prepare an IBM Cloud Infrastructure Environment {: #prepare }

To prepare your IBM Cloud Infrastructure environment:

Create a SoftLayer account {: #account }

If you do not have an SoftLayer account, create one for one month free.

Use the login credentials received in your provided email to login to SoftLayer Customer Portal.

Generate an API Key {: #api-key }

API keys are used to securely access the SoftLayer API. Follow Generate an API Key to generate your API key.

Access SoftLayer VPN {: #vpn }

To access SoftLayer Private network, you need to access SoftLayer VPN. Follow VPN Access to access the VPN. You can get your VPN password from your user profile. Follow VPN Access to access the VPN.

Order VLANs {: #vlan }

VLANs provide the ability to partition devices and subnets on the network. To order VLANs, login to SoftLayer Customer Portal and navigate to Network > IP Management > VLANs. Once on the page, click the "Order VLAN" link in the top-right corner. Fill in the pop-up window to order the VLANs as you need. The VLAN IDs are needed in the deployment manifest.

Step 2: Deploy {: #deploy }

  1. Install BOSH CLI v2, make sure to download SoftLayer specific version of bosh-cli linux or mac.

  2. Establish VPN to make sure you can connect to IBM Cloud Infrastructure over private network from your workstation where to run BOSH CLI.

  3. [Option 1 ] Apply a portable IP from Softlayer or

    [Option 2 ] Create a clean VM on Softlayer and generate state file (including VM CID and IP) using this script

    Example:

    ./create_vm_sl.sh -h <hostname> -d softlayer.com -c 2 -m 4096 -hb true -ld false -da false -ms 100 -dc dal09 -uv <public_vlan> -iv <private_vlane> -u <username> -k <api_key> > /tmp/state.json

    No matter which option you select, let's say the portable IP or dynamic IP (in state.json) is 10.0.0.6

  4. Use bosh create-env command to deploy the Director.

    # Create a worksapce directory to keep state
$ mkdir -p bosh-workspace && cd bosh-workspace

# Copy state.json generated in step #3 into bosh-workspace
cp /tmp/state.json .

# Clone Director templates
$ git clone https://github.com/cloudfoundry/bosh-deployment

# Fill below variables (replace example values) and deploy the Director
$ sudo bosh create-env bosh-deployment/bosh.yml \
    --state=state.json \
    --vars-store=creds.yml \
    -o bosh-deployment/softlayer/cpi.yml \  # bosh-deployment/softlayer/cpi-dynamic.yml  if option 2 using dynamic IP
    -v director_name=bosh \
    -v internal_cidr=10.0.0.0/24 \        # Only for option 1 portable IP
    -v internal_gw=10.0.0.1 \             # Only for option 1 portable IP
    -v internal_ip=10.0.0.6 \
    -v sl_datacenter= \
    -v sl_vm_domain= \
    -v sl_vm_name_prefix= \
    -v sl_vlan_public= \
    -v sl_vlan_private= \
    -v sl_username= \
    -v sl_api_key=

  5. Connect to the Director.

    # Configure local alias
$ bosh alias-env bosh -e 10.0.0.6 --ca-cert <(bosh int ./creds.yml --path /director_ssl/ca)

# Log in to the Director
$ export BOSH_CLIENT=admin
$ export BOSH_CLIENT_SECRET=`bosh int ./creds.yml --path /admin_password`

# Query the Director for more info
$ bosh -e bosh env

  6. Save the deployment state files stored in your workspace directory bosh-workspace for future update/deletion. See Deployment state for details.