You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: jekyll/_ccie/single-box.md
+40-24Lines changed: 40 additions & 24 deletions
Original file line number
Diff line number
Diff line change
@@ -8,44 +8,32 @@ description: "How to install CircleCI Enterprise on a single VM"
8
8
---
9
9
10
10
CircleCI Enterprise is a scalable CI/CD platform that supports clusters
11
-
of tens or hundreds of build machines. This document provides instructions for installing and running the platform on a single virtual machine to provide a simple mechanism for getting started with a small trial in any environment.
11
+
of tens or hundreds of build machines. This document provides instructions for installing and running the platform on a single virtual machine to provide a simple mechanism for getting started with a small trial in any environment:
12
+
13
+
* TOC
14
+
{:toc}
12
15
13
16
## Prerequisites
14
17
15
-
Following are required for successful trial installation:
18
+
The following requirements must be met for successful trial installation:
16
19
17
20
-[Sign-up](https://circleci.com/enterprise-trial-install/) to recieve a trial license file.
18
21
- Use **GitHub.com or GitHub Enterprise** for version control.
19
22
- Machines running CircleCI Enterprise and GitHub must be able to reach each other on the network.
20
23
- CircleCI Enterprise machine must have outbound internet access. If you use a proxy server, [Contact us](mailto:[email protected]) for instructions.
21
24
22
-
## Steps for Installation
23
-
24
-
1. Launch a VM with at least 8GB of RAM, 100GB of disk space on the root volume, and a version of Linux that supports Docker, for example Ubuntu Trusty 14.04.
25
-
26
-
2. Open ports 22 and 8800 to administrators, open ports 80 and 443 to all users, and optionally open ports 64535-65535 to developers to SSH into builds.
27
-
28
-
3. Install Replicated, the tool used to package and distribute CircleCI Enterprise, by running the `curl https://get.replicated.com/docker | sudo bash` command. **Note:** Docker must not use the device mapper storage driver. Check this by running `sudo docker info | grep "Storage Driver"`.)
29
-
30
-
4. Visit port 8800 on the machine in a web browser to complete the guided installation process.
31
-
32
-
5. Complete the SSL certificate, license upload, admin password, hostname configuration, GitHub OAuth registration, and protocol settings to begin application start up.
33
-
34
-
6. Open the CircleCI Enterprise app and click Get Started to authorize your GitHub account. The Add Projects page appears where you can select a project for your first build.
35
-
36
-
37
-
## Steps for AWS EC2 Installation
25
+
## Steps for Installation on AWS EC2
38
26
39
-
The following steps install CircleCI Enterprise on a single EC2 VM by using the pre-made Amazon Machine Image (AMI) which is a special type of virtual appliance that is used to create a virtual machine within the Amazon Elastic Compute Cloud ("EC2").
27
+
Use this procedure to install CircleCI Enterprise on a single EC2 VM by using the pre-made Amazon Machine Image (AMI) which is a special type of virtual appliance that is used to create a virtual machine within the Amazon Elastic Compute Cloud ("EC2").
40
28
41
29
**Note:** All builds that run on the installed machine will have access
42
-
to the AWS Identity and Access Management (IAM) privileges associated with its instance profile. Do not
30
+
to the AWS Identity and Access Management (IAM) privileges associated with its instance profile. Do **not**
43
31
give any inappropriate privileges to your instance. It is possible to block
44
-
this access with `iptables` rules in a production setup, [contact us](mailto:[email protected])
32
+
this access with `iptables` rules in a production setup, [contact support](mailto:[email protected])
45
33
for specific instructions.
46
34
47
35
<ol>
48
-
<li>Find the AMazon Machine Image with at least 8G of RAM in your region from the following list:<br>
36
+
<li>Find the Amazon Machine Image with at least 8G of RAM in your region from the following list:<br>
49
37
50
38
<script>
51
39
var amiIds = {
@@ -93,13 +81,41 @@ for specific instructions.
93
81
<li>(Optional) To enable developers to SSH into builds for debugging purposes, open ports 64535-65535.
94
82
</li>
95
83
96
-
<li>After the VM is lauched, go to the public or private IP address or hostname for the VM to complete the rest of the guided installation process. **Note:** Final startup of the app can take some time to complete while it is dowloading the "circleci/build-image" Docker image.</li>
84
+
<li>After the VM is lauched, go to the public or private IP address or hostname for the VM to complete the rest of the guided installation process.
85
+
</li>
86
+
87
+
<li>Complete the process by choosing an SSL certificate option, uploading the license, setting the admin password and hostnames, enabling GitHub OAuth registration, and defining protocol settings. The application start up process begins by downloading the ~160 MB docker image, so it may take some time to complete.
88
+
</li>
89
+
90
+
<li>Open the CircleCI Enterprise app and click Get Started to authorize your GitHub account. The Add Projects page appears where you can select a project for your first build.
91
+
</li>
97
92
</ol>
98
93
99
-
<pstyle="font-size: 20px; text-align: center"><strong>A short video walkthrough of the entire install process on AWS:</strong></p>
94
+
### AWS Installation Video Tutorial
95
+
96
+
<pstyle="font-size: 20px; text-align: center">Following is a short video walkthrough of the entire install process on AWS:</p>
## Steps for Installation on Cloud Storage Providers Other Than AWS
102
+
103
+
1. Launch a VM with at least 8GB of RAM, 100GB of disk space on the root volume, and a version of Linux that supports Docker, for example Ubuntu Trusty 14.04.
104
+
105
+
2. Open ports 22 and 8800 to administrators, open ports 80 and 443 to all users, and optionally open ports 64535-65535 to developers to SSH into builds.
106
+
107
+
3. Install Replicated, the tool used to package and distribute CircleCI Enterprise, by running the `curl https://get.replicated.com/docker | sudo bash` command. **Note:** Docker must not use the device mapper storage driver. Check this by running `sudo docker info | grep "Storage Driver"`.)
108
+
109
+
4. Visit port 8800 on the machine in a web browser to complete the guided installation process.
110
+
111
+
5. Complete the process by choosing an SSL certificate option, uploading the license, setting the admin password and hostnames, enabling GitHub OAuth registration, and defining protocol settings. The application start up process begins by downloading the ~160 MB docker image, so it may take some time to complete.
112
+
113
+
6. Open the CircleCI Enterprise app and click Get Started to authorize your GitHub account. The Add Projects page appears where you can select a project for your first build.
0 commit comments