Skip to content

CLI Tool for Importing Cloud Data to Visualize Cloud Infrastructure in Miro

License

Notifications You must be signed in to change notification settings

miroapp/cloud-data-import

Repository files navigation

Cloud Data Import for Miro

Miro Cloud View

Welcome to the Cloud Data Import for Miro! This script is designed to facilitate the visualization of AWS infrastructure data within Miro by importing cloud infrastructure snapshots directly into your Miro boards. The tool is an integral part of Cloud View, an app in Miro that allows you to visualize and optimize your cloud infrastructure. Ideal for cloud practitioners, CloudView leverages Miro's powerful visualization capabilities to help you gain insights and improve your cloud management strategies.

🛠 Prerequisites

Before running the script, ensure the following prerequisites are met:

📦 Installation and Usage

To run the script, execute the following command in your terminal:

npx @mirohq/cloud-data-import@latest aws

This command will automatically install and run the script, launching a GUI for interaction.

⚙️ Script Arguments and Configuration

The script accepts several arguments to customize the data import process:

Argument Description
-r, --regions Specify the AWS regions to scan. Use "all" to scan all available regions.
-p, --profile Specify the AWS profile to use (takes priority over the AWS_PROFILE environment variable).
-o, --output Define the output file path for the imported data. Must be a .json file.
--rps, --call-rate-rps Set the maximum number of API calls to make per second. Default is 10.
-c, --compressed Enable output compression.
-ro, --regional-only Limit the scan to regional services, ignoring global services.
--ood, --open-output-dir Open the output directory and points to the output file, after the import process is complete.

Example Usage with Arguments

npx @mirohq/cloud-data-import@latest aws --regions us-east-1 us-west-2 --output ./data.json --call-rate-rps 5 --compressed

📜 License

This project is licensed under the Apache 2.0 License. See the LICENSE file for more details.

🤝 Contributing

We welcome contributions to the Cloud Data Import project! If you're interested in helping improve this tool, please take a moment to review our contribution guide. It outlines our development process, how to propose bugfixes and improvements, and how to build and test your changes.

Here are some ways you can contribute:

  • Report bugs or suggest features by opening an issue
  • Improve documentations
  • Submit pull requests with bug fixes or new features

We appreciate your interest in making Cloud Data Import tool better!