azure-aks-cluster

Azure Kubernetes Service (AKS) is a fully managed container orchestration service. AKS offers serverless Kubernetes, an integrated continuous integration and continuous delivery (CI/CD) experience, and enterprise-grade security and governance.

---

Design

For detailed information, check out our Operator Guide for this bundle.

Usage

Our bundles aren't intended to be used locally, outside of testing. Instead, our bundles are designed to be configured, connected, deployed and monitored in the Massdriver platform.

What are Bundles?

Bundles are the basic building blocks of infrastructure, applications, and architectures in Massdriver. Read more here.

Bundle

Params

Form input parameters for configuring a bundle for deployment.

View

Properties

• cluster (object): Configure the Kubernetes cluster.
  • enable_log_analytics (boolean): Enable Log Analytics for this cluster. Default: False.
• core_services (object): Configure core services in Kubernetes for Massdriver to manage.
  • azure_dns_zones (array): Add an Azure DNS Zone associated with this cluster to allow Kubernetes to automatically manage DNS records and SSL certificates.
    • Items (string)
  • enable_ingress (boolean): Enabling this will create an NGINX Ingress Controller in the cluster, allowing internet traffic to flow into web accessible services within the cluster. Default: False.
• monitoring (object)
  • prometheus (object): Configuration settings for the Prometheus instances that are automatically installed into the cluster to provide monitoring capabilities.
    • grafana_enabled (boolean): Install Grafana into the cluster to provide a metric visualizer. Default: False.
• node_groups (object): The node groups that should be used for this cluster.
  • additional_node_groups (array): Default: [].
    • Items (object)
      • compute_type (string): Compute type to use in the node group. Changing this forces a deletion and re-creation of the node group. Must be one of: ['General Purpose', 'Memory Optimized', 'Compute Optimized', 'Storage Optimized', 'GPU'].
      • max_size (number): Maximum number of instances in the node group. Minimum: 1. Maximum: 1000. Default: 10.
      • min_size (number): Minimum number of instances in the node group. Minimum: 1. Maximum: 1000. Default: 1.
      • name (string)
  • default_node_group (object): Configuration of the node group.
    • compute_type (string): Compute type to use in the node group. Changing this forces a deletion and re-creation of the node group. Must be one of: ['General Purpose', 'Memory Optimized', 'Compute Optimized', 'Storage Optimized', 'GPU'].
    • max_size (number): Maximum number of instances in the node group. Minimum: 1. Maximum: 1000. Default: 10.
    • min_size (number): Minimum number of instances in the node group. Minimum: 1. Maximum: 1000. Default: 1.
    • name (string)

Examples

{
    "__name": "Development",
    "node_groups": {
        "default_node_group": {
            "compute_type": "General Purpose",
            "max_size": 10,
            "min_size": 1,
            "name": "default",
            "node_size": "Standard_D2s_v3"
        }
    }
}

{
    "__name": "Production",
    "node_groups": {
        "additional_node_groups": [
            {
                "compute_type": "General Purpose",
                "max_size": 10,
                "min_size": 1,
                "name": "shared",
                "node_size": "Standard_D8s_v3"
            }
        ],
        "default_node_group": {
            "max_size": 10,
            "min_size": 1,
            "name": "default",
            "node_size": "Standard_D8s_v3"
        }
    }
}

{
    "__name": "Wizard",
    "cluster": {
        "enable_log_analytics": false
    },
    "core_services": {
        "azure_dns_zones": [],
        "enable_ingress": true
    },
    "node_groups": {
        "additional_node_groups": [],
        "default_node_group": {
            "compute_type": "General Purpose",
            "max_size": 5,
            "min_size": 1,
            "name": "default",
            "node_size": "Standard_B2s"
        }
    }
}

Connections

Connections from other bundles that this bundle depends on.

View

Properties

• azure_service_principal (object): . Cannot contain additional properties.

  • data (object)

    • client_id (string): A valid UUID field.

      Examples:

      "123xyz99-ab34-56cd-e7f8-456abc1q2w3e"

    • client_secret (string)

    • subscription_id (string): A valid UUID field.

      Examples:

      "123xyz99-ab34-56cd-e7f8-456abc1q2w3e"

    • tenant_id (string): A valid UUID field.

      Examples:

      "123xyz99-ab34-56cd-e7f8-456abc1q2w3e"

  • specs (object)

