AWS OpsWorks Referência do Stacks Data Bag

AWS OpsWorks Stacks expõe uma grande variedade de configurações de receitas como conteúdo do pacote de dados do Chef. Essa referência lista esse conteúdo de data bag.

Um data bag é um conceito do Chef. O data bag é uma variável global armazenada como dados JSON em uma instância; os dados JSON podem ser acessados no Chef. Por exemplo, um pacote de dados pode armazenar variáveis globais, como o URL de origem de um aplicativo, o nome do host da instância e o identificador VPC da pilha associada. AWS OpsWorks O Stacks armazena seus pacotes de dados nas instâncias de cada pilha. Em instâncias Linux, o AWS OpsWorks Stacks armazena pacotes de dados no /var/chef/runs/run-ID/data_bags diretório. Nas instâncias do Linux, ele armazena recipientes de dados no diretório drive:\chef\runs\run-id\data_bags. Em ambos os casos, Run-ID é um ID exclusivo que o AWS OpsWorks Stacks atribui a cada execução do Chef em uma instância. Esses diretórios incluem um conjunto de data bags (subdiretórios). Cada data bag contém zero ou mais itens de data bag, que são arquivos formatados pelo JSON que contêm conjuntos de conteúdo de data bag.

O conteúdo de data bag pode incluir:

As receitas do Chef podem acessar data bags, itens de data bag e conteúdo de data bag por meio da pesquisa do Chef ou diretamente. Os dados a seguir descrevem como usar as duas abordagens de acesso (embora a pesquisa do Chef seja preferencial).

Para acessar uma bolsa de dados por meio da pesquisa do Chef, use o método de pesquisa, especificando o índice de pesquisa desejado. AWS OpsWorks O Stacks fornece os seguintes índices de pesquisa:

Assim que você souber o nome do índice de pesquisa, acesse o conteúdo do data bag desse índice de pesquisa. Por exemplo, o código de receita a seguir usa o índice de pesquisa aws_opsworks_app para obter o conteúdo do primeiro item de data bag (o primeiro arquivo JSON) no data bagaws_opsworks_app (o diretório aws_opsworks_app). Em seguida, o código grava duas mensagens no log do Chef, uma com o conteúdo de data bag de nome curto do aplicativo (uma string no arquivo JSON) e outra com o conteúdo de data bag de URL de origem do aplicativo (outra string no arquivo JSON):

app = search("aws_opsworks_app").first
Chef::Log.info("********** The app's short name is '#{app['shortname']}' **********")
Chef::Log.info("********** The app's URL is '#{app['app_source']['url']}' **********")

Em que ['shortname'] e ['app_source']['url'] especificam o conteúdo de data bag a seguir no arquivo JSON correspondente:

{
  ...
  "shortname": "mylinuxdemoapp",
  ...
  "app_source": {
    ...
    "url": "https://s3.amazonaws.com/opsworks-demo-assets/opsworks-linux-demo-nodejs.tar.gz",
  },
  ...  
}

Para obter uma lista do conteúdo de data bag que você pode pesquisar, consulte os tópicos de referência nesta seção.

Você também pode percorrer um conjunto de itens de data bag em um data bag. Por exemplo, o código de receita a seguir é semelhante ao exemplo anterior; ele percorre cada um dos itens de data bag no data bag quando há mais de um item de data bag:

search("aws_opsworks_app").each do |app|
  Chef::Log.info("********** The app's short name is '#{app['shortname']}' **********")
  Chef::Log.info("********** The app's URL is '#{app['app_source']['url']}' **********")
end

Se você souber que existe um conteúdo de data bag específico, poderá encontrar o item de data bag correspondente com a seguinte sintaxe:

search("search_index", "key:value").first

Por exemplo, o código de receita a seguir usa o índice de pesquisa aws_opsworks_app para encontrar o item de data bag que contém o nome curto de aplicativo mylinuxdemoapp. Em seguida, ele usa o conteúdo do item de data bag para gravar uma mensagem no log do Chef com o nome curto e o URL de origem do aplicativo correspondente:

app = search("aws_opsworks_app", "shortname:mylinuxdemoapp").first
Chef::Log.info("********** For the app with the short name '#{app['shortname']}', the app's URL is '#{app['app_source']['url']}' **********")

Para o índice de pesquisa aws_opsworks_instance somente, você pode especificar self:true para representar a instância em que a receita está sendo executada. O código de receita a seguir usa o conteúdo do item do pacote de dados correspondente para gravar uma mensagem no registro do Chef com o ID e o sistema operacional AWS OpsWorks gerados pelo Stacks da instância correspondente:

instance = search("aws_opsworks_instance", "self:true").first
Chef::Log.info("********** For instance '#{instance['instance_id']}', the instance's operating system is '#{instance['os']}' **********")

Em vez de usar a pesquisa do Chef para acessar data bags, itens de data bag e conteúdo de data bag, você pode acessá-los diretamente. Para fazer isso, use os métodos data_bag e data_bag_item para acessar data bags e itens de data bags, respectivamente. Por exemplo, o código de receita a seguir executa a mesma função demonstrada nos exemplos anteriores; a diferença é que ele acessa diretamente um único item de data bag e, depois, vários itens de data bag quando há mais de um:

# Syntax: data_bag_item("the data bag name", "the file name in the data bag without the file extension")
app = data_bag_item("aws_opsworks_app", "mylinuxdemoapp")
Chef::Log.info("********** The app's short name is '#{app['shortname']}' **********")
Chef::Log.info("********** The app's URL is '#{app['app_source']['url']}' **********")
    
data_bag("aws_opsworks_app").each do |data_bag_item|
  app = data_bag_item("aws_opsworks_app", data_bag_item)
  Chef::Log.info("********** The app's short name is '#{app['shortname']}' **********")
  Chef::Log.info("********** The app's URL is '#{app['app_source']['url']}' **********")
end

Entre essas duas abordagens, recomendamos que você use a pesquisa do Chef. Todos os exemplos relacionados neste guia demonstram essa abordagem.