openwhisk-website icon indicating copy to clipboard operation
openwhisk-website copied to clipboard

update wskdeploy docs to reflect it being a subcommand of wsk

Open dgrove-oss opened this issue 6 years ago • 12 comments

http://openwhisk.apache.org/documentation.html#wskdeploy should be reworked to reflect wskdeploy now being bundled as a sub-command of wsk

dgrove-oss avatar Apr 25 '19 17:04 dgrove-oss

thanks @dgrove-oss yup, agree, need to update the website as well

pritidesai avatar Apr 25 '19 17:04 pritidesai

Bump: https://github.com/apache/openwhisk-wskdeploy/issues/1109

I can change that one paragraph, but I'm not sure what yall wanna do for the rest of that section considering that recent wskdeploy releases no longer have binaries attached so if one were dedicated to using wskdeploy as opposed to wsk project then they're going to have to build it themselves.

Amndeep7 avatar Jan 29 '21 22:01 Amndeep7

@mrutkows - opinions? coming up on two years now and the docs are still out of date.

dgrove-oss avatar Jan 29 '21 23:01 dgrove-oss

I think the references to wskdeploy can be replaced with references to the wsk CLI instead, including amending the command line example.

rabbah avatar Jan 31 '21 20:01 rabbah

@dgrove-oss @rabbah It had been my intent to maintain a wskdeploy (standalone) binary as well as the "deploy" command within the CLI since one can create automation with just the wskdeploy executable and not install the CLI. I did not recall seeing anyone change that; releases never have official binaries; we did release "convenience" binaries. The website docs should reflect both the standalone instructions (as secondary) as well as the "deploy" command as part of CLI (primary).

mrutkows avatar Feb 01 '21 18:02 mrutkows

@dgrove-oss @rabbah I no longer see the releases tab under the GitHub repo. did this get removed by Apache Infra.??? How do we get it back?

The website docs were updated: https://openwhisk.apache.org/documentation.html#wskdeploy and apparently, they reference the (no hidden) releases link: https://github.com/apache/openwhisk-wskdeploy/releases

As I said, I do not recall (forgive if I truly forgot) no longer supplying binaries... assume this was some Apache decision to avoid legal issues around graduation time? If so, would love to add them back.

mrutkows avatar Feb 01 '21 18:02 mrutkows

@mrutkows The releases "tab" was moved by a UI update by Github a while back to instead be a section on the column on the right hand side.

Amndeep7 avatar Feb 01 '21 18:02 Amndeep7

@Amndeep7 I would like to revisit the decision to not produce wskdeploy binaries... as I truly do not recall agreeing to no longer do this but assume some discussion was had and this was required to allow us to graduate and/or simplify/streamline processes.

mrutkows avatar Feb 01 '21 18:02 mrutkows

is there an active maintainer for wskdeploy? If so, their first step would be to get it passing travis builds again. been broken for months.

dgrove-oss avatar Feb 01 '21 18:02 dgrove-oss

@dgrove-oss I saw that 2 weeks ago and assume your key changes work... trying to find time... would like to merge you travis/key PR and then see why those 2 integration tests are failing against golang runtime.

The last I had time/left it (PR merged) it built fine which was Sept. when I forced into an emergency assignment. The first indication it did no longer build was your Travis PR https://github.com/apache/openwhisk-wskdeploy/pull/1108 which was Dec. 17th and did not see until under 2 weeks ago as I was not actively working. This is likely due to a change YE2020 in ICF support for golang or other images.

mrutkows avatar Feb 01 '21 18:02 mrutkows

@dgrove-oss and Dave please know that resources have become rather scarce/tenuous and I have been trying to add new professionals as part of our Jumpstart program each of the last 3 quarters.

mrutkows avatar Feb 01 '21 18:02 mrutkows

The reason why there are no connivence binarys with the 1.1.0 release of wskdeploy is that the wskdeploy build failed due to changes in golang runtime versions and no one had the bandwidth to fix it. If wskdeploy built and passed its own test suite, all of the machinery is still in place to publish images.

https://travis-ci.org/github/apache/openwhisk-wskdeploy/builds/732114326

dgrove-oss avatar Feb 01 '21 18:02 dgrove-oss