Cloud Foundry Installation Documentation Release 0.1

Lumír Jasiok

Sep 14, 2017

Contents:

1 Getting Started 1

2 OpenStack Installation 3 2.1 OpenStack Requirements...... 3

3 Glossary 5

4 Indices and tables 7

i ii CHAPTER 1

Getting Started

Using this documentation you should be able to deploy Foundry in easy and (mostly) automated way. First things first. Please read Glossary to be familiar with terminology and return back. Now, you have to clone repository with code to your computer. Go to the directory (of your choose) you created for Cloud Foundry deployment and run following code: git clone https://github.com/jas02/cloudfoundry-installation.git

I am assuming, that you have installed Git. Now you should have in current directory sub-directory cloudfoundry-installation

1 Cloud Foundry Installation Documentation, Release 0.1

2 Chapter 1. Getting Started CHAPTER 2

OpenStack Installation

OpenStack Requirements

First, you have to ask your OpenStack administrator to create for you OpenStack project and credentials. Project should have at least following parameters:

Hardware Requirements

Instances VCPUs RAM Volumes Volume Storage 21 50 90GB 48 1.2TB

Assign Floating IP and Create DNS Record

To be allow access you Cloud Foundry instance from the outside OpenStack, you must have assigned Floating IP and create wildcard DNS record. To get Floating IP , you can use script in bin/cfi-assign-floating-ip.py in the cloudfoundry-installation repository directory. But before you can run the script, you have to cre- ate configuration file clouds.yaml and place it into the right directory. In case that you are using Linux, the directory is ~/.config/. So full path is ~/.config/openstack/clouds.yaml. In case of macOS, the full path for clouds.yaml is ~/Library/Application Support/openstack/ clouds.yaml. The content of clouds.yaml should be as follows: clouds: osinstancename: region_name: RegionOne auth: username: your_username password: XXXXXXX

3 Cloud Foundry Installation Documentation, Release 0.1

project_name:'your_project_name' auth_url:'https://openstack.yourdomain.com:5000/v2.0'

Of course, you have to change: • region_name: In case that is different, than OpenStack default RegionOne • username: OpenStack username • password: OpenStack password • project_name: OpenStack project name, provided by OpenStack administrator, that created project for you • auth_url: URL to the OpenStack Keystone API 2.0 server

4 Chapter 2. OpenStack Installation CHAPTER 3

Glossary

This is a work-in-progress list of commonly used terms when discussing Cloud Foundry. 501(c)(6) It means a tax-exempt nonprofit organization, like many other types of 501(c)s. BOSH BOSH is an open source project which offers a tool chain for release engineering, deployment & life-cycle management of large scale distributed services. Cloud Foundry Cloud Foundry is an open source, multi cloud application platform (PaaS) governed by the Cloud Foundry Foundation, a 501(c)(6) organization. Git Git is a version control system (VCS) for tracking changes in computer files and coordinating work on those files among multiple people. It is primarily used for source code management in software development,[8] but it can be used to keep track of changes in any set of files. Keystone Keystone is the identity service used by OpenStack for authentication (authN) and high-level authorization (authZ). It currently supports token-based authN and user-service authorization. It has recently been rearchi- tected to allow for expansion to support proxying external services and AuthN/AuthZ mechanisms such as oAuth, SAML and openID in future versions. OpenStack OpenStack is a free and open-source software platform for , mostly deployed as infrastructure-as-a-service (IaaS).

5 Cloud Foundry Installation Documentation, Release 0.1

6 Chapter 3. Glossary CHAPTER 4

Indices and tables

• genindex

7 Cloud Foundry Installation Documentation, Release 0.1

8 Chapter 4. Indices and tables Index

Symbols 501(c)(6), 5 B BOSH, 5 C Cloud Foundry, 5 G Git, 5 K Keystone, 5 O OpenStack, 5

9