├── .github ├── ISSUE_TEMPLATE.md └── PULL_REQUEST_TEMPLATE.md ├── .gitignore ├── .travis.yml ├── CODE_OF_CONDUCT.md ├── CONTRIBUTING.md ├── LICENSE ├── LICENSE-APACHE2-ExplorerCanvas ├── LICENSE-BSD-base64js ├── LICENSE-MIT-EJS10 ├── LICENSE-MIT-Flot ├── LICENSE-MIT-Sammy060 ├── LICENSE-MIT-jQuery164 ├── LICENSE-MPL-RabbitMQ ├── Makefile ├── README.md ├── erlang.mk ├── priv └── www │ └── js │ ├── federation.js │ └── tmpl │ ├── federation-upstream.ejs │ ├── federation-upstreams.ejs │ └── federation.ejs ├── rabbitmq-components.mk ├── src └── rabbit_federation_mgmt.erl └── test └── federation_mgmt_SUITE.erl /.github/ISSUE_TEMPLATE.md: -------------------------------------------------------------------------------- 1 | Thank you for using RabbitMQ and for taking the time to report an 2 | issue. 3 | 4 | ## Does This Belong to GitHub or RabbitMQ Mailing List? 5 | 6 | *Important:* please first read the `CONTRIBUTING.md` document in the 7 | root of this repository. It will help you determine whether your 8 | feedback should be directed to the RabbitMQ mailing list [1] instead. 9 | 10 | ## Please Help Maintainers and Contributors Help You 11 | 12 | In order for the RabbitMQ team to investigate your issue, please provide 13 | **as much as possible** of the following details: 14 | 15 | * RabbitMQ version 16 | * Erlang version 17 | * RabbitMQ server and client application log files 18 | * A runnable code sample, terminal transcript or detailed set of 19 | instructions that can be used to reproduce the issue 20 | * RabbitMQ plugin information via `rabbitmq-plugins list` 21 | * Client library version (for all libraries used) 22 | * Operating system, version, and patch level 23 | 24 | Running the `rabbitmq-collect-env` [2] script can provide most of the 25 | information needed. Please make the archive available via a third-party 26 | service and note that **the script does not attempt to scrub any 27 | sensitive data**. 28 | 29 | If your issue involves RabbitMQ management UI or HTTP API, please also provide 30 | the following: 31 | 32 | * Browser and its version 33 | * What management UI page was used (if applicable) 34 | * How the HTTP API requests performed can be reproduced with `curl` 35 | * Operating system on which you are running your browser, and its version 36 | * Errors reported in the JavaScript console (if any) 37 | 38 | This information **greatly speeds up issue investigation** (or makes it 39 | possible to investigate it at all). Please help project maintainers and 40 | contributors to help you by providing it! 41 | 42 | 1. https://groups.google.com/forum/#!forum/rabbitmq-users 43 | 2. https://github.com/rabbitmq/support-tools/blob/master/scripts/rabbitmq-collect-env 44 | -------------------------------------------------------------------------------- /.github/PULL_REQUEST_TEMPLATE.md: -------------------------------------------------------------------------------- 1 | ## Proposed Changes 2 | 3 | Please describe the big picture of your changes here to communicate to the 4 | RabbitMQ team why we should accept this pull request. If it fixes a bug or 5 | resolves a feature request, be sure to link to that issue. 6 | 7 | A pull request that doesn't explain **why** the change was made has a much 8 | lower chance of being accepted. 9 | 10 | If English isn't your first language, don't worry about it and try to 11 | communicate the problem you are trying to solve to the best of your abilities. 12 | As long as we can understand the intent, it's all good. 13 | 14 | ## Types of Changes 15 | 16 | What types of changes does your code introduce to this project? 17 | _Put an `x` in the boxes that apply_ 18 | 19 | - [ ] Bugfix (non-breaking change which fixes issue #NNNN) 20 | - [ ] New feature (non-breaking change which adds functionality) 21 | - [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected) 22 | - [ ] Documentation (correction or otherwise) 23 | - [ ] Cosmetics (whitespace, appearance) 24 | 25 | ## Checklist 26 | 27 | _Put an `x` in the boxes that apply. You can also fill these out after creating 28 | the PR. If you're unsure about any of them, don't hesitate to ask on the 29 | mailing list. We're here to help! This is simply a reminder of what we are 30 | going to look for before merging your code._ 31 | 32 | - [ ] I have read the `CONTRIBUTING.md` document 33 | - [ ] I have signed the CA (see https://cla.pivotal.io/sign/rabbitmq) 34 | - [ ] All tests pass locally with my changes 35 | - [ ] I have added tests that prove my fix is effective or that my feature works 36 | - [ ] I have added necessary documentation (if appropriate) 37 | - [ ] Any dependent changes have been merged and published in related repositories 38 | 39 | ## Further Comments 40 | 41 | If this is a relatively large or complex change, kick off the discussion by 42 | explaining why you chose the solution you did and what alternatives you 43 | considered, etc. 44 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | .sw? 2 | .*.sw? 3 | *.beam 4 | /.erlang.mk/ 5 | /cover/ 6 | /deps/ 7 | /doc/ 8 | /ebin/ 9 | /escript/ 10 | /escript.lock 11 | /logs/ 12 | /plugins/ 13 | /plugins.lock 14 | /sbin/ 15 | /sbin.lock 16 | 17 | /rabbitmq_federation_management.d 18 | -------------------------------------------------------------------------------- /.travis.yml: -------------------------------------------------------------------------------- 1 | # vim:sw=2:et: 2 | 3 | os: linux 4 | dist: xenial 5 | language: elixir 6 | notifications: 7 | email: 8 | recipients: 9 | - alerts@rabbitmq.com 10 | on_success: never 11 | on_failure: always 12 | addons: 13 | apt: 14 | packages: 15 | - awscli 16 | cache: 17 | apt: true 18 | env: 19 | global: 20 | - secure: QjlyeWlfsQY8ejgtfLNJoKa8baKSs2+1uW+am1jE2/QVWsuJROLJbRpLnqmixtr6Xvlh1ayUTre+g3rtXHsmBQ5HEU51GvK/s3TA8JolkZs2vpx96UTKWFQaYHNyCSdovkXXon5jR+jN8D6z2HBgV5Emf0Fjx0w8/avhAt+Z8X8= 21 | - secure: SPsBl7vHGNof4p3i0tRNxh8C22cmCDrcaukpp2Y+591TsSdKQsZ/hNFNylb7Qfuaavpizijb+Twk4gD3TPhTagYHZaviUFRNbYrv09Ck5UvU+8z5R/XVfusFZ1OsY4awX2DzSuL3qwNuXKCVcLGlK83Z/HswVXEi4j6VHLI29iU= 22 | 23 | # $base_rmq_ref is used by rabbitmq-components.mk to select the 24 | # appropriate branch for dependencies. 25 | - base_rmq_ref=master 26 | 27 | elixir: 28 | - '1.9' 29 | otp_release: 30 | - '21.3' 31 | - '22.2' 32 | 33 | install: 34 | # This project being an Erlang one (we just set language to Elixir 35 | # to ensure it is installed), we don't want Travis to run mix(1) 36 | # automatically as it will break. 37 | skip 38 | 39 | script: 40 | # $current_rmq_ref is also used by rabbitmq-components.mk to select 41 | # the appropriate branch for dependencies. 42 | - make check-rabbitmq-components.mk 43 | current_rmq_ref="${TRAVIS_PULL_REQUEST_BRANCH:-${TRAVIS_BRANCH}}" 44 | - make xref 45 | current_rmq_ref="${TRAVIS_PULL_REQUEST_BRANCH:-${TRAVIS_BRANCH}}" 46 | - make tests 47 | current_rmq_ref="${TRAVIS_PULL_REQUEST_BRANCH:-${TRAVIS_BRANCH}}" 48 | 49 | after_failure: 50 | - | 51 | cd "$TRAVIS_BUILD_DIR" 52 | if test -d logs && test "$AWS_ACCESS_KEY_ID" && test "$AWS_SECRET_ACCESS_KEY"; then 53 | archive_name="$(basename "$TRAVIS_REPO_SLUG")-$TRAVIS_JOB_NUMBER" 54 | 55 | tar -c --transform "s/^logs/${archive_name}/" -f - logs | \ 56 | xz > "${archive_name}.tar.xz" 57 | 58 | aws s3 cp "${archive_name}.tar.xz" s3://server-release-pipeline/travis-ci-logs/ \ 59 | --region eu-west-1 \ 60 | --acl public-read 61 | fi 62 | -------------------------------------------------------------------------------- /CODE_OF_CONDUCT.md: -------------------------------------------------------------------------------- 1 | # Contributor Code of Conduct 2 | 3 | As contributors and maintainers of this project, and in the interest of fostering an open 4 | and welcoming community, we pledge to respect all people who contribute through reporting 5 | issues, posting feature requests, updating documentation, submitting pull requests or 6 | patches, and other activities. 7 | 8 | We are committed to making participation in this project a harassment-free experience for 9 | everyone, regardless of level of experience, gender, gender identity and expression, 10 | sexual orientation, disability, personal appearance, body size, race, ethnicity, age, 11 | religion, or nationality. 12 | 13 | Examples of unacceptable behavior by participants include: 14 | 15 | * The use of sexualized language or imagery 16 | * Personal attacks 17 | * Trolling or insulting/derogatory comments 18 | * Public or private harassment 19 | * Publishing other's private information, such as physical or electronic addresses, 20 | without explicit permission 21 | * Other unethical or unprofessional conduct 22 | 23 | Project maintainers have the right and responsibility to remove, edit, or reject comments, 24 | commits, code, wiki edits, issues, and other contributions that are not aligned to this 25 | Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors 26 | that they deem inappropriate, threatening, offensive, or harmful. 27 | 28 | By adopting this Code of Conduct, project maintainers commit themselves to fairly and 29 | consistently applying these principles to every aspect of managing this project. Project 30 | maintainers who do not follow or enforce the Code of Conduct may be permanently removed 31 | from the project team. 32 | 33 | This Code of Conduct applies both within project spaces and in public spaces when an 34 | individual is representing the project or its community. 35 | 36 | Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by 37 | contacting a project maintainer at [info@rabbitmq.com](mailto:info@rabbitmq.com). All complaints will 38 | be reviewed and investigated and will result in a response that is deemed necessary and 39 | appropriate to the circumstances. Maintainers are obligated to maintain confidentiality 40 | with regard to the reporter of an incident. 41 | 42 | This Code of Conduct is adapted from the 43 | [Contributor Covenant](https://contributor-covenant.org), version 1.3.0, available at 44 | [contributor-covenant.org/version/1/3/0/](https://contributor-covenant.org/version/1/3/0/) 45 | -------------------------------------------------------------------------------- /CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | Thank you for using RabbitMQ and for taking the time to contribute to the project. 2 | This document has two main parts: 3 | 4 | * when and how to file GitHub issues for RabbitMQ projects 5 | * how to submit pull requests 6 | 7 | They intend to save you and RabbitMQ maintainers some time, so please 8 | take a moment to read through them. 9 | 10 | ## Overview 11 | 12 | ### GitHub issues 13 | 14 | The RabbitMQ team uses GitHub issues for _specific actionable items_ that 15 | engineers can work on. This assumes the following: 16 | 17 | * GitHub issues are not used for questions, investigations, root cause 18 | analysis, discussions of potential issues, etc (as defined by this team) 19 | * Enough information is provided by the reporter for maintainers to work with 20 | 21 | The team receives many questions through various venues every single 22 | day. Frequently, these questions do not include the necessary details 23 | the team needs to begin useful work. GitHub issues can very quickly 24 | turn into a something impossible to navigate and make sense 25 | of. Because of this, questions, investigations, root cause analysis, 26 | and discussions of potential features are all considered to be 27 | [mailing list][rmq-users] material. If you are unsure where to begin, 28 | the [RabbitMQ users mailing list][rmq-users] is the right place. 29 | 30 | Getting all the details necessary to reproduce an issue, make a 31 | conclusion or even form a hypothesis about what's happening can take a 32 | fair amount of time. Please help others help you by providing a way to 33 | reproduce the behavior you're observing, or at least sharing as much 34 | relevant information as possible on the [RabbitMQ users mailing 35 | list][rmq-users]. 36 | 37 | Please provide versions of the software used: 38 | 39 | * RabbitMQ server 40 | * Erlang 41 | * Operating system version (and distribution, if applicable) 42 | * All client libraries used 43 | * RabbitMQ plugins (if applicable) 44 | 45 | The following information greatly helps in investigating and reproducing issues: 46 | 47 | * RabbitMQ server logs 48 | * A code example or terminal transcript that can be used to reproduce 49 | * Full exception stack traces (a single line message is not enough!) 50 | * `rabbitmqctl report` and `rabbitmqctl environment` output 51 | * Other relevant details about the environment and workload, e.g. a traffic capture 52 | * Feel free to edit out hostnames and other potentially sensitive information. 53 | 54 | To make collecting much of this and other environment information, use 55 | the [`rabbitmq-collect-env`][rmq-collect-env] script. It will produce an archive with 56 | server logs, operating system logs, output of certain diagnostics commands and so on. 57 | Please note that **no effort is made to scrub any information that may be sensitive**. 58 | 59 | ### Pull Requests 60 | 61 | RabbitMQ projects use pull requests to discuss, collaborate on and accept code contributions. 62 | Pull requests is the primary place of discussing code changes. 63 | 64 | Here's the recommended workflow: 65 | 66 | * [Fork the repository][github-fork] or repositories you plan on contributing to. If multiple 67 | repositories are involved in addressing the same issue, please use the same branch name 68 | in each repository 69 | * Create a branch with a descriptive name in the relevant repositories 70 | * Make your changes, run tests (usually with `make tests`), commit with a 71 | [descriptive message][git-commit-msgs], push to your fork 72 | * Submit pull requests with an explanation what has been changed and **why** 73 | * Submit a filled out and signed [Contributor Agreement][ca-agreement] if needed (see below) 74 | * Be patient. We will get to your pull request eventually 75 | 76 | If what you are going to work on is a substantial change, please first 77 | ask the core team for their opinion on the [RabbitMQ users mailing list][rmq-users]. 78 | 79 | ## Code of Conduct 80 | 81 | See [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md). 82 | 83 | ## Contributor Agreement 84 | 85 | If you want to contribute a non-trivial change, please submit a signed 86 | copy of our [Contributor Agreement][ca-agreement] around the time you 87 | submit your pull request. This will make it much easier (in some 88 | cases, possible) for the RabbitMQ team at Pivotal to merge your 89 | contribution. 90 | 91 | ## Where to Ask Questions 92 | 93 | If something isn't clear, feel free to ask on our [mailing list][rmq-users]. 94 | 95 | [rmq-collect-env]: https://github.com/rabbitmq/support-tools/blob/master/scripts/rabbitmq-collect-env 96 | [git-commit-msgs]: https://chris.beams.io/posts/git-commit/ 97 | [rmq-users]: https://groups.google.com/forum/#!forum/rabbitmq-users 98 | [ca-agreement]: https://cla.pivotal.io/sign/rabbitmq 99 | [github-fork]: https://help.github.com/articles/fork-a-repo/ 100 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | This package, the RabbitMQ FederationManagement Plugin is licensed under the MPL 2.0. For the 2 | MPL 2.0, please see LICENSE-MPL-RabbitMQ. 3 | 4 | This package makes use of the following third party libraries: 5 | 6 | jQuery - https://jquery.com/ - MIT license, see LICENSE-MIT-jQuery164 7 | EJS - https://embeddedjs.com/ - MIT license, see LICENSE-MIT-EJS10 8 | Sammy - https://code.quirkey.com/sammy/ - MIT license, see LICENSE-MIT-Sammy060 9 | cowboy - https://github.com/ninenines/cowboy - ISC license 10 | base64.js - https://code.google.com/p/stringencoders/ - BSD license, see LICENSE-BSD-base64js 11 | 12 | If you have any questions regarding licensing, please contact us at 13 | info@rabbitmq.com. 14 | -------------------------------------------------------------------------------- /LICENSE-APACHE2-ExplorerCanvas: -------------------------------------------------------------------------------- 1 | 2 | Apache License 3 | Version 2.0, January 2004 4 | http://www.apache.org/licenses/ 5 | 6 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 7 | 8 | 1. Definitions. 9 | 10 | "License" shall mean the terms and conditions for use, reproduction, 11 | and distribution as defined by Sections 1 through 9 of this document. 12 | 13 | "Licensor" shall mean the copyright owner or entity authorized by 14 | the copyright owner that is granting the License. 15 | 16 | "Legal Entity" shall mean the union of the acting entity and all 17 | other entities that control, are controlled by, or are under common 18 | control with that entity. For the purposes of this definition, 19 | "control" means (i) the power, direct or indirect, to cause the 20 | direction or management of such entity, whether by contract or 21 | otherwise, or (ii) ownership of fifty percent (50%) or more of the 22 | outstanding shares, or (iii) beneficial ownership of such entity. 23 | 24 | "You" (or "Your") shall mean an individual or Legal Entity 25 | exercising permissions granted by this License. 26 | 27 | "Source" form shall mean the preferred form for making modifications, 28 | including but not limited to software source code, documentation 29 | source, and configuration files. 30 | 31 | "Object" form shall mean any form resulting from mechanical 32 | transformation or translation of a Source form, including but 33 | not limited to compiled object code, generated documentation, 34 | and conversions to other media types. 35 | 36 | "Work" shall mean the work of authorship, whether in Source or 37 | Object form, made available under the License, as indicated by a 38 | copyright notice that is included in or attached to the work 39 | (an example is provided in the Appendix below). 40 | 41 | "Derivative Works" shall mean any work, whether in Source or Object 42 | form, that is based on (or derived from) the Work and for which the 43 | editorial revisions, annotations, elaborations, or other modifications 44 | represent, as a whole, an original work of authorship. For the purposes 45 | of this License, Derivative Works shall not include works that remain 46 | separable from, or merely link (or bind by name) to the interfaces of, 47 | the Work and Derivative Works thereof. 48 | 49 | "Contribution" shall mean any work of authorship, including 50 | the original version of the Work and any modifications or additions 51 | to that Work or Derivative Works thereof, that is intentionally 52 | submitted to Licensor for inclusion in the Work by the copyright owner 53 | or by an individual or Legal Entity authorized to submit on behalf of 54 | the copyright owner. For the purposes of this definition, "submitted" 55 | means any form of electronic, verbal, or written communication sent 56 | to the Licensor or its representatives, including but not limited to 57 | communication on electronic mailing lists, source code control systems, 58 | and issue tracking systems that are managed by, or on behalf of, the 59 | Licensor for the purpose of discussing and improving the Work, but 60 | excluding communication that is conspicuously marked or otherwise 61 | designated in writing by the copyright owner as "Not a Contribution." 62 | 63 | "Contributor" shall mean Licensor and any individual or Legal Entity 64 | on behalf of whom a Contribution has been received by Licensor and 65 | subsequently incorporated within the Work. 66 | 67 | 2. Grant of Copyright License. Subject to the terms and conditions of 68 | this License, each Contributor hereby grants to You a perpetual, 69 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 70 | copyright license to reproduce, prepare Derivative Works of, 71 | publicly display, publicly perform, sublicense, and distribute the 72 | Work and such Derivative Works in Source or Object form. 73 | 74 | 3. Grant of Patent License. Subject to the terms and conditions of 75 | this License, each Contributor hereby grants to You a perpetual, 76 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 77 | (except as stated in this section) patent license to make, have made, 78 | use, offer to sell, sell, import, and otherwise transfer the Work, 79 | where such license applies only to those patent claims licensable 80 | by such Contributor that are necessarily infringed by their 81 | Contribution(s) alone or by combination of their Contribution(s) 82 | with the Work to which such Contribution(s) was submitted. If You 83 | institute patent litigation against any entity (including a 84 | cross-claim or counterclaim in a lawsuit) alleging that the Work 85 | or a Contribution incorporated within the Work constitutes direct 86 | or contributory patent infringement, then any patent licenses 87 | granted to You under this License for that Work shall terminate 88 | as of the date such litigation is filed. 89 | 90 | 4. Redistribution. You may reproduce and distribute copies of the 91 | Work or Derivative Works thereof in any medium, with or without 92 | modifications, and in Source or Object form, provided that You 93 | meet the following conditions: 94 | 95 | (a) You must give any other recipients of the Work or 96 | Derivative Works a copy of this License; and 97 | 98 | (b) You must cause any modified files to carry prominent notices 99 | stating that You changed the files; and 100 | 101 | (c) You must retain, in the Source form of any Derivative Works 102 | that You distribute, all copyright, patent, trademark, and 103 | attribution notices from the Source form of the Work, 104 | excluding those notices that do not pertain to any part of 105 | the Derivative Works; and 106 | 107 | (d) If the Work includes a "NOTICE" text file as part of its 108 | distribution, then any Derivative Works that You distribute must 109 | include a readable copy of the attribution notices contained 110 | within such NOTICE file, excluding those notices that do not 111 | pertain to any part of the Derivative Works, in at least one 112 | of the following places: within a NOTICE text file distributed 113 | as part of the Derivative Works; within the Source form or 114 | documentation, if provided along with the Derivative Works; or, 115 | within a display generated by the Derivative Works, if and 116 | wherever such third-party notices normally appear. The contents 117 | of the NOTICE file are for informational purposes only and 118 | do not modify the License. You may add Your own attribution 119 | notices within Derivative Works that You distribute, alongside 120 | or as an addendum to the NOTICE text from the Work, provided 121 | that such additional attribution notices cannot be construed 122 | as modifying the License. 123 | 124 | You may add Your own copyright statement to Your modifications and 125 | may provide additional or different license terms and conditions 126 | for use, reproduction, or distribution of Your modifications, or 127 | for any such Derivative Works as a whole, provided Your use, 128 | reproduction, and distribution of the Work otherwise complies with 129 | the conditions stated in this License. 130 | 131 | 5. Submission of Contributions. Unless You explicitly state otherwise, 132 | any Contribution intentionally submitted for inclusion in the Work 133 | by You to the Licensor shall be under the terms and conditions of 134 | this License, without any additional terms or conditions. 135 | Notwithstanding the above, nothing herein shall supersede or modify 136 | the terms of any separate license agreement you may have executed 137 | with Licensor regarding such Contributions. 138 | 139 | 6. Trademarks. This License does not grant permission to use the trade 140 | names, trademarks, service marks, or product names of the Licensor, 141 | except as required for reasonable and customary use in describing the 142 | origin of the Work and reproducing the content of the NOTICE file. 143 | 144 | 7. Disclaimer of Warranty. Unless required by applicable law or 145 | agreed to in writing, Licensor provides the Work (and each 146 | Contributor provides its Contributions) on an "AS IS" BASIS, 147 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 148 | implied, including, without limitation, any warranties or conditions 149 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A 150 | PARTICULAR PURPOSE. You are solely responsible for determining the 151 | appropriateness of using or redistributing the Work and assume any 152 | risks associated with Your exercise of permissions under this License. 153 | 154 | 8. Limitation of Liability. In no event and under no legal theory, 155 | whether in tort (including negligence), contract, or otherwise, 156 | unless required by applicable law (such as deliberate and grossly 157 | negligent acts) or agreed to in writing, shall any Contributor be 158 | liable to You for damages, including any direct, indirect, special, 159 | incidental, or consequential damages of any character arising as a 160 | result of this License or out of the use or inability to use the 161 | Work (including but not limited to damages for loss of goodwill, 162 | work stoppage, computer failure or malfunction, or any and all 163 | other commercial damages or losses), even if such Contributor 164 | has been advised of the possibility of such damages. 165 | 166 | 9. Accepting Warranty or Additional Liability. While redistributing 167 | the Work or Derivative Works thereof, You may choose to offer, 168 | and charge a fee for, acceptance of support, warranty, indemnity, 169 | or other liability obligations and/or rights consistent with this 170 | License. However, in accepting such obligations, You may act only 171 | on Your own behalf and on Your sole responsibility, not on behalf 172 | of any other Contributor, and only if You agree to indemnify, 173 | defend, and hold each Contributor harmless for any liability 174 | incurred by, or claims asserted against, such Contributor by reason 175 | of your accepting any such warranty or additional liability. 176 | 177 | END OF TERMS AND CONDITIONS 178 | 179 | APPENDIX: How to apply the Apache License to your work. 180 | 181 | To apply the Apache License to your work, attach the following 182 | boilerplate notice, with the fields enclosed by brackets "[]" 183 | replaced with your own identifying information. (Don't include 184 | the brackets!) The text should be enclosed in the appropriate 185 | comment syntax for the file format. We also recommend that a 186 | file or class name and description of purpose be included on the 187 | same "printed page" as the copyright notice for easier 188 | identification within third-party archives. 189 | 190 | Copyright [yyyy] [name of copyright owner] 191 | 192 | Licensed under the Apache License, Version 2.0 (the "License"); 193 | you may not use this file except in compliance with the License. 194 | You may obtain a copy of the License at 195 | 196 | http://www.apache.org/licenses/LICENSE-2.0 197 | 198 | Unless required by applicable law or agreed to in writing, software 199 | distributed under the License is distributed on an "AS IS" BASIS, 200 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 201 | See the License for the specific language governing permissions and 202 | limitations under the License. 203 | -------------------------------------------------------------------------------- /LICENSE-BSD-base64js: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (c) 2010 Nick Galbreath 3 | * https://code.google.com/p/stringencoders/source/browse/#svn/trunk/javascript 4 | * 5 | * Permission is hereby granted, free of charge, to any person 6 | * obtaining a copy of this software and associated documentation 7 | * files (the "Software"), to deal in the Software without 8 | * restriction, including without limitation the rights to use, 9 | * copy, modify, merge, publish, distribute, sublicense, and/or sell 10 | * copies of the Software, and to permit persons to whom the 11 | * Software is furnished to do so, subject to the following 12 | * conditions: 13 | * 14 | * The above copyright notice and this permission notice shall be 15 | * included in all copies or substantial portions of the Software. 16 | * 17 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 18 | * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES 19 | * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 20 | * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT 21 | * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 22 | * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 23 | * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR 24 | * OTHER DEALINGS IN THE SOFTWARE. 25 | */ 26 | -------------------------------------------------------------------------------- /LICENSE-MIT-EJS10: -------------------------------------------------------------------------------- 1 | EJS - Embedded JavaScript 2 | 3 | Copyright (c) 2007 Edward Benson 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in 13 | all copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN 21 | THE SOFTWARE. 22 | 23 | 24 | -------------------------------------------------------------------------------- /LICENSE-MIT-Flot: -------------------------------------------------------------------------------- 1 | Copyright (c) 2007-2013 IOLA and Ole Laursen 2 | 3 | Permission is hereby granted, free of charge, to any person 4 | obtaining a copy of this software and associated documentation 5 | files (the "Software"), to deal in the Software without 6 | restriction, including without limitation the rights to use, 7 | copy, modify, merge, publish, distribute, sublicense, and/or sell 8 | copies of the Software, and to permit persons to whom the 9 | Software is furnished to do so, subject to the following 10 | conditions: 11 | 12 | The above copyright notice and this permission notice shall be 13 | included in all copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 16 | EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES 17 | OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 18 | NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT 19 | HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 20 | WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 21 | FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR 22 | OTHER DEALINGS IN THE SOFTWARE. 23 | -------------------------------------------------------------------------------- /LICENSE-MIT-Sammy060: -------------------------------------------------------------------------------- 1 | Copyright (c) 2008 Aaron Quint, Quirkey NYC, LLC 2 | 3 | Permission is hereby granted, free of charge, to any person 4 | obtaining a copy of this software and associated documentation 5 | files (the "Software"), to deal in the Software without 6 | restriction, including without limitation the rights to use, 7 | copy, modify, merge, publish, distribute, sublicense, and/or sell 8 | copies of the Software, and to permit persons to whom the 9 | Software is furnished to do so, subject to the following 10 | conditions: 11 | 12 | The above copyright notice and this permission notice shall be 13 | included in all copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 16 | EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES 17 | OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 18 | NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT 19 | HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 20 | WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 21 | FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR 22 | OTHER DEALINGS IN THE SOFTWARE. 23 | 24 | 25 | 26 | -------------------------------------------------------------------------------- /LICENSE-MIT-jQuery164: -------------------------------------------------------------------------------- 1 | Copyright (c) 2011 John Resig, https://jquery.com/ 2 | 3 | Permission is hereby granted, free of charge, to any person obtaining 4 | a copy of this software and associated documentation files (the 5 | "Software"), to deal in the Software without restriction, including 6 | without limitation the rights to use, copy, modify, merge, publish, 7 | distribute, sublicense, and/or sell copies of the Software, and to 8 | permit persons to whom the Software is furnished to do so, subject to 9 | the following conditions: 10 | 11 | The above copyright notice and this permission notice shall be 12 | included in all copies or substantial portions of the Software. 13 | 14 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 15 | EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 16 | MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 17 | NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE 18 | LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION 19 | OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION 20 | WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 21 | 22 | -------------------------------------------------------------------------------- /LICENSE-MPL-RabbitMQ: -------------------------------------------------------------------------------- 1 | Mozilla Public License Version 2.0 2 | ================================== 3 | 4 | 1. Definitions 5 | -------------- 6 | 7 | 1.1. "Contributor" 8 | means each individual or legal entity that creates, contributes to 9 | the creation of, or owns Covered Software. 10 | 11 | 1.2. "Contributor Version" 12 | means the combination of the Contributions of others (if any) used 13 | by a Contributor and that particular Contributor's Contribution. 14 | 15 | 1.3. "Contribution" 16 | means Covered Software of a particular Contributor. 17 | 18 | 1.4. "Covered Software" 19 | means Source Code Form to which the initial Contributor has attached 20 | the notice in Exhibit A, the Executable Form of such Source Code 21 | Form, and Modifications of such Source Code Form, in each case 22 | including portions thereof. 23 | 24 | 1.5. "Incompatible With Secondary Licenses" 25 | means 26 | 27 | (a) that the initial Contributor has attached the notice described 28 | in Exhibit B to the Covered Software; or 29 | 30 | (b) that the Covered Software was made available under the terms of 31 | version 1.1 or earlier of the License, but not also under the 32 | terms of a Secondary License. 33 | 34 | 1.6. "Executable Form" 35 | means any form of the work other than Source Code Form. 36 | 37 | 1.7. "Larger Work" 38 | means a work that combines Covered Software with other material, in 39 | a separate file or files, that is not Covered Software. 40 | 41 | 1.8. "License" 42 | means this document. 43 | 44 | 1.9. "Licensable" 45 | means having the right to grant, to the maximum extent possible, 46 | whether at the time of the initial grant or subsequently, any and 47 | all of the rights conveyed by this License. 48 | 49 | 1.10. "Modifications" 50 | means any of the following: 51 | 52 | (a) any file in Source Code Form that results from an addition to, 53 | deletion from, or modification of the contents of Covered 54 | Software; or 55 | 56 | (b) any new file in Source Code Form that contains any Covered 57 | Software. 58 | 59 | 1.11. "Patent Claims" of a Contributor 60 | means any patent claim(s), including without limitation, method, 61 | process, and apparatus claims, in any patent Licensable by such 62 | Contributor that would be infringed, but for the grant of the 63 | License, by the making, using, selling, offering for sale, having 64 | made, import, or transfer of either its Contributions or its 65 | Contributor Version. 66 | 67 | 1.12. "Secondary License" 68 | means either the GNU General Public License, Version 2.0, the GNU 69 | Lesser General Public License, Version 2.1, the GNU Affero General 70 | Public License, Version 3.0, or any later versions of those 71 | licenses. 72 | 73 | 1.13. "Source Code Form" 74 | means the form of the work preferred for making modifications. 75 | 76 | 1.14. "You" (or "Your") 77 | means an individual or a legal entity exercising rights under this 78 | License. For legal entities, "You" includes any entity that 79 | controls, is controlled by, or is under common control with You. For 80 | purposes of this definition, "control" means (a) the power, direct 81 | or indirect, to cause the direction or management of such entity, 82 | whether by contract or otherwise, or (b) ownership of more than 83 | fifty percent (50%) of the outstanding shares or beneficial 84 | ownership of such entity. 85 | 86 | 2. License Grants and Conditions 87 | -------------------------------- 88 | 89 | 2.1. Grants 90 | 91 | Each Contributor hereby grants You a world-wide, royalty-free, 92 | non-exclusive license: 93 | 94 | (a) under intellectual property rights (other than patent or trademark) 95 | Licensable by such Contributor to use, reproduce, make available, 96 | modify, display, perform, distribute, and otherwise exploit its 97 | Contributions, either on an unmodified basis, with Modifications, or 98 | as part of a Larger Work; and 99 | 100 | (b) under Patent Claims of such Contributor to make, use, sell, offer 101 | for sale, have made, import, and otherwise transfer either its 102 | Contributions or its Contributor Version. 103 | 104 | 2.2. Effective Date 105 | 106 | The licenses granted in Section 2.1 with respect to any Contribution 107 | become effective for each Contribution on the date the Contributor first 108 | distributes such Contribution. 109 | 110 | 2.3. Limitations on Grant Scope 111 | 112 | The licenses granted in this Section 2 are the only rights granted under 113 | this License. No additional rights or licenses will be implied from the 114 | distribution or licensing of Covered Software under this License. 115 | Notwithstanding Section 2.1(b) above, no patent license is granted by a 116 | Contributor: 117 | 118 | (a) for any code that a Contributor has removed from Covered Software; 119 | or 120 | 121 | (b) for infringements caused by: (i) Your and any other third party's 122 | modifications of Covered Software, or (ii) the combination of its 123 | Contributions with other software (except as part of its Contributor 124 | Version); or 125 | 126 | (c) under Patent Claims infringed by Covered Software in the absence of 127 | its Contributions. 128 | 129 | This License does not grant any rights in the trademarks, service marks, 130 | or logos of any Contributor (except as may be necessary to comply with 131 | the notice requirements in Section 3.4). 132 | 133 | 2.4. Subsequent Licenses 134 | 135 | No Contributor makes additional grants as a result of Your choice to 136 | distribute the Covered Software under a subsequent version of this 137 | License (see Section 10.2) or under the terms of a Secondary License (if 138 | permitted under the terms of Section 3.3). 139 | 140 | 2.5. Representation 141 | 142 | Each Contributor represents that the Contributor believes its 143 | Contributions are its original creation(s) or it has sufficient rights 144 | to grant the rights to its Contributions conveyed by this License. 145 | 146 | 2.6. Fair Use 147 | 148 | This License is not intended to limit any rights You have under 149 | applicable copyright doctrines of fair use, fair dealing, or other 150 | equivalents. 151 | 152 | 2.7. Conditions 153 | 154 | Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted 155 | in Section 2.1. 156 | 157 | 3. Responsibilities 158 | ------------------- 159 | 160 | 3.1. Distribution of Source Form 161 | 162 | All distribution of Covered Software in Source Code Form, including any 163 | Modifications that You create or to which You contribute, must be under 164 | the terms of this License. You must inform recipients that the Source 165 | Code Form of the Covered Software is governed by the terms of this 166 | License, and how they can obtain a copy of this License. You may not 167 | attempt to alter or restrict the recipients' rights in the Source Code 168 | Form. 169 | 170 | 3.2. Distribution of Executable Form 171 | 172 | If You distribute Covered Software in Executable Form then: 173 | 174 | (a) such Covered Software must also be made available in Source Code 175 | Form, as described in Section 3.1, and You must inform recipients of 176 | the Executable Form how they can obtain a copy of such Source Code 177 | Form by reasonable means in a timely manner, at a charge no more 178 | than the cost of distribution to the recipient; and 179 | 180 | (b) You may distribute such Executable Form under the terms of this 181 | License, or sublicense it under different terms, provided that the 182 | license for the Executable Form does not attempt to limit or alter 183 | the recipients' rights in the Source Code Form under this License. 184 | 185 | 3.3. Distribution of a Larger Work 186 | 187 | You may create and distribute a Larger Work under terms of Your choice, 188 | provided that You also comply with the requirements of this License for 189 | the Covered Software. If the Larger Work is a combination of Covered 190 | Software with a work governed by one or more Secondary Licenses, and the 191 | Covered Software is not Incompatible With Secondary Licenses, this 192 | License permits You to additionally distribute such Covered Software 193 | under the terms of such Secondary License(s), so that the recipient of 194 | the Larger Work may, at their option, further distribute the Covered 195 | Software under the terms of either this License or such Secondary 196 | License(s). 197 | 198 | 3.4. Notices 199 | 200 | You may not remove or alter the substance of any license notices 201 | (including copyright notices, patent notices, disclaimers of warranty, 202 | or limitations of liability) contained within the Source Code Form of 203 | the Covered Software, except that You may alter any license notices to 204 | the extent required to remedy known factual inaccuracies. 205 | 206 | 3.5. Application of Additional Terms 207 | 208 | You may choose to offer, and to charge a fee for, warranty, support, 209 | indemnity or liability obligations to one or more recipients of Covered 210 | Software. However, You may do so only on Your own behalf, and not on 211 | behalf of any Contributor. You must make it absolutely clear that any 212 | such warranty, support, indemnity, or liability obligation is offered by 213 | You alone, and You hereby agree to indemnify every Contributor for any 214 | liability incurred by such Contributor as a result of warranty, support, 215 | indemnity or liability terms You offer. You may include additional 216 | disclaimers of warranty and limitations of liability specific to any 217 | jurisdiction. 218 | 219 | 4. Inability to Comply Due to Statute or Regulation 220 | --------------------------------------------------- 221 | 222 | If it is impossible for You to comply with any of the terms of this 223 | License with respect to some or all of the Covered Software due to 224 | statute, judicial order, or regulation then You must: (a) comply with 225 | the terms of this License to the maximum extent possible; and (b) 226 | describe the limitations and the code they affect. Such description must 227 | be placed in a text file included with all distributions of the Covered 228 | Software under this License. Except to the extent prohibited by statute 229 | or regulation, such description must be sufficiently detailed for a 230 | recipient of ordinary skill to be able to understand it. 231 | 232 | 5. Termination 233 | -------------- 234 | 235 | 5.1. The rights granted under this License will terminate automatically 236 | if You fail to comply with any of its terms. However, if You become 237 | compliant, then the rights granted under this License from a particular 238 | Contributor are reinstated (a) provisionally, unless and until such 239 | Contributor explicitly and finally terminates Your grants, and (b) on an 240 | ongoing basis, if such Contributor fails to notify You of the 241 | non-compliance by some reasonable means prior to 60 days after You have 242 | come back into compliance. Moreover, Your grants from a particular 243 | Contributor are reinstated on an ongoing basis if such Contributor 244 | notifies You of the non-compliance by some reasonable means, this is the 245 | first time You have received notice of non-compliance with this License 246 | from such Contributor, and You become compliant prior to 30 days after 247 | Your receipt of the notice. 248 | 249 | 5.2. If You initiate litigation against any entity by asserting a patent 250 | infringement claim (excluding declaratory judgment actions, 251 | counter-claims, and cross-claims) alleging that a Contributor Version 252 | directly or indirectly infringes any patent, then the rights granted to 253 | You by any and all Contributors for the Covered Software under Section 254 | 2.1 of this License shall terminate. 255 | 256 | 5.3. In the event of termination under Sections 5.1 or 5.2 above, all 257 | end user license agreements (excluding distributors and resellers) which 258 | have been validly granted by You or Your distributors under this License 259 | prior to termination shall survive termination. 260 | 261 | ************************************************************************ 262 | * * 263 | * 6. Disclaimer of Warranty * 264 | * ------------------------- * 265 | * * 266 | * Covered Software is provided under this License on an "as is" * 267 | * basis, without warranty of any kind, either expressed, implied, or * 268 | * statutory, including, without limitation, warranties that the * 269 | * Covered Software is free of defects, merchantable, fit for a * 270 | * particular purpose or non-infringing. The entire risk as to the * 271 | * quality and performance of the Covered Software is with You. * 272 | * Should any Covered Software prove defective in any respect, You * 273 | * (not any Contributor) assume the cost of any necessary servicing, * 274 | * repair, or correction. This disclaimer of warranty constitutes an * 275 | * essential part of this License. No use of any Covered Software is * 276 | * authorized under this License except under this disclaimer. * 277 | * * 278 | ************************************************************************ 279 | 280 | ************************************************************************ 281 | * * 282 | * 7. Limitation of Liability * 283 | * -------------------------- * 284 | * * 285 | * Under no circumstances and under no legal theory, whether tort * 286 | * (including negligence), contract, or otherwise, shall any * 287 | * Contributor, or anyone who distributes Covered Software as * 288 | * permitted above, be liable to You for any direct, indirect, * 289 | * special, incidental, or consequential damages of any character * 290 | * including, without limitation, damages for lost profits, loss of * 291 | * goodwill, work stoppage, computer failure or malfunction, or any * 292 | * and all other commercial damages or losses, even if such party * 293 | * shall have been informed of the possibility of such damages. This * 294 | * limitation of liability shall not apply to liability for death or * 295 | * personal injury resulting from such party's negligence to the * 296 | * extent applicable law prohibits such limitation. Some * 297 | * jurisdictions do not allow the exclusion or limitation of * 298 | * incidental or consequential damages, so this exclusion and * 299 | * limitation may not apply to You. * 300 | * * 301 | ************************************************************************ 302 | 303 | 8. Litigation 304 | ------------- 305 | 306 | Any litigation relating to this License may be brought only in the 307 | courts of a jurisdiction where the defendant maintains its principal 308 | place of business and such litigation shall be governed by laws of that 309 | jurisdiction, without reference to its conflict-of-law provisions. 310 | Nothing in this Section shall prevent a party's ability to bring 311 | cross-claims or counter-claims. 312 | 313 | 9. Miscellaneous 314 | ---------------- 315 | 316 | This License represents the complete agreement concerning the subject 317 | matter hereof. If any provision of this License is held to be 318 | unenforceable, such provision shall be reformed only to the extent 319 | necessary to make it enforceable. Any law or regulation which provides 320 | that the language of a contract shall be construed against the drafter 321 | shall not be used to construe this License against a Contributor. 322 | 323 | 10. Versions of the License 324 | --------------------------- 325 | 326 | 10.1. New Versions 327 | 328 | Mozilla Foundation is the license steward. Except as provided in Section 329 | 10.3, no one other than the license steward has the right to modify or 330 | publish new versions of this License. Each version will be given a 331 | distinguishing version number. 332 | 333 | 10.2. Effect of New Versions 334 | 335 | You may distribute the Covered Software under the terms of the version 336 | of the License under which You originally received the Covered Software, 337 | or under the terms of any subsequent version published by the license 338 | steward. 339 | 340 | 10.3. Modified Versions 341 | 342 | If you create software not governed by this License, and you want to 343 | create a new license for such software, you may create and use a 344 | modified version of this License if you rename the license and remove 345 | any references to the name of the license steward (except to note that 346 | such modified license differs from this License). 347 | 348 | 10.4. Distributing Source Code Form that is Incompatible With Secondary 349 | Licenses 350 | 351 | If You choose to distribute Source Code Form that is Incompatible With 352 | Secondary Licenses under the terms of this version of the License, the 353 | notice described in Exhibit B of this License must be attached. 354 | 355 | Exhibit A - Source Code Form License Notice 356 | ------------------------------------------- 357 | 358 | This Source Code Form is subject to the terms of the Mozilla Public 359 | License, v. 2.0. If a copy of the MPL was not distributed with this 360 | file, You can obtain one at http://mozilla.org/MPL/2.0/. 361 | 362 | If it is not possible or desirable to put the notice in a particular 363 | file, then You may include the notice in a location (such as a LICENSE 364 | file in a relevant directory) where a recipient would be likely to look 365 | for such a notice. 366 | 367 | You may add additional accurate notices of copyright ownership. 368 | 369 | Exhibit B - "Incompatible With Secondary Licenses" Notice 370 | --------------------------------------------------------- 371 | 372 | This Source Code Form is "Incompatible With Secondary Licenses", as 373 | defined by the Mozilla Public License, v. 2.0. 374 | -------------------------------------------------------------------------------- /Makefile: -------------------------------------------------------------------------------- 1 | PROJECT = rabbitmq_federation_management 2 | PROJECT_DESCRIPTION = RabbitMQ Federation Management 3 | 4 | define PROJECT_APP_EXTRA_KEYS 5 | {broker_version_requirements, []} 6 | endef 7 | 8 | DEPS = rabbit_common rabbit rabbitmq_management rabbitmq_federation 9 | TEST_DEPS = rabbitmq_ct_helpers rabbitmq_ct_client_helpers 10 | 11 | DEP_EARLY_PLUGINS = rabbit_common/mk/rabbitmq-early-plugin.mk 12 | DEP_PLUGINS = rabbit_common/mk/rabbitmq-plugin.mk 13 | 14 | # FIXME: Use erlang.mk patched for RabbitMQ, while waiting for PRs to be 15 | # reviewed and merged. 16 | 17 | ERLANG_MK_REPO = https://github.com/rabbitmq/erlang.mk.git 18 | ERLANG_MK_COMMIT = rabbitmq-tmp 19 | 20 | include rabbitmq-components.mk 21 | include erlang.mk 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # RabbitMQ Federation Management Plugin 2 | 3 | ## This was migrated to https://github.com/rabbitmq/rabbitmq-server 4 | 5 | This repository has been moved to the main unified RabbitMQ "monorepo", including all open issues. You can find the source under [/deps/rabbitmq_federation_management](https://github.com/rabbitmq/rabbitmq-server/tree/master/deps/rabbitmq_federation_management). 6 | All issues have been transferred. 7 | 8 | ## Overview 9 | 10 | This plugin adds information on federation link status to the management 11 | plugin. 12 | 13 | ## Installation 14 | 15 | In recent releases, this [plugin](https://www.rabbitmq.com/plugins.html) ships with RabbitMQ. 16 | [Enable](https://www.rabbitmq.com/plugins.html#basics) it with 17 | 18 | ``` shell 19 | rabbitmq-plugins enable rabbitmq_management rabbitmq_federation_management 20 | ``` 21 | 22 | If you have a heterogenous cluster (where the nodes have different 23 | plugins installed), this should be installed on the same nodes as the 24 | management plugin. 25 | 26 | 27 | ## Use over HTTP API 28 | 29 | The HTTP API endpoints allow for retrieval of federation links: 30 | 31 | # lists all links 32 | GET /api/federation-links 33 | # lists links in a vhost 34 | GET /api/federation-links/{vhost} 35 | 36 | 37 | ## Building From Source 38 | 39 | To [build the plugin](https://www.rabbitmq.com/plugin-development.html), use 40 | 41 | make dist 42 | 43 | and see under the `./plugins` directory. 44 | 45 | 46 | ## Copyright and License 47 | 48 | (c) 2007-2020 VMware, Inc. or its affiliates. 49 | 50 | See `LICENSE` for license information. 51 | -------------------------------------------------------------------------------- /priv/www/js/federation.js: -------------------------------------------------------------------------------- 1 | dispatcher_add(function(sammy) { 2 | sammy.get('#/federation', function() { 3 | render({'links': {path: '/federation-links', 4 | options:{vhost:true}}, 5 | 'vhosts': '/vhosts'}, 6 | 'federation', '#/federation'); 7 | }); 8 | sammy.get('#/federation-upstreams', function() { 9 | render({'upstreams': {path: '/parameters/federation-upstream', 10 | options:{vhost:true}}, 11 | 'vhosts': '/vhosts', 12 | 'globals': '/parameters/federation'}, 13 | 'federation-upstreams', '#/federation-upstreams'); 14 | }); 15 | sammy.get('#/federation-upstreams/:vhost/:id', function() { 16 | render({'upstream': '/parameters/federation-upstream/' + esc(this.params['vhost']) + '/' + esc(this.params['id'])}, 17 | 'federation-upstream', '#/federation'); 18 | }); 19 | sammy.put('#/fed-parameters', function() { 20 | var num_keys = ['expires', 'message-ttl', 'max-hops', 21 | 'prefetch-count', 'reconnect-delay']; 22 | var bool_keys = ['trust-user-id']; 23 | var arrayable_keys = ['uri']; 24 | put_parameter(this, [], num_keys, bool_keys, arrayable_keys); 25 | return false; 26 | }); 27 | sammy.del('#/fed-parameters', function() { 28 | if (sync_delete(this, '/parameters/:component/:vhost/:name')) 29 | go_to('#/federation-upstreams'); 30 | return false; 31 | }); 32 | sammy.del("#/federation-restart-link", function(){ 33 | if(sync_delete(this, '/federation-links/vhost/:vhost/:id/:node/restart')){ 34 | update(); 35 | } 36 | }); 37 | }); 38 | 39 | NAVIGATION['Admin'][0]['Federation Status'] = ['#/federation', "monitoring"]; 40 | NAVIGATION['Admin'][0]['Federation Upstreams'] = ['#/federation-upstreams', "policymaker"]; 41 | 42 | HELP['federation-uri'] = 43 | 'URI to connect to. If upstream is a cluster and can have several URIs, you can enter them here separated by spaces.'; 44 | 45 | HELP['federation-prefetch'] = 46 | 'Maximum number of unacknowledged messages that may be in flight over a federation link at one time. Defaults to 1000 if not set.'; 47 | 48 | 49 | HELP['federation-reconnect'] = 50 | 'Time in seconds to wait after a network link goes down before attempting reconnection. Defaults to 5 if not set.'; 51 | 52 | 53 | HELP['federation-ack-mode'] = 54 | '
\ 55 |
on-confirm
\ 56 |
Messages are acknowledged to the upstream broker after they have been confirmed downstream. Handles network errors and broker failures without losing messages. The slowest option, and the default.
\ 57 |
on-publish
\ 58 |
Messages are acknowledged to the upstream broker after they have been published downstream. Handles network errors without losing messages, but may lose messages in the event of broker failures.
\ 59 |
no-ack
\ 60 |
Message acknowledgements are not used. The fastest option, but may lose messages in the event of network or broker failures.
\ 61 |
'; 62 | 63 | HELP['federation-trust-user-id'] = 64 | 'Set "Yes" to preserve the "user-id" field across a federation link, even if the user-id does not match that used to republish the message. Set to "No" to clear the "user-id" field when messages are federated. Only set this to "Yes" if you trust the upstream broker not to forge user-ids.'; 65 | 66 | HELP['exchange'] = 67 | 'The name of the upstream exchange. Default is to use the same name as the federated exchange.'; 68 | 69 | HELP['federation-max-hops'] = 70 | 'Maximum number of federation links that messages can traverse before being dropped. Defaults to 1 if not set.'; 71 | 72 | HELP['federation-expires'] = 73 | 'Time in milliseconds that the upstream should remember about this node for. After this time all upstream state will be removed. Leave this blank to mean "forever".'; 74 | 75 | HELP['federation-ttl'] = 76 | 'Time in milliseconds that undelivered messages should be held upstream when there is a network outage or backlog. Leave this blank to mean "forever".'; 77 | 78 | HELP['ha-policy'] = 79 | 'Determines the "x-ha-policy" argument for the upstream queue for a federated exchange. Default is "none", meaning the queue is not HA.'; 80 | 81 | HELP['queue'] = 82 | 'The name of the upstream queue. Default is to use the same name as the federated queue.'; 83 | 84 | HELP['consumer-tag'] = 85 | 'The consumer tag to use when consuming from upstream. Optional.'; 86 | 87 | function link_fed_conn(vhost, name) { 88 | return _link_to(name, '#/federation-upstreams/' + esc(vhost) + '/' + esc(name)); 89 | } 90 | -------------------------------------------------------------------------------- /priv/www/js/tmpl/federation-upstream.ejs: -------------------------------------------------------------------------------- 1 |

Federation Upstream: <%= fmt_string(upstream.name) %><%= fmt_maybe_vhost(upstream.vhost) %>

2 | 3 |
4 |

Overview

5 |
6 | 7 | 8 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | 64 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | 80 | 81 |
9 |

General parameters

10 |
URI<%= fmt_string(fmt_uri_with_credentials(upstream.value.uri)) %>
Prefetch Count<%= fmt_string(upstream.value['prefetch-count']) %>
Reconnect Delay<%= fmt_time(upstream.value['reconnect-delay'], 's') %>
Ack Mode<%= fmt_string(upstream.value['ack-mode']) %>
Trust User-ID<%= fmt_boolean(upstream.value['trust-user-id']) %>
34 |

Federated exchange parameters

35 |
Exchange<%= fmt_string(upstream.value['exchange']) %>
Max Hops<%= fmt_string(upstream.value['max-hops']) %>
Expires<%= fmt_time(upstream.value.expires, 'ms') %>
Message TTL<%= fmt_time(upstream.value['message-ttl'], 'ms') %>
HA Policy<%= fmt_string(upstream.value['ha-policy']) %>
65 |

Federated queue parameters

66 |
Queue<%= fmt_string(upstream.value['queue']) %>
Consumer tag<%= fmt_string(upstream.value['consumer-tag']) %>
82 |
83 |
84 | 85 |
86 |

Delete this upstream

87 |
88 |
89 | 90 | 91 | 92 | 93 |
94 |
95 |
96 | -------------------------------------------------------------------------------- /priv/www/js/tmpl/federation-upstreams.ejs: -------------------------------------------------------------------------------- 1 |

Federation Upstreams

2 |
3 |

Upstreams

4 |
5 | <% if (upstreams.length > 0) { %> 6 | 7 | 8 | 9 | <% if (vhosts_interesting) { %> 10 | 11 | <% } %> 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | <% 29 | for (var i = 0; i < upstreams.length; i++) { 30 | var upstream = upstreams[i]; 31 | %> 32 | > 33 | <% if (vhosts_interesting) { %> 34 | 35 | <% } %> 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | <% } %> 51 | 52 |
Virtual HostNameURIPrefetch CountReconnect DelayAck modeTrust User-IDExchangeMax HopsExpiryMessage TTLHA PolicyQueueConsumer tag
<%= fmt_string(upstream.vhost) %><%= link_fed_conn(upstream.vhost, upstream.name) %><%= fmt_shortened_uri(fmt_uri_with_credentials(upstream.value.uri)) %><%= upstream.value['prefetch-count'] %><%= fmt_time(upstream.value['reconnect-delay'], 's') %><%= fmt_string(upstream.value['ack-mode']) %><%= fmt_boolean(upstream.value['trust-user-id']) %><%= fmt_string(upstream.value['exchange']) %><%= upstream.value['max-hops'] %><%= fmt_time(upstream.value.expires, 'ms') %><%= fmt_time(upstream.value['message-ttl'], 'ms') %><%= fmt_string(upstream.value['ha-policy']) %><%= fmt_string(upstream.value['queue']) %><%= upstream.value['consumer-tag'] %>
53 | <% } else { %> 54 |

... no upstreams ...

55 | <% } %> 56 |
57 |
58 | 59 |
60 |

Add a new upstream

61 |
62 |
63 | 64 | 65 | 66 | 69 | 70 | <% if (vhosts_interesting) { %> 71 | 72 | 73 | 80 | 81 | <% } else { %> 82 | 83 | <% } %> 84 | 85 | 86 | 87 | 88 | 89 | 90 | 91 | 97 | 98 | 99 | 100 | 106 | 107 | 108 | 109 | 115 | 116 | 117 | 118 | 124 | 131 | 132 | 133 | 139 | 140 | 146 | 147 | 148 | 151 | 152 | 153 | 154 | 155 | 161 | 162 | 163 | 164 | 165 | 171 | 172 | 173 | 174 | 175 | 181 | 182 | 183 | 184 | 185 | 191 | 192 | 193 | 194 | 195 | 196 | 202 | 203 | 204 | 205 | 206 | 207 | 210 | 211 | 212 | 213 | 219 | 220 | 221 | 222 | 228 | 229 | 230 | 231 | 232 | 233 | 234 |
67 |

General parameters

68 |
74 | 79 |
*
92 | 96 | *
101 | 105 |
110 | 114 | s
119 | 123 | 125 | 130 |
134 | 138 | 141 | 145 |
149 |

Federated exchanges parameters

150 |
156 | 160 |
166 | 170 |
176 | 180 | ms
186 | 190 | ms
197 | 201 |
208 |

Federated queues parameter

209 |
214 | 218 |
223 | 227 |
235 | 236 |
237 |
238 |
239 |
240 |

URI examples

241 |
242 | 261 |
262 |
263 | -------------------------------------------------------------------------------- /priv/www/js/tmpl/federation.ejs: -------------------------------------------------------------------------------- 1 |

Federation Status

2 |
3 |

Running Links

4 |
5 | <% if (links.length > 0) { %> 6 | 7 | 8 | 9 | 10 | 11 | <% if (vhosts_interesting) { %> 12 | 13 | <% } %> 14 | 15 | <% if (nodes_interesting) { %> 16 | 17 | <% } %> 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | <% 28 | for (var i = 0; i < links.length; i++) { 29 | var link = links[i]; 30 | %> 31 | > 32 | 42 | 43 | <% if (vhosts_interesting) { %> 44 | 45 | <% } %> 46 | 54 | <% if (nodes_interesting) { %> 55 | 56 | <% } %> 57 | <% if (link.error) { %> 58 | 61 | 62 | 63 | 64 | 65 | <% if (vhosts_interesting) { %> 66 | 73 | 74 | <% } else { %> 75 | 78 | 83 | 84 | 85 | 86 | 94 | 95 | <% } %> 96 | <% } %> 97 | 98 |
UpstreamURIVirtual HostExchange / QueueNodeStateInbound message rateLast changedIDConsumer tagOperations
33 | <%= fmt_string(link.upstream) %> 34 | <% if (link.type == 'exchange' && 35 | link.exchange != link.upstream_exchange) { %> 36 | <%= fmt_string(link.upstream_exchange) %> 37 | <% } else if (link.type == 'queue' && 38 | link.queue != link.upstream_queue) { %> 39 | <%= fmt_string(link.upstream_queue) %> 40 | <% } %> 41 | <%= fmt_string(fmt_uri_with_credentials(link.uri)) %><%= fmt_string(link.vhost) %> 47 | <% if (link.type == 'exchange') { %> 48 | <%= link_exchange(link.vhost, link.exchange) %> 49 | <% } else { %> 50 | <%= link_queue(link.vhost, link.queue) %> 51 | <% } %> 52 | <%= fmt_string(link.type) %> 53 | <%= fmt_node(link.node) %> 59 | <%= fmt_state('red', link.status) %> 60 | <%= link.timestamp %>
67 | <% } else { %> 68 | 69 | <% } %> 70 | Error detail: 71 | 
<%= fmt_escape_html(link.error) %>
72 |
76 | <%= fmt_state(link.status == 'starting' ? 'yellow' : 'green', link.status) %> 77 | 79 | <% if (link.local_channel) { %> 80 | <%= fmt_detail_rate(link.local_channel.message_stats, 'confirm') %> 81 | <% } %> 82 | <%= link.timestamp %><%= link.id %><%= link.consumer_tag %> 87 |
88 | 89 | 90 | 91 | 92 |
93 |
99 | <% } else { %> 100 |

... no links ...

101 | <% } %> 102 |
103 |
104 | -------------------------------------------------------------------------------- /rabbitmq-components.mk: -------------------------------------------------------------------------------- 1 | ifeq ($(.DEFAULT_GOAL),) 2 | # Define default goal to `all` because this file defines some targets 3 | # before the inclusion of erlang.mk leading to the wrong target becoming 4 | # the default. 5 | .DEFAULT_GOAL = all 6 | endif 7 | 8 | # PROJECT_VERSION defaults to: 9 | # 1. the version exported by rabbitmq-server-release; 10 | # 2. the version stored in `git-revisions.txt`, if it exists; 11 | # 3. a version based on git-describe(1), if it is a Git clone; 12 | # 4. 0.0.0 13 | 14 | PROJECT_VERSION := $(RABBITMQ_VERSION) 15 | 16 | ifeq ($(PROJECT_VERSION),) 17 | PROJECT_VERSION := $(shell \ 18 | if test -f git-revisions.txt; then \ 19 | head -n1 git-revisions.txt | \ 20 | awk '{print $$$(words $(PROJECT_DESCRIPTION) version);}'; \ 21 | else \ 22 | (git describe --dirty --abbrev=7 --tags --always --first-parent \ 23 | 2>/dev/null || echo rabbitmq_v0_0_0) | \ 24 | sed -e 's/^rabbitmq_v//' -e 's/^v//' -e 's/_/./g' -e 's/-/+/' \ 25 | -e 's/-/./g'; \ 26 | fi) 27 | endif 28 | 29 | # -------------------------------------------------------------------- 30 | # RabbitMQ components. 31 | # -------------------------------------------------------------------- 32 | 33 | # For RabbitMQ repositories, we want to checkout branches which match 34 | # the parent project. For instance, if the parent project is on a 35 | # release tag, dependencies must be on the same release tag. If the 36 | # parent project is on a topic branch, dependencies must be on the same 37 | # topic branch or fallback to `stable` or `master` whichever was the 38 | # base of the topic branch. 39 | 40 | dep_amqp_client = git_rmq rabbitmq-erlang-client $(current_rmq_ref) $(base_rmq_ref) master 41 | dep_amqp10_client = git_rmq rabbitmq-amqp1.0-client $(current_rmq_ref) $(base_rmq_ref) master 42 | dep_amqp10_common = git_rmq rabbitmq-amqp1.0-common $(current_rmq_ref) $(base_rmq_ref) master 43 | dep_rabbit = git_rmq rabbitmq-server $(current_rmq_ref) $(base_rmq_ref) master 44 | dep_rabbit_common = git_rmq rabbitmq-common $(current_rmq_ref) $(base_rmq_ref) master 45 | dep_rabbitmq_amqp1_0 = git_rmq rabbitmq-amqp1.0 $(current_rmq_ref) $(base_rmq_ref) master 46 | dep_rabbitmq_auth_backend_amqp = git_rmq rabbitmq-auth-backend-amqp $(current_rmq_ref) $(base_rmq_ref) master 47 | dep_rabbitmq_auth_backend_cache = git_rmq rabbitmq-auth-backend-cache $(current_rmq_ref) $(base_rmq_ref) master 48 | dep_rabbitmq_auth_backend_http = git_rmq rabbitmq-auth-backend-http $(current_rmq_ref) $(base_rmq_ref) master 49 | dep_rabbitmq_auth_backend_ldap = git_rmq rabbitmq-auth-backend-ldap $(current_rmq_ref) $(base_rmq_ref) master 50 | dep_rabbitmq_auth_backend_oauth2 = git_rmq rabbitmq-auth-backend-oauth2 $(current_rmq_ref) $(base_rmq_ref) master 51 | dep_rabbitmq_auth_mechanism_ssl = git_rmq rabbitmq-auth-mechanism-ssl $(current_rmq_ref) $(base_rmq_ref) master 52 | dep_rabbitmq_aws = git_rmq rabbitmq-aws $(current_rmq_ref) $(base_rmq_ref) master 53 | dep_rabbitmq_boot_steps_visualiser = git_rmq rabbitmq-boot-steps-visualiser $(current_rmq_ref) $(base_rmq_ref) master 54 | dep_rabbitmq_cli = git_rmq rabbitmq-cli $(current_rmq_ref) $(base_rmq_ref) master 55 | dep_rabbitmq_codegen = git_rmq rabbitmq-codegen $(current_rmq_ref) $(base_rmq_ref) master 56 | dep_rabbitmq_consistent_hash_exchange = git_rmq rabbitmq-consistent-hash-exchange $(current_rmq_ref) $(base_rmq_ref) master 57 | dep_rabbitmq_ct_client_helpers = git_rmq rabbitmq-ct-client-helpers $(current_rmq_ref) $(base_rmq_ref) master 58 | dep_rabbitmq_ct_helpers = git_rmq rabbitmq-ct-helpers $(current_rmq_ref) $(base_rmq_ref) master 59 | dep_rabbitmq_delayed_message_exchange = git_rmq rabbitmq-delayed-message-exchange $(current_rmq_ref) $(base_rmq_ref) master 60 | dep_rabbitmq_dotnet_client = git_rmq rabbitmq-dotnet-client $(current_rmq_ref) $(base_rmq_ref) master 61 | dep_rabbitmq_event_exchange = git_rmq rabbitmq-event-exchange $(current_rmq_ref) $(base_rmq_ref) master 62 | dep_rabbitmq_federation = git_rmq rabbitmq-federation $(current_rmq_ref) $(base_rmq_ref) master 63 | dep_rabbitmq_federation_management = git_rmq rabbitmq-federation-management $(current_rmq_ref) $(base_rmq_ref) master 64 | dep_rabbitmq_java_client = git_rmq rabbitmq-java-client $(current_rmq_ref) $(base_rmq_ref) master 65 | dep_rabbitmq_jms_client = git_rmq rabbitmq-jms-client $(current_rmq_ref) $(base_rmq_ref) master 66 | dep_rabbitmq_jms_cts = git_rmq rabbitmq-jms-cts $(current_rmq_ref) $(base_rmq_ref) master 67 | dep_rabbitmq_jms_topic_exchange = git_rmq rabbitmq-jms-topic-exchange $(current_rmq_ref) $(base_rmq_ref) master 68 | dep_rabbitmq_lvc_exchange = git_rmq rabbitmq-lvc-exchange $(current_rmq_ref) $(base_rmq_ref) master 69 | dep_rabbitmq_management = git_rmq rabbitmq-management $(current_rmq_ref) $(base_rmq_ref) master 70 | dep_rabbitmq_management_agent = git_rmq rabbitmq-management-agent $(current_rmq_ref) $(base_rmq_ref) master 71 | dep_rabbitmq_management_exchange = git_rmq rabbitmq-management-exchange $(current_rmq_ref) $(base_rmq_ref) master 72 | dep_rabbitmq_management_themes = git_rmq rabbitmq-management-themes $(current_rmq_ref) $(base_rmq_ref) master 73 | dep_rabbitmq_message_timestamp = git_rmq rabbitmq-message-timestamp $(current_rmq_ref) $(base_rmq_ref) master 74 | dep_rabbitmq_metronome = git_rmq rabbitmq-metronome $(current_rmq_ref) $(base_rmq_ref) master 75 | dep_rabbitmq_mqtt = git_rmq rabbitmq-mqtt $(current_rmq_ref) $(base_rmq_ref) master 76 | dep_rabbitmq_objc_client = git_rmq rabbitmq-objc-client $(current_rmq_ref) $(base_rmq_ref) master 77 | dep_rabbitmq_peer_discovery_aws = git_rmq rabbitmq-peer-discovery-aws $(current_rmq_ref) $(base_rmq_ref) master 78 | dep_rabbitmq_peer_discovery_common = git_rmq rabbitmq-peer-discovery-common $(current_rmq_ref) $(base_rmq_ref) master 79 | dep_rabbitmq_peer_discovery_consul = git_rmq rabbitmq-peer-discovery-consul $(current_rmq_ref) $(base_rmq_ref) master 80 | dep_rabbitmq_peer_discovery_etcd = git_rmq rabbitmq-peer-discovery-etcd $(current_rmq_ref) $(base_rmq_ref) master 81 | dep_rabbitmq_peer_discovery_k8s = git_rmq rabbitmq-peer-discovery-k8s $(current_rmq_ref) $(base_rmq_ref) master 82 | dep_rabbitmq_prometheus = git_rmq rabbitmq-prometheus $(current_rmq_ref) $(base_rmq_ref) master 83 | dep_rabbitmq_random_exchange = git_rmq rabbitmq-random-exchange $(current_rmq_ref) $(base_rmq_ref) master 84 | dep_rabbitmq_recent_history_exchange = git_rmq rabbitmq-recent-history-exchange $(current_rmq_ref) $(base_rmq_ref) master 85 | dep_rabbitmq_routing_node_stamp = git_rmq rabbitmq-routing-node-stamp $(current_rmq_ref) $(base_rmq_ref) master 86 | dep_rabbitmq_rtopic_exchange = git_rmq rabbitmq-rtopic-exchange $(current_rmq_ref) $(base_rmq_ref) master 87 | dep_rabbitmq_server_release = git_rmq rabbitmq-server-release $(current_rmq_ref) $(base_rmq_ref) master 88 | dep_rabbitmq_sharding = git_rmq rabbitmq-sharding $(current_rmq_ref) $(base_rmq_ref) master 89 | dep_rabbitmq_shovel = git_rmq rabbitmq-shovel $(current_rmq_ref) $(base_rmq_ref) master 90 | dep_rabbitmq_shovel_management = git_rmq rabbitmq-shovel-management $(current_rmq_ref) $(base_rmq_ref) master 91 | dep_rabbitmq_stomp = git_rmq rabbitmq-stomp $(current_rmq_ref) $(base_rmq_ref) master 92 | dep_rabbitmq_stream = git_rmq rabbitmq-stream $(current_rmq_ref) $(base_rmq_ref) master 93 | dep_rabbitmq_toke = git_rmq rabbitmq-toke $(current_rmq_ref) $(base_rmq_ref) master 94 | dep_rabbitmq_top = git_rmq rabbitmq-top $(current_rmq_ref) $(base_rmq_ref) master 95 | dep_rabbitmq_tracing = git_rmq rabbitmq-tracing $(current_rmq_ref) $(base_rmq_ref) master 96 | dep_rabbitmq_trust_store = git_rmq rabbitmq-trust-store $(current_rmq_ref) $(base_rmq_ref) master 97 | dep_rabbitmq_test = git_rmq rabbitmq-test $(current_rmq_ref) $(base_rmq_ref) master 98 | dep_rabbitmq_web_dispatch = git_rmq rabbitmq-web-dispatch $(current_rmq_ref) $(base_rmq_ref) master 99 | dep_rabbitmq_web_stomp = git_rmq rabbitmq-web-stomp $(current_rmq_ref) $(base_rmq_ref) master 100 | dep_rabbitmq_web_stomp_examples = git_rmq rabbitmq-web-stomp-examples $(current_rmq_ref) $(base_rmq_ref) master 101 | dep_rabbitmq_web_mqtt = git_rmq rabbitmq-web-mqtt $(current_rmq_ref) $(base_rmq_ref) master 102 | dep_rabbitmq_web_mqtt_examples = git_rmq rabbitmq-web-mqtt-examples $(current_rmq_ref) $(base_rmq_ref) master 103 | dep_rabbitmq_website = git_rmq rabbitmq-website $(current_rmq_ref) $(base_rmq_ref) live master 104 | dep_toke = git_rmq toke $(current_rmq_ref) $(base_rmq_ref) master 105 | 106 | dep_rabbitmq_public_umbrella = git_rmq rabbitmq-public-umbrella $(current_rmq_ref) $(base_rmq_ref) master 107 | 108 | # Third-party dependencies version pinning. 109 | # 110 | # We do that in this file, which is copied in all projects, to ensure 111 | # all projects use the same versions. It avoids conflicts and makes it 112 | # possible to work with rabbitmq-public-umbrella. 113 | 114 | dep_accept = hex 0.3.5 115 | dep_cowboy = hex 2.8.0 116 | dep_cowlib = hex 2.9.1 117 | dep_jsx = hex 2.11.0 118 | dep_lager = hex 3.8.0 119 | dep_prometheus = git https://github.com/deadtrickster/prometheus.erl.git master 120 | dep_ra = git https://github.com/rabbitmq/ra.git master 121 | dep_ranch = hex 1.7.1 122 | dep_recon = hex 2.5.1 123 | dep_observer_cli = hex 1.5.4 124 | dep_stdout_formatter = hex 0.2.4 125 | dep_sysmon_handler = hex 1.3.0 126 | 127 | RABBITMQ_COMPONENTS = amqp_client \ 128 | amqp10_common \ 129 | amqp10_client \ 130 | rabbit \ 131 | rabbit_common \ 132 | rabbitmq_amqp1_0 \ 133 | rabbitmq_auth_backend_amqp \ 134 | rabbitmq_auth_backend_cache \ 135 | rabbitmq_auth_backend_http \ 136 | rabbitmq_auth_backend_ldap \ 137 | rabbitmq_auth_backend_oauth2 \ 138 | rabbitmq_auth_mechanism_ssl \ 139 | rabbitmq_aws \ 140 | rabbitmq_boot_steps_visualiser \ 141 | rabbitmq_cli \ 142 | rabbitmq_codegen \ 143 | rabbitmq_consistent_hash_exchange \ 144 | rabbitmq_ct_client_helpers \ 145 | rabbitmq_ct_helpers \ 146 | rabbitmq_delayed_message_exchange \ 147 | rabbitmq_dotnet_client \ 148 | rabbitmq_event_exchange \ 149 | rabbitmq_federation \ 150 | rabbitmq_federation_management \ 151 | rabbitmq_java_client \ 152 | rabbitmq_jms_client \ 153 | rabbitmq_jms_cts \ 154 | rabbitmq_jms_topic_exchange \ 155 | rabbitmq_lvc_exchange \ 156 | rabbitmq_management \ 157 | rabbitmq_management_agent \ 158 | rabbitmq_management_exchange \ 159 | rabbitmq_management_themes \ 160 | rabbitmq_message_timestamp \ 161 | rabbitmq_metronome \ 162 | rabbitmq_mqtt \ 163 | rabbitmq_objc_client \ 164 | rabbitmq_peer_discovery_aws \ 165 | rabbitmq_peer_discovery_common \ 166 | rabbitmq_peer_discovery_consul \ 167 | rabbitmq_peer_discovery_etcd \ 168 | rabbitmq_peer_discovery_k8s \ 169 | rabbitmq_prometheus \ 170 | rabbitmq_random_exchange \ 171 | rabbitmq_recent_history_exchange \ 172 | rabbitmq_routing_node_stamp \ 173 | rabbitmq_rtopic_exchange \ 174 | rabbitmq_server_release \ 175 | rabbitmq_sharding \ 176 | rabbitmq_shovel \ 177 | rabbitmq_shovel_management \ 178 | rabbitmq_stomp \ 179 | rabbitmq_stream \ 180 | rabbitmq_toke \ 181 | rabbitmq_top \ 182 | rabbitmq_tracing \ 183 | rabbitmq_trust_store \ 184 | rabbitmq_web_dispatch \ 185 | rabbitmq_web_mqtt \ 186 | rabbitmq_web_mqtt_examples \ 187 | rabbitmq_web_stomp \ 188 | rabbitmq_web_stomp_examples \ 189 | rabbitmq_website 190 | 191 | # Erlang.mk does not rebuild dependencies by default, once they were 192 | # compiled once, except for those listed in the `$(FORCE_REBUILD)` 193 | # variable. 194 | # 195 | # We want all RabbitMQ components to always be rebuilt: this eases 196 | # the work on several components at the same time. 197 | 198 | FORCE_REBUILD = $(RABBITMQ_COMPONENTS) 199 | 200 | # Several components have a custom erlang.mk/build.config, mainly 201 | # to disable eunit. Therefore, we can't use the top-level project's 202 | # erlang.mk copy. 203 | NO_AUTOPATCH += $(RABBITMQ_COMPONENTS) 204 | 205 | ifeq ($(origin current_rmq_ref),undefined) 206 | ifneq ($(wildcard .git),) 207 | current_rmq_ref := $(shell (\ 208 | ref=$$(LANG=C git branch --list | awk '/^\* \(.*detached / {ref=$$0; sub(/.*detached [^ ]+ /, "", ref); sub(/\)$$/, "", ref); print ref; exit;} /^\* / {ref=$$0; sub(/^\* /, "", ref); print ref; exit}');\ 209 | if test "$$(git rev-parse --short HEAD)" != "$$ref"; then echo "$$ref"; fi)) 210 | else 211 | current_rmq_ref := master 212 | endif 213 | endif 214 | export current_rmq_ref 215 | 216 | ifeq ($(origin base_rmq_ref),undefined) 217 | ifneq ($(wildcard .git),) 218 | possible_base_rmq_ref := master 219 | ifeq ($(possible_base_rmq_ref),$(current_rmq_ref)) 220 | base_rmq_ref := $(current_rmq_ref) 221 | else 222 | base_rmq_ref := $(shell \ 223 | (git rev-parse --verify -q master >/dev/null && \ 224 | git rev-parse --verify -q $(possible_base_rmq_ref) >/dev/null && \ 225 | git merge-base --is-ancestor $$(git merge-base master HEAD) $(possible_base_rmq_ref) && \ 226 | echo $(possible_base_rmq_ref)) || \ 227 | echo master) 228 | endif 229 | else 230 | base_rmq_ref := master 231 | endif 232 | endif 233 | export base_rmq_ref 234 | 235 | # Repository URL selection. 236 | # 237 | # First, we infer other components' location from the current project 238 | # repository URL, if it's a Git repository: 239 | # - We take the "origin" remote URL as the base 240 | # - The current project name and repository name is replaced by the 241 | # target's properties: 242 | # eg. rabbitmq-common is replaced by rabbitmq-codegen 243 | # eg. rabbit_common is replaced by rabbitmq_codegen 244 | # 245 | # If cloning from this computed location fails, we fallback to RabbitMQ 246 | # upstream which is GitHub. 247 | 248 | # Macro to transform eg. "rabbit_common" to "rabbitmq-common". 249 | rmq_cmp_repo_name = $(word 2,$(dep_$(1))) 250 | 251 | # Upstream URL for the current project. 252 | RABBITMQ_COMPONENT_REPO_NAME := $(call rmq_cmp_repo_name,$(PROJECT)) 253 | RABBITMQ_UPSTREAM_FETCH_URL ?= https://github.com/rabbitmq/$(RABBITMQ_COMPONENT_REPO_NAME).git 254 | RABBITMQ_UPSTREAM_PUSH_URL ?= git@github.com:rabbitmq/$(RABBITMQ_COMPONENT_REPO_NAME).git 255 | 256 | # Current URL for the current project. If this is not a Git clone, 257 | # default to the upstream Git repository. 258 | ifneq ($(wildcard .git),) 259 | git_origin_fetch_url := $(shell git config remote.origin.url) 260 | git_origin_push_url := $(shell git config remote.origin.pushurl || git config remote.origin.url) 261 | RABBITMQ_CURRENT_FETCH_URL ?= $(git_origin_fetch_url) 262 | RABBITMQ_CURRENT_PUSH_URL ?= $(git_origin_push_url) 263 | else 264 | RABBITMQ_CURRENT_FETCH_URL ?= $(RABBITMQ_UPSTREAM_FETCH_URL) 265 | RABBITMQ_CURRENT_PUSH_URL ?= $(RABBITMQ_UPSTREAM_PUSH_URL) 266 | endif 267 | 268 | # Macro to replace the following pattern: 269 | # 1. /foo.git -> /bar.git 270 | # 2. /foo -> /bar 271 | # 3. /foo/ -> /bar/ 272 | subst_repo_name = $(patsubst %/$(1)/%,%/$(2)/%,$(patsubst %/$(1),%/$(2),$(patsubst %/$(1).git,%/$(2).git,$(3)))) 273 | 274 | # Macro to replace both the project's name (eg. "rabbit_common") and 275 | # repository name (eg. "rabbitmq-common") by the target's equivalent. 276 | # 277 | # This macro is kept on one line because we don't want whitespaces in 278 | # the returned value, as it's used in $(dep_fetch_git_rmq) in a shell 279 | # single-quoted string. 280 | dep_rmq_repo = $(if $(dep_$(2)),$(call subst_repo_name,$(PROJECT),$(2),$(call subst_repo_name,$(RABBITMQ_COMPONENT_REPO_NAME),$(call rmq_cmp_repo_name,$(2)),$(1))),$(pkg_$(1)_repo)) 281 | 282 | dep_rmq_commits = $(if $(dep_$(1)), \ 283 | $(wordlist 3,$(words $(dep_$(1))),$(dep_$(1))), \ 284 | $(pkg_$(1)_commit)) 285 | 286 | define dep_fetch_git_rmq 287 | fetch_url1='$(call dep_rmq_repo,$(RABBITMQ_CURRENT_FETCH_URL),$(1))'; \ 288 | fetch_url2='$(call dep_rmq_repo,$(RABBITMQ_UPSTREAM_FETCH_URL),$(1))'; \ 289 | if test "$$$$fetch_url1" != '$(RABBITMQ_CURRENT_FETCH_URL)' && \ 290 | git clone -q -n -- "$$$$fetch_url1" $(DEPS_DIR)/$(call dep_name,$(1)); then \ 291 | fetch_url="$$$$fetch_url1"; \ 292 | push_url='$(call dep_rmq_repo,$(RABBITMQ_CURRENT_PUSH_URL),$(1))'; \ 293 | elif git clone -q -n -- "$$$$fetch_url2" $(DEPS_DIR)/$(call dep_name,$(1)); then \ 294 | fetch_url="$$$$fetch_url2"; \ 295 | push_url='$(call dep_rmq_repo,$(RABBITMQ_UPSTREAM_PUSH_URL),$(1))'; \ 296 | fi; \ 297 | cd $(DEPS_DIR)/$(call dep_name,$(1)) && ( \ 298 | $(foreach ref,$(call dep_rmq_commits,$(1)), \ 299 | git checkout -q $(ref) >/dev/null 2>&1 || \ 300 | ) \ 301 | (echo "error: no valid pathspec among: $(call dep_rmq_commits,$(1))" \ 302 | 1>&2 && false) ) && \ 303 | (test "$$$$fetch_url" = "$$$$push_url" || \ 304 | git remote set-url --push origin "$$$$push_url") 305 | endef 306 | 307 | # -------------------------------------------------------------------- 308 | # Component distribution. 309 | # -------------------------------------------------------------------- 310 | 311 | list-dist-deps:: 312 | @: 313 | 314 | prepare-dist:: 315 | @: 316 | 317 | # -------------------------------------------------------------------- 318 | # Umbrella-specific settings. 319 | # -------------------------------------------------------------------- 320 | 321 | # If the top-level project is a RabbitMQ component, we override 322 | # $(DEPS_DIR) for this project to point to the top-level's one. 323 | # 324 | # We also verify that the guessed DEPS_DIR is actually named `deps`, 325 | # to rule out any situation where it is a coincidence that we found a 326 | # `rabbitmq-components.mk` up upper directories. 327 | 328 | possible_deps_dir_1 = $(abspath ..) 329 | possible_deps_dir_2 = $(abspath ../../..) 330 | 331 | ifeq ($(notdir $(possible_deps_dir_1)),deps) 332 | ifneq ($(wildcard $(possible_deps_dir_1)/../rabbitmq-components.mk),) 333 | deps_dir_overriden = 1 334 | DEPS_DIR ?= $(possible_deps_dir_1) 335 | DISABLE_DISTCLEAN = 1 336 | endif 337 | endif 338 | 339 | ifeq ($(deps_dir_overriden),) 340 | ifeq ($(notdir $(possible_deps_dir_2)),deps) 341 | ifneq ($(wildcard $(possible_deps_dir_2)/../rabbitmq-components.mk),) 342 | deps_dir_overriden = 1 343 | DEPS_DIR ?= $(possible_deps_dir_2) 344 | DISABLE_DISTCLEAN = 1 345 | endif 346 | endif 347 | endif 348 | 349 | ifneq ($(wildcard UMBRELLA.md),) 350 | DISABLE_DISTCLEAN = 1 351 | endif 352 | 353 | # We disable `make distclean` so $(DEPS_DIR) is not accidentally removed. 354 | 355 | ifeq ($(DISABLE_DISTCLEAN),1) 356 | ifneq ($(filter distclean distclean-deps,$(MAKECMDGOALS)),) 357 | SKIP_DEPS = 1 358 | endif 359 | endif 360 | -------------------------------------------------------------------------------- /src/rabbit_federation_mgmt.erl: -------------------------------------------------------------------------------- 1 | %% This Source Code Form is subject to the terms of the Mozilla Public 2 | %% License, v. 2.0. If a copy of the MPL was not distributed with this 3 | %% file, You can obtain one at https://mozilla.org/MPL/2.0/. 4 | %% 5 | %% Copyright (c) 2007-2020 VMware, Inc. or its affiliates. All rights reserved. 6 | %% 7 | 8 | -module(rabbit_federation_mgmt). 9 | 10 | -behaviour(rabbit_mgmt_extension). 11 | 12 | -export([dispatcher/0, web_ui/0]). 13 | -export([init/2, to_json/2, resource_exists/2, content_types_provided/2, 14 | is_authorized/2, allowed_methods/2, delete_resource/2]). 15 | 16 | -import(rabbit_misc, [pget/2]). 17 | 18 | -include_lib("rabbitmq_management_agent/include/rabbit_mgmt_records.hrl"). 19 | 20 | dispatcher() -> [{"/federation-links", ?MODULE, [all]}, 21 | {"/federation-links/:vhost", ?MODULE, [all]}, 22 | {"/federation-links/state/down/", ?MODULE, [down]}, 23 | {"/federation-links/:vhost/state/down", ?MODULE, [down]}, 24 | {"/federation-links/vhost/:vhost/:id/:node/restart", ?MODULE, []}]. 25 | 26 | web_ui() -> [{javascript, <<"federation.js">>}]. 27 | 28 | %%-------------------------------------------------------------------- 29 | 30 | init(Req, [Filter]) -> 31 | {cowboy_rest, rabbit_mgmt_cors:set_headers(Req, ?MODULE), {Filter, #context{}}}; 32 | init(Req, []) -> 33 | {cowboy_rest, rabbit_mgmt_cors:set_headers(Req, ?MODULE), #context{}}. 34 | 35 | content_types_provided(ReqData, Context) -> 36 | {[{<<"application/json">>, to_json}], ReqData, Context}. 37 | 38 | allowed_methods(ReqData, Context) -> 39 | {[<<"HEAD">>, <<"GET">>, <<"DELETE">>, <<"OPTIONS">>], ReqData, Context}. 40 | 41 | resource_exists(ReqData, Context) -> 42 | {case rabbit_mgmt_util:vhost(ReqData) of 43 | not_found -> false; 44 | _ -> case rabbit_mgmt_util:id(id, ReqData) of 45 | %% Listing links 46 | none -> true; 47 | %% Restarting a link 48 | Id -> 49 | lookup(Id, ReqData) 50 | end 51 | end, ReqData, Context}. 52 | 53 | to_json(ReqData, {Filter, Context}) -> 54 | Chs = rabbit_mgmt_db:get_all_channels( 55 | rabbit_mgmt_util:range(ReqData)), 56 | rabbit_mgmt_util:reply_list( 57 | filter_vhost(status(Chs, ReqData, Context, Filter), ReqData), ReqData, Context); 58 | to_json(ReqData, Context) -> 59 | to_json(ReqData, {all, Context}). 60 | 61 | is_authorized(ReqData, {Filter, Context}) -> 62 | {Res, RD, C} = rabbit_mgmt_util:is_authorized_monitor(ReqData, Context), 63 | {Res, RD, {Filter, C}}; 64 | is_authorized(ReqData, Context) -> 65 | rabbit_mgmt_util:is_authorized_monitor(ReqData, Context). 66 | 67 | delete_resource(ReqData, Context) -> 68 | Reply = case rabbit_mgmt_util:id(id, ReqData) of 69 | none -> false; 70 | Id -> restart(Id, ReqData) 71 | end, 72 | {Reply, ReqData, Context}. 73 | 74 | %%-------------------------------------------------------------------- 75 | filter_vhost(List, ReqData) -> 76 | rabbit_mgmt_util:all_or_one_vhost( 77 | ReqData, 78 | fun(V) -> lists:filter(fun(I) -> pget(vhost, I) =:= V end, List) end). 79 | 80 | status(Chs, ReqData, Context, Filter) -> 81 | rabbit_mgmt_util:filter_vhost( 82 | lists:append([status(Node, Chs, Filter) || Node <- [node() | nodes()]]), 83 | ReqData, Context). 84 | 85 | status(Node, Chs, Filter) -> 86 | case rpc:call(Node, rabbit_federation_status, status, [], infinity) of 87 | {badrpc, {'EXIT', {undef, _}}} -> []; 88 | {badrpc, {'EXIT', {noproc, _}}} -> []; 89 | Status -> [format(Node, I, Chs) || I <- Status, 90 | filter_status(I, Filter)] 91 | end. 92 | 93 | filter_status(_, all) -> 94 | true; 95 | filter_status(Props, down) -> 96 | Status = pget(status, Props), 97 | not lists:member(Status, [running, starting]). 98 | 99 | format(Node, Info, Chs) -> 100 | LocalCh = case rabbit_mgmt_format:strip_pids( 101 | [Ch || Ch <- Chs, 102 | pget(name, pget(connection_details, Ch)) 103 | =:= pget(local_connection, Info)]) of 104 | [Ch] -> [{local_channel, Ch}]; 105 | [] -> [] 106 | end, 107 | [{node, Node} | format_info(Info)] ++ LocalCh. 108 | 109 | format_info(Items) -> 110 | [format_item(I) || I <- Items]. 111 | 112 | format_item({timestamp, {{Y, M, D}, {H, Min, S}}}) -> 113 | {timestamp, print("~w-~2.2.0w-~2.2.0w ~w:~2.2.0w:~2.2.0w", 114 | [Y, M, D, H, Min, S])}; 115 | format_item({error, E}) -> 116 | {error, rabbit_mgmt_format:print("~p", [E])}; 117 | format_item(I) -> 118 | I. 119 | 120 | print(Fmt, Val) -> 121 | list_to_binary(io_lib:format(Fmt, Val)). 122 | 123 | lookup(Id, ReqData) -> 124 | Node = get_node(ReqData), 125 | case rpc:call(Node, rabbit_federation_status, lookup, [Id], infinity) of 126 | {badrpc, _} -> false; 127 | not_found -> false; 128 | _ -> true 129 | end. 130 | 131 | restart(Id, ReqData) -> 132 | Node = get_node(ReqData), 133 | case rpc:call(Node, rabbit_federation_status, lookup, [Id], infinity) of 134 | not_found -> false; 135 | Obj -> 136 | Upstream = proplists:get_value(upstream, Obj), 137 | Supervisor = proplists:get_value(supervisor, Obj), 138 | rpc:call(Node, rabbit_federation_link_sup, restart, [Supervisor, Upstream], infinity), 139 | true 140 | end. 141 | 142 | get_node(ReqData) -> 143 | list_to_atom(binary_to_list(rabbit_mgmt_util:id(node, ReqData))). 144 | -------------------------------------------------------------------------------- /test/federation_mgmt_SUITE.erl: -------------------------------------------------------------------------------- 1 | %% This Source Code Form is subject to the terms of the Mozilla Public 2 | %% License, v. 2.0. If a copy of the MPL was not distributed with this 3 | %% file, You can obtain one at https://mozilla.org/MPL/2.0/. 4 | %% 5 | %% Copyright (c) 2007-2020 VMware, Inc. or its affiliates. All rights reserved. 6 | %% 7 | 8 | -module(federation_mgmt_SUITE). 9 | 10 | -include_lib("common_test/include/ct.hrl"). 11 | -include_lib("amqp_client/include/amqp_client.hrl"). 12 | -include_lib("rabbitmq_ct_helpers/include/rabbit_mgmt_test.hrl"). 13 | 14 | -compile(export_all). 15 | 16 | all() -> 17 | [ 18 | {group, non_parallel_tests} 19 | ]. 20 | 21 | groups() -> 22 | [ 23 | {non_parallel_tests, [], [ 24 | federation_links, 25 | federation_down_links, 26 | restart_link 27 | ]} 28 | ]. 29 | 30 | %% ------------------------------------------------------------------- 31 | %% Testsuite setup/teardown. 32 | %% ------------------------------------------------------------------- 33 | init_per_suite(Config) -> 34 | rabbit_ct_helpers:log_environment(), 35 | inets:start(), 36 | Config1 = rabbit_ct_helpers:set_config(Config, [ 37 | {rmq_nodename_suffix, ?MODULE} 38 | ]), 39 | rabbit_ct_helpers:run_setup_steps(Config1, 40 | rabbit_ct_broker_helpers:setup_steps() ++ 41 | rabbit_ct_client_helpers:setup_steps() ++ 42 | [fun setup_federation/1]). 43 | end_per_suite(Config) -> 44 | rabbit_ct_helpers:run_teardown_steps(Config, 45 | rabbit_ct_client_helpers:teardown_steps() ++ 46 | rabbit_ct_broker_helpers:teardown_steps()). 47 | 48 | setup_federation(Config) -> 49 | set_policy(Config), 50 | Port = amqp_port(Config, 0), 51 | Uri = lists:flatten(io_lib:format("amqp://myuser:myuser@localhost:~p", [Port])), 52 | rabbit_ct_broker_helpers:set_parameter( 53 | Config, 0, <<"federation-upstream">>, <<"broken-bunny">>, 54 | [{<<"uri">>, list_to_binary(Uri)}, 55 | {<<"reconnect-delay">>, 600000}]), 56 | rabbit_ct_broker_helpers:set_parameter( 57 | Config, 0, <<"federation-upstream">>, <<"bunny">>, 58 | [{<<"uri">>, <<"amqp://">>}, 59 | {<<"reconnect-delay">>, 600000}]), 60 | Config. 61 | 62 | set_policy(Config) -> 63 | rabbit_ct_broker_helpers:set_policy( 64 | Config, 0, 65 | <<"fed">>, <<".*">>, <<"all">>, [{<<"federation-upstream-set">>, <<"all">>}]). 66 | 67 | init_per_group(_, Config) -> 68 | Config. 69 | 70 | end_per_group(_, Config) -> 71 | Config. 72 | 73 | init_per_testcase(Testcase, Config) -> 74 | rabbit_ct_helpers:testcase_started(Config, Testcase). 75 | 76 | end_per_testcase(Testcase, Config) -> 77 | rabbit_ct_helpers:testcase_finished(Config, Testcase). 78 | 79 | %% ------------------------------------------------------------------- 80 | %% Testcases. 81 | %% ------------------------------------------------------------------- 82 | federation_links(Config) -> 83 | DefaultExchanges = [<<"amq.direct">>, <<"amq.fanout">>, <<"amq.headers">>, 84 | <<"amq.match">>, <<"amq.topic">>], 85 | Running = [{X, <<"bunny">>, <<"running">>} || X <- DefaultExchanges], 86 | Down = [{X, <<"broken-bunny">>, <<"error">>} || X <- DefaultExchanges], 87 | All = lists:sort(Running ++ Down), 88 | Verify = fun(Result) -> 89 | All == lists:sort(Result) 90 | end, 91 | %% Verify we have 5 running links and 5 down links 92 | wait_until(fun() -> 93 | AllLinks = http_get(Config, "/federation-links"), 94 | Result = [{maps:get(exchange, Link), 95 | maps:get(upstream, Link), 96 | maps:get(status, Link)} || Link <- AllLinks], 97 | Verify(Result) 98 | end). 99 | 100 | federation_down_links(Config) -> 101 | DefaultExchanges = [<<"amq.direct">>, <<"amq.fanout">>, <<"amq.headers">>, 102 | <<"amq.match">>, <<"amq.topic">>], 103 | Down = lists:sort([{X, <<"broken-bunny">>, <<"error">>} || X <- DefaultExchanges]), 104 | %% we might have to wait for all links to get into 'error' status, 105 | %% but no other status is allowed on the meanwhile 106 | Verify = fun(Result) -> 107 | lists:all(fun({_, _, <<"error">>}) -> 108 | true; 109 | (_) -> 110 | throw(down_links_returned_wrong_status) 111 | end, Result) andalso (Down == lists:sort(Result)) 112 | end, 113 | wait_until(fun() -> 114 | AllLinks = http_get(Config, "/federation-links/state/down"), 115 | Result = [{maps:get(exchange, Link), 116 | maps:get(upstream, Link), 117 | maps:get(status, Link)} || Link <- AllLinks], 118 | Verify(Result) 119 | end). 120 | 121 | restart_link(Config) -> 122 | try 123 | federation_down_links(Config), 124 | http_put(Config, "/users/myuser", [{password, <<"myuser">>}, {tags, <<"">>}, 125 | {username, <<"myuser">>}], 126 | [?CREATED, ?NO_CONTENT]), 127 | http_put(Config, "/permissions/%2F/myuser", 128 | [{configure, <<".*">>}, {write, <<".*">>}, {read, <<".*">>}, 129 | {vhost, <<"/">>}, {username, <<"myuser">>}], 130 | [?CREATED, ?NO_CONTENT]), 131 | Links = http_get(Config, "/federation-links/state/down"), 132 | [http_delete(Config, restart_uri(Link)) || Link <- Links], 133 | wait_until(fun() -> 134 | [] == http_get(Config, "/federation-links/state/down") 135 | end) 136 | after 137 | http_delete(Config, "/users/myuser"), 138 | rabbit_ct_broker_helpers:clear_policy(Config, 0, <<"fed">>), 139 | set_policy(Config) 140 | end. 141 | 142 | %% ------------------------------------------------------------------- 143 | %% Helpers 144 | %% ------------------------------------------------------------------- 145 | wait_until(Fun) -> 146 | wait_until(Fun, 600). 147 | 148 | wait_until(_Fun, 0) -> 149 | throw(federation_links_timeout); 150 | wait_until(Fun, N) -> 151 | case Fun() of 152 | true -> 153 | ok; 154 | false -> 155 | timer:sleep(1000), 156 | wait_until(Fun, N-1) 157 | end. 158 | 159 | restart_uri(Link) -> 160 | "/federation-links/vhost/%2f/" ++ 161 | binary_to_list(maps:get(id, Link)) ++ "/" ++ 162 | binary_to_list(maps:get(node, Link)) ++ "/restart". 163 | 164 | %% ------------------------------------------------------------------- 165 | %% Helpers from rabbitmq_management tests 166 | %% ------------------------------------------------------------------- 167 | http_get(Config, Path) -> 168 | http_get(Config, Path, ?OK). 169 | 170 | http_get(Config, Path, CodeExp) -> 171 | http_get(Config, Path, "guest", "guest", CodeExp). 172 | 173 | http_get(Config, Path, User, Pass, CodeExp) -> 174 | {ok, {{_HTTP, CodeAct, _}, Headers, ResBody}} = 175 | req(Config, 0, get, Path, [auth_header(User, Pass)]), 176 | assert_code(CodeExp, CodeAct, "GET", Path, ResBody), 177 | decode(CodeExp, Headers, ResBody). 178 | 179 | http_put(Config, Path, List, CodeExp) -> 180 | http_put_raw(Config, Path, format_for_upload(List), CodeExp). 181 | 182 | http_put_raw(Config, Path, Body, CodeExp) -> 183 | http_upload_raw(Config, put, Path, Body, "guest", "guest", CodeExp, []). 184 | 185 | http_put_raw(Config, Path, Body, User, Pass, CodeExp) -> 186 | http_upload_raw(Config, put, Path, Body, User, Pass, CodeExp, []). 187 | 188 | http_upload_raw(Config, Type, Path, Body, User, Pass, CodeExp, MoreHeaders) -> 189 | {ok, {{_HTTP, CodeAct, _}, Headers, ResBody}} = 190 | req(Config, 0, Type, Path, [auth_header(User, Pass)] ++ MoreHeaders, Body), 191 | assert_code(CodeExp, CodeAct, Type, Path, ResBody), 192 | decode(CodeExp, Headers, ResBody). 193 | 194 | http_delete(Config, Path) -> 195 | http_delete(Config, Path, "guest", "guest", ?NO_CONTENT). 196 | 197 | http_delete(Config, Path, User, Pass, CodeExp) -> 198 | {ok, {{_HTTP, CodeAct, _}, Headers, ResBody}} = 199 | req(Config, 0, delete, Path, [auth_header(User, Pass)]), 200 | assert_code(CodeExp, CodeAct, "DELETE", Path, ResBody), 201 | decode(CodeExp, Headers, ResBody). 202 | 203 | format_for_upload(none) -> 204 | <<"">>; 205 | format_for_upload(List) -> 206 | iolist_to_binary(rabbit_json:encode(List)). 207 | 208 | req(Config, Node, Type, Path, Headers) -> 209 | httpc:request(Type, {uri_base_from(Config, Node) ++ Path, Headers}, ?HTTPC_OPTS, []). 210 | 211 | req(Config, Node, Type, Path, Headers, Body) -> 212 | httpc:request(Type, {uri_base_from(Config, Node) ++ Path, Headers, "application/json", Body}, 213 | ?HTTPC_OPTS, []). 214 | 215 | uri_base_from(Config, Node) -> 216 | binary_to_list( 217 | rabbit_mgmt_format:print( 218 | "http://localhost:~w/api", 219 | [mgmt_port(Config, Node)])). 220 | 221 | auth_header(Username, Password) -> 222 | {"Authorization", 223 | "Basic " ++ binary_to_list(base64:encode(Username ++ ":" ++ Password))}. 224 | 225 | mgmt_port(Config, Node) -> 226 | rabbit_ct_broker_helpers:get_node_config(Config, Node, tcp_port_mgmt). 227 | 228 | amqp_port(Config, Node) -> 229 | rabbit_ct_broker_helpers:get_node_config(Config, Node, tcp_port_amqp). 230 | 231 | assert_code(CodesExpected, CodeAct, Type, Path, Body) when is_list(CodesExpected) -> 232 | case lists:member(CodeAct, CodesExpected) of 233 | true -> 234 | ok; 235 | false -> 236 | throw({expected, CodesExpected, got, CodeAct, type, Type, 237 | path, Path, body, Body}) 238 | end; 239 | assert_code(CodeExp, CodeAct, Type, Path, Body) -> 240 | case CodeExp of 241 | CodeAct -> ok; 242 | _ -> throw({expected, CodeExp, got, CodeAct, type, Type, 243 | path, Path, body, Body}) 244 | end. 245 | 246 | decode(?OK, _Headers, ResBody) -> 247 | cleanup(rabbit_json:decode(rabbit_data_coercion:to_binary(ResBody))); 248 | decode(_, Headers, _ResBody) -> Headers. 249 | 250 | cleanup(L) when is_list(L) -> 251 | [cleanup(I) || I <- L]; 252 | cleanup(M) when is_map(M) -> 253 | maps:fold(fun(K, V, Acc) -> 254 | Acc#{binary_to_atom(K, latin1) => cleanup(V)} 255 | end, #{}, M); 256 | cleanup(I) -> 257 | I. 258 | --------------------------------------------------------------------------------