Skip to main content

Create Cloud Diagrams

To help you create a diagram, the DoiT console provides a step-by-step wizard to walk you through importing an AWS account.

Choose your learning path

Read the content below or check out the ▶️ interactive demo for a visual walkthrough.

CloudFormation stack​

You will need an AWS CloudFormation stack. You can create one as part of the wizard when you import an AWS account. You must have the necessary permissions to create a CloudFormation stack.

EKS clusters​

If the wizard detects any EKS clusters, you can choose to include them on your diagram. You can also add your EKS clusters to the diagram later using the DoiT console if you want to quickly visualize your core infrastructure first, or focus on a specific area, without overwhelming the initial diagram.

  1. Sign in to the DoiT console, select Integrate from the top navigation bar, and then select Assets.

  2. On the Assets page, select Kubernetes.

    • For single cluster activation, select Activate.

    • For bulk cluster activation, select Enable features.

    EKS clusters already connected this way are automatically included in your diagram.

Import an AWS account​

To import an AWS account whose resources you want to display:

  1. Sign in to the DoiT console, select Analyze from the top navigation bar, and then select Cloud Diagrams.

  2. From AWS account list, select an AWS account whose products and services you wish to visualize.

  3. Choose how you want to create a CloudFormation stack. You can do this using the AWS Console or CLI commands.

    1. Select AWS Console (CloudFormation stack).
    2. Select Set up Cloud Diagrams on AWS Console. You'll be taken to your AWS console to create a CloudFormation stack from a template.

    Once you have created a CloudFormation stack from a template, you may have to wait about 30 seconds while we update your account. Once your account is imported, a diagram is created.

  4. Select Continue.

  5. If DoiT detects EKS clusters in your account, you can choose to:

    • Show your EKS clusters on your diagram, for example, (show pods, deployments, and container details) for specific clusters.

    • Create a diagram without EKS clusters. If you select this option, your diagram is created. EKS clusters can be enabled at any time from the DoiT console.

      Choose how to visualize your EKS clusters

  6. We scan your account and detect your EKS clusters.

    We detect your EKS clusters

    Note

    If you want to do this later, you can choose to create the diagram without EKS clusters by selecting Skip this and create diagram. Your EKS clusters can be enabled at any time from the DoiT console.

    Select View detected clusters.

  7. Select the EKS clusters you want to enable and select Next.

  8. You must allow DoiT access to your EKS clusters. You can do this using either EKS access entry or Kubernetes RBAC, depending on your requirements.

    Selecting EKS access entry displays a code block. Copy the provided code block to create a new access entry, granting DoiTs designated IAM principal permissions and associating the AmazonEKSViewPolicy. This provides read-only access to your cluster's resources. You can open the AWS console to do this or use another method.

  9. Select Next. The wizard tests the cluster connection. This may take a few seconds.

  10. Select Continue. Once, your diagram is created, you are redirected to the diagram view. You can troubleshoot any import errors by selecting Import Errors.

▶️Interactive demo​

Try out our interactive demo for a hands-on walk-through experience.

If the demo doesn't display properly, try expanding your browser window or opening the demo in a new tab.

Last updated on