mirror of
https://github.com/gravitational/teleport.git
synced 2026-11-02 14:59:53 +08:00
Alan Parra
a75fcc21d8
Update metalinter, fix a few lint warnings and replace deprecated linters. `deadcode`, `structcheck` and `varcheck` are abandoned and now replaced by [`unused`][1]. Since 1.19, `go fmt` reformats godocs according to https://go.dev/doc/comment. I've done a bulk-reformatting of the codebase to keep the linter happy. Backporting is mostly harmless (the exception being `lib/services/role_test.go`, that for some reason breaks the _old_ linter using the new format). [1]: https://golangci-lint.run/usage/linters/ * Bump golangci-lint version * Replace abandoned linters * Fix bodyclose on lib/auth/github.com * Fix bodyclose on lib/kube/proxy/streamproto/proto_test.go * Fix bodyclose on lib/srv/alpnproxy/proxy_test.go * Fix bodyclose on lib/web/conn_upgrade_test.go * Silence staticcheck on lib/kube/proxy/forwarder_test.go * Silence staticcheck on lib/utils/certs_test.go * Address BuildNameToCertificate deprecation warnings * Run `go fmt ./...` * Run `go fmt ./...` on api/ * Ignore formatting in role_test.go * Remove redundant initializers in lib/srv/uacc/ * Update e/
50 lines
2.1 KiB
Go
50 lines
2.1 KiB
Go
/*
|
|
Copyright 2022 Gravitational, Inc.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
*/
|
|
|
|
/*
|
|
Package postgres implements a SQL backend for PostgreSQL and CockroachDB.
|
|
|
|
# Schema
|
|
|
|
The database schema consists of three tables: item, lease, and event.
|
|
|
|
┌──────────┐ ┌──────────┐ ┌──────────┐
|
|
│ item │ │ lease │ │ event │
|
|
├──────────┤ ├──────────┤ ├──────────┤
|
|
│* key │ │* key │ │* eventid │
|
|
│* id │ │ id │ │ created │
|
|
│ value │ │ expires │ │ key │
|
|
│ │ │ │ │ id │
|
|
│ │ │ │ │ type │
|
|
└──────────┘ └──────────┘ └──────────┘
|
|
|
|
The item table contains the backend item's value and is insert-only. The table
|
|
supports multiple items per key. Updates to an item's value creates a new
|
|
record with an ID greater than the most recent record.
|
|
|
|
The lease table contains the backend item's active record, which may have already
|
|
expired. Active leases have a null expires value or expires is greater than the
|
|
current time.
|
|
|
|
The event table contains events for all changes to backend items and is keyed by an
|
|
autoincrementing integer (may not be a sequence/will contain gaps). The event's
|
|
type represents the value of types.OpType.
|
|
|
|
The design allows for items to be updated before an event for previous item has
|
|
been emitted without duplicating storage for value.
|
|
*/
|
|
package postgres
|