sigs.k8s.io/cluster-api-provider-azure@v1.14.3/docs/book/src/topics/flatcar.md (about)

     1  # Flatcar Clusters
     2  
     3  ## Overview
     4  
     5  CAPZ enables you to create Kubernetes clusters using Flatcar Container Linux on Microsoft Azure.
     6  
     7  ### Image creation
     8  
     9  The testing reference images are built using [image-builder](https://github.com/kubernetes-sigs/image-builder) by Flatcar maintainers and published to the Flatcar CAPI Community Gallery on Azure with community gallery name `flatcar4capi-742ef0cb-dcaa-4ecb-9cb0-bfd2e43dccc0`.
    10  
    11  <aside class="note warning">
    12  
    13  <h1> Security </h1>
    14  
    15  The reference images are not updated with security fixes. They are intended only to facilitate testing and to help users try out Cluster API for Azure.
    16  
    17  The reference images should not be used in a production environment. It is highly recommended to [maintain your own custom image](#building-a-custom-image) instead.
    18  
    19  </aside>
    20  
    21  Find the latest published images:
    22  
    23  ```console
    24  $ az sig image-definition list-community --location westeurope --public-gallery-name flatcar4capi-742ef0cb-dcaa-4ecb-9cb0-bfd2e43dccc0 --only-show-errors
    25  HyperVGeneration    Location    Name                                OsState      OsType    UniqueId
    26  ------------------  ----------  ----------------------------------  -----------  --------  ---------------------------------------------------------------------------------------------------------------
    27  V2                  westeurope  flatcar-stable-amd64-capi-v1.23.13  Generalized  Linux     /CommunityGalleries/flatcar4capi-742ef0cb-dcaa-4ecb-9cb0-bfd2e43dccc0/Images/flatcar-stable-amd64-capi-v1.23.13
    28  V2                  westeurope  flatcar-stable-amd64-capi-v1.25.4   Generalized  Linux     /CommunityGalleries/flatcar4capi-742ef0cb-dcaa-4ecb-9cb0-bfd2e43dccc0/Images/flatcar-stable-amd64-capi-v1.25.4
    29  V2                  westeurope  flatcar-stable-amd64-capi-v1.26.0   Generalized  Linux     /CommunityGalleries/flatcar4capi-742ef0cb-dcaa-4ecb-9cb0-bfd2e43dccc0/Images/flatcar-stable-amd64-capi-v1.26.0
    30  $
    31  $ az sig image-version list-community --location westeurope --public-gallery-name flatcar4capi-742ef0cb-dcaa-4ecb-9cb0-bfd2e43dccc0 --only-show-errors --gallery-image-definition flatcar-stable-amd64-capi-v1.26.0
    32  ExcludeFromLatest    Location    Name      PublishedDate                     UniqueId
    33  -------------------  ----------  --------  --------------------------------  --------------------------------------------------------------------------------------------------------------------------------
    34  False                westeurope  3227.2.3  2022-12-09T18:05:58.830464+00:00  /CommunityGalleries/flatcar4capi-742ef0cb-dcaa-4ecb-9cb0-bfd2e43dccc0/Images/flatcar-stable-amd64-capi-v1.26.0/Versions/3227.2.3
    35  ```
    36  
    37  If you would like customize your images please refer to the documentation on building your own [custom images](custom-images.md).
    38  
    39  ## Trying it out
    40  
    41  To create a cluster using Flatcar Container Linux, use `flatcar` cluster flavor.
    42  
    43  - Note: When working with **Flatcar machines**, append `--set-string cloudControllerManager.caCertDir=/usr/share/ca-certificates` to the `cloud-provider-azure` _helm_ command. Refer ["External Cloud Provider's Note for flatcar-flavored machine"](https://github.com/kubernetes-sigs/cluster-api-provider-azure/blob/764aa1e8bd02d150dff90ff6bc7f8daa2b38810f/docs/book/src/topics/addons.md#external-cloud-provider)
    44    - However, no changes are needed when using tilt to bring up flatcar-flavored workload clusters.