Metrôs vs. Instalações

Em abril de 2021, o Equinix Metal lançou um novo conceito de localização: os "áreas metropolitanas". Um "área metropolitana" é um conceito da Equinix que engloba data centers agrupados geograficamente. Data centers dentro de um "área metropolitana" compartilham capacidade e características de rede. Você pode ler mais sobre "áreas metropolitanas" em https://docs.equinix.com/metal/locations/metros/. Em abril de 2023, o recurso de implantação de instalações foi descontinuado, com o provisionamento de "área metropolitana" áreas metropolitanas oferecido como uma estratégia de implantação superior em todos os aspectos. Consulte o guia de instalações na documentação da API do Metal para obter mais detalhes sobre a alteração da API .

Antes da introdução dos áreas metropolitanas, os recursos eram implantados em um único local facility. Ao provisionamento recursos equinix_metal_device, a instalação podia ser escolhida pelo Equinix Metal com uma lista fornecida pelo usuário de facilities ou uma instalação curinga any. Os locais individuais das instalações usam um código como "sv15" ou "ny5". Os metros agrupam instalações. Por exemplo, o área metropolitana "sv" contém a instalação "sv15", entre outras. Se você especificar um área metropolitana ao criar um recurso, ele será implantado em uma das instalações do grupo área metropolitana . Você pode então encontrar a instalação implantada usando um atributo somente leitura do recurso (por exemplo, deployed_facility para recursos equinix_metal_device).

Alterar seus modelos Terraform para usar metros em vez de facilities

Para aproveitar alguns dos características do área metropolitana, você pode querer alterar a configuração de seus modelos Terraform para que os dispositivos tenham metro especificado em vez de facilities. Como metro e facilities são parâmetros ForceNew (uma alteração acionará a recriação do recurso), você deve ter cuidado se você quiser que o dispositivo seja destruído.

Atualizamos o recurso equinix_metal_device para que a mudança seja transparente, mas proceda com cuidado. O parâmetro metro também é um atributo calculado e, se você usar uma versão do provedor mais recente que a 3.2.1, o atributo metro já estará presente no seu recurso. Nesse caso, você só precisa adicioná-lo explicitamente à sua configuração.

O parâmetro facilities é usado apenas para seleção de instalação ao criar o recurso do dispositivo . A instalação real onde o dispositivo é implantado está no atributo calculado deployed_facility.

Se você quiser apenas alterar a especificação do recurso equinix_metal_device de baseado em instalação para baseado em metro, por exemplo, de facilities ["sv15"] para área metropolitana "sv", basta remover o atributo facilities e adicionar o atributo metro.

Por exemplo, dada a seguinte configuração de um dispositivo implantado na instalação sv15:

resource "equinix_metal_device" "node" {
  project_id       = local.project_id
  facilities       = ["sv15"]
  plan             = "c3.small.x86"
  operating_system = "ubuntu_16_04"
  hostname         = "test"
  billing_cycle    = "hourly"
}

... você pode remover faclities e adicionar metro, alterando a configuração para:

resource "equinix_metal_device" "node" {
  project_id       = local.project_id
  metro            = "sv"
  plan             = "c3.small.x86"
  operating_system = "ubuntu_16_04"
  hostname         = "test"
  billing_cycle    = "hourly"
}

Para testar se a alteração não contaminou o estado e se o dispositivo não será recriado, você pode verificar se terraform plan reporta alguma diferença. O estado do Terraform deve estar atualizado, desde que a instalação na qual o dispositivo foi implantado esteja contida na área metropolitana.

Se a diferença entre planos não estiver vazia, você pode ter usado uma área metropolitana que não contém a instalação na qual o dispositivo foi implantado. Isso pode acontecer se você usou mais instalações na lista facilities ou você usou a instalação especial "qualquer".

Você pode descobrir a instalação implantada e o área metropolitana que a contém examinando o estado do Terraform do recurso equinix_metal_device:

$ terraform state show equinix_metal_device.node | grep deployed
    deployed_facility                = "sv15"

$ terraform state show equinix_metal_device.node | grep metro
    metro                            = "sv"

Em seguida, você deve configurar o metrô existente em seus modelos do Terraform.