- Notifications
You must be signed in to change notification settings - Fork929
chore: update change log to v2.10.0 and install docs for release channels#12863
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 ourterms of service andprivacy statement. We’ll occasionally send you account related emails.
Already on GitHub?Sign in to your account
Uh oh!
There was an error while loading.Please reload this page.
Merged
Changes fromall commits
Commits
Show all changes
9 commits Select commitHold shift + click to select a range
ed2ea3c 2.10.0 changelog
stirby0dd5c96 updated install docs for mainline/stable releases
stirbyafae242 make fmt
stirby005fc1d cpp icon -> C++
stirbya120ff5 added disclaimer on MAX_TTL, support bundle info
stirby3fad3d9 'release schedule'
stirby0e184fe lowercase mainline
stirbyae85046 Agent OOM protection info
stirby7388c33 minor tweak
stirbyFile filter
Filter by extension
Conversations
Failed to load comments.
Loading
Uh oh!
There was an error while loading.Please reload this page.
Jump to
Jump to file
Failed to load files.
Loading
Uh oh!
There was an error while loading.Please reload this page.
Diff view
Diff view
There are no files selected for viewing
Binary file addeddocs/changelogs/images/support-bundle.png
Loading
Sorry, something went wrong.Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
130 changes: 130 additions & 0 deletionsdocs/changelogs/v2.10.0.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,130 @@ | ||
| ## Changelog | ||
| > [!NOTE] | ||
| > This is a mainline Coder release. We advise enterprise customers without a staging environment to install our [latest stable release](https://github.com/coder/coder/releases/latest) while we refine this version. Learn more about our [Release Schedule](../install/releases.md). | ||
| ### BREAKING CHANGES | ||
| - Removed `max_ttl` from templates (#12644) (@Emyrk) | ||
stirby marked this conversation as resolved. Show resolvedHide resolvedUh oh!There was an error while loading.Please reload this page. | ||
| > Maximum Workspace Lifetime, or `MAX_TTL`, has been removed from the product in favor of Autostop Requirement. Max Lifetime was designed to automate workspace shutdowns to enable security policy enforcement, enforce routine updates, and reduce idle resource costs. | ||
| > | ||
| > If you use Maximum Lifetime in your templates, workspaces will no longer stop at the end of this timer. Instead, we advise migrating to Autostop Requirement. | ||
| > | ||
| > Autostop Requirement shares the benefits of `MAX_TTL`, but also respects user-configured quiet hours to avoid forcing shutdowns while developers are connected. | ||
| > | ||
| > We only completely deprecate features after a 2-month heads up in the UI. | ||
| ### Features | ||
| - Make agent stats' cardinality configurable (#12535) (@dannykopping) | ||
| - Upgrade tailscale fork to set TCP options for performance (#12574) (@spikecurtis) | ||
| - Add AWS IAM RDS Database auth driver (#12566) (@f0ssel) | ||
| - Support Windows containers in bootstrap script (#12662) (@kylecarbs) | ||
| - Add `workspace_id` to `workspace_build` audit logs (#12718) (@sreya) | ||
| - Make OAuth2 provider not enterprise-only (#12732) (@code-asher) | ||
| - Allow number options with monotonic validation (#12726) (@dannykopping) | ||
| - Expose workspace statuses (with details) as a prometheus metric (#12762) (@dannykopping) | ||
| - Agent: Support adjusting child process OOM scores (#12655) (@sreya) | ||
| > This opt-in configuration protects the Agent process from crashing via OOM. To prevent the agent from being killed in most scenarios, set `CODER_PROC_PRIO_MGMT=1` on your container. | ||
| - Expose HTTP debug server over tailnet API (#12582) (@johnstcn) | ||
| - Show queue position during workspace builds (#12606) (@dannykopping) | ||
| - Unhide support bundle command (#12745) (@johnstcn) | ||
| > The Coder support bundle grabs a variety of deployment health information to improve and expedite the debugging experience. | ||
| >  | ||
| - Add golden tests for errors (#11588) (#12698) (@elasticspoon) | ||
| - Enforce confirmation before creating bundle (#12684) (@johnstcn) | ||
| - Add enabled experiments to telemetry (#12656) (@dannykopping) | ||
| - Export metric indicating each experiment's status (#12657) (@dannykopping) | ||
| - Add sftp to insights apps (#12675) (@mafredri) | ||
| - Add `template_usage_stats` table and rollup query (#12664) (@mafredri) | ||
| - Add `dbrollup` service to rollup insights (#12665) (@mafredri) | ||
| - Use `template_usage_stats` in `GetTemplateInsights` query (#12666) (@mafredri) | ||
| - Use `template_usage_stats` in `GetTemplateInsightsByInterval` query (#12667) (@mafredri) | ||
| - Use `template_usage_stats` in `GetTemplateAppInsights` query (#12669) (@mafredri) | ||
| - Use `template_usage_stats` in `GetUserLatencyInsights` query (#12671) (@mafredri) | ||
| - Use `template_usage_stats` in `GetUserActivityInsights` query (#12672) (@mafredri) | ||
| - Use `template_usage_stats` in `*ByTemplate` insights queries (#12668) (@mafredri) | ||
| - Add debug handlers for logs, manifest, and token to agent (#12593) (@johnstcn) | ||
| - Add linting to all examples (#12595) (@mafredri) | ||
| - Add C++ icon (#12572) (@michaelbrewer) | ||
| - Add support for `--mainline` (default) and `--stable` (#12858) (@mafredri) | ||
| - Make listening ports scrollable (#12660) (@BrunoQuaresma) | ||
| - Fetch agent network info over tailnet (#12577) (@johnstcn) | ||
| - Add client magicsock and agent prometheus metrics to support bundle (#12604) (@johnstcn) | ||
| ### Bug fixes | ||
| - Server: Fix data race in TestLabelsAggregation tests (#12578) (@dannykopping) | ||
| - Dashboard: Hide actions and notifications from deleted workspaces (#12563) (@aslilac) | ||
| - VSCode: Importing api into vscode-coder (#12570) (@code-asher) | ||
| - CLI: Clean template destination path for `pull` (#12559) (@dannykopping) | ||
| - Agent: Ensure agent token is from latest build in middleware (#12443) (@f0ssel) | ||
| - CLI: Handle CLI default organization when none exists in <v2.9.0 coderd (#12594) (@Emyrk) | ||
| - Server: Separate signals for passive, active, and forced shutdown (#12358) (@kylecarbs) | ||
| - Docs: Correct typo error about minTerraformVersion (#12621) (@garylavayou) | ||
| - Docs: Correct troubleshooting links (#12608) (@dannykopping) | ||
| - Server: Prevent single replica proxies from staying unhealthy (#12641) (@deansheather) | ||
| - Database: Implicit schema in dump (#12646) (@mtojek) | ||
| - Server: Disable workspace auto-create if external auth requirements aren't met (#12538) (@aslilac) | ||
| - Server: Allow proxy version mismatch (with warning) (#12433) (@deansheather) | ||
| - Server: Disable relay if built-in DERP is disabled (#12654) (@coadler) | ||
| - Dashboard: Create workspace with optional auth providers (#12729) (@aslilac) | ||
| - Always use bash when executing web terminal tests (#12755) (@aslilac) | ||
| - Server: Nil ptr dereference when removing a license (#12785) (@coadler) | ||
| - Use latest coder/tailscale (@spikecurtis) | ||
| - Agent: remove unused token debug handler (#12602) (@johnstcn) | ||
| - CLI: Show error/hide help for unsupported subcommands (#10760) (#12624) (@elasticspoon) | ||
| - CLI: Port-forward: update workspace last_used_at (#12659) (@johnstcn) | ||
| - CLI: Fix newline escape sequence in support blurb (#12749) (@johnstcn) | ||
| - Server: Skip logging error for cancelled query in agent report stats (#12730) (@mafredri) | ||
| - Server: Add timeout to websocket waitgroup on shutdown (#12754) (@coadler) | ||
| - Server: Use insights for DAUs, simplify metricscache (#12775) (@mafredri) | ||
| - API: always write agent stats when provided (#12699) (@mafredri) | ||
| - Database: Improve data exclusion in `UpsertTemplateUsageStats` (#12764) (@mafredri) | ||
| - Database: Improve query performance of `GetTemplateAppInsights` (#12767) (@mafredri) | ||
| - Database: Improve performance of `GetTemplateInsightsByInterval` (#12773) (@mafredri) | ||
| - Database: Add FK index for `workspace_agent_scripts` (#12791) (@mafredri) | ||
| - API: Abort in-progress writes/reads when closing websocket (#12650) (@ammario) | ||
| - Update base image in lima/coder.yaml example, remove usage of deprecated LIMA_CIDATA (#12613) (@johnstcn) | ||
| - Removed hardcoded public (#12620) (@95gabor) | ||
| - API: change test to use bash script instead of binary echo (#12759) (@spikecurtis) | ||
| - Dashboard: Display not found page when pagination page is invalid (#12611) (@BrunoQuaresma) | ||
| - Dashboard: Fix and improve pending state on template editor UI (#12766) (@BrunoQuaresma) | ||
| - Also sanitize agent environment (#12615) (@johnstcn) | ||
| - Sanitize manifest for tests (#12711) (@johnstcn) | ||
| ### Documentation | ||
| - Add updated architecture diagrams (#12584) (@ericpaulsen) | ||
| - Describe reference architectures (#12609) (@mtojek) | ||
| - Use scale testing utility (#12643) (@mtojek) | ||
| - Describe Coder's operational readiness (#12723) (@mtojek) | ||
| - Add guide for JFrog Xray integration (#12629) (@matifali) | ||
| - Document how to run workspace-proxy as a system service (#12810) (@michaelbrewer) | ||
| - Describe mutually exclusive create workspace template fields (#12834) (@Emyrk) | ||
| - Describe single region and multi-region deployments (#12779) (@mtojek) | ||
| - Fix coder-logstream-kube typo in deployment-logs.md (#12845) (@toshikish) | ||
| - Remove phone number, we do not offer phone support yet (#12658) (@bpmct) | ||
| ### Performance improvements | ||
| - Optimize `GetWorkspaceAgentAndLatestBuildByAuthToken` query (#12809) (@mafredri) | ||
| ### Tests | ||
| - Apptest was accidently choosing ports in use (#12580) (@Emyrk) | ||
| - Ensure `RequireActiveVersion` is actually set when testing with AGPL store (#12843) (@aslilac) | ||
| - Add an E2E test for removing a group (#12844) (@aslilac) | ||
| - Enable `dbrollup` service for insights tests (#12673) (@mafredri) | ||
| - Fix TODO for increased accuracy in insights test (#12727) (@mafredri) | ||
| - Fix template name too long in TestPatchTemplateMeta (#12781) (@mafredri) | ||
| Compare: [`v2.9.0...v2.10.0`](https://github.com/coder/coder/compare/v2.9.0...v2.10.0) | ||
| ## Container image | ||
| - `docker pull ghcr.io/coder/coder:v2.10.0` | ||
| ## Install/upgrade | ||
| Refer to our docs to [install](https://coder.com/docs/v2/latest/install) or [upgrade](https://coder.com/docs/v2/latest/admin/upgrade) Coder, or use a release asset below. | ||
3 changes: 3 additions & 0 deletionsdocs/install/index.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.Learn more about bidirectional Unicode characters
23 changes: 22 additions & 1 deletiondocs/install/kubernetes.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.Learn more about bidirectional Unicode characters
56 changes: 56 additions & 0 deletionsdocs/install/releases.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,56 @@ | ||
| # Releases | ||
| Coder releases are cut directly from main in our | ||
| [Github](https://github.com/coder/coder) on the first Tuesday of each month. | ||
| We recommend enterprise customers test the compatibility of new releases with | ||
| their infrastructure on a staging environment before upgrading a production | ||
| deployment. | ||
| We support two release channels: | ||
| [mainline](https://github.com/coder/coder/2.10.0) for the edge version of Coder | ||
| and [stable](https://github.com/coder/coder/releases/latest) for those with | ||
| lower tolerance for fault. We field our mainline releases publicly for two weeks | ||
| before promoting them to stable. | ||
| ### Mainline releases | ||
| - Intended for customers with a staging environment | ||
| - Gives earliest access to new features | ||
| - May include minor bugs | ||
| - All bugfixes and security patches are supported | ||
| ### Stable releases | ||
| - Safest upgrade/installation path | ||
| - May not include the latest features | ||
| - Security vulnerabilities and major bugfixes are supported | ||
| > Note: We support major security vulnerabilities (CVEs) for the past three | ||
| > versions of Coder. | ||
| ## Installing stable | ||
| When installing Coder, we generally advise specifying the desired version from | ||
| our Github [releases page](https://github.com/coder/coder/releases). | ||
| You can also use our `install.sh` script with the `stable` flag to install the | ||
| latest stable release: | ||
| ```shell | ||
| curl -fsSL https://coder.com/install.sh | sh -s -- --stable | ||
| ``` | ||
| Best practices for installing Coder can be found on our [install](./index.md) | ||
| pages. | ||
| ## Release schedule | ||
| | Release name | Date | Status | | ||
| | ------------ | ------------------ | ---------------- | | ||
| | 2.7.0 | January 01, 2024 | Not Supported | | ||
| | 2.8.0 | Februrary 06, 2024 | Security Support | | ||
| | 2.9.0 | March 07, 2024 | Stable | | ||
| | 2.10.0 | April 03, 2024 | Mainline | | ||
| | 2.11.0 | May 07, 2024 | Not Released | | ||
| | 2.12.0 | June 04, 2024 | Not Released | |
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.