This cookbook serves as a platform to install Chef Automate in a couple of ways:
- As a number of virtual machines spun up via Test Kitchen and vagrant,
- Using a number of existing hosts onto which the Chef Automate services can be deployed.
Look at the available platforms in .kitchen.yml
:
platforms:
- name: centos-6.8
- name: centos-7.3
- name: ubuntu-14.04
- name: ubuntu-16.04
Select ONE of the platforms to install Chef Automate.
NOTE: For this example, we'll use centos-7.3.
-
Run
kitchen list centos-73
to see the list of instances that will get created:$ kitchen list centos-73 Instance Driver Provisioner Verifier Transport Last Action Last Error chef-server-centos-73 Vagrant ChefZero Inspec Ssh <Not Created> <None> automate-centos-73 Vagrant ChefZero Inspec Ssh <Not Created> <None> build-centos-73 Vagrant ChefZero Inspec Ssh <Not Created> <None> supermarket-centos-73 Vagrant ChefZero Inspec Ssh <Not Created> <None> compliance-centos-73 Vagrant ChefZero Inspec Ssh <Not Created> <None>
-
Create the instances:
$ kitchen converge centos-73
While the instances are getting created and converged, execute Step 3 below.
- Add the following lines to your local workstation
/etc/hosts
:
33.33.33.10 chef.services.com
33.33.33.11 automate.services.com
33.33.33.12 build.services.com
33.33.33.13 supermarket.services.com
33.33.33.14 compliance.services.com
Once the kitchen converge ...
has completed, the various logins can be tested as follows.
- Browse to http://chef.services.com
- Sign in with: Username: delivery Password: delivery
-
Obtain the credentials for the Automate login using this command:
kitchen exec automate-centos-73 -c 'cat /etc/delivery/test.creds'
-
Browse to http://automate.services.com/e/test
-
Sign in with the credentials from Step 1.
Recommend creating a new admin user with a sane password:
- Browse to https://automate.services.com/e/test/#/users and select Users → + NEW USER.
- Fill in the FIRST NAME, LAST NAME, EMAIL, USERNAME, and PASSWORD fields. All check the admin role under Roles Within the Enterprise.
- Paste your public key into the SSH KEY field. Without this, subsequent
delivery
commands won't authenticate properly. - Click SAVE & CLOSE.
Future admin logins can use this account rather than the admin account with its cryptic password.
- Browse to http://supermarket.services.com
- Browse to http://compliance.services.com
- Sign in with: Username: admin Password: password
The sample pipeline we'll be using is from the National Parks Cookbook.
- Create a new Workflow Organization by browsing to https://automate.services.com/e/test/#/organizations.
- Fill in the ORGANIZATION NAME field with
travel-usa
. - Click SAVE & CLOSE.
- Browse to https://automate.services.com/e/test/#/organizations.
- Click on the travel-usa Workflow Org.
- Fill in the PROJECT NAME with
national_parks_cookbook
. - Select Chef Automate for the Source Code Provider.
- Click SAVE & CLOSE.
For this step, we only want to pull the cookbook source from github and not use github as our repo (We'll be using Chef Automate's git repo). So, we'll pull the source and then blow away the national_parks_cookbook/.git
directory.
-
Clone the source to the cookbook to the local workstation:
$ git clone https://github.com/billmeyer/national_parks_cookbook $ cd national_parks_cookbook
-
Change git repo from GitHub to Chef Automate:
$ git remote remove origin $ git remote add origin ssh://bmeyer@[email protected]:8989/test/travel-usa/national_parks_cookbook $ git remote add delivery ssh://bmeyer@[email protected]:8989/test/travel-usa/national_parks_cookbook
-
Create the project config file:
$ delivery setup --ent=test --org=travel-usa --user=bmeyer --server=automate.services.com $ delivery init
This use case can be used for on-premise installations of Chef Automate using supplied hosts.
kitchen create chef-server-centos-73
kitchen login chef-server-centos-73
sudo su -
NOTE: -u <username> should be a user account on the remote host that has sudo privileges on the remote host.
curl -O https://raw.githubusercontent.com/stephenlauck/chef-services/master/files/default/installer.sh && \
sudo bash ./installer.sh \
-u vagrant -p vagrant \
-c <chef-server-host-or-ip> \
-a <automate-server-host-or-ip> \
-b <build-server-host-or-ip>