# 使用 Homebrew, Nix 安装 terracognita

查看 terracognita 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:terracognita
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install terracognita
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#terracognita
```

  证据: nixpkgs package indexes: pkgs/by-name/te/terracognita/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:terracognita
- **软件包管理器:** Homebrew
- **版本:** 0.8.4
- **来源摘要:** Reads from existing Cloud Providers and generates Terraform code
- **主页:** <https://github.com/cycloidio/terracognita>
- **仓库:** <https://github.com/cycloidio/terracognita>
- **最后更新:** 2026-07-26T00:50:35+02:00
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- terracognita (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 0.8.4
## 项目历史与用法

TerraCognita is Cycloid's reverse-Terraform tool: it reads existing cloud infrastructure and generates Terraform HCL and/or Terraform state. Its history tracks the practical DevOps problem of bringing already-existing AWS, Google Cloud, AzureRM, and vSphere resources under infrastructure-as-code management.

### 项目历史

The repository was created in February 2019. In the README, Cycloid explains that infrastructure as code was part of the company's practice and that TerraCognita was built to help customers convert existing cloud infrastructure into Terraform code automatically, relying on community Terraform providers.

Early releases expanded the importer beyond its initial AWS-oriented base. Release notes show v0.3.0 adding multiple Google resources, v0.4.0 adding AzureRM support and targeted import, and v0.6.0 adding AWS profile/config support, session-token authentication, interpolation controls, HCL2 work, and Homebrew support.

Later development focused on keeping pace with provider APIs and larger resource catalogs. The changelog documents broad Azure additions, Terraform 1.1.9 and provider updates in the 0.7.x line, vSphere support and many GCP/AWS resources in v0.8.0, and AzureRM fixes and additions through v0.8.4.

### 采用历史

The README documents binary releases, source builds, AUR packages, Homebrew installation, and Docker usage through the `cycloid/terracognita` image. It also describes InfraImport inside Cycloid as the visual representation of TerraCognita, making the CLI both a standalone package and part of Cycloid's platform workflow.

### 使用方式

The main CLI form is `terracognita [TERRAFORM_PROVIDER] [--flags]`, where users choose a provider such as `aws`, pass provider-specific flags, and emit Terraform HCL, modules, and/or state files. The README documents include/exclude filters by Terraform resource name, module generation, Docker execution with cloud credentials passed through the environment, and follow-up `terraform init` and `terraform plan` checks.

### 为什么软件包爱好者会关心

For infrastructure package nerds, TerraCognita is notable because it packages a moving target: it embeds assumptions about Terraform, provider versions, cloud SDK behavior, generated HCL, and state output. Package managers expose it as a single CLI, but maintainers care about the bundled provider matrix and how quickly it tracks Terraform ecosystem churn.

### 时间线

- 2019: GitHub repository created.
- 2019: v0.1.6 release added version reporting, CI/CD, prebuilt binaries, and automated GitHub/Docker releases.
- 2019: v0.2.0 moved TFState output to Terraform 0.12 format.
- 2020: v0.4.0 added AzureRM provider support.
- 2020: v0.6.0 added AWS profile/config support, session-token authentication, HCL2-related fixes, and Homebrew support.
- 2022: v0.8.0 added vSphere provider support and expanded AWS/GCP/Azure resource coverage.
- 2023: v0.8.4 added AzureRM resources and fixes for generated HCL maps and cyclic dependencies.

### Related projects

- The README lists TerraCognita alongside Cycloid's InfraMap, which reads Terraform state or HCL to generate provider-specific graphs, and TerraCost, a Terraform-oriented cloud cost estimation CLI.
- It is adjacent to Terraform import workflows and tools that inventory existing cloud accounts before migrating to infrastructure as code.

### 来源

- <https://api.github.com/repos/cycloidio/terracognita>
- <https://api.github.com/repos/cycloidio/terracognita/releases?per_page=100>
- <https://github.com/cycloidio/terracognita>
- <https://raw.githubusercontent.com/cycloidio/terracognita/master/CHANGELOG.md>
- <https://raw.githubusercontent.com/cycloidio/terracognita/master/README.md>
- source_facts.package-manager


## 安全说明

infrastructure mutation or orchestration signal.

- **Geiger 风险:** orange / 中
- infrastructure mutation or orchestration signal

## 其他软件包管理器记录

- Nix - terracognita: normalized package name match | nixpkgs package indexes: pkgs/by-name/te/terracognita/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/terracognita.yml](https://github.com/mxcl/pkgdb/blob/main/combined/terracognita.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph