Release v1.122.0 - release → staging

README.md

@@ -45,11 +45,11 @@ This repository is home to the Akamai Connected **[Cloud Manager](https://cloud.
 
 ## Developing Locally
 
-To get started running Cloud Manager locally, please see the [_Getting Started_ guide](docs/GETTING_STARTED.md).
+To get started running Cloud Manager locally, please see the [Getting Started guide](https://linode.github.io/manager/GETTING_STARTED.html).
 
 ## Contributing
 
-If you already have your development environment set up, please read the [contributing guidelines](docs/CONTRIBUTING.md) to get help in creating your first Pull Request.
+If you already have your development environment set up, please read the [Contributing Guidelines](https://linode.github.io/manager/CONTRIBUTING.html) to get help in creating your first Pull Request.
 
 To report a bug or request a feature in Cloud Manager, please [open a GitHub Issue](https://github.com/linode/manager/issues/new). For general feedback, use [linode.com/feedback](https://www.linode.com/feedback/).
 

docs/CONTRIBUTING.md

@@ -17,25 +17,26 @@ Feel free to open an issue to report a bug or request a feature.
 5. Commit message format standard: `<commit type>: [JIRA-ticket-number] - <description>`
 
     **Commit Types:**
-    `feat`: New feature for the user (not a part of the code, or ci, ...).
-    `fix`: Bugfix for the user (not a fix to build something, ...).
-    `change`: Modifying an existing visual UI instance. Such as a component or a feature.
-    `refactor`: Restructuring existing code without changing its external behavior or visual UI. Typically to improve readability, maintainability, and performance.
-    `test`: New tests or changes to existing tests. Does not change the production code.
-    `upcoming`: A new feature that is in progress, not visible to users yet, and usually behind a feature flag.
+    - `feat`: New feature for the user (not a part of the code, or ci, ...).
+    - `fix`: Bugfix for the user (not a fix to build something, ...).
+    - `change`: Modifying an existing visual UI instance. Such as a component or a feature.
+    - `refactor`: Restructuring existing code without changing its external behavior or visual UI. Typically to improve readability, maintainability, and performance.
+    - `test`: New tests or changes to existing tests. Does not change the production code.
+    - `upcoming`: A new feature that is in progress, not visible to users yet, and usually behind a feature flag.
 
     **Example:** `feat: [M3-1234] - Allow user to view their login history`
 
 6. Open a pull request against `develop` and make sure the title follows the same format as the commit message.
 7. If needed, create a changeset to populate our changelog
-    -  If you don't have the Github CLI installed or need to update it (you need GH CLI 2.21.0 or greater),
+    - If you don't have the Github CLI installed or need to update it (you need GH CLI 2.21.0 or greater),
         - install it via `brew`: https://cli.github.com/manual/installation or upgrade with `brew upgrade gh`
         - Once installed, run `gh repo set-default` and pick `linode/manager` (only > 2.21.0)
         - You can also just create the changeset manually, in this case make sure to use the proper formatting for it.
     - Run `yarn changeset`from the root, choose the package to create a changeset for, and provide a description for the change.
     You can either have it committed automatically or do it manually if you need to edit it.
-    - A changeset is optional, it merely depends if it falls in one of the following categories:
+    - A changeset is optional, but should be included if the PR falls in one of the following categories:<br>
     `Added`, `Fixed`, `Changed`, `Removed`, `Tech Stories`, `Tests`, `Upcoming Features`
+      - Select the changeset category that matches the commit type in your PR title. (Where this isn't a 1:1 match: generally, a `feat` commit type falls under an `Added` change and `refactor` falls under `Tech Stories`.)
 
 Two reviews from members of the Cloud Manager team are required before merge. After approval, all pull requests are squash merged.
 

docs/development-guide/08-testing.md

@@ -186,9 +186,10 @@ These environment variables are specific to Cloud Manager UI tests. They can be
 ###### General
 Environment variables related to the general operation of the Cloud Manager Cypress tests.
 
-| Environment Variable | Description                                                                                           | Example  | Default                         |
-|----------------------|-------------------------------------------------------------------------------------------------------|----------|---------------------------------|
-| `CY_TEST_SUITE`      | Name of the Cloud Manager UI test suite to run. Possible values are `core`, `region`, or `synthetic`. | `region` | Unset; defaults to `core` suite |
+| Environment Variable | Description                                                                                           | Example      | Default                         |
+|----------------------|-------------------------------------------------------------------------------------------------------|--------------|---------------------------------|
+| `CY_TEST_SUITE`      | Name of the Cloud Manager UI test suite to run. Possible values are `core`, `region`, or `synthetic`. | `region`     | Unset; defaults to `core` suite |
+| `CY_TEST_TAGS`       | Query identifying tests that should run by specifying allowed and disallowed tags.                    | `method:e2e` | Unset; all tests run by default |
 
 ###### Regions
 These environment variables are used by Cloud Manager's UI tests to override region selection behavior. This can be useful for testing Cloud Manager functionality against a specific region.

docs/development-guide/15-api-events.md

@@ -7,7 +7,7 @@ In order to display these messages in the application (Notification Center, /eve
 ## Adding a new Action and Composing Messages
 
 In order to add a new Action, one must add a new key to the read-only `EventActionKeys` constant array in the api-v4 package.
-Once that's done, a related entry must be added to the `eventMessages` Event Map. In order to do so, the entry can either be added to an existing Event Factory or a new one. `eventMessages` is strictly typed, so the decision where to add the new Action will be clear. ex:
+Once that's done, a related entry must be added to the `eventMessages` Event Map. In order to do so, the entry can either be added to an existing Event Factory or a new one. `eventMessages` is strictly typed, so the action needs to be added to an existing factory or a new one, depending on its key (in this example the action starts with `linode_` so it belongs in the `linode.tsx` factory):
 
 ```Typescript
 import { EventLink } from '../EventLink';
@@ -32,6 +32,41 @@ The convention to compose the message is as follows:
   - the primary action: (ex: `<strong>created</strong>`) 
   - its correlated negation for negative actions (ex: `could <strong>not</strong> be <strong>created</strong>.`)
 - The `message` should be also handled via the `<EventMessage message={e.message} />` in order to handle potential formatting from the API string (ticks to indicate code blocks).
+- The message composition can be enhanced by using custom components. For instance, if we need to fetch extra data based on an event entity, we can simply write a new component to include in the message:
+
+```Typescript
+export const linode: PartialEventMap<'linode'> = {
+  linode_migrate_datacenter: {
+    started: (e) => <LinodeMigrateDataCenterMessage event={e} />,
+  },
+};
+
+const LinodeMigrateDataCenterMessage = ({ event }: { event: Event }) => {
+  const { data: linode } = useLinodeQuery(event.entity?.id ?? -1);
+  const { data: regions } = useRegionsQuery();
+  const region = regions?.find((r) => r.id === linode?.region);
+
+  return (
+    <>
+      Linode <EventLink event={event} to="entity" /> is being{' '}
+      <strong>migrated</strong>
+      {region && (
+        <>
+          {' '}
+          to <strong>{region.label}</strong>
+        </>
+      )}
+      .
+    </>
+  );
+};
+```
+
+## In Progress Events
+
+Some event messages are meant to be displayed alongside a progress bar to show the user the percentage of the action's completion. When an action is in progress, the polling interval switches to every two seconds to provide real-time feedback.
+
+Despite receiving a `percent_complete` value from the API, not all actions are suitable for displaying visual progress, often because they're too short, or we only receive 0% and 100% from the endpoint. To allow only certain events to feature the progress bar, their action keys must be added to the `ACTIONS_TO_INCLUDE_AS_PROGRESS_EVENTS` constant.
 
 ## Displaying Events in snackbars
 

package.json

@@ -7,7 +7,7 @@
     "npm-run-all": "^4.1.5",
     "patch-package": "^7.0.0",
     "postinstall": "^0.6.0",
-    "typescript": "^4.9.5"
+    "typescript": "^5.4.5"
   },
   "husky": {
     "hooks": {

packages/api-v4/CHANGELOG.md

@@ -1,3 +1,12 @@
+## [2024-06-24] - v0.120.0
+
+
+### Added:
+
+- New endpoint for LKE HA types used in pricing ([#10505](https://github.com/linode/manager/pull/10505))
+- UpdateImagePayload type ([#10514](https://github.com/linode/manager/pull/10514))
+- New endpoint for `network-transfer/prices`` ([#10566](https://github.com/linode/manager/pull/10566))
+
 ## [2024-06-10] - v0.119.0
 
 

packages/api-v4/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linode/api-v4",
-  "version": "0.119.0",
+  "version": "0.120.0",
   "homepage": "https://github.com/linode/manager/tree/develop/packages/api-v4",
   "bugs": {
     "url": "https://github.com/linode/manager/issues"
@@ -67,7 +67,7 @@
     "lint-staged": "^13.2.2",
     "prettier": "~2.2.1",
     "tsup": "^7.2.0",
-    "vitest": "^1.3.1"
+    "vitest": "^1.6.0"
   },
   "lint-staged": {
     "*.{ts,tsx,js}": [

packages/api-v4/src/images/images.ts

@@ -17,6 +17,7 @@ import type {
   CreateImagePayload,
   Image,
   ImageUploadPayload,
+  UpdateImagePayload,
   UploadImageResponse,
 } from './types';
 
@@ -58,21 +59,9 @@ export const createImage = (data: CreateImagePayload) => {
  * Updates a private Image that you have permission to read_write.
  *
  * @param imageId { string } ID of the Image to look up.
- * @param label { string } A short description of the Image. Labels cannot contain special characters.
- * @param description { string } A detailed description of this Image.
+ * @param data { UpdateImagePayload } the updated image details
  */
-export const updateImage = (
-  imageId: string,
-  label?: string,
-  description?: string,
-  tags?: string[]
-) => {
-  const data = {
-    ...(label && { label }),
-    ...(description && { description }),
-    ...(tags && { tags }),
-  };
-
+export const updateImage = (imageId: string, data: UpdateImagePayload) => {
   return Request<Image>(
     setURL(`${API_ROOT}/images/${encodeURIComponent(imageId)}`),
     setMethod('PUT'),

packages/api-v4/src/images/types.ts

@@ -4,7 +4,7 @@ export type ImageStatus =
   | 'deleted'
   | 'pending_upload';
 
-type ImageCapabilities = 'cloud-init' | 'distributed-images';
+export type ImageCapabilities = 'cloud-init' | 'distributed-images';
 
 type ImageType = 'manual' | 'automatic';
 
@@ -148,6 +148,8 @@ export interface CreateImagePayload extends BaseImagePayload {
   disk_id: number;
 }
 
+export type UpdateImagePayload = Omit<BaseImagePayload, 'cloud_init'>;
+
 export interface ImageUploadPayload extends BaseImagePayload {
   label: string;
   region: string;

packages/api-v4/src/index.ts

@@ -22,6 +22,8 @@ export * from './managed';
 
 export * from './networking';
 
+export * from './network-transfer';
+
 export * from './nodebalancers';
 
 export * from './object-storage';

packages/api-v4/src/kubernetes/kubernetes.ts

@@ -7,8 +7,8 @@ import Request, {
   setURL,
   setXFilter,
 } from '../request';
-import { Filter, Params, ResourcePage as Page } from '../types';
-import {
+import type { Filter, Params, ResourcePage as Page, PriceType } from '../types';
+import type {
   CreateKubeClusterPayload,
   KubeConfigResponse,
   KubernetesCluster,
@@ -180,3 +180,15 @@ export const recycleClusterNodes = (clusterID: number) =>
     setMethod('POST'),
     setURL(`${API_ROOT}/lke/clusters/${encodeURIComponent(clusterID)}/recycle`)
   );
+
+/**
+ * getKubernetesTypes
+ *
+ * Returns a paginated list of available Kubernetes types; used for dynamic pricing.
+ */
+export const getKubernetesTypes = (params?: Params) =>
+  Request<Page<PriceType>>(
+    setURL(`${API_ROOT}/lke/types`),
+    setMethod('GET'),
+    setParams(params)
+  );

packages/api-v4/src/network-transfer/index.ts

@@ -0,0 +1 @@
+export * from './prices';

packages/api-v4/src/network-transfer/prices.ts

@@ -0,0 +1,10 @@
+import { API_ROOT } from 'src/constants';
+import Request, { setMethod, setURL, setParams } from 'src/request';
+import { Params, PriceType, ResourcePage } from 'src/types';
+
+export const getNetworkTransferPrices = (params?: Params) =>
+  Request<ResourcePage<PriceType>>(
+    setURL(`${API_ROOT}/network-transfer/prices`),
+    setMethod('GET'),
+    setParams(params)
+  );

packages/api-v4/src/regions/types.ts

@@ -47,6 +47,6 @@ export interface RegionAvailability {
   region: string;
 }
 
-type ContinentCode = keyof typeof COUNTRY_CODE_TO_CONTINENT_CODE;
+type CountryCode = keyof typeof COUNTRY_CODE_TO_CONTINENT_CODE;
 
-export type Country = Lowercase<ContinentCode>;
+export type Country = Lowercase<CountryCode>;

packages/manager/.changeset/pr-10545-upcoming-features-1718402597165.md

@@ -0,0 +1,5 @@
+---
+"@linode/manager": Upcoming Features
+---
+
+Update Images Landing table ([#10545](https://github.com/linode/manager/pull/10545))

packages/manager/.changeset/pr-10597-fixed-1718893685492.md

@@ -0,0 +1,5 @@
+---
+"@linode/manager": Fixed
+---
+
+fix: [M3-8274] - Fix parsing issue causing in Kubernetes Version field ([#10597](https://github.com/linode/manager/pull/10597))

packages/manager/.changeset/pr-10602-tests-1718985699307.md

@@ -0,0 +1,5 @@
+---
+"@linode/manager": Tests
+---
+
+Update Object Storage tests to mock account capabilities as needed for multi cluster ([#10602](https://github.com/linode/manager/pull/10602))

packages/manager/CHANGELOG.md

@@ -4,6 +4,66 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](http://keepachangelog.com/) and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## [2024-06-24] - v1.122.0
+
+
+### :
+
+- Use dynamic HA pricing with `lke/types` endpoint ([#10505](https://github.com/linode/manager/pull/10505))
+
+### Added:
+
+- Informational notice about capturing an image from a Linode in a distributed compute region ([#10544](https://github.com/linode/manager/pull/10544))
+- Volume & Images landing pages search and filtering ([#10570](https://github.com/linode/manager/pull/10570))
+
+### Changed:
+
+- Rename to 'Choose a Distribution' to 'Choose an OS' in Linode Create flow ([#10554](https://github.com/linode/manager/pull/10554))
+- Use dynamic outbound transfer pricing with `network-transfer/prices` endpoint ([#10566](https://github.com/linode/manager/pull/10566))
+- Link Cloud Manager README to new documentation pages ([#10582](https://github.com/linode/manager/pull/10582))
+
+### Fixed:
+
+- Marketplace docs urls for Apache Kafka Cluster and Couchbase Cluster ([#10569](https://github.com/linode/manager/pull/10569))
+- Users must be an unrestricted User in order to add or modify tags on Linodes ([#10583](https://github.com/linode/manager/pull/10583))
+- CONTRIBUTING doc page commit type list markup ([#10587](https://github.com/linode/manager/pull/10587))
+- React Query Events `seen` behavior and other optimizations ([#10588](https://github.com/linode/manager/pull/10588))
+- Accessibility: Add tabindex to TextTooltip ([#10590](https://github.com/linode/manager/pull/10590))
+
+### Tech Stories:
+
+- Refactor and clean up ImagesDrawer ([#10514](https://github.com/linode/manager/pull/10514))
+- Event Messages Refactor: progress events ([#10550](https://github.com/linode/manager/pull/10550))
+- NodeBalancer Query Key Factory ([#10556](https://github.com/linode/manager/pull/10556))
+- Query Key Factory for Domains ([#10559](https://github.com/linode/manager/pull/10559))
+- Upgrade Vitest and related dependencies to 1.6.0 ([#10561](https://github.com/linode/manager/pull/10561))
+- Query Key Factory for Firewalls ([#10568](https://github.com/linode/manager/pull/10568))
+- Update TypeScript to latest ([#10573](https://github.com/linode/manager/pull/10573))
+
+### Tests:
+
+- Cypress integration test to add SSH key via Profile page ([#10477](https://github.com/linode/manager/pull/10477))
+- Add assertions regarding Disk Encryption info banner to lke-landing-page.spec.ts ([#10546](https://github.com/linode/manager/pull/10546))
+- Add Placement Group navigation integration tests ([#10552](https://github.com/linode/manager/pull/10552))
+- Improve Cypress test suite compatibility against alternative environments ([#10562](https://github.com/linode/manager/pull/10562))
+- Improve stability of StackScripts pagination test ([#10574](https://github.com/linode/manager/pull/10574))
+- Fix Linode/Firewall related E2E test flake ([#10581](https://github.com/linode/manager/pull/10581))
+- Mock profile request to improve security questions test stability ([#10585](https://github.com/linode/manager/pull/10585))
+- Fix hanging unit tests ([#10591](https://github.com/linode/manager/pull/10591))
+- Unit test coverage - HostNameTableCell ([#10596](https://github.com/linode/manager/pull/10596))
+
+### Upcoming Features:
+
+- Resources MultiSelect component in cloudpulse global filters view ([#10539](https://github.com/linode/manager/pull/10539))
+- Add Disk Encryption info banner to Kubernetes landing page ([#10546](https://github.com/linode/manager/pull/10546))
+- Add Disk Encryption section to Linode Rebuild modal ([#10549](https://github.com/linode/manager/pull/10549))
+- Obj fix for crashing accesskey page when relevant customer tags are not added ([#10555](https://github.com/linode/manager/pull/10555))
+- Linode Create v2 - Handle side-effects when changing the Region ([#10564](https://github.com/linode/manager/pull/10564))
+- Revise LDE copy in Linode Create flow when Distributed region is selected ([#10576](https://github.com/linode/manager/pull/10576))
+- Update description for Add Node Pools section in LKE Create flow ([#10578](https://github.com/linode/manager/pull/10578))
+- Linode Create v2 - Add Marketplace Searching / Filtering ([#10586](https://github.com/linode/manager/pull/10586))
+- Add Distributed Icon to ImageSelects for distributed compatible images ([#10592](https://github.com/linode/manager/pull/10592))
+
 ## [2024-06-11] - v1.121.1
 
 ### Fixed:

packages/manager/cypress.config.ts

@@ -14,6 +14,7 @@ import { fetchAccount } from './cypress/support/plugins/fetch-account';
 import { fetchLinodeRegions } from './cypress/support/plugins/fetch-linode-regions';
 import { splitCypressRun } from './cypress/support/plugins/split-run';
 import { enableJunitReport } from './cypress/support/plugins/junit-report';
+import { logTestTagInfo } from './cypress/support/plugins/test-tagging-info';
 
 /**
  * Exports a Cypress configuration object.
@@ -66,6 +67,7 @@ export default defineConfig({
         fetchAccount,
         fetchLinodeRegions,
         regionOverrideCheck,
+        logTestTagInfo,
         splitCypressRun,
         enableJunitReport,
       ]);

packages/manager/cypress/e2e/core/account/security-questions.spec.ts

@@ -2,8 +2,10 @@
  * @file Integration tests for account security questions.
  */
 
+import { profileFactory } from 'src/factories/profile';
 import { securityQuestionsFactory } from 'src/factories/profile';
 import {
+  mockGetProfile,
   mockGetSecurityQuestions,
   mockUpdateSecurityQuestions,
 } from 'support/intercepts/profile';
@@ -117,6 +119,10 @@ describe('Account security questions', () => {
     const securityQuestions = securityQuestionsFactory.build();
     const securityQuestionAnswers = ['Answer 1', 'Answer 2', 'Answer 3'];
 
+    const mockProfile = profileFactory.build({
+      two_factor_auth: false,
+    });
+
     const securityQuestionsPayload = {
       security_questions: [
         { question_id: 1, response: securityQuestionAnswers[0] },
@@ -128,6 +134,7 @@ describe('Account security questions', () => {
     const tfaSecurityQuestionsWarning =
       'To use two-factor authentication you must set up your security questions listed below.';
 
+    mockGetProfile(mockProfile);
     mockGetSecurityQuestions(securityQuestions).as('getSecurityQuestions');
     mockUpdateSecurityQuestions(securityQuestionsPayload).as(
       'setSecurityQuestions'