EKS Add On
Using Calyptia Core Agent directly through AWS marketplace
Last updated
Using Calyptia Core Agent directly through AWS marketplace
Last updated
The Calyptia Core Agent builds on top of the vendor-neutral CNCF OSS Fluent Bit offering to support various inputs and outputs with inline processing too.
The default configuration of the add on provides basic output but the intention is this is customized to support whatever use case required.
Calyptia Core Agent is provided as an either by directly running the container images or using the dedicated EKS Add On.
Ensure you have subscribed to the Calyptia Core Agent via .
Install , and .
Ensure you have access to an (or the ability to create one).
The container requires ongoing access to the AWS Marketplace metering so to support this ensure the cluster has OIDC enabled and an appropriate IAM role attached to the service account (IRSA).
This service account needs to be assigned the AWS managed policy arn:aws:iam::aws:policy/AWSMarketplaceMeteringRegisterUsage
(or an equivent one).
Here is an example IAM policy:
The Amazon EKS cluster needs to have the IAM OIDC provider enabled.
The steps below help to automate these manual steps:
Create an IAM role with the AWS-managed IAM policy above.
Set up a trust relationship between the created IAM role with the service account automatically created by the add-on called calyptia-fluentbit.
Note we do not create a service account above, only the role - the service account will be created automatically by the add-on creation process (or by Helm).
After subscribing to the Calyptia Core Agent on AWS Marketplace and following the on-screen instructions successfully, you will be redirected to the Amazon EKS console.
To get started in the Amazon EKS console, go to your EKS clusters, and in the Add-ons tab, select Get more add-ons to find the Calyptia Core Agent EKS add-on in the cluster setting of your existing EKS clusters.
You can also use the search bar to find "Calyptia Core Agent" and follow the on-screen instructions to enable the Calyptia Core Agent add-on for your Amazon EKS clusters.
To enable the Calyptia Core Agent add-on for your Amazon EKS cluster run the following commands:
To monitor the installation status, you can run the following command:
To disable the add-on, you can run the following command:
Create a service account associated with the appropriate policy.
Deploy the helm chart using the pre-created service account in the right region.
Calyptia Core integration
Modify version deployed
To deploy with different versions of the Calyptia Fluent Bit AWS marketplace offering, just configure the image.tag
key:
The container image can also be directly consumed in ECS or EKS pods, ensuring the IAM role is set up to allow it.
The AWS provides more details.
The AWS documentation provides more details.
AWS provides more details on how to set up these kinds of relationships .
You can learn more about direct deployment to Amazon EKS clusters from this .
Refer to the AWS documentation for the details on using the create-addon
command and for an overview of role management. The service account create by the add-on has to be associated with the role created earlier so confirm the information is correct and matches your role identifier.
A is provided to deploy the EKS Add On as well as via the AWS CLI and UI.
The and tools are used below to simplify deployment.
The Helm chart also supports direct integration with by providing the token to use.
A separate helm chart is provided to deploy the AWS marketplace offering of Calyptia Fluent Bit directly. Refer to the installation instructions for the helm chart: .