cli icon indicating copy to clipboard operation
cli copied to clipboard

Deprecated `sfdx source/mdapi/org` commands will be removed on November 6th, 2024

Open VivekMChawla opened this issue 6 months ago • 8 comments

What's Happening?

On November 6th, 2024, Salesforce will…

  1. Stop bundling plugin-source with the Salesforce CLI sf(v2).
  2. Remove the force:org:create and force:org:delete commands from plugin-org.

What's the Impact of This Change?

  1. force:source:* and force:mdapi:* commands will not be available for use with sf(v2).
    • Solution: Migrate to sf project/org commands (migration guide)
    • Workaround 1: Manually install plugin-source after installing the CLI.
    • Workaround 2: Use a version of the CLI released before November 6th (<= 2.64.7).
  2. force:org:create and force:org:delete will not be available for use with sf(v2).
    • Solution: Migrate to sf org commands (migration guide)
    • Workaround 1: Manually install an earlier version of plugin-org after installing the CLI (<= 4.8.2).
    • Workaround 2: Use a version of the CLI released before November 6th (<= 2.64.7).

Why is Salesforce Making This Change?

  1. Standardizing the sf command syntax and structure is part of our strategic vision for sf(v2).
  2. Distributing deprecated code for a prolonged period increases complexity and technical debt for the CLI as a whole.
  3. A large majority of CLI users have already transitioned to the new commands.

Why is This Change Being Made Now?

We understand this will be a disruptive change for customers who postponed migrating away from the deprecated commands.

While there's never a "good" time for changes like this, we decided to make this change now because:

  1. The impacted commands have been deprecated for over a year.
  2. Tools and resources exist to help customers make this transition (see below)
  3. Workarounds exist for customers requiring additional time to make this change.

As mentioned in the "workaround" notes above, customers who need more than four months to migrate can pin themselves to the latest (stable) CLI version available on November 5th. Changes specific to Winter ’25 (e.g., support for new metadata types) will be incorporated into this version, giving it a reasonable "shelf life" beyond November 6th.

Additional Resources

Questions or Feedback?

Please share any questions or feedback by commenting on this issue.

VivekMChawla avatar Jul 29 '24 16:07 VivekMChawla