Commit Graph
31 Commits
Author SHA1 Message Date
David Boslee 0edbc8252b Add documentation for proxy peering (#15790) 2022-10-04 11:00:37 -05:00
Ryan Clark e7b022de1d Fix incorrect proxy_servers mention in the config reference docs (#16962) 2022-10-04 14:30:43 +00:00
Lisa Kim bc81db4655 Use field hostname for node resource for predicate expr using "name" identifier (#16902)
* Predicate expressions using the "name" identifier will now use
  field "hostname" when `ls` querying for nodes, as expected by
  the user
* Change predicate expression for access request that use
  name identifier to using the actual json field names
2022-10-04 00:20:04 +00:00
Alex FornutoandPaul Gottschling 7162921bbc [Docs] Update and Align Metric Reference (#16857)
* format table

* Re-implement #14729

* Apply suggestions from code review

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2022-10-03 23:17:42 +00:00
Tiago Silva d3bc7bd7f4 Add option to disable the ServiceAccount creation for teleport-kube-agent chart (#16876)
When assigning AWS IAM permissions to Teleport, `eksctl create iamserviceaccount` command manages the ServiceAccount lifecycle. 

This PR allows any user to configure an existing Kubernetes ServiceAccount used by the agent.

Part of #11866
2022-10-03 16:25:51 +01:00
Zac Bergquist 88f369360a docs: add more details on audit log retention (#16730) 2022-09-28 21:14:28 +00:00
Ryan Clark 806a568ada Introduce config v3, add auth_server and proxy_server, remove auth_addresses (#15761) 2022-09-28 15:30:15 +00:00
rosstimothy e0721a1609 Leverage inventory control stream for instance version metrics (#16518)
* Leverage inventory control stream for instance version metrics

The version metrics relied on loading all resources in the cache on
each auth server to tally the counts. Unmarshalling items from the
cache can be quite expensive, especially when done every 15s for
all resources in a cluster. While auth servers are typically robust
machines the extra computation for calculating a single metric is
a bit costly and will grow with the cluster size.

Now that the inventory control stream provides a simple and efficient
manner to iterate over all connected instances we can leverage it
instead of the cache to calculate the version counts. This is a slight
breaking change however, as an auth server will now only be reporting
the versions of instances connected directly to itself, and not
versions for all instances within the cluster. This can easily be
worked around by aggregating the metric from all auth servers for
a cluster.

Closes #16429
2022-09-26 19:15:41 +00:00
Grzegorz Zdunek 6426500069 Change kube logged in message (#16368) 2022-09-26 15:31:22 +00:00
Bence Kiglics 41474a021d Add documentation for Slack Helm chart (#13726)
It includes an updated guide and the reference of the new Helm chart.
2022-09-26 10:11:17 +00:00
Hugo Shaka 1cf949e5c4 helm: add minReadySeconds to teleport-cluster chart (#16465)
Fixes #13129

This PR sets minReadySeconds to 15 by default. During a rollout we still have proxies that don't have tunnels to all agents, but at least agents don't end up with 0 active tunnels.
2022-09-23 14:20:03 +00:00
Alan Parra 9bc7ba815a Remove HOTP mention from reference config (#16590)
HOTP is a leftover from olden times.
2022-09-21 20:14:48 +00:00
Paul Gottschling c423c08fd3 Refresh the Enterprise Getting Started guide (#15780)
* Refresh the Enterprise Getting Started guide

Fixes #14249

Edit the Enterprise Getting Started guide based on manual testing to
make the guide up to date and easier to follow.

- Update the architectural description in the introduction
- Structure the guide, following out Linux Server guide for open source
  installations, to include Application Access
- Add DNS instructions rather than using the `--insecure` flag
- Add copy-pastable installation instructions
- Flesh out the license file instructions and add a screenshot of the
  customer portal
- Simplify the instructions for adding a local user
- Remove the docker-compose instructions, since we want the user to
  finish setting up a minimal Teleport cluster by the end of the guide,
  and these instructions begin a new step-by-step sequence. We also have
  a separate docker-compose guide that users can follow for a local
  demo
- Add a "Next steps" section and move relevant content there

* Respond to PR feedback
2022-09-21 16:27:36 +00:00
Zac Bergquist 15977aed4b docs: move S3 IAM policy into an include (#16464)
Prior to this change, the only place you could find a complete IAM
policy for using S3 to store session recordings was in the helm
deployment section.

Move the IAM policy into an include so that we can also include it
in the S3 section of the backends reference page.
2022-09-16 18:56:38 +00:00
Hugo ShakaandPaul Gottschling 920495c6d7 helm: allow custom CA in teleport-cluster without custom certs (#16325)
Provides a solution for #9298

This removes an unnecessary limitation of the Helm chart: `.Values.tls.existingCASecretName` can now be used without `.Values.tls.existingSecretName`. This allows users to trust their own CAs without building custom images.

Context:
- go's x509 library supports loading system certs based on the SSL_CERTS_FILE environment variable
- we are already using this in the chart to trust private CAs (teleport proxy needs to trust its own certs to start)
- users might want to trust custom CAs to
  - speak with a S3 backend (minio)
  - validate upstream app certs (unlike DB access you can't trust certs per-application)
  - trust another cluster
  - call an OIDC provider
- teleport-kube-agent chart already has the feature

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2022-09-16 15:53:35 +00:00
Alex FornutoandPaul Gottschling 68527f8520 [Docs] note S3 versioning requirement (#16423)
* note S3 versioning requirement

* expand from input on GH

* copy edits after talking with Jeff

* Update docs/pages/reference/backends.mdx

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2022-09-15 15:21:00 -05:00
Forrest Marshall 0b20709522 fix hb numbers in readyz docs 2022-09-14 10:44:34 -07:00
Hugo Shaka 6367c1415a docs: fix joinParams reference (#16346) 2022-09-13 21:23:32 +00:00
c67130052f helm: Add conditional creation of serviceAccount (#16337 and #11895)
Add conditional creation of `serviceAccount` in both `teleport-cluster` and `teleport-kube-agent` charts.

Signed-off-by: Hugo Hervieux <hugo.hervieux@goteleport.com>
Co-authored-by: nickolanick <biliaievnk@gmail.com>
Co-authored-by: Gus Luxton <gus@goteleport.com>
Co-authored-by: Mykola Biliaiev <mykola@firebolt.io>
2022-09-13 12:25:19 +00:00
Bence Kiglics c522b38383 Add documentation for MatterMost Helm chart (#13728)
Includes an updated guide and the reference of the new Helm chart.
2022-09-08 11:49:30 +00:00
Bence Kiglics 5e476ed17d Add documentation for PagerDuty Helm chart (#13729) 2022-08-31 15:57:20 +00:00
Gus Luxton 2723369543 docs: Add missing commands key to dynamic labels in reference (#15869)
Add missing commands key to dynamic labels

Somehow the `commands:` key got removed and so the reference was giving an incorrect structure.
2022-08-29 14:23:18 +00:00
Bence KiglicsandPaul Gottschling 6e246ab5c9 Add documentation for Jira Helm chart (#13730)
* Add documentation for Jira Helm chart

It includes an updated guide and the reference of the new Helm chart.

* Fixed some minor mistakes in the guides

* Reorganized Helm related examples

* Fixed a few minor mistakes

* Alphabetized jira.* settings

* Renamed Cloud to Executable in Testing

* Extended YAML config example with explanation

* Edit Jira Access Request plugin Helm chart docs

- Edit the configuration instructions so we don't instruct Helm users to
  use the `configure` subcommand. Also use the `Tabs` component's
  dropdown functionality so we can include both self-hosted and Teleport
  Cloud instructions for Helm and VM users.

- Minor style tweaks.

* Add Helm Chart example to Installation section

* Removed confusing (and broken) link
git push

* Fixed wrong default value

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2022-08-26 12:23:07 +00:00
Andrew LeFevre 7edf9c333f Merge pull request #15144 from gravitational/capnspacehook/file-copy-role-option
Added file copying role option and node config option
2022-08-24 20:13:41 +00:00
Logan Davis 6cbc9e1142 Update helm chart snapshots and tests for amazon ECR Public (#15355) 2022-08-23 16:03:40 +00:00
Paul Gottschling 91c89b6126 Organize docs guide sections chronologically (#15357)
* Organize docs guide sections chronologically

This change aims to make docs navigation easier by organizing some docs
sections according to the sequence of steps a user would take to set up
Teleport.

The current docs organization uses a variety of categories and schemes
to organize the docs. For example, there is a "Home" section that
includes the Changelog, Installation page, and Getting Started guides; a
"Setup" section that includes references and admin guides; and
edition-specific sections (Enterprise, Cloud). For a user who is setting
up Teleport--or who has already done some setup work and wants more
advanced instructions--it's difficult to know where in the docs to find
the right information.

This change organizes our how-to guides into the following categories
that describe the process of setting up Teleport:

- Try out Teleport
- Deploy a Cluster (including choosing an edition)
- Configure Access (including SSO, RBAC, and Access Requests)
- Manage your Cluster (admin guides, operations, etc.)
- Use Teleport (this section already exists)

I moved the Reference section after this chronology, since users can
access the reference guides anywhere in the setup process.

As part of the change, I have also moved the content from the
"Enterprise" and "Cloud" sections into "Deploy a Cluster", since this
content has to do with how to deploy a specific edition of Teleport.

Note that this change does _not_ attempt to reorganize our
protocol-specific sections. While adding resources is part of the
Teleport setup process, we have a lot of content in our
protocol-specific sections, and moving it all into a single section
related to adding resources to a cluster would (a) exceed the maximum
depth for subsections in the nav bar and (b) cause more confusion than
it alleviates.

* Respond to PR feedback

- Create a "Compliance Frameworks" section of "Configure Access" with
  the FedRAMP and SOC 2 guides
- Rename "Use Teleport" to "Connect your Client"
- Move the database GUI client guide into "Connect your Client"

* Add redirects

* Fix linter issues
2022-08-22 19:45:32 +00:00
Alexander KlizhentasandBen Arent e49e894efe Sasha/fwd user (#7996)
* Video Banner (#7914)

* Drain off admin guide into setup sections. (#7960)

* Expand daemon section and graceful restarts guide
* Move API section to top
* Move references to setup

Co-authored-by: Ben Arent <ben@goteleport.com>
2021-08-19 15:00:26 -07:00
inertial-frame 9fbe282052 [v7.0] docs: port of edit pass 2/9 (#7173)
* docs: port 6961

* docs: comment out line

* docs: correct OSS

* docs: correction

* docs: bump example from 24h to 2190h

* docs: update notes
2021-06-15 20:14:00 -05:00
inertial-frame e519af958e [v7.0] docs: port of edit pass 3/9 (#7187)
* docs: port of 6968

* docs: correct link

* docs: header
2021-06-15 19:32:04 -05:00
inertial-frame c5f3f56719 docs: port api changes (#7031) 2021-06-02 15:40:43 -05:00
Brian Joerger d830ed6db7 Refactor api package and docs to use pkg.go.dev effectively. (#6388) 2021-04-20 16:44:17 -07:00