forked from pivotal-cf/docs-pcf-gsg
-
Notifications
You must be signed in to change notification settings - Fork 0
/
index.html.md.erb
111 lines (73 loc) · 8.33 KB
/
index.html.md.erb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
---
breadcrumb: Pivotal Cloud Foundry Documentation
title: Architecture and Installation Overview
owner: PCF Documentation
---
##<a id='who'></a>For PCF Architects and Operators
This guide shows you how to design a Pivotal Cloud Foundry (PCF) platform and install it on an IaaS. If you are doing this, you have one or both of the following roles:
* **Architects** design a PCF platform. They know the IaaS that they will deploy it to, and what other relevant resources they have. In their design, they consider needs for the platform's capacity, availability, security, geography, budget, and other factors. If they do not install PCF themselves, they provide the architectural specifications to whoever does.
* **Operators** run a PCF platform, keep it up-to-date, monitor its health and performance, and fix any problems. They may also install the platform, or perform "Day 2" configurations that expand its functionality and integrate it with external systems.
This guide helps people in both roles create a PCF platform that does what they want it to. The contents of this guide follow the phases of a typical PCF planning and installation effort.
<p class='note'><strong>Note:</strong> Elastic Runtime has been renamed Pivotal Application Service.</p>
##<a id='overview'></a>Planning and Installation Overview
PCF is a suite of products that runs on multiple IaaSes. Planning and installing PCF means building layers from the bottom up, starting with the details of your IaaS and ending with "Day 2" configurations that you perform on a installed and running PCF deployment.
Here's the typical PCF planning and installation process:
1. **Plan**
- Review the Requirements for your IaaS ([AWS](../customizing/aws.html), [Azure](../customizing/azure.html), [GCP](../customizing/gcp.html), [OpenStack](../customizing/openstack.html), [vSphere](../customizing/vsphere.html)).
- Refer to the Reference Architecture for your IaaS.
- Assess your platform needs, including capacity, availability, container support, host OS, resource isolation, and geographical distribution. Discuss with your Pivotal contact.
1. **Deploy BOSH and Ops Manager**
- [BOSH](http://bosh.io) is an open-source tool that lets you run software systems in the cloud.
- BOSH and its IaaS-specific Cloud Provider Interfaces (CPIs) are what enable PCF to run on multiple IaaSes.
- See [Deploying with BOSH](../customizing/index.html#bosh) for a brief description of the BOSH deployment process.
- [Ops Manager](../customizing/ops-man.html) is a GUI application deployed by BOSH that streamlines deploying subsequent software to the cloud via BOSH.
- Ops Manager represents PCF products as _tiles_ with multiple configuration panes that let you input or select configuration values needed for the product.
- Ops Manager generates BOSH manifests containing the user-supplied configuration values, and sends them to the Director.
- After you install Ops Manager and BOSH, you use Ops Manager to deploy almost all PCF products.
- Deploying Ops Manager deploys both BOSH and Ops Manager with a single procedure.
- On AWS, you can deploy Ops Manager manually, or automatically with a CloudFormation template.
- On Azure, you can deploy Ops Manager manually, or automatically with an Azure Resource Manager (ARM) template. On Azure Government Cloud and Azure Germany you can only deploy Ops Manager manually.
1. **Deploy BOSH Add-ons** (Optional)
- BOSH add-ons include the [IPsec](https://docs.pivotal.io/addon-ipsec), [ClamAV](https://docs.pivotal.io/addon-antivirus/), and [File Integrity Monitoring](https://docs.pivotal.io/addon-fim), which enhance PCF platform security and security logging.
- You deploy these add-ons via BOSH rather than installing them with Ops Manager tiles.
1. **Install Runtimes**
- [PAS](../customizing/pas.html) (Pivotal Application Service) lets developers develop and manage cloud-native apps and software services.
- PAS is based on the Cloud Foundry Foundation's open-source Application Runtime (formerly Elastic Runtime) project.
- [PCF Isolation Segment](../customizing/installing-pcf-is.html) lets a single PAS deployment run apps from separate, isolated pools of computing, routing, and logging resources.
- Operators replicate and configure an Isolation Segment tile for each new resource pool they want to create.
- You must install PAS before you can install Isolation Segment.
- [PAS for Windows 2012R2](https://docs-pas-windows.cfapps.io/pas-windows/index.html) enables PAS to manage Windows Server 2012 cells hosting .NET apps, and can also be replicated to create multiple isolated resource pools.
- As with Isolation Segment, Operators replicate and configure a PAS for Windows 2012R2 tile for each new resource pool they want to create.
- You must install PAS before you can install PAS for Windows 2012R2.
- [Small Footprint PAS](../customizing/small-footprint.html) is an alternative to PAS that uses far fewer VMs than PAS but has limitations.
1. **Day 2 Configurations**
- Day 2 configurations set up internal operations and external integrations on a running PCF platform.
- Examples include front-end configuration, user accounts, logging and monitoring, internal security, and container and stemcell images.
1. **Install Services**
- Install software services for PCF developers to use in their apps.
- Services include the databases, caches, and message brokers that stateless cloud apps rely on to save information.
- Installing and managing software services on PCF is an ongoing process, and is covered in the [PCF Operator Guide](../opsguide/index.html).
##<a id='contents'></a>Guide Contents
This guide has two parts. The first part explains the PCF planning and installation process, and the second describes the main tools that operators use when installing PCF.
### Planning and Installation
PCF is a suite of products that runs on multiple IaaSes. Planning and installing PCF means building layers from the bottom up, starting with the details of your IaaS and ending with "Day 2" configurations that you perform on a installed and running PCF deployment.
The first part of this guide follows this bottom-up progression:
* <a href="/pivotalcf/2-0/customizing/plan.html">Planning PCF</a> - Design a PCF platform that runs on your IaaS and fits your needs.
* <a href="/pivotalcf/2-0/customizing/deploy-bosh-om.html">Deploying BOSH and Ops Manager</a> - Build the foundation of PCF.
* <a href="/pivotalcf/2-0/customizing/add-ons.html">Deploying BOSH Add-Ons</a> - Use BOSH to extend foundation-level PCF capabilities.
* <a href="/pivotalcf/2-0/customizing/runtimes.html">Installing Runtimes</a> - Install the application and container runtime environments that PCF exists for.
* <a href="/pivotalcf/2-0/customizing/platform-tiles.html">Installing Platform Extension Tiles</a> - Use Ops Manager to extend PCF platform capabilities.
* <a href="/pivotalcf/2-0/customizing/day2.html">"Day 2" Configurations</a> - Set up internal operations and external integrations for PCF.
After installing PCF, Operators install the software services that PCF developers use in their apps. These PCF services include the databases, caches, and message brokers that stateless cloud apps rely on to save information.
Installing and managing software services on PCF is an ongoing process, and is covered in the [PCF Operator Guide](../opsguide/index.html).
### Tools and Reference
The second part of this guide explains the main PCF tools that operators use when installing PCF:
* <a href="/pivotalcf/2-0/customizing/ops-man.html">Using Ops Manager</a>
* <a href="/pivotalcf/2-0/cf-cli/index.html">Using the Cloud Foundry Command Line Interface (cf CLI)</a>
* <a href="/pivotalcf/2-0/customizing/troubleshooting-diagnostics.html">Troubleshooting and Diagnostics</a>
##<a id='pcf-docs'></a>Related Documentation
The [PCF Operator Guide](../opsguide/index.html) explains how to maintain a running PCF platform, including monitoring, tuning, troubleshooting, and upgrading.
The [PCF Security Guide](../security/index.html) explains how PCF security sytems work and how to keep your PCF platform secure.
[Getting Started with PCF](../concepts/overview.html) gives a high-level overview of how PCF works and explains how you can try a
a simple deployment on your own local machine.
See [Pivotal Cloud Foundry Documentation](./pcf-docs.html) for all PCF documentation.