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: