diff --git a/builder/yandex/LICENSE b/builder/yandex/LICENSE new file mode 100644 index 000000000..7b349dfb6 --- /dev/null +++ b/builder/yandex/LICENSE @@ -0,0 +1,375 @@ +(C) YANDEX LLC, 2019 + +Mozilla Public License Version 2.0 +================================== + +1. Definitions +-------------- + +1.1. "Contributor" + means each individual or legal entity that creates, contributes to + the creation of, or owns Covered Software. + +1.2. "Contributor Version" + means the combination of the Contributions of others (if any) used + by a Contributor and that particular Contributor's Contribution. + +1.3. "Contribution" + means Covered Software of a particular Contributor. + +1.4. "Covered Software" + means Source Code Form to which the initial Contributor has attached + the notice in Exhibit A, the Executable Form of such Source Code + Form, and Modifications of such Source Code Form, in each case + including portions thereof. + +1.5. "Incompatible With Secondary Licenses" + means + + (a) that the initial Contributor has attached the notice described + in Exhibit B to the Covered Software; or + + (b) that the Covered Software was made available under the terms of + version 1.1 or earlier of the License, but not also under the + terms of a Secondary License. + +1.6. "Executable Form" + means any form of the work other than Source Code Form. + +1.7. "Larger Work" + means a work that combines Covered Software with other material, in + a separate file or files, that is not Covered Software. + +1.8. "License" + means this document. + +1.9. "Licensable" + means having the right to grant, to the maximum extent possible, + whether at the time of the initial grant or subsequently, any and + all of the rights conveyed by this License. + +1.10. "Modifications" + means any of the following: + + (a) any file in Source Code Form that results from an addition to, + deletion from, or modification of the contents of Covered + Software; or + + (b) any new file in Source Code Form that contains any Covered + Software. + +1.11. "Patent Claims" of a Contributor + means any patent claim(s), including without limitation, method, + process, and apparatus claims, in any patent Licensable by such + Contributor that would be infringed, but for the grant of the + License, by the making, using, selling, offering for sale, having + made, import, or transfer of either its Contributions or its + Contributor Version. + +1.12. "Secondary License" + means either the GNU General Public License, Version 2.0, the GNU + Lesser General Public License, Version 2.1, the GNU Affero General + Public License, Version 3.0, or any later versions of those + licenses. + +1.13. "Source Code Form" + means the form of the work preferred for making modifications. + +1.14. "You" (or "Your") + means an individual or a legal entity exercising rights under this + License. For legal entities, "You" includes any entity that + controls, is controlled by, or is under common control with You. For + purposes of this definition, "control" means (a) the power, direct + or indirect, to cause the direction or management of such entity, + whether by contract or otherwise, or (b) ownership of more than + fifty percent (50%) of the outstanding shares or beneficial + ownership of such entity. + +2. License Grants and Conditions +-------------------------------- + +2.1. Grants + +Each Contributor hereby grants You a world-wide, royalty-free, +non-exclusive license: + +(a) under intellectual property rights (other than patent or trademark) + Licensable by such Contributor to use, reproduce, make available, + modify, display, perform, distribute, and otherwise exploit its + Contributions, either on an unmodified basis, with Modifications, or + as part of a Larger Work; and + +(b) under Patent Claims of such Contributor to make, use, sell, offer + for sale, have made, import, and otherwise transfer either its + Contributions or its Contributor Version. + +2.2. Effective Date + +The licenses granted in Section 2.1 with respect to any Contribution +become effective for each Contribution on the date the Contributor first +distributes such Contribution. + +2.3. Limitations on Grant Scope + +The licenses granted in this Section 2 are the only rights granted under +this License. No additional rights or licenses will be implied from the +distribution or licensing of Covered Software under this License. +Notwithstanding Section 2.1(b) above, no patent license is granted by a +Contributor: + +(a) for any code that a Contributor has removed from Covered Software; + or + +(b) for infringements caused by: (i) Your and any other third party's + modifications of Covered Software, or (ii) the combination of its + Contributions with other software (except as part of its Contributor + Version); or + +(c) under Patent Claims infringed by Covered Software in the absence of + its Contributions. + +This License does not grant any rights in the trademarks, service marks, +or logos of any Contributor (except as may be necessary to comply with +the notice requirements in Section 3.4). + +2.4. Subsequent Licenses + +No Contributor makes additional grants as a result of Your choice to +distribute the Covered Software under a subsequent version of this +License (see Section 10.2) or under the terms of a Secondary License (if +permitted under the terms of Section 3.3). + +2.5. Representation + +Each Contributor represents that the Contributor believes its +Contributions are its original creation(s) or it has sufficient rights +to grant the rights to its Contributions conveyed by this License. + +2.6. Fair Use + +This License is not intended to limit any rights You have under +applicable copyright doctrines of fair use, fair dealing, or other +equivalents. + +2.7. Conditions + +Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted +in Section 2.1. + +3. Responsibilities +------------------- + +3.1. Distribution of Source Form + +All distribution of Covered Software in Source Code Form, including any +Modifications that You create or to which You contribute, must be under +the terms of this License. You must inform recipients that the Source +Code Form of the Covered Software is governed by the terms of this +License, and how they can obtain a copy of this License. You may not +attempt to alter or restrict the recipients' rights in the Source Code +Form. + +3.2. Distribution of Executable Form + +If You distribute Covered Software in Executable Form then: + +(a) such Covered Software must also be made available in Source Code + Form, as described in Section 3.1, and You must inform recipients of + the Executable Form how they can obtain a copy of such Source Code + Form by reasonable means in a timely manner, at a charge no more + than the cost of distribution to the recipient; and + +(b) You may distribute such Executable Form under the terms of this + License, or sublicense it under different terms, provided that the + license for the Executable Form does not attempt to limit or alter + the recipients' rights in the Source Code Form under this License. + +3.3. Distribution of a Larger Work + +You may create and distribute a Larger Work under terms of Your choice, +provided that You also comply with the requirements of this License for +the Covered Software. If the Larger Work is a combination of Covered +Software with a work governed by one or more Secondary Licenses, and the +Covered Software is not Incompatible With Secondary Licenses, this +License permits You to additionally distribute such Covered Software +under the terms of such Secondary License(s), so that the recipient of +the Larger Work may, at their option, further distribute the Covered +Software under the terms of either this License or such Secondary +License(s). + +3.4. Notices + +You may not remove or alter the substance of any license notices +(including copyright notices, patent notices, disclaimers of warranty, +or limitations of liability) contained within the Source Code Form of +the Covered Software, except that You may alter any license notices to +the extent required to remedy known factual inaccuracies. + +3.5. Application of Additional Terms + +You may choose to offer, and to charge a fee for, warranty, support, +indemnity or liability obligations to one or more recipients of Covered +Software. However, You may do so only on Your own behalf, and not on +behalf of any Contributor. You must make it absolutely clear that any +such warranty, support, indemnity, or liability obligation is offered by +You alone, and You hereby agree to indemnify every Contributor for any +liability incurred by such Contributor as a result of warranty, support, +indemnity or liability terms You offer. You may include additional +disclaimers of warranty and limitations of liability specific to any +jurisdiction. + +4. Inability to Comply Due to Statute or Regulation +--------------------------------------------------- + +If it is impossible for You to comply with any of the terms of this +License with respect to some or all of the Covered Software due to +statute, judicial order, or regulation then You must: (a) comply with +the terms of this License to the maximum extent possible; and (b) +describe the limitations and the code they affect. Such description must +be placed in a text file included with all distributions of the Covered +Software under this License. Except to the extent prohibited by statute +or regulation, such description must be sufficiently detailed for a +recipient of ordinary skill to be able to understand it. + +5. Termination +-------------- + +5.1. The rights granted under this License will terminate automatically +if You fail to comply with any of its terms. However, if You become +compliant, then the rights granted under this License from a particular +Contributor are reinstated (a) provisionally, unless and until such +Contributor explicitly and finally terminates Your grants, and (b) on an +ongoing basis, if such Contributor fails to notify You of the +non-compliance by some reasonable means prior to 60 days after You have +come back into compliance. Moreover, Your grants from a particular +Contributor are reinstated on an ongoing basis if such Contributor +notifies You of the non-compliance by some reasonable means, this is the +first time You have received notice of non-compliance with this License +from such Contributor, and You become compliant prior to 30 days after +Your receipt of the notice. + +5.2. If You initiate litigation against any entity by asserting a patent +infringement claim (excluding declaratory judgment actions, +counter-claims, and cross-claims) alleging that a Contributor Version +directly or indirectly infringes any patent, then the rights granted to +You by any and all Contributors for the Covered Software under Section +2.1 of this License shall terminate. + +5.3. In the event of termination under Sections 5.1 or 5.2 above, all +end user license agreements (excluding distributors and resellers) which +have been validly granted by You or Your distributors under this License +prior to termination shall survive termination. + +************************************************************************ +* * +* 6. Disclaimer of Warranty * +* ------------------------- * +* * +* Covered Software is provided under this License on an "as is" * +* basis, without warranty of any kind, either expressed, implied, or * +* statutory, including, without limitation, warranties that the * +* Covered Software is free of defects, merchantable, fit for a * +* particular purpose or non-infringing. The entire risk as to the * +* quality and performance of the Covered Software is with You. * +* Should any Covered Software prove defective in any respect, You * +* (not any Contributor) assume the cost of any necessary servicing, * +* repair, or correction. This disclaimer of warranty constitutes an * +* essential part of this License. No use of any Covered Software is * +* authorized under this License except under this disclaimer. * +* * +************************************************************************ + +************************************************************************ +* * +* 7. Limitation of Liability * +* -------------------------- * +* * +* Under no circumstances and under no legal theory, whether tort * +* (including negligence), contract, or otherwise, shall any * +* Contributor, or anyone who distributes Covered Software as * +* permitted above, be liable to You for any direct, indirect, * +* special, incidental, or consequential damages of any character * +* including, without limitation, damages for lost profits, loss of * +* goodwill, work stoppage, computer failure or malfunction, or any * +* and all other commercial damages or losses, even if such party * +* shall have been informed of the possibility of such damages. This * +* limitation of liability shall not apply to liability for death or * +* personal injury resulting from such party's negligence to the * +* extent applicable law prohibits such limitation. Some * +* jurisdictions do not allow the exclusion or limitation of * +* incidental or consequential damages, so this exclusion and * +* limitation may not apply to You. * +* * +************************************************************************ + +8. Litigation +------------- + +Any litigation relating to this License may be brought only in the +courts of a jurisdiction where the defendant maintains its principal +place of business and such litigation shall be governed by laws of that +jurisdiction, without reference to its conflict-of-law provisions. +Nothing in this Section shall prevent a party's ability to bring +cross-claims or counter-claims. + +9. Miscellaneous +---------------- + +This License represents the complete agreement concerning the subject +matter hereof. If any provision of this License is held to be +unenforceable, such provision shall be reformed only to the extent +necessary to make it enforceable. Any law or regulation which provides +that the language of a contract shall be construed against the drafter +shall not be used to construe this License against a Contributor. + +10. Versions of the License +--------------------------- + +10.1. New Versions + +Mozilla Foundation is the license steward. Except as provided in Section +10.3, no one other than the license steward has the right to modify or +publish new versions of this License. Each version will be given a +distinguishing version number. + +10.2. Effect of New Versions + +You may distribute the Covered Software under the terms of the version +of the License under which You originally received the Covered Software, +or under the terms of any subsequent version published by the license +steward. + +10.3. Modified Versions + +If you create software not governed by this License, and you want to +create a new license for such software, you may create and use a +modified version of this License if you rename the license and remove +any references to the name of the license steward (except to note that +such modified license differs from this License). + +10.4. Distributing Source Code Form that is Incompatible With Secondary +Licenses + +If You choose to distribute Source Code Form that is Incompatible With +Secondary Licenses under the terms of this version of the License, the +notice described in Exhibit B of this License must be attached. + +Exhibit A - Source Code Form License Notice +------------------------------------------- + + This Source Code Form is subject to the terms of the Mozilla Public + License, v. 2.0. If a copy of the MPL was not distributed with this + file, You can obtain one at http://mozilla.org/MPL/2.0/. + +If it is not possible or desirable to put the notice in a particular +file, then You may include the notice in a location (such as a LICENSE +file in a relevant directory) where a recipient would be likely to look +for such a notice. + +You may add additional accurate notices of copyright ownership. + +Exhibit B - "Incompatible With Secondary Licenses" Notice +--------------------------------------------------------- + + This Source Code Form is "Incompatible With Secondary Licenses", as + defined by the Mozilla Public License, v. 2.0. diff --git a/builder/yandex/THIRD-PARTY b/builder/yandex/THIRD-PARTY new file mode 100644 index 000000000..8709059f4 --- /dev/null +++ b/builder/yandex/THIRD-PARTY @@ -0,0 +1,758 @@ +Third Party Notices + +This software is based on or incorporates materials from the following projects. +Their original copyright notices and licenses are provided below. + + +BSD License +github.com/golang/protobuf - Copyright (c) 2010 The Go Authors. All rights reserved. +golang.org/x/crypto/ssh - Copyright (c) 2009 The Go Authors. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + * Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above +copyright notice, this list of conditions and the following disclaimer +in the documentation and/or other materials provided with the +distribution. + * Neither the name of Google Inc. nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + +MIT License +github.com/yandex-cloud/go-genproto - Copyright (c) 2018 YANDEX LLC +github.com/yandex-cloud/go-sdk - Copyright (c) 2018 YANDEX LLC +github.com/c2h5oh/datasize - Copyright (c) 2016 Maciej Lisiewski. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. + + +Apache License 2.0 +google.golang.org/grpc - Copyright (c) 2014 Google Inc. + + Apache License + + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + + 1. Definitions. + + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + + END OF TERMS AND CONDITIONS + + + APPENDIX: How to apply the Apache License to your work. + + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + + Copyright [yyyy] [name of copyright owner] + + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + + http://www.apache.org/licenses/LICENSE-2.0 + + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + + +MPL License +github.com/hashicorp/packer – Copyright (c) 2013 HashiCorp, Inc. All rights reserved. + +Mozilla Public License Version 2.0 +================================== + + +1. Definitions +-------------- + + +1.1. "Contributor" + means each individual or legal entity that creates, contributes to + the creation of, or owns Covered Software. + + +1.2. "Contributor Version" + means the combination of the Contributions of others (if any) used + by a Contributor and that particular Contributor's Contribution. + + +1.3. "Contribution" + means Covered Software of a particular Contributor. + + +1.4. "Covered Software" + means Source Code Form to which the initial Contributor has attached + the notice in Exhibit A, the Executable Form of such Source Code + Form, and Modifications of such Source Code Form, in each case + including portions thereof. + + +1.5. "Incompatible With Secondary Licenses" + means + + + (a) that the initial Contributor has attached the notice described + in Exhibit B to the Covered Software; or + + + (b) that the Covered Software was made available under the terms of + version 1.1 or earlier of the License, but not also under the + terms of a Secondary License. + + +1.6. "Executable Form" + means any form of the work other than Source Code Form. + + +1.7. "Larger Work" + means a work that combines Covered Software with other material, in + a separate file or files, that is not Covered Software. + + +1.8. "License" + means this document. + + +1.9. "Licensable" + means having the right to grant, to the maximum extent possible, + whether at the time of the initial grant or subsequently, any and + all of the rights conveyed by this License. + + +1.10. "Modifications" + means any of the following: + + + (a) any file in Source Code Form that results from an addition to, + deletion from, or modification of the contents of Covered + Software; or + + + (b) any new file in Source Code Form that contains any Covered + Software. + + +1.11. "Patent Claims" of a Contributor + means any patent claim(s), including without limitation, method, + process, and apparatus claims, in any patent Licensable by such + Contributor that would be infringed, but for the grant of the + License, by the making, using, selling, offering for sale, having + made, import, or transfer of either its Contributions or its + Contributor Version. + + +1.12. "Secondary License" + means either the GNU General Public License, Version 2.0, the GNU + Lesser General Public License, Version 2.1, the GNU Affero General + Public License, Version 3.0, or any later versions of those + licenses. + + +1.13. "Source Code Form" + means the form of the work preferred for making modifications. + + +1.14. "You" (or "Your") + means an individual or a legal entity exercising rights under this + License. For legal entities, "You" includes any entity that + controls, is controlled by, or is under common control with You. For + purposes of this definition, "control" means (a) the power, direct + or indirect, to cause the direction or management of such entity, + whether by contract or otherwise, or (b) ownership of more than + fifty percent (50%) of the outstanding shares or beneficial + ownership of such entity. + + +2. License Grants and Conditions +-------------------------------- + + +2.1. Grants + + +Each Contributor hereby grants You a world-wide, royalty-free, +non-exclusive license: + + +(a) under intellectual property rights (other than patent or trademark) + Licensable by such Contributor to use, reproduce, make available, + modify, display, perform, distribute, and otherwise exploit its + Contributions, either on an unmodified basis, with Modifications, or + as part of a Larger Work; and + + +(b) under Patent Claims of such Contributor to make, use, sell, offer + for sale, have made, import, and otherwise transfer either its + Contributions or its Contributor Version. + + +2.2. Effective Date + + +The licenses granted in Section 2.1 with respect to any Contribution +become effective for each Contribution on the date the Contributor first +distributes such Contribution. + + +2.3. Limitations on Grant Scope + + +The licenses granted in this Section 2 are the only rights granted under +this License. No additional rights or licenses will be implied from the +distribution or licensing of Covered Software under this License. +Notwithstanding Section 2.1(b) above, no patent license is granted by a +Contributor: + + +(a) for any code that a Contributor has removed from Covered Software; + or + + +(b) for infringements caused by: (i) Your and any other third party's + modifications of Covered Software, or (ii) the combination of its + Contributions with other software (except as part of its Contributor + Version); or + + +(c) under Patent Claims infringed by Covered Software in the absence of + its Contributions. + + +This License does not grant any rights in the trademarks, service marks, +or logos of any Contributor (except as may be necessary to comply with +the notice requirements in Section 3.4). + + +2.4. Subsequent Licenses + + +No Contributor makes additional grants as a result of Your choice to +distribute the Covered Software under a subsequent version of this +License (see Section 10.2) or under the terms of a Secondary License (if +permitted under the terms of Section 3.3). + + +2.5. Representation + + +Each Contributor represents that the Contributor believes its +Contributions are its original creation(s) or it has sufficient rights +to grant the rights to its Contributions conveyed by this License. + + +2.6. Fair Use + + +This License is not intended to limit any rights You have under +applicable copyright doctrines of fair use, fair dealing, or other +equivalents. + + +2.7. Conditions + + +Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted +in Section 2.1. + + +3. Responsibilities +------------------- + + +3.1. Distribution of Source Form + + +All distribution of Covered Software in Source Code Form, including any +Modifications that You create or to which You contribute, must be under +the terms of this License. You must inform recipients that the Source +Code Form of the Covered Software is governed by the terms of this +License, and how they can obtain a copy of this License. You may not +attempt to alter or restrict the recipients' rights in the Source Code +Form. + + +3.2. Distribution of Executable Form + + +If You distribute Covered Software in Executable Form then: + + +(a) such Covered Software must also be made available in Source Code + Form, as described in Section 3.1, and You must inform recipients of + the Executable Form how they can obtain a copy of such Source Code + Form by reasonable means in a timely manner, at a charge no more + than the cost of distribution to the recipient; and + + +(b) You may distribute such Executable Form under the terms of this + License, or sublicense it under different terms, provided that the + license for the Executable Form does not attempt to limit or alter + the recipients' rights in the Source Code Form under this License. + + +3.3. Distribution of a Larger Work + + +You may create and distribute a Larger Work under terms of Your choice, +provided that You also comply with the requirements of this License for +the Covered Software. If the Larger Work is a combination of Covered +Software with a work governed by one or more Secondary Licenses, and the +Covered Software is not Incompatible With Secondary Licenses, this +License permits You to additionally distribute such Covered Software +under the terms of such Secondary License(s), so that the recipient of +the Larger Work may, at their option, further distribute the Covered +Software under the terms of either this License or such Secondary +License(s). + + +3.4. Notices + + +You may not remove or alter the substance of any license notices +(including copyright notices, patent notices, disclaimers of warranty, +or limitations of liability) contained within the Source Code Form of +the Covered Software, except that You may alter any license notices to +the extent required to remedy known factual inaccuracies. + + +3.5. Application of Additional Terms + + +You may choose to offer, and to charge a fee for, warranty, support, +indemnity or liability obligations to one or more recipients of Covered +Software. However, You may do so only on Your own behalf, and not on +behalf of any Contributor. You must make it absolutely clear that any +such warranty, support, indemnity, or liability obligation is offered by +You alone, and You hereby agree to indemnify every Contributor for any +liability incurred by such Contributor as a result of warranty, support, +indemnity or liability terms You offer. You may include additional +disclaimers of warranty and limitations of liability specific to any +jurisdiction. + + +4. Inability to Comply Due to Statute or Regulation +--------------------------------------------------- + + +If it is impossible for You to comply with any of the terms of this +License with respect to some or all of the Covered Software due to +statute, judicial order, or regulation then You must: (a) comply with +the terms of this License to the maximum extent possible; and (b) +describe the limitations and the code they affect. Such description must +be placed in a text file included with all distributions of the Covered +Software under this License. Except to the extent prohibited by statute +or regulation, such description must be sufficiently detailed for a +recipient of ordinary skill to be able to understand it. + + +5. Termination +-------------- + + +5.1. The rights granted under this License will terminate automatically +if You fail to comply with any of its terms. However, if You become +compliant, then the rights granted under this License from a particular +Contributor are reinstated (a) provisionally, unless and until such +Contributor explicitly and finally terminates Your grants, and (b) on an +ongoing basis, if such Contributor fails to notify You of the +non-compliance by some reasonable means prior to 60 days after You have +come back into compliance. Moreover, Your grants from a particular +Contributor are reinstated on an ongoing basis if such Contributor +notifies You of the non-compliance by some reasonable means, this is the +first time You have received notice of non-compliance with this License +from such Contributor, and You become compliant prior to 30 days after +Your receipt of the notice. + + +5.2. If You initiate litigation against any entity by asserting a patent +infringement claim (excluding declaratory judgment actions, +counter-claims, and cross-claims) alleging that a Contributor Version +directly or indirectly infringes any patent, then the rights granted to +You by any and all Contributors for the Covered Software under Section +2.1 of this License shall terminate. + + +5.3. In the event of termination under Sections 5.1 or 5.2 above, all +end user license agreements (excluding distributors and resellers) which +have been validly granted by You or Your distributors under this License +prior to termination shall survive termination. + + +************************************************************************ +* * +* 6. Disclaimer of Warranty * +* ------------------------- * +* * +* Covered Software is provided under this License on an "as is" * +* basis, without warranty of any kind, either expressed, implied, or * +* statutory, including, without limitation, warranties that the * +* Covered Software is free of defects, merchantable, fit for a * +* particular purpose or non-infringing. The entire risk as to the * +* quality and performance of the Covered Software is with You. * +* Should any Covered Software prove defective in any respect, You * +* (not any Contributor) assume the cost of any necessary servicing, * +* repair, or correction. This disclaimer of warranty constitutes an * +* essential part of this License. No use of any Covered Software is * +* authorized under this License except under this disclaimer. * +* * +************************************************************************ + + +************************************************************************ +* * +* 7. Limitation of Liability * +* -------------------------- * +* * +* Under no circumstances and under no legal theory, whether tort * +* (including negligence), contract, or otherwise, shall any * +* Contributor, or anyone who distributes Covered Software as * +* permitted above, be liable to You for any direct, indirect, * +* special, incidental, or consequential damages of any character * +* including, without limitation, damages for lost profits, loss of * +* goodwill, work stoppage, computer failure or malfunction, or any * +* and all other commercial damages or losses, even if such party * +* shall have been informed of the possibility of such damages. This * +* limitation of liability shall not apply to liability for death or * +* personal injury resulting from such party's negligence to the * +* extent applicable law prohibits such limitation. Some * +* jurisdictions do not allow the exclusion or limitation of * +* incidental or consequential damages, so this exclusion and * +* limitation may not apply to You. * +* * +************************************************************************ + + +8. Litigation +------------- + + +Any litigation relating to this License may be brought only in the +courts of a jurisdiction where the defendant maintains its principal +place of business and such litigation shall be governed by laws of that +jurisdiction, without reference to its conflict-of-law provisions. +Nothing in this Section shall prevent a party's ability to bring +cross-claims or counter-claims. + + +9. Miscellaneous +---------------- + + +This License represents the complete agreement concerning the subject +matter hereof. If any provision of this License is held to be +unenforceable, such provision shall be reformed only to the extent +necessary to make it enforceable. Any law or regulation which provides +that the language of a contract shall be construed against the drafter +shall not be used to construe this License against a Contributor. + + +10. Versions of the License +--------------------------- + + +10.1. New Versions + + +Mozilla Foundation is the license steward. Except as provided in Section +10.3, no one other than the license steward has the right to modify or +publish new versions of this License. Each version will be given a +distinguishing version number. + + +10.2. Effect of New Versions + + +You may distribute the Covered Software under the terms of the version +of the License under which You originally received the Covered Software, +or under the terms of any subsequent version published by the license +steward. + + +10.3. Modified Versions + + +If you create software not governed by this License, and you want to +create a new license for such software, you may create and use a +modified version of this License if you rename the license and remove +any references to the name of the license steward (except to note that +such modified license differs from this License). + + +10.4. Distributing Source Code Form that is Incompatible With Secondary +Licenses + + +If You choose to distribute Source Code Form that is Incompatible With +Secondary Licenses under the terms of this version of the License, the +notice described in Exhibit B of this License must be attached. + + +Exhibit A - Source Code Form License Notice +------------------------------------------- + + + This Source Code Form is subject to the terms of the Mozilla Public + License, v. 2.0. If a copy of the MPL was not distributed with this + file, You can obtain one at http://mozilla.org/MPL/2.0/. + + +If it is not possible or desirable to put the notice in a particular +file, then You may include the notice in a location (such as a LICENSE +file in a relevant directory) where a recipient would be likely to look +for such a notice. + + +You may add additional accurate notices of copyright ownership. + + +Exhibit B - "Incompatible With Secondary Licenses" Notice +--------------------------------------------------------- + + + This Source Code Form is "Incompatible With Secondary Licenses", as + defined by the Mozilla Public License, v. 2.0. + diff --git a/builder/yandex/builder.go b/builder/yandex/builder.go index 095733a18..2ec7f04ee 100644 --- a/builder/yandex/builder.go +++ b/builder/yandex/builder.go @@ -66,7 +66,7 @@ func (b *Builder) Run(ui packer.Ui, hook packer.Hook) (packer.Artifact, error) { &common.StepCleanupTempKeys{ Comm: &b.config.Communicator, }, - &stepShutdown{ + &stepTeardownInstance{ Debug: b.config.PackerDebug, }, &stepCreateImage{}, diff --git a/builder/yandex/builder_acc_test.go b/builder/yandex/builder_acc_test.go new file mode 100644 index 000000000..44a3b0f9f --- /dev/null +++ b/builder/yandex/builder_acc_test.go @@ -0,0 +1,36 @@ +package yandex + +import ( + "os" + "testing" + + builderT "github.com/hashicorp/packer/helper/builder/testing" +) + +func TestBuilderAcc_basic(t *testing.T) { + builderT.Test(t, builderT.TestCase{ + PreCheck: func() { testAccPreCheck(t) }, + Builder: &Builder{}, + Template: testBuilderAccBasic, + }) +} + +func testAccPreCheck(t *testing.T) { + if v := os.Getenv("YC_TOKEN"); v == "" { + t.Fatal("YC_TOKEN must be set for acceptance tests") + } + if v := os.Getenv("YC_FOLDER_ID"); v == "" { + t.Fatal("YC_FOLDER_ID must be set for acceptance tests") + } +} + +const testBuilderAccBasic = ` +{ + "builders": [{ + "type": "test", + "source_image_family": "ubuntu-1804-lts", + "use_ipv4_nat": "true", + "ssh_username": "ubuntu" + }] +} +` diff --git a/builder/yandex/config.go b/builder/yandex/config.go index 90cff475c..948eb0d2e 100644 --- a/builder/yandex/config.go +++ b/builder/yandex/config.go @@ -17,6 +17,9 @@ import ( "github.com/yandex-cloud/go-sdk/iamkey" ) +const defaultEndpoint = "api.cloud.yandex.net:443" +const defaultZone = "ru-central1-a" + var reImageFamily = regexp.MustCompile(`^[a-z]([-a-z0-9]{0,61}[a-z0-9])?$`) type Config struct { @@ -52,10 +55,9 @@ type Config struct { UseIPv4Nat bool `mapstructure:"use_ipv4_nat"` UseIPv6 bool `mapstructure:"use_ipv6"` - RawStepTimeout string `mapstructure:"step_timeout"` + StateTimeout time.Duration `mapstructure:"state_timeout"` - stepTimeout time.Duration - ctx interpolate.Context + ctx interpolate.Context } func NewConfig(raws ...interface{}) (*Config, []string, error) { @@ -134,10 +136,6 @@ func NewConfig(raws ...interface{}) (*Config, []string, error) { c.MachineType = "standard-v1" } - if c.RawStepTimeout == "" { - c.RawStepTimeout = "5m" - } - if es := c.Communicator.Prepare(&c.ctx); len(es) > 0 { errs = packer.MultiErrorAppend(errs, es...) } @@ -149,25 +147,35 @@ func NewConfig(raws ...interface{}) (*Config, []string, error) { errs, errors.New("a source_image_id or source_image_family must be specified")) } - err = c.CalcTimeout() - if err != nil { - errs = packer.MultiErrorAppend(errs, err) + if c.Endpoint == "" { + c.Endpoint = defaultEndpoint } - if c.Endpoint == "" { - c.Endpoint = "api.cloud.yandex.net:443" + if c.Zone == "" { + c.Zone = defaultZone + } + + // provision config by OS environment variables + if c.Token == "" { + c.Token = os.Getenv("YC_TOKEN") + } + + if c.ServiceAccountKeyFile == "" { + c.ServiceAccountKeyFile = os.Getenv("YC_SERVICE_ACCOUNT_KEY_FILE") + } + + if c.FolderID == "" { + c.FolderID = os.Getenv("YC_FOLDER_ID") } if c.Token == "" && c.ServiceAccountKeyFile == "" { errs = packer.MultiErrorAppend( errs, errors.New("a token or service account key file must be specified")) - } if c.Token != "" && c.ServiceAccountKeyFile != "" { errs = packer.MultiErrorAppend( errs, errors.New("one of token or service account key file must be specified, not both")) - } if c.Token != "" { @@ -177,9 +185,8 @@ func NewConfig(raws ...interface{}) (*Config, []string, error) { if c.ServiceAccountKeyFile != "" { if _, err := iamkey.ReadFromJSONFile(c.ServiceAccountKeyFile); err != nil { errs = packer.MultiErrorAppend( - errs, fmt.Errorf("fail to parse service account key file: %s", err)) + errs, fmt.Errorf("fail to read service account key file: %s", err)) } - } if c.FolderID == "" { @@ -187,9 +194,8 @@ func NewConfig(raws ...interface{}) (*Config, []string, error) { errs, errors.New("a folder_id must be specified")) } - if c.Zone == "" { - errs = packer.MultiErrorAppend( - errs, errors.New("a zone must be specified")) + if c.StateTimeout == 0 { + c.StateTimeout = 5 * time.Minute } // Check for any errors. @@ -199,12 +205,3 @@ func NewConfig(raws ...interface{}) (*Config, []string, error) { return c, nil, nil } - -func (c *Config) CalcTimeout() error { - stepTimeout, err := time.ParseDuration(c.RawStepTimeout) - if err != nil { - return fmt.Errorf("Failed parsing step_timeout: %s", err) - } - c.stepTimeout = stepTimeout - return nil -} diff --git a/builder/yandex/config_test.go b/builder/yandex/config_test.go index 3ac026241..5c7b89482 100644 --- a/builder/yandex/config_test.go +++ b/builder/yandex/config_test.go @@ -33,13 +33,11 @@ func TestConfigPrepare(t *testing.T) { "/tmp/i/should/not/exist", true, }, - { "service_account_key_file", tf.Name(), true, }, - { "service_account_key_file", TestServiceAccountKeyFile, @@ -82,7 +80,7 @@ func TestConfigPrepare(t *testing.T) { { "zone", nil, - true, + false, }, { "zone", @@ -101,16 +99,6 @@ func TestConfigPrepare(t *testing.T) { false, }, - { - "step_timeout", - "SO BAD", - true, - }, - { - "step_timeout", - "5s", - false, - }, { "image_family", nil, diff --git a/builder/yandex/driver_yc.go b/builder/yandex/driver_yc.go index 3bd40a45a..ebcb7a124 100644 --- a/builder/yandex/driver_yc.go +++ b/builder/yandex/driver_yc.go @@ -20,7 +20,7 @@ type Driver interface { DeleteImage(id string) error SDK() *ycsdk.SDK GetImage(imageID string) (*Image, error) - GetImageFromFolder(folderID string, family string) (*Image, error) + GetImageFromFolder(ctx context.Context, folderID string, family string) (*Image, error) } type driverYC struct { @@ -47,8 +47,8 @@ func (d *driverYC) GetImage(imageID string) (*Image, error) { }, nil } -func (d *driverYC) GetImageFromFolder(folderID string, family string) (*Image, error) { - image, err := d.sdk.Compute().Image().GetLatestByFamily(context.Background(), &compute.GetImageLatestByFamilyRequest{ +func (d *driverYC) GetImageFromFolder(ctx context.Context, folderID string, family string) (*Image, error) { + image, err := d.sdk.Compute().Image().GetLatestByFamily(ctx, &compute.GetImageLatestByFamilyRequest{ FolderId: folderID, Family: family, }) diff --git a/builder/yandex/step_create_image.go b/builder/yandex/step_create_image.go index 9d764c30b..75acdfcb1 100644 --- a/builder/yandex/step_create_image.go +++ b/builder/yandex/step_create_image.go @@ -15,14 +15,17 @@ import ( type stepCreateImage struct{} -func (stepCreateImage) Run(_ context.Context, state multistep.StateBag) multistep.StepAction { +func (stepCreateImage) Run(ctx context.Context, state multistep.StateBag) multistep.StepAction { sdk := state.Get("sdk").(*ycsdk.SDK) ui := state.Get("ui").(packer.Ui) c := state.Get("config").(*Config) diskID := state.Get("disk_id").(string) ui.Say(fmt.Sprintf("Creating image: %v", c.ImageName)) - op, err := sdk.WrapOperation(sdk.Compute().Image().Create(context.Background(), &compute.CreateImageRequest{ + ctx, cancel := context.WithTimeout(ctx, c.StateTimeout) + defer cancel() + + op, err := sdk.WrapOperation(sdk.Compute().Image().Create(ctx, &compute.CreateImageRequest{ FolderId: c.FolderID, Name: c.ImageName, Family: c.ImageFamily, @@ -37,9 +40,8 @@ func (stepCreateImage) Run(_ context.Context, state multistep.StateBag) multiste return stepHaltWithError(state, fmt.Errorf("Error creating image: %s", err)) } - // With the pending state over, verify that we're in the active state ui.Say("Waiting for image to complete...") - if err := op.Wait(context.Background()); err != nil { + if err := op.Wait(ctx); err != nil { return stepHaltWithError(state, fmt.Errorf("Error waiting for image: %s", err)) } @@ -61,6 +63,7 @@ func (stepCreateImage) Run(_ context.Context, state multistep.StateBag) multiste state.Put("image_id", image.Id) state.Put("image_name", c.ImageName) state.Put("image_family", c.ImageFamily) + state.Put("image_description", c.ImageDescription) return multistep.ActionContinue } diff --git a/builder/yandex/step_create_instance.go b/builder/yandex/step_create_instance.go index fa95bb3ad..a9dfc2c1c 100644 --- a/builder/yandex/step_create_instance.go +++ b/builder/yandex/step_create_instance.go @@ -25,13 +25,12 @@ type stepCreateInstance struct { cleanupSubnetID string } -func createNetwork(c *Config, d Driver) (*vpc.Network, error) { +func createNetwork(ctx context.Context, c *Config, d Driver) (*vpc.Network, error) { req := &vpc.CreateNetworkRequest{ FolderId: c.FolderID, Name: fmt.Sprintf("packer-network-%s", uuid.TimeOrderedUUID()), } - ctx := context.Background() sdk := d.SDK() op, err := sdk.WrapOperation(sdk.VPC().Network().Create(ctx, req)) @@ -56,7 +55,7 @@ func createNetwork(c *Config, d Driver) (*vpc.Network, error) { return network, nil } -func createSubnet(c *Config, d Driver, networkID string) (*vpc.Subnet, error) { +func createSubnet(ctx context.Context, c *Config, d Driver, networkID string) (*vpc.Subnet, error) { req := &vpc.CreateSubnetRequest{ FolderId: c.FolderID, NetworkId: networkID, @@ -65,7 +64,6 @@ func createSubnet(c *Config, d Driver, networkID string) (*vpc.Subnet, error) { V4CidrBlocks: []string{"192.168.111.0/24"}, } - ctx := context.Background() sdk := d.SDK() op, err := sdk.WrapOperation(sdk.VPC().Subnet().Create(ctx, req)) @@ -90,38 +88,41 @@ func createSubnet(c *Config, d Driver, networkID string) (*vpc.Subnet, error) { return network, nil } -func getImage(c *Config, d Driver) (*Image, error) { +func getImage(ctx context.Context, c *Config, d Driver) (*Image, error) { if c.SourceImageID != "" { return d.GetImage(c.SourceImageID) } familyName := c.SourceImageFamily if c.SourceImageFolderID != "" { - return d.GetImageFromFolder(c.SourceImageFolderID, familyName) + return d.GetImageFromFolder(ctx, c.SourceImageFolderID, familyName) } - return d.GetImageFromFolder("standard-images", familyName) + return d.GetImageFromFolder(ctx, "standard-images", familyName) } -func (s *stepCreateInstance) Run(_ context.Context, state multistep.StateBag) multistep.StepAction { +func (s *stepCreateInstance) Run(ctx context.Context, state multistep.StateBag) multistep.StepAction { sdk := state.Get("sdk").(*ycsdk.SDK) ui := state.Get("ui").(packer.Ui) c := state.Get("config").(*Config) d := state.Get("driver").(Driver) - // create or reuse Subnet + ctx, cancel := context.WithTimeout(ctx, c.StateTimeout) + defer cancel() + + // create or reuse network configuration instanceSubnetID := "" if c.SubnetID == "" { - // create Network + // create Network and Subnet ui.Say("Creating network...") - network, err := createNetwork(c, d) + network, err := createNetwork(ctx, c, d) if err != nil { return stepHaltWithError(state, fmt.Errorf("Error creating network: %s", err)) } state.Put("network_id", network.Id) s.cleanupNetworkID = network.Id - ui.Say("Creating subnet in zone...") - subnet, err := createSubnet(c, d, network.Id) + ui.Say(fmt.Sprintf("Creating subnet in zone %q...", c.Zone)) + subnet, err := createSubnet(ctx, c, d, network.Id) if err != nil { return stepHaltWithError(state, fmt.Errorf("Error creating subnet: %s", err)) } @@ -136,7 +137,7 @@ func (s *stepCreateInstance) Run(_ context.Context, state multistep.StateBag) mu // Create an instance based on the configuration ui.Say("Creating instance...") - sourceImage, err := getImage(c, d) + sourceImage, err := getImage(ctx, c, d) if err != nil { return stepHaltWithError(state, fmt.Errorf("Error getting source image for instance creation: %s", err)) } @@ -173,7 +174,7 @@ runcmd: }, Metadata: instanceMetadata, BootDiskSpec: &compute.AttachedDiskSpec{ - AutoDelete: true, + AutoDelete: false, Disk: &compute.AttachedDiskSpec_DiskSpec_{ DiskSpec: &compute.AttachedDiskSpec_DiskSpec{ Name: c.DiskName, @@ -205,7 +206,6 @@ runcmd: } } - ctx := context.Background() op, err := sdk.WrapOperation(sdk.Compute().Instance().Create(ctx, req)) if err != nil { return stepHaltWithError(state, fmt.Errorf("Error create instance: %s", err)) @@ -230,7 +230,7 @@ runcmd: s.cleanupInstanceID = instance.Id if s.Debug { - ui.Message(fmt.Sprintf("Instance ID %s started. Current status %s", instance.Id, instance.Status)) + ui.Message(fmt.Sprintf("Instance ID %s started. Current instance status %s", instance.Id, instance.Status)) } // Store the instance id for later @@ -246,7 +246,7 @@ func (s *stepCreateInstance) Cleanup(state multistep.StateBag) { return } - sdk := state.Get("sdk").(*ycsdk.SDK) + c := state.Get("config").(*Config) ui := state.Get("ui").(packer.Ui) if s.SerialLogFile != "" { @@ -257,26 +257,13 @@ func (s *stepCreateInstance) Cleanup(state multistep.StateBag) { } } - // Destroy the instance we just created - ui.Say("Destroying instance...") - - _, err := sdk.Compute().Instance().Delete(context.Background(), &compute.DeleteInstanceRequest{ - InstanceId: s.cleanupInstanceID, - }) - if err != nil { - ui.Error(fmt.Sprintf( - "Error destroying instance (id: %s): %s.\nPlease destroy it manually", s.cleanupInstanceID, err)) - } + ctx, cancel := context.WithTimeout(context.Background(), c.StateTimeout) + defer cancel() if s.cleanupSubnetID != "" { - // some sleep before delete network components - time.Sleep(30 * time.Second) - // Destroy the subnet we just created ui.Say("Destroying subnet...") - _, err = sdk.VPC().Subnet().Delete(context.Background(), &vpc.DeleteSubnetRequest{ - SubnetId: s.cleanupSubnetID, - }) + err := deleteSubnet(ctx, s.cleanupSubnetID, state) if err != nil { ui.Error(fmt.Sprintf( "Error destroying subnet (id: %s). Please destroy it manually: %s", s.cleanupSubnetID, err)) @@ -287,16 +274,79 @@ func (s *stepCreateInstance) Cleanup(state multistep.StateBag) { // Destroy the network we just created ui.Say("Destroying network...") - _, err = sdk.VPC().Network().Delete(context.Background(), &vpc.DeleteNetworkRequest{ - NetworkId: s.cleanupNetworkID, - }) + err = deleteNetwork(ctx, s.cleanupNetworkID, state) if err != nil { ui.Error(fmt.Sprintf( "Error destroying network (id: %s). Please destroy it manually: %s", s.cleanupNetworkID, err)) } } + ui.Say("Destroying boot disk...") + diskID := state.Get("disk_id").(string) + err := deleteDisk(ctx, diskID, state) + if err != nil { + ui.Error(fmt.Sprintf( + "Error destroying boot disk (id: %s). Please destroy it manually: %s", s.cleanupNetworkID, err)) + } +} + +func deleteSubnet(ctx context.Context, subnetID string, state multistep.StateBag) error { + sdk := state.Get("sdk").(*ycsdk.SDK) + + op, err := sdk.WrapOperation(sdk.VPC().Subnet().Delete(ctx, &vpc.DeleteSubnetRequest{ + SubnetId: subnetID, + })) + if err != nil { + return err + } + + err = op.Wait(ctx) + if err != nil { + return err + } + + _, err = op.Response() + return err } + +func deleteNetwork(ctx context.Context, networkID string, state multistep.StateBag) error { + sdk := state.Get("sdk").(*ycsdk.SDK) + + op, err := sdk.WrapOperation(sdk.VPC().Network().Delete(ctx, &vpc.DeleteNetworkRequest{ + NetworkId: networkID, + })) + if err != nil { + return err + } + + err = op.Wait(ctx) + if err != nil { + return err + } + + _, err = op.Response() + return err +} + +func deleteDisk(ctx context.Context, diskID string, state multistep.StateBag) error { + sdk := state.Get("sdk").(*ycsdk.SDK) + + op, err := sdk.WrapOperation(sdk.Compute().Disk().Delete(ctx, &compute.DeleteDiskRequest{ + DiskId: diskID, + })) + if err != nil { + return err + } + + err = op.Wait(ctx) + if err != nil { + return err + } + + _, err = op.Response() + return err +} + func (s *stepCreateInstance) writeSerialLogFile(state multistep.StateBag) error { sdk := state.Get("sdk").(*ycsdk.SDK) ui := state.Get("ui").(packer.Ui) diff --git a/builder/yandex/step_instance_info.go b/builder/yandex/step_instance_info.go index bd6f192c6..1a3d77e78 100644 --- a/builder/yandex/step_instance_info.go +++ b/builder/yandex/step_instance_info.go @@ -14,7 +14,7 @@ import ( type stepInstanceInfo struct{} -func (s *stepInstanceInfo) Run(_ context.Context, state multistep.StateBag) multistep.StepAction { +func (s *stepInstanceInfo) Run(ctx context.Context, state multistep.StateBag) multistep.StepAction { sdk := state.Get("sdk").(*ycsdk.SDK) ui := state.Get("ui").(packer.Ui) c := state.Get("config").(*Config) @@ -22,8 +22,10 @@ func (s *stepInstanceInfo) Run(_ context.Context, state multistep.StateBag) mult ui.Say("Waiting for instance to become active...") - // Set the IP on the state for later - instance, err := sdk.Compute().Instance().Get(context.Background(), &compute.GetInstanceRequest{ + ctx, cancel := context.WithTimeout(ctx, c.StateTimeout) + defer cancel() + + instance, err := sdk.Compute().Instance().Get(ctx, &compute.GetInstanceRequest{ InstanceId: instanceID, View: compute.InstanceView_FULL, }) diff --git a/builder/yandex/step_shutdown.go b/builder/yandex/step_shutdown.go deleted file mode 100644 index e1f189bd3..000000000 --- a/builder/yandex/step_shutdown.go +++ /dev/null @@ -1,49 +0,0 @@ -package yandex - -import ( - "context" - "fmt" - - "github.com/hashicorp/packer/helper/multistep" - "github.com/hashicorp/packer/packer" - - "github.com/yandex-cloud/go-genproto/yandex/cloud/compute/v1" - ycsdk "github.com/yandex-cloud/go-sdk" -) - -type stepShutdown struct { - Debug bool -} - -func (s *stepShutdown) Run(_ context.Context, state multistep.StateBag) multistep.StepAction { - sdk := state.Get("sdk").(*ycsdk.SDK) - ui := state.Get("ui").(packer.Ui) - instanceID := state.Get("instance_id").(string) - - // Gracefully power off the instance. We have to retry this a number - // of times because sometimes it says it completed when it actually - // did absolutely nothing (*ALAKAZAM!* magic!). We give up after - // a pretty arbitrary amount of time. - ui.Say("Gracefully shutting down instance...") - op, err := sdk.WrapOperation(sdk.Compute().Instance().Stop(context.Background(), &compute.StopInstanceRequest{ - InstanceId: instanceID, - })) - if err != nil { - return stepHaltWithError(state, fmt.Errorf("Error shutting down instance: %s", err)) - } - err = op.Wait(context.Background()) - if err != nil { - return stepHaltWithError(state, fmt.Errorf("Error shutting down instance: %s", err)) - } - - if s.Debug { - ui.Message("Instance status before image create:") - displayInstanceStatus(sdk, instanceID, ui) - } - - return multistep.ActionContinue -} - -func (s *stepShutdown) Cleanup(state multistep.StateBag) { - // no cleanup -} diff --git a/builder/yandex/step_teardown_instance.go b/builder/yandex/step_teardown_instance.go new file mode 100644 index 000000000..ded44437e --- /dev/null +++ b/builder/yandex/step_teardown_instance.go @@ -0,0 +1,48 @@ +package yandex + +import ( + "context" + "fmt" + + "github.com/hashicorp/packer/helper/multistep" + "github.com/hashicorp/packer/packer" + + "github.com/yandex-cloud/go-genproto/yandex/cloud/compute/v1" + ycsdk "github.com/yandex-cloud/go-sdk" +) + +type stepTeardownInstance struct { + Debug bool +} + +func (s *stepTeardownInstance) Run(ctx context.Context, state multistep.StateBag) multistep.StepAction { + sdk := state.Get("sdk").(*ycsdk.SDK) + ui := state.Get("ui").(packer.Ui) + c := state.Get("config").(*Config) + + instanceID := state.Get("instance_id").(string) + + ui.Say("Deleting instance...") + ctx, cancel := context.WithTimeout(ctx, c.StateTimeout) + defer cancel() + + op, err := sdk.WrapOperation(sdk.Compute().Instance().Delete(ctx, &compute.DeleteInstanceRequest{ + InstanceId: instanceID, + })) + if err != nil { + return stepHaltWithError(state, fmt.Errorf("Error deleting instance: %s", err)) + } + err = op.Wait(ctx) + if err != nil { + return stepHaltWithError(state, fmt.Errorf("Error deleting instance: %s", err)) + } + + ui.Message("Instance has been deleted!") + state.Put("instance_id", "") + + return multistep.ActionContinue +} + +func (s *stepTeardownInstance) Cleanup(state multistep.StateBag) { + // no cleanup +} diff --git a/builder/yandex/util.go b/builder/yandex/util.go index 52eb63f90..9c10aa842 100644 --- a/builder/yandex/util.go +++ b/builder/yandex/util.go @@ -1,15 +1,9 @@ package yandex import ( - "context" - "fmt" - "github.com/c2h5oh/datasize" "github.com/hashicorp/packer/helper/multistep" "github.com/hashicorp/packer/packer" - - "github.com/yandex-cloud/go-genproto/yandex/cloud/compute/v1" - ycsdk "github.com/yandex-cloud/go-sdk" ) func stepHaltWithError(state multistep.StateBag, err error) multistep.StepAction { @@ -19,16 +13,6 @@ func stepHaltWithError(state multistep.StateBag, err error) multistep.StepAction return multistep.ActionHalt } -func displayInstanceStatus(sdk *ycsdk.SDK, instanceID string, ui packer.Ui) { - instance, err := sdk.Compute().Instance().Get(context.Background(), &compute.GetInstanceRequest{ - InstanceId: instanceID, - }) - if err != nil { - ui.Error(fmt.Sprintf("Fail to get instance data: %s", err)) - } - ui.Message(fmt.Sprintf("Current instance status %s", instance.Status)) -} - func toGigabytes(bytesCount int64) int { return int((datasize.ByteSize(bytesCount) * datasize.B).GBytes()) } diff --git a/website/source/docs/builders/yandex.html.md b/website/source/docs/builders/yandex.html.md index b91882b0c..746d3b2a3 100644 --- a/website/source/docs/builders/yandex.html.md +++ b/website/source/docs/builders/yandex.html.md @@ -18,17 +18,34 @@ based on existing images. ## Authentication -FIXME +Yandex.Cloud services authentication requires one of the following security credentials: + +- OAuth token +- File with Service Account Key + + +### Authentication Using Token + +To authenticate with an OAuth token only `token` config key is needed. +Or use the `YC_TOKEN` environment variable. + + +### Authentication Using Service Account Key File + +To authenticate with a service account credential, only `service_account_key_file` is needed. +Or use the `YC_SERVICE_ACCOUNT_KEY_FILE` environment variable. -## Basic Example -FIXME +## Basic Example ``` json { - "builders": [ - FIXME - ] + "type": "yandex", + "token": "YOUR OAUTH TOKEN", + "folder_id": "YOUR FOLDER ID", + "source_image_family": "ubuntu-1804-lts", + "ssh_username": "ubuntu", + "use_ipv4_nat": "true" } ``` @@ -38,16 +55,88 @@ Configuration options are organized below into two categories: required and optional. Within each category, the available options are alphabetized and described. -In addition to the options listed here, a -[communicator](/docs/templates/communicator.html) can be configured for this -builder. +In addition to the options listed here, a [communicator](/docs/templates/communicator.html) +can be configured for this builder. ### Required: -FIXME +- `folder_id` (string) - The folder ID that will be used to launch instances and store images. + Alternatively you may set value by environment variable `YC_FOLDER_ID`. + +- `token` (string) - OAuth token to use to authenticate to Yandex.Cloud. Alternatively you may set + value by environment variable `YC_TOKEN`. + +- `source_image_family` (string) - The source image family to create the new image + from. You can also specify `source_image_id` instead. Just one of a `source_image_id` or + `source_image_family` must be specified. Example: `ubuntu-1804-lts` ### Optional: -FIXME +- `endpoint` (string) - Non standard api endpoint URL. + +- `instance_cores` (number) - The number of cores available to the instance. + +- `instance_mem_gb` (number) - The amount of memory available to the instance, specified in gigabytes. + +- `disk_name` (string) - The name of the disk, if unset the instance name + will be used. + +- `disk_size_gb` (number) - The size of the disk in GB. This defaults to `10`, which is 10GB. + +- `disk_type` (string) - Specify disk type for the launched instance. Defaults to `network-hdd`. + +- `image_description` (string) - The description of the resulting image. + +- `image_family` (string) - The family name of the resulting image. + +- `image_labels` (object of key/value strings) - Key/value pair labels to + apply to the created image. + +- `image_name` (string) - The unique name of the resulting image. Defaults to + `packer-{{timestamp}}`. + +- `image_product_ids` (list) - License IDs that indicate which licenses are attached to resulting image. + +- `instance_name` (string) - The name assigned to the instance. + +- `labels` (object of key/value strings) - Key/value pair labels to apply to + the launched instance. + +- `machine_type` (string) - The type of virtual machine to launch. This defaults to 'standard-v1'. + +- `metadata` (object of key/value strings) - Metadata applied to the launched + instance. + +- `serial_log_file` (string) - File path to save serial port output of the launched instance. + +- `service_account_key_file` (string) - Path to file with Service Account key in json format. This + is an alternative method to authenticate to Yandex.Cloud. Alternatively you may set environment variable + `YC_SERVICE_ACCOUNT_KEY_FILE`. + +- `source_image_folder_id` (string) - The ID of the folder containing the source image. + +- `source_image_id` (string) - The source image ID to use to create the new image + from. + +- `source_image_family` (string) - The source image family to create + the new image from. The image family always returns its latest image that + is not deprecated. Example: `ubuntu-1804-lts`. + +- `subnet_id` (string) - The Yandex VPC subnet id to use for + the launched instance. Note, the zone of the subnet must match the + `zone` in which the VM is launched. + +- `use_internal_ip` (boolean) - If true, use the instance's internal IP address + instead of its external IP during building. + +- `use_ipv4_nat` (boolean) - If set to `true`, then launched instance will have external internet + access. + +- `use_ipv6` (boolean) - Set to `true` to enable IPv6 for the instance being + created. This defaults to `false`, or not enabled. +-> **Note:** ~> Usage of IPv6 will be available in the future. +- `state_timeout` (string) - The time to wait for instance state changes. + Defaults to `5m`. +- `zone` (string) - The name of the zone to launch the instance. This defaults to `ru-central1-a`.