• vnet (object): . Cannot contain additional properties.

  • data (object)

    • infrastructure (object)

      • cidr (string)

        Examples:

        "10.100.0.0/16"

        "192.24.12.0/22"

      • default_subnet_id (string): Azure Resource ID.

        Examples:

        "/subscriptions/12345678-1234-1234-abcd-1234567890ab/resourceGroups/resource-group-name/providers/Microsoft.Network/virtualNetworks/network-name"

      • id (string): Azure Resource ID.

        Examples:

        "/subscriptions/12345678-1234-1234-abcd-1234567890ab/resourceGroups/resource-group-name/providers/Microsoft.Network/virtualNetworks/network-name"

  • specs (object)

    • azure (object): .
      • region (string): Select the Azure region you'd like to provision your resources in.

Artifacts

Resources created by this bundle that can be connected to other bundles.

View

Properties

• kubernetes_cluster (object): Kubernetes cluster authentication and cloud-specific configuration. Cannot contain additional properties.

  • data (object)

    • authentication (object)
      • cluster (object)
        • certificate-authority-data (string)
        • server (string)
      • user (object)
        • token (string)
    • infrastructure (object): Cloud specific Kubernetes configuration data.
      • One of

        • AWS EKS infrastructure configobject: . Cannot contain additional properties.

          • arn (string): Amazon Resource Name.

            Examples:

            "arn:aws:rds::ACCOUNT_NUMBER:db/prod"

            "arn:aws:ec2::ACCOUNT_NUMBER:vpc/vpc-foo"

          • oidc_issuer_url (string): An HTTPS endpoint URL.

            Examples:

            "https://example.com/some/path"

            "https://massdriver.cloud"

        • Infrastructure Configobject: Azure AKS Infrastructure Configuration. Cannot contain additional properties.

          • ari (string): Azure Resource ID.

            Examples:

            "/subscriptions/12345678-1234-1234-abcd-1234567890ab/resourceGroups/resource-group-name/providers/Microsoft.Network/virtualNetworks/network-name"

          • oidc_issuer_url (string)

        • GCP Infrastructure GRNobject: Minimal GCP Infrastructure Config. Cannot contain additional properties.

          • grn (string): GCP Resource Name (GRN).

            Examples:

            "projects/my-project/global/networks/my-global-network"

            "projects/my-project/regions/us-west2/subnetworks/my-subnetwork"

            "projects/my-project/topics/my-pubsub-topic"

            "projects/my-project/subscriptions/my-pubsub-subscription"

            "projects/my-project/locations/us-west2/instances/my-redis-instance"

            "projects/my-project/locations/us-west2/clusters/my-gke-cluster"

  • specs (object)

    • aws (object): .

      • region (string): AWS Region to provision in.

        Examples:

        "us-west-2"

    • azure (object): .

      • region (string): Select the Azure region you'd like to provision your resources in.

    • gcp (object): .

      • project (string)

      • region (string): The GCP region to provision resources in.

        Examples:

        "us-east1"

        "us-east4"

        "us-west1"

        "us-west2"

        "us-west3"

        "us-west4"

        "us-central1"

    • kubernetes (object): Kubernetes distribution and version specifications.

      • cloud (string): Must be one of: ['aws', 'gcp', 'azure'].
      • distribution (string): Must be one of: ['eks', 'gke', 'aks'].
      • platform_version (string)
      • version (string)

Contributing

Bug Reports & Feature Requests

Did we miss something? Please submit an issue to report any bugs or request additional features.

Developing

Note: Massdriver bundles are intended to be tightly use-case scoped, intention-based, reusable pieces of IaC for use in the Massdriver platform. For this reason, major feature additions that broaden the scope of an existing bundle are likely to be rejected by the community.

Still want to get involved? First check out our contribution guidelines.

Fix or Fork

If your use-case isn't covered by this bundle, you can still get involved! Massdriver is designed to be an extensible platform. Fork this bundle, or create your own bundle from scratch!

Connect

Questions? Concerns? Adulations? We'd love to hear from you!

Please connect with us!