Skip to content

Conversation

@djs55
Copy link
Contributor

@djs55 djs55 commented Dec 12, 2024

FYI @KatTomrushka

Description

Highlight 2 deprecations in the release notes. Technically both were highlighted before in the DD UI by adding "(Legacy)" labels, but it's better to over-communicate than under-communicate!

For filesharing, anyone still using osxfs should switch to virtiofs which is faster and more stable.

For running the Linux VM locally, anyone still using Qemu on Apple Silicon should switch to virtualization.framework which is also faster and more stable.

In case someone hits a problem, can't switch and needs help, include links to support and the github issue tracker.

Some history:

  • In 2020 osxfs was marked as legacy (Docker Desktop 2.4.2.0).

  • In 2023 with the release of macOS 14, all supported macOS versions (current release plus previous two) use virtualization.framework by default.

  • In 2024 (Docker Desktop 4.36) Qemu as a VMM was marked as legacy in the UI.

Related issues or tickets

Reviews

  • Technical review
  • Editorial review
  • Product review

@djs55 djs55 requested a review from aevesdocker as a code owner December 12, 2024 17:12
@github-actions github-actions bot added the area/desktop Issue affects a desktop edition of Docker. E.g docker for mac label Dec 12, 2024
@netlify
Copy link

netlify bot commented Dec 12, 2024

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit b8f3c2d
🔍 Latest deploy log https://app.netlify.com/sites/docsdocker/deploys/675c2ce21f66b80008901af3
😎 Deploy Preview https://deploy-preview-21621--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.


#### For Mac

- QEMU (Legacy) as a VMM on Apple Silicon will be removed in 4.39. Please switch to virtualization.framework for increased performance and stability. If you encounter an issue, [contact support](https://www.docker.com/support/) or file a [github issue](https://github.com/docker/for-mac/issues).
Copy link
Member

Choose a reason for hiding this comment

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

  • Looks like Vale doesn't like the "Please"; perhaps "Users are recommended to switch to ..."
  • It also complains about "VMM" as unknown acronym; I think it works if you put it like "Virtual Machine Manager (VMM) ..." (is it "manager"?)

@KatTomrushka
Copy link

I am happy to put a note in the release notes but let's not commit to when we will deprecate without an internal alignment first.
To say that we will completely remove the option from the GUI in DD 4.39 (end of Feb?) is a bit agressive timeline given that the adoption rate is slower specially in enterprises. Suggest identifying which business tier companies (if any) are affected and emailing them about it. Then, the typical process is 180 days for deprecation.

…uture version

For filesharing, anyone still using osxfs should switch to virtiofs which
is faster and more stable.

For running the Linux VM locally, anyone still using Qemu on Apple Silicon
should switch to virtualization.framework which is also faster and more stable.

In case someone hits a problem and needs help, include links to support and
the github issue tracker.

Some history:

- In 2020 osxfs was marked as legacy (Docker Desktop 2.4.2.0).

- In 2023 with the release of macOS 14, all supported macOS versions (current
release plus previous two) use virtualization.framework by default.

- In 2024 (Docker Desktop 4.36) Qemu as a VMM was marked as legacy in the UI.

Signed-off-by: David Scott <dave.scott@docker.com>
@djs55 djs55 changed the title 4.37: propose that (Legacy) Qemu VMM + osxfs will be removed in 4.39 4.37: propose that (Legacy) Qemu VMM + osxfs will be removed in a future version Dec 12, 2024
@aevesdocker aevesdocker merged commit 9bad947 into docker:main Dec 13, 2024
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/desktop Issue affects a desktop edition of Docker. E.g docker for mac

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants