CircleCI Server v3.x - Creating Your First Cluster (Optional)
Step 1 - Create
CircleCI recommends using
eksctl to set up your first cluster on AWS.
eksctl will take care of VPC creation, in addition
to security group selection.
Before creating the cluster, make sure you have the following:
Create a cluster using flags
To create a simple cluster, you can run the command:
eksctl create cluster
Additional flags are available on the command line. See the
eksctl introduction for more information.
Create cluster using a configuration file
You can also create a config file for your cluster, for example:
apiVersion: eksctl.io/v1alpha5 kind: ClusterConfig metadata: name: <your-cluster-name> region: <aws-region> managedNodeGroups: - name: <nodegroup-name-1> instanceType: <instance-type> # i.e., m5.large. see https://aws.amazon.com/ec2/instance-types/ for available instance types minSize: 4 # see https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-as-group.html#cfn-as-group-minsize for more information maxSize: 6 # see https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-as-group.html#cfn-as-group-maxsize for more information
For more examples on cluster configuration files, see eksctl.io.
When you are finished with your configuration, save it and run:
eksctl create cluster -f <your-cluster-config.yaml>
When using the
Step 2 - Verify
Once your cluster is finished being created, you should be able to run various
kubectl commands to view your cluster resources.
For instance, to view your cluster’s built-in services, you can run:
Or, to verify that your cluster has worker nodes attached, run:
kubectl get nodes -o wide
For more information on exploring your new cluster, see the following:
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub. We welcome your contributions.
- Suggest an edit to this page (please read the contributing guide first).
- To report a problem in the documentation, or to submit feedback and comments, please open an issue on GitHub.
- CircleCI is always seeking ways to improve your experience with our platform. If you would like to share feedback, please join our research community.
CircleCI Documentation by CircleCI is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.