Exemplo 6: Criação de arquivos - AWS OpsWorks
Instalação de um arquivo usando um livro de receitasCriação de um arquivo usando um modelo

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Exemplo 6: Criação de arquivos

Importante

O AWS OpsWorks Stacks serviço chegou ao fim da vida útil em 26 de maio de 2024 e foi desativado para clientes novos e existentes. É altamente recomendável que os clientes migrem suas cargas de trabalho para outras soluções o mais rápido possível. Se você tiver dúvidas sobre migração, entre em contato com a AWS Support equipe no AWS re:POST ou por meio do Premium AWS Support.

Depois de ter criado diretórios, você normalmente precisa preenchê-los com arquivos de configuração, arquivos de dados etc. Este tópico mostra duas maneiras de instalar arquivos em uma instância.

Instalação de um arquivo usando um livro de receitas

A maneira mais simples de instalar um arquivo em uma instância é usando um recurso cookbook_file, que copia um arquivo do livro de receitas para um local especificado na instância para os sistemas Linux e Windows. Este exemplo estende a receita do Exemplo 3: Criação de diretórios para adicionar um arquivo de dados a /srv/www/shared após a criação do diretório. Para referência, aqui está a receita original.


directory "/srv/www/shared" do
  mode 0755
  owner 'root'
  group 'root'
  recursive true
  action :create
end
Para configurar o livro de receitas

  1. No diretório opsworks_cookbooks, crie um diretório chamado createfile e navegue até ele.

  2. Adicione um arquivo metadata.rb a createfile, com o seguinte conteúdo.

    
name "createfile"
version "0.1.0"

  3. Inicialize e configure o Test Kitchen, conforme descrito em Exemplo 1: Instalação de pacotes e remova CentOS da lista platforms.

  4. Adicione um subdiretório recipes a createfile.

O arquivo a ser instalado contém os dados JSON a seguir.


{
  "my_name" : "myname",
  "your_name" : "yourname",
  "a_number" : 42,
  "a_boolean" : true
}
Para configurar o arquivo de dados

  1. Adicione um subdiretório files e createfile e um subdiretório default a files. Qualquer arquivo instalado por você com cookbook_file deve estar em um subdiretório de files, como files/default neste exemplo.

    nota

    Caso queira especificar arquivos diferentes para sistemas distintos, você pode colocar o arquivo específico de cada sistema em uma subpasta chamada considerando o sistema, como files/ubuntu. O recurso cookbook_file copia o arquivo específico do sistema apropriado, caso ele exista, e usa o arquivo default. Para obter mais informações, consulte cookbook_file.

  2. Crie um arquivo chamado example_data.json com o JSON do exemplo anterior e adicione-o a files/default.

A receita a seguir copia example_data.json para um local especificado. 


directory "/srv/www/shared" do
  mode 0755
  owner 'root'
  group 'root'
  recursive true
  action :create
end

cookbook_file "/srv/www/shared/example_data.json" do
  source "example_data.json"
  mode 0644
  action :create_if_missing
end

Depois que cria /srv/www/shared, o recurso cookbook_file copia example_data.json para esse diretório e também define o usuário, o grupo e o modo do arquivo.

nota

O recurso cookbook_file apresenta uma nova ação: create_if_missing. Você também pode usar uma ação create, mas ela substitui um arquivo existente. Caso você não queira substituir nada, use create_if_missing, que só instala example_data.json caso ainda não exista.

Para executar a receita

  1. Execute kitchen destroy para começar com uma instância nova.

  2. Crie um arquivo default.rb que contenha a receita anterior e o salve em recipes.

  3. Execute kitchen converge e faça logon na instância para verificar se o arquivo /srv/www/shared contém example_data.json.

Criação de um arquivo usando um modelo

O recurso cookbook_file é útil para algumas finalidades, mas só instala o arquivo que você tem no livro de receitas. Um recurso template oferece uma maneira mais flexível de instalar um arquivo em uma instância do Windows ou do Linux o criando dinamicamente com base em um modelo. Você pode acabar determinando os detalhes do conteúdo do arquivo no runtime e alterá-los conforme necessário. Por exemplo, você talvez queira que um arquivo de configuração tenha uma determinada configuração ao iniciar a instância e modificar a configuração depois, quando adicionar mais instâncias à pilha.

Este exemplo modifica o livro de receitas createfile a fim de usar um recurso template para instalar uma versão levemente modificada de example_data.json.

Aqui está como será a aparência do arquivo instalado.


{
  "my_name" : "myname",
  "your_name" : "yourname",
  "a_number" : 42,
  "a_boolean" : true,
  "a_string" : "some string",
  "platform" : "ubuntu"
}

Os recursos de modelo costumam ser usados com arquivos de atributo. Assim, o exemplo usa um para definir os valores a seguir.


default['createfile']['my_name'] = 'myname'
default['createfile']['your_name'] = 'yourname'
default['createfile']['install_file'] = true
Para configurar o livro de receitas

  1. Exclua o diretório createfile e seu conteúdo do livro de receitas files.

  2. Adicione um subdiretório attributes a createfile e um arquivo default.rb a attributes que contenha as definições de atributo anteriores.

Modelo é um arquivo .erb que é basicamente uma cópia do arquivo final, com alguns dos conteúdos representados por espaços reservados. Quando cria o arquivo, o recurso template copia o conteúdo do modelo para o arquivo especificado e substitui os espaços reservados pelos valores atribuídos. Veja o modelo de example_data.json.


{
  "my_name" : "<%= node['createfile']['my_name'] %>",
  "your_name" : "<%= node['createfile']['your_name'] %>",
  "a_number" : 42,
  "a_boolean" : <%= @a_boolean_var %>,
  "a_string" : "<%= @a_string_var %>",
  "platform" : "<%= node['platform'] %>"
}

Os valores <%=...%> são os espaços reservados.

  • <%=node[...]%> representa um valor de atributo do nó.

    Para este exemplo, o valor "your_name" é um espaço reservado que representa um dos valores de atributo do arquivo de atributo do livro de receitas.

  • <%=@...%> representa o valor de uma variável definido no recurso do modelo, conforme abordado resumidamente.

Como criar o arquivo de modelo do

  1. Adicione um subdiretório templates ao livro de receitas createfile e um subdiretório default a templates.

    nota

    O diretório templates funciona de maneira muito semelhante ao diretório files. Você pode colocar modelos específicos do sistema em um subdiretório, como ubuntu, nomeado por causa do sistema. O recurso template usa o modelo específico do sistema apropriado caso ele exista e acaba usando o modelo default.

  2. Crie um arquivo chamado example_data.json.erb e coloque-o no diretório templates/default. O nome do modelo é arbitrário, mas você normalmente o cria acrescentando .erb ao nome do arquivo, inclusive extensões.

A receita a seguir usa um recurso template para criar /srv/www/shared/example_data.json. 


directory "/srv/www/shared" do
  mode 0755
  owner 'root'
  group 'root'
  recursive true
  action :create
end

template "/srv/www/shared/example_data.json" do
  source "example_data.json.erb"
  mode 0644
  variables(
    :a_boolean_var => true,
    :a_string_var => "some string"
  )
  only_if {node['createfile']['install_file']}
end

O recurso template cria example_data.json usando um modelo e o instala em /srv/www/shared.

  • O nome do modelo, /srv/www/shared/example_data.json, especifica o caminho e o nome do arquivo instalado.

  • O atributo source especifica o modelo usado para criar o arquivo.

  • O atributo mode especifica o modo do arquivo instalado.

  • O recurso define duas variáveis, a_boolean_var e a_string_var.

    Quando cria example_data.json, o recurso substitui os espaços reservados da variável no modelo pelos valores correspondentes do recurso.

  • O atributo only_if guard só leva o recurso a criar o arquivo caso ['createfile']['install_file'] esteja definido como true.

Para executar a receita

  1. Execute kitchen destroy para começar com uma instância nova.

  2. Substitua o código em recipes/default.rb pelo exemplo anterior.

  3. Execute kitchen converge e faça logon na instância para verificar se o arquivo está em /srv/www/shared e tem o conteúdo correto.

Quando terminar, execute kitchen destroy para desligar a instância. A próxima seção usa um livro de receitas novo.