Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document workflow for uploading custom integrations and enabling agentless support #3797

Merged
merged 10 commits into from
Apr 23, 2024

Conversation

bmorelli25
Copy link
Member

@bmorelli25 bmorelli25 commented Apr 17, 2024

Summary

(1) Since 8.7, Fleet supports integration installation through direct upload as a means to support integration developers or users who have created custom integrations that they don't want to commit upstream back to https://github.com/elastic/integrations. This PR adds the relevant instructions.

(2) We are adding support for "agentless" in integrations. These integrations will be deployed in fully managed agents, so the way they are configured will be slightly different. This PR defines what deployment modes are, how to enable agentless in template policies, and how to disable variables if needed.

Shout out to @kpollich and @jsoriano for their fantastic walkthroughs on these topics.

Copy link
Contributor

A documentation preview will be available soon.

Request a new doc build by commenting
  • Rebuild this PR: run docs-build
  • Rebuild this PR and all Elastic docs: run docs-build rebuild

run docs-build is much faster than run docs-build rebuild. A rebuild should only be needed in rare situations.

If your PR continues to fail for an unknown reason, the doc build pipeline may be broken. Elastic employees can check the pipeline status here.

Copy link
Contributor

mergify bot commented Apr 17, 2024

This pull request does not have a backport label. Could you fix it @bmorelli25? 🙏
To fixup this pull request, you need to add the backport labels for the needed
branches, such as:

  • backport-/d./d is the label to automatically backport to the /d./d branch. /d is the digit
    NOTE: backport-skip has been added to this pull request.

@mergify mergify bot added the backport-skip Skip notification from the automated backport with mergify label Apr 17, 2024
@bmorelli25 bmorelli25 changed the title Document workflow for uploading custom integrations Document workflow for uploading custom integrations and enabling agentless support Apr 17, 2024
@bmorelli25 bmorelli25 self-assigned this Apr 17, 2024
@bmorelli25 bmorelli25 marked this pull request as ready for review April 17, 2024 19:22
@bmorelli25 bmorelli25 requested a review from a team as a code owner April 17, 2024 19:22
kilfoyle
kilfoyle previously approved these changes Apr 17, 2024
Copy link
Contributor

@kilfoyle kilfoyle left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! 🚀
Very nice!

Copy link
Member

@jsoriano jsoriano left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for updating these docs!

docs/en/integrations/build-integration.asciidoc Outdated Show resolved Hide resolved
docs/en/integrations/build-integration.asciidoc Outdated Show resolved Hide resolved
docs/en/integrations/build-integration.asciidoc Outdated Show resolved Hide resolved
docs/en/integrations/elastic-package.asciidoc Outdated Show resolved Hide resolved
Use this command to install the package in {kib}.
Use this command to upload and install a package in {kib}.

Starting with Kibana version `8.7.0`, packages do not need to be exposed in the Package Registry to be installed.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for adding the docs about this too 👍

docs/en/integrations/upload-integration.asciidoc Outdated Show resolved Hide resolved
Co-authored-by: Jaime Soriano Pastor <jaime.soriano@elastic.co>
alaudazzi
alaudazzi previously approved these changes Apr 22, 2024
Copy link
Contributor

@alaudazzi alaudazzi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Left a few minor suggestions, otherwise LGTM.

docs/en/integrations/build-integration.asciidoc Outdated Show resolved Hide resolved
docs/en/integrations/build-integration.asciidoc Outdated Show resolved Hide resolved
Co-authored-by: Arianna Laudazzi <46651782+alaudazzi@users.noreply.github.com>
@bmorelli25 bmorelli25 enabled auto-merge (squash) April 22, 2024 18:05
Copy link
Contributor

@alaudazzi alaudazzi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@bmorelli25 bmorelli25 merged commit fa97724 into elastic:main Apr 23, 2024
4 checks passed
@bmorelli25 bmorelli25 deleted the integrations-dev-guide-update branch May 2, 2024 22:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
backport-skip Skip notification from the automated backport with mergify
Projects
None yet
4 participants