Re: [Wikitech-l] [Breaking Change] Scap change for deployers

2016-05-14 Thread Tyler Cipriani

On 16-05-13 20:32:37, Legoktm wrote:

Would it be possible to have tab completion for the new scap
subcommands? "mwv" → mwversionsinuse versus typing out all of "scap
wikiversions-inuse" ;) Same with "sync-f", etc.


Hadn't thought about command expansion. Bash autocompletion is now
tracked in a ticket in Phabricator[0] and is definitely needed.

The plan is to get rid of the old commands like `mwversionsinuse` in
future in favor of the `scap [command]` format. Any thoughts on how to
make this transition easier for deployers are welcome—the best place for
the discussion is probably the phabricator ticket mentioned above
(although the ticket may need to be retitled as it evolves :)).

Thanks!
Tyler

[0]. https://phabricator.wikimedia.org/T135317

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l

Re: [Wikitech-l] [Breaking Change] Scap change for deployers

2016-05-13 Thread Legoktm
Hi,

On 05/10/2016 10:08 AM, Tyler Cipriani wrote:
> Long story short, you will now run:
> 
> scap sync-file  [message]
> 
> Instead of:
> 
> sync-file  [message]
> 

Would it be possible to have tab completion for the new scap
subcommands? "mwv" → mwversionsinuse versus typing out all of "scap
wikiversions-inuse" ;) Same with "sync-f", etc.

It's not that huge of a deal, but I think we all use those commands
pretty frequently that tab completion saves a lot of keystrokes...

-- Legoktm

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l

[Wikitech-l] [Breaking Change] Scap change for deployers now live!

2016-05-11 Thread Tyler Cipriani
tl;dr starting today:

Use:
  scap sync 'message for posterity'
instead of:
  scap 'message for posterity'

Scap 3.2.0-1 is now alive and well in production which means scap
subcommands are live.

All subcommands are documented[0]. Additional documentation can be
seen by running `scap --help` (or `scap [subcommand] --help`). If you
have any questions feel free to ask them on-list or in IRC on #scap3
or #wikimedia-releng.

Thanks!
Tyler Cipriani and the Deployment Working Group

[0]. Mediawiki:
https://doc.wikimedia.org/mw-tools-scap/scap2/commands.html Scap3:
https://doc.wikimedia.org/mw-tools-scap/scap3/deploy_commands.html

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l

[Wikitech-l] [Breaking Change] Scap change for deployers

2016-05-10 Thread Tyler Cipriani
tl;dr: Our beloved scap is changing to use subcommands rather than a
bunch of scripts, but the existing scripts will work for a short time.

Starting with the 3.2.0 release[0], which will hit production in the
next day or so, scap will use subcommands rather than using many
different scripts that all call the same underlying code. The scripts
(e.g., deploy, sync-file, sync-dir, sync-wikiversions.) will continue
to work as usual, but they will issue a deprecation warning until the
next release when they will disappear.

The most notable exception is the `scap` command which must be invoked
as `scap sync [message]`.

The docs are updated[1] and you can see new help output there or on
phabricator[2].

Long story short, you will now run:

scap sync-file  [message]

Instead of:

sync-file  [message]

This change has been cherry-picked on beta cluster and is currently live there.

<3,
Tyler Cipriani and the Deployment Working Group

[0]. https://gerrit.wikimedia.org/r/#/c/287918
[1]. https://doc.wikimedia.org/mw-tools-scap/
[2]. https://phabricator.wikimedia.org/P3027

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l