iSharkFly-Docs/packer-cn
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
packer-cn/website/source/layouts/guides.erb

61 lines
3.1 KiB
Plaintext
Raw Normal View History

Revamp pages and docs to fit HashiCorp brand
2017-03-25 18:13:52 -04:00
<% wrap_layout :inner do %>
<% content_for :sidebar do %>
Update CSS breakpoints
2017-03-26 17:21:14 -04:00
<ul class="nav docs-sidenav">
build using HCL2 (#8423) This follows #8232 which added the code to generate the code required to parse HCL files for each packer component. All old config files of packer will keep on working the same. Packer takes one argument. When a directory is passed, all files in the folder with a name ending with “.pkr.hcl” or “.pkr.json” will be parsed using the HCL2 format. When a file ending with “.pkr.hcl” or “.pkr.json” is passed it will be parsed using the HCL2 format. For every other case; the old packer style will be used. ## 1. the hcl2template pkg can create a packer.Build from a set of HCL (v2) files I had to make the packer.coreBuild (which is our one and only packer.Build ) a public struct with public fields ## 2. Components interfaces get a new ConfigSpec Method to read a file from an HCL file. This is a breaking change for packer plugins. a packer component can be a: builder/provisioner/post-processor each component interface now gets a `ConfigSpec() hcldec.ObjectSpec` which allows packer to tell what is the layout of the hcl2 config meant to configure that specific component. This ObjectSpec is sent through the wire (RPC) and a cty.Value is now sent through the already existing configuration entrypoints: Provisioner.Prepare(raws ...interface{}) error Builder.Prepare(raws ...interface{}) ([]string, error) PostProcessor.Configure(raws ...interface{}) error close #1768 Example hcl files: ```hcl // file amazon-ebs-kms-key/run.pkr.hcl build { sources = [ "source.amazon-ebs.first", ] provisioner "shell" { inline = [ "sleep 5" ] } post-processor "shell-local" { inline = [ "sleep 5" ] } } // amazon-ebs-kms-key/source.pkr.hcl source "amazon-ebs" "first" { ami_name = "hcl2-test" region = "us-east-1" instance_type = "t2.micro" kms_key_id = "c729958f-c6ba-44cd-ab39-35ab68ce0a6c" encrypt_boot = true source_ami_filter { filters { virtualization-type = "hvm" name = "amzn-ami-hvm-????.??.?.????????-x86_64-gp2" root-device-type = "ebs" } most_recent = true owners = ["amazon"] } launch_block_device_mappings { device_name = "/dev/xvda" volume_size = 20 volume_type = "gp2" delete_on_termination = "true" } launch_block_device_mappings { device_name = "/dev/xvdf" volume_size = 500 volume_type = "gp2" delete_on_termination = true encrypted = true } ami_regions = ["eu-central-1"] run_tags { Name = "packer-solr-something" stack-name = "DevOps Tools" } communicator = "ssh" ssh_pty = true ssh_username = "ec2-user" associate_public_ip_address = true } ```
2019-12-17 11:25:56 +01:00
<li<%= sidebar_current("hcl") %>>
<a href="/guides/hcl">HCL guides</a>
<ul class="nav">
<li<%= sidebar_current("hcl-from-json-v1") %>>
<a href="/guides/hcl/from-json-v1">from JSON v1</a>
</li>
Update guides.erb
2019-12-18 15:51:38 +01:00
<li<%= sidebar_current("hcl-component-object-spec") %>>
<a href="/guides/hcl/component-object-spec">Making a plugin HCL2 enabled</a>
</li>
build using HCL2 (#8423) This follows #8232 which added the code to generate the code required to parse HCL files for each packer component. All old config files of packer will keep on working the same. Packer takes one argument. When a directory is passed, all files in the folder with a name ending with “.pkr.hcl” or “.pkr.json” will be parsed using the HCL2 format. When a file ending with “.pkr.hcl” or “.pkr.json” is passed it will be parsed using the HCL2 format. For every other case; the old packer style will be used. ## 1. the hcl2template pkg can create a packer.Build from a set of HCL (v2) files I had to make the packer.coreBuild (which is our one and only packer.Build ) a public struct with public fields ## 2. Components interfaces get a new ConfigSpec Method to read a file from an HCL file. This is a breaking change for packer plugins. a packer component can be a: builder/provisioner/post-processor each component interface now gets a `ConfigSpec() hcldec.ObjectSpec` which allows packer to tell what is the layout of the hcl2 config meant to configure that specific component. This ObjectSpec is sent through the wire (RPC) and a cty.Value is now sent through the already existing configuration entrypoints: Provisioner.Prepare(raws ...interface{}) error Builder.Prepare(raws ...interface{}) ([]string, error) PostProcessor.Configure(raws ...interface{}) error close #1768 Example hcl files: ```hcl // file amazon-ebs-kms-key/run.pkr.hcl build { sources = [ "source.amazon-ebs.first", ] provisioner "shell" { inline = [ "sleep 5" ] } post-processor "shell-local" { inline = [ "sleep 5" ] } } // amazon-ebs-kms-key/source.pkr.hcl source "amazon-ebs" "first" { ami_name = "hcl2-test" region = "us-east-1" instance_type = "t2.micro" kms_key_id = "c729958f-c6ba-44cd-ab39-35ab68ce0a6c" encrypt_boot = true source_ami_filter { filters { virtualization-type = "hvm" name = "amzn-ami-hvm-????.??.?.????????-x86_64-gp2" root-device-type = "ebs" } most_recent = true owners = ["amazon"] } launch_block_device_mappings { device_name = "/dev/xvda" volume_size = 20 volume_type = "gp2" delete_on_termination = "true" } launch_block_device_mappings { device_name = "/dev/xvdf" volume_size = 500 volume_type = "gp2" delete_on_termination = true encrypted = true } ami_regions = ["eu-central-1"] run_tags { Name = "packer-solr-something" stack-name = "DevOps Tools" } communicator = "ssh" ssh_pty = true ssh_username = "ec2-user" associate_public_ip_address = true } ```
2019-12-17 11:25:56 +01:00
</ul>
</li>
major rework of communicator docs and addition of preseed guides
2019-10-01 08:59:48 -07:00
<li<%= sidebar_current("automatic-operating-system-installs") %>>
<a href="/guides/automatic-operating-system-installs/index.html">Automatic OS Installs</a>
<ul class="nav">
<li<%= sidebar_current("automatic-operating-system-installs-unattended-installation-windows") %>>
<a href="/guides/automatic-operating-system-installs/autounattend_windows.html">Unattended Installation for Windows</a>
</li>
<li<%= sidebar_current("automatic-operating-system-installs-unattended-installation-debian") %>>
<a href="/guides/automatic-operating-system-installs/preseed_ubuntu.html">Unattended Installation for Debian</a>
</li>
</ul>
Update CSS breakpoints
2017-03-26 17:21:14 -04:00
</li>
major rework of communicator docs and addition of preseed guides
2019-10-01 08:59:48 -07:00
<li<%= sidebar_current("workflow-tips-and-tricks") %>>
<a href="/guides/workflow-tips-and-tricks/index.html">Workflow Tips and Tricks</a>
<ul class="nav">
<li<%= sidebar_current("workflow-tips-and-tricks-isotime-template-function") %>>
<a href="/guides/workflow-tips-and-tricks/isotime-template-function.html">Isotime Template Function</a>
</li>
<li<%= sidebar_current("workflow-tips-and-tricks-guides-veewee-to-packer") %>>
<a href="/guides/workflow-tips-and-tricks/veewee-to-packer.html">Veewee to Packer</a>
</li>
<li<%= sidebar_current("workflow-tips-and-tricks-use-packer-with-comment") %>>
<a href="/guides/workflow-tips-and-tricks/use-packer-with-comment.html">Use jq to strip comments from a Packer template</a>
</li>
</ul>
add guide for uisng jq to strip comments from packer template
2019-04-22 15:35:00 -07:00
</li>
Navigation and placeholders for guide
2017-12-08 08:28:27 -08:00
<li<%= sidebar_current("guides-packer-on-cicd") %>>
guides should use infinitive verbs
2017-12-11 14:31:44 -08:00
<a href="/guides/packer-on-cicd/index.html">Build Immutable Infrastructure with Packer in CI/CD</a>
Navigation and placeholders for guide
2017-12-08 08:28:27 -08:00
<ul class="nav">
<li<%= sidebar_current("guides-packer-on-cicd-build-image") %>>
guides should use infinitive verbs
2017-12-11 14:31:44 -08:00
<a href="/guides/packer-on-cicd/build-image-in-cicd.html">Build Images in CI/CD</a>
Navigation and placeholders for guide
2017-12-08 08:28:27 -08:00
</li>
<li<%= sidebar_current("guides-packer-on-cicd-build-virtualbox") %>>
guides should use infinitive verbs
2017-12-11 14:31:44 -08:00
<a href="/guides/packer-on-cicd/build-virtualbox-image.html">Build a VirtualBox Image with Packer in TeamCity</a>
Navigation and placeholders for guide
2017-12-08 08:28:27 -08:00
</li>
<li<%= sidebar_current("guides-packer-on-cicd-upload-image-to-artifact-store") %>>
guides should use infinitive verbs
2017-12-11 14:31:44 -08:00
<a href="/guides/packer-on-cicd/upload-images-to-artifact.html">Upload a VirtualBox Image to S3</a>
Navigation and placeholders for guide
2017-12-08 08:28:27 -08:00
</li>
guides should use infinitive verbs
2017-12-11 14:31:44 -08:00
<li<%= sidebar_current("guides-packer-on-cicd-trigger-tfe-run") %>>
<a href="/guides/packer-on-cicd/trigger-tfe.html">Trigger Terraform Enterprise runs</a>
Navigation and placeholders for guide
2017-12-08 08:28:27 -08:00
</li>
</li>
</li>
Update CSS breakpoints
2017-03-26 17:21:14 -04:00
</ul>
Revamp pages and docs to fit HashiCorp brand
2017-03-25 18:13:52 -04:00
<% end %>
<%= yield %>
major rework of communicator docs and addition of preseed guides
2019-10-01 08:59:48 -07:00
<% end %>
Reference in New Issue Copy Permalink