dpl 2.0.0.alpha.5 → 2.0.0.alpha.6

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 1dc5d3510c8999c2945c0227c5e096d4f2d8d2b5
4
- data.tar.gz: 833ba7206a6f91273ea15c029473b4855db46314
3
+ metadata.gz: 8c1cc40dc2134c6e6252560ce53b979e367bc7e3
4
+ data.tar.gz: 145636ec93f38e235cb62010b442e8ffb25df97c
5
5
  SHA512:
6
- metadata.gz: f1e4c9e3128f9976517c933dfb58bbc7b60f0fbfab99ce7ec6bcc08b589c158589b387e66960d73efb7a19ac5f8aa0439b235a13ec0a8d7d23b59f3c043a355c
7
- data.tar.gz: d42f768920ebc2d1327aeede2cc2d01f02d42984702259a763b79c3928303923f0e6bbc3b5af49edba0762c64d04016771f96b0a3ef63f3edb95b651b6fa315e
6
+ metadata.gz: 72e3396404e483cc2255314805e0ccff4a0f0fb34ccdbb1185dd34bd5e943fedeb2cd4930d0bc0619cda77cda72544e3d82f4ab3b87c555c54ce61c5240fb129
7
+ data.tar.gz: ad28320f7855b3a059259d5d5a0c53889626f8c7aeefa4451e8d08a51305a5a19be1142ce1438cb4ecb7e94cacf108a329e529bde2b188c5733b64366f92addf
@@ -1,7 +1,7 @@
1
1
  PATH
2
2
  remote: .
3
3
  specs:
4
- dpl (2.0.0.alpha.4)
4
+ dpl (2.0.0.alpha.5)
5
5
  cl (~> 1.0)
6
6
 
7
7
  GEM
data/NOTES.md CHANGED
@@ -66,18 +66,9 @@ x refactor Provider by splitting out a Cmd class for shell commands
66
66
  x document Cmd methods
67
67
  x revisit README and CONTRIBUTING
68
68
  x Make sure failed deployments always fail the build starting with dpl 2.0
69
-
70
- - PR sf-datapipeline
71
-
72
- - add a DSL for moving files out of the way, and moving them back later, e.g. gcs /etc/boto.cfg
73
- - start a CHANGELOG.md?
74
-
75
- - update the docs for the changed netlify provider (Petra's branch?)
76
- - update the docs for the changed openshift provider
77
- - update the docs for the renamed catalyze (now datica) provider
78
- - remove deis from the docs, keep hephy
79
-
80
- Docs
69
+ x PR sf-datapipeline
70
+ x add a DSL for moving files out of the way, and moving them back later, e.g. gcs /etc/boto.cfg
71
+ x start a CHANGELOG.md?
81
72
 
82
73
  - EY docs do not explain where to obtain the api key
83
74
 
data/README.md CHANGED
@@ -39,10 +39,11 @@ Dpl is generally optimized for usage on Linux systems.
39
39
 
40
40
  ## Installation
41
41
 
42
- Installation:
42
+ This version of dpl is currently released as an `alpha` preview release. In
43
+ order to install it, add the `--pre` flag:
43
44
 
44
45
  ```
45
- gem install dpl
46
+ gem install dpl --pre
46
47
  ```
47
48
 
48
49
  ## Usage
@@ -159,17 +160,17 @@ Options:
159
160
 
160
161
  --username USER anynines username (type: string, required: true)
161
162
  --password PASS anynines password (type: string, required: true)
162
- --organization ORG anynines target organization (type: string, required: true)
163
- --space SPACE anynines target space (type: string, required: true)
163
+ --organization ORG anynines organization (type: string, required: true)
164
+ --space SPACE anynines space (type: string, required: true)
164
165
  --app_name APP Application name (type: string)
165
- --buildpack PACK Custom buildpack name or Git URL (type: string)
166
+ --buildpack PACK Buildpack name or Git URL (type: string)
166
167
  --manifest FILE Path to the manifest (type: string)
167
168
 
168
169
  Common Options:
169
170
 
170
- --run CMD Command to execute after the deployment finished successfully (type: array
171
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
172
+ --run CMD Commands to execute after the deployment finished successfully (type: array
171
173
  (string, can be given multiple times))
172
- --cleanup Skip cleaning up build artifacts before the deployment
173
174
  --help Get help on this command
174
175
 
175
176
  Examples:
@@ -226,9 +227,9 @@ Options:
226
227
 
227
228
  Common Options:
228
229
 
229
- --run CMD Command to execute after the deployment finished successfully (type: array
230
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
231
+ --run CMD Commands to execute after the deployment finished successfully (type: array
230
232
  (string, can be given multiple times))
231
- --cleanup Skip cleaning up build artifacts before the deployment
232
233
  --help Get help on this command
233
234
 
234
235
  Examples:
@@ -271,16 +272,16 @@ Options:
271
272
  --file_exists_behavior STR How to handle files that already exist in a deployment target location (type:
272
273
  string, default: disallow, known values: disallow, overwrite, retain)
273
274
  --[no-]wait_until_deployed Wait until the deployment has finished
274
- --bundle_type TYPE type: string
275
- --endpoint ENDPOINT type: string
276
- --key KEY type: string
277
- --description DESCR type: string
275
+ --bundle_type TYPE Bundle type of the revision (type: string)
276
+ --key KEY S3 bucket key of the revision (type: string)
277
+ --description DESCR Description of the revision (type: string)
278
+ --endpoint ENDPOINT S3 endpoint url (type: string)
278
279
 
279
280
  Common Options:
280
281
 
281
- --run CMD Command to execute after the deployment finished successfully (type: array
282
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
283
+ --run CMD Commands to execute after the deployment finished successfully (type: array
282
284
  (string, can be given multiple times))
283
- --cleanup Skip cleaning up build artifacts before the deployment
284
285
  --help Get help on this command
285
286
 
286
287
  Examples:
@@ -327,9 +328,9 @@ Options:
327
328
 
328
329
  Common Options:
329
330
 
330
- --run CMD Command to execute after the deployment finished successfully (type: array
331
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
332
+ --run CMD Commands to execute after the deployment finished successfully (type: array
331
333
  (string, can be given multiple times))
332
- --cleanup Skip cleaning up build artifacts before the deployment
333
334
  --help Get help on this command
334
335
 
335
336
  Examples:
@@ -364,8 +365,8 @@ Options:
364
365
  --region REGION AWS region the Lambda function is running in (type: string, default: us-east-1)
365
366
  --function_name FUNC Name of the Lambda being created or updated (type: string, required: true)
366
367
  --role ROLE ARN of the IAM role to assign to the Lambda function (type: string, note:
367
- required for creating a new function)
368
- --handler_name NAME Function the Lambda calls to begin execution. (type: string, note: required for
368
+ required when creating a new function)
369
+ --handler_name NAME Function the Lambda calls to begin execution. (type: string, note: required when
369
370
  creating a new function)
370
371
  --module_name NAME Name of the module that exports the handler (type: string, requires:
371
372
  handler_name, default: index)
@@ -384,7 +385,7 @@ Options:
384
385
  note: Can be encrypted for added security)
385
386
  --runtime NAME Lambda runtime to use (type: string, default: nodejs8.10, known values: java8,
386
387
  nodejs8.10, nodejs10.x, python2.7, python3.6, python3.7, dotnetcore2.1, go1.x,
387
- ruby2.5)
388
+ ruby2.5, note: required when creating a new function)
388
389
  --dead_letter_arn ARN ARN to an SNS or SQS resource used for the dead letter queue. (type: string)
389
390
  --kms_key_arn ARN KMS key ARN to use to encrypt environment_variables. (type: string)
390
391
  --tracing_mode MODE Tracing mode (type: string, default: PassThrough, known values: Active,
@@ -400,9 +401,9 @@ Options:
400
401
 
401
402
  Common Options:
402
403
 
403
- --run CMD Command to execute after the deployment finished successfully (type: array
404
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
405
+ --run CMD Commands to execute after the deployment finished successfully (type: array
404
406
  (string, can be given multiple times))
405
- --cleanup Skip cleaning up build artifacts before the deployment
406
407
  --help Get help on this command
407
408
 
408
409
  Examples:
@@ -447,9 +448,9 @@ Options:
447
448
 
448
449
  Common Options:
449
450
 
450
- --run CMD Command to execute after the deployment finished successfully (type: array
451
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
452
+ --run CMD Commands to execute after the deployment finished successfully (type: array
451
453
  (string, can be given multiple times))
452
- --cleanup Skip cleaning up build artifacts before the deployment
453
454
  --help Get help on this command
454
455
 
455
456
  Examples:
@@ -485,11 +486,12 @@ Options:
485
486
  --region REGION S3 region (type: string, default: us-east-1)
486
487
  --endpoint URL S3 endpoint (type: string)
487
488
  --upload_dir DIR S3 directory to upload to (type: string)
488
- --storage_class CLASS S3 storage class to upload as (type: string, default: STANDARD, known values:
489
- STANDARD, STANDARD_IA, REDUCED_REDUNDANCY)
490
- --[no-]server_side_encryption Use S3 Server Side Encryption (SSE-AES256)
491
489
  --local_dir DIR Local directory to upload from (type: string, default: ., e.g.: ~/travis/build
492
490
  (absolute path) or ./build (relative path))
491
+ --[no-]dot_match Upload hidden files starting with a dot
492
+ --acl ACL Access control for the uploaded objects (type: string, default: private, known
493
+ values: private, public_read, public_read_write, authenticated_read,
494
+ bucket_owner_read, bucket_owner_full_control)
493
495
  --[no-]detect_encoding HTTP header Content-Encoding for files compressed with gzip and compress
494
496
  utilities
495
497
  --cache_control STR HTTP header Cache-Control to suggest that the browser cache the file (type:
@@ -499,23 +501,22 @@ Options:
499
501
  --expires DATE Date and time that the cached object expires (type: array (string, can be given
500
502
  multiple times), format: /^"?\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2} .+"?.*$/, note:
501
503
  accepts mapping values to globs)
502
- --acl ACL Access control for the uploaded objects (type: string, default: private, known
503
- values: private, public_read, public_read_write, authenticated_read,
504
- bucket_owner_read, bucket_owner_full_control)
505
- --[no-]dot_match Upload hidden files starting with a dot
506
- --index_document_suffix SUFFIX Index document suffix of a S3 website (type: string)
507
504
  --default_text_charset CHARSET Default character set to append to the content-type of text files (type: string)
508
- --max_threads NUM The number of threads to use for S3 file uploads (type: integer, default: 5,
509
- max: 15)
505
+ --storage_class CLASS S3 storage class to upload as (type: string, default: STANDARD, known values:
506
+ STANDARD, STANDARD_IA, REDUCED_REDUNDANCY)
507
+ --[no-]server_side_encryption Use S3 Server Side Encryption (SSE-AES256)
508
+ --index_document_suffix SUFFIX Index document suffix of a S3 website (type: string)
510
509
  --[no-]overwrite Whether or not to overwrite existing files (default: true)
511
510
  --[no-]force_path_style Whether to force keeping the bucket name on the path
511
+ --max_threads NUM The number of threads to use for S3 file uploads (type: integer, default: 5,
512
+ max: 15)
512
513
  --[no-]verbose Be verbose about uploading files
513
514
 
514
515
  Common Options:
515
516
 
516
- --run CMD Command to execute after the deployment finished successfully (type: array
517
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
518
+ --run CMD Commands to execute after the deployment finished successfully (type: array
517
519
  (string, can be given multiple times))
518
- --cleanup Skip cleaning up build artifacts before the deployment
519
520
  --help Get help on this command
520
521
 
521
522
  Examples:
@@ -544,25 +545,25 @@ Description:
544
545
 
545
546
  Options:
546
547
 
547
- --site SITE Web App name (e.g. myapp in myapp.azurewebsites.net) (type: string, required:
548
- true)
549
548
  --username NAME Web App Deployment Username (type: string, required: true)
550
549
  --password PASS Web App Deployment Password (type: string, required: true)
550
+ --site SITE Web App name (e.g. myapp in myapp.azurewebsites.net) (type: string, required:
551
+ true)
551
552
  --slot SLOT Slot name (if your app uses staging deployment) (type: string)
552
553
  --[no-]verbose Print deployment output from Azure. Warning: If authentication fails, Git prints
553
554
  credentials in clear text. Correct credentials remain hidden.
554
555
 
555
556
  Common Options:
556
557
 
557
- --run CMD Command to execute after the deployment finished successfully (type: array
558
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
559
+ --run CMD Commands to execute after the deployment finished successfully (type: array
558
560
  (string, can be given multiple times))
559
- --cleanup Skip cleaning up build artifacts before the deployment
560
561
  --help Get help on this command
561
562
 
562
563
  Examples:
563
564
 
564
- dpl azure_web_apps --site site --username name --password pass
565
- dpl azure_web_apps --site site --username name --password pass --slot slot --verbose
565
+ dpl azure_web_apps --username name --password pass --site site
566
+ dpl azure_web_apps --username name --password pass --site site --slot slot --verbose
566
567
  ```
567
568
 
568
569
  Options can be given via env vars if prefixed with `AZURE_WA_`. E.g. the option `--password` can be
@@ -592,15 +593,15 @@ Options:
592
593
 
593
594
  Common Options:
594
595
 
595
- --run CMD Command to execute after the deployment finished successfully (type: array
596
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
597
+ --run CMD Commands to execute after the deployment finished successfully (type: array
596
598
  (string, can be given multiple times))
597
- --cleanup Skip cleaning up build artifacts before the deployment
598
599
  --help Get help on this command
599
600
 
600
601
  Examples:
601
602
 
602
603
  dpl bintray --user user --key key --file file
603
- dpl bintray --user user --key key --file file --passphrase phrase --run cmd
604
+ dpl bintray --user user --key key --file file --passphrase phrase --cleanup
604
605
  ```
605
606
 
606
607
  Options can be given via env vars if prefixed with `BINTRAY_`. E.g. the option `--key` can be given
@@ -625,21 +626,21 @@ Options:
625
626
 
626
627
  --username USER Bluemix username (type: string, required: true)
627
628
  --password PASS Bluemix password (type: string, required: true)
628
- --organization ORG Bluemix target organization (type: string, required: true)
629
- --space SPACE Bluemix target space (type: string, required: true)
629
+ --organization ORG Bluemix organization (type: string, required: true)
630
+ --space SPACE Bluemix space (type: string, required: true)
630
631
  --region REGION Bluemix region (type: string, default: ng, known values: ng, eu-gb, eu-de,
631
632
  au-syd)
632
633
  --api URL Bluemix api URL (type: string)
633
634
  --app_name APP Application name (type: string)
634
- --buildpack PACK Custom buildpack name or Git URL (type: string)
635
+ --buildpack PACK Buildpack name or Git URL (type: string)
635
636
  --manifest FILE Path to the manifest (type: string)
636
637
  --[no-]skip_ssl_validation Skip SSL validation
637
638
 
638
639
  Common Options:
639
640
 
640
- --run CMD Command to execute after the deployment finished successfully (type: array
641
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
642
+ --run CMD Commands to execute after the deployment finished successfully (type: array
641
643
  (string, can be given multiple times))
642
- --cleanup Skip cleaning up build artifacts before the deployment
643
644
  --help Get help on this command
644
645
 
645
646
  Examples:
@@ -670,24 +671,24 @@ Options:
670
671
 
671
672
  --user USER type: string, required: true
672
673
  --secret SECRET type: string, required: true
673
- --config_file FILE type: string, alias: configfile (deprecated, please use config_file)
674
674
  --payload PAYLOAD type: string
675
675
  --app APP type: string
676
676
  --version VERSION type: string
677
677
  --env ENV type: string
678
+ --config_file FILE type: string, alias: configfile (deprecated, please use config_file)
678
679
  --extra_args ARGS type: string
679
680
 
680
681
  Common Options:
681
682
 
682
- --run CMD Command to execute after the deployment finished successfully (type: array
683
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
684
+ --run CMD Commands to execute after the deployment finished successfully (type: array
683
685
  (string, can be given multiple times))
684
- --cleanup Skip cleaning up build artifacts before the deployment
685
686
  --help Get help on this command
686
687
 
687
688
  Examples:
688
689
 
689
690
  dpl boxfuse --user user --secret secret
690
- dpl boxfuse --user user --secret secret --config_file file --payload payload --app app
691
+ dpl boxfuse --user user --secret secret --payload payload --app app --version version
691
692
  ```
692
693
 
693
694
  Options can be given via env vars if prefixed with `BOXFUSE_`. E.g. the option `--secret` can be
@@ -710,19 +711,20 @@ Description:
710
711
 
711
712
  Options:
712
713
 
713
- --token TOKEN Cargo registry API token (type: string, required: true)
714
+ --token TOKEN Cargo registry API token (type: string, required: true)
715
+ --[no-]allow_dirty Allow publishing from a dirty git working directory
714
716
 
715
717
  Common Options:
716
718
 
717
- --run CMD Command to execute after the deployment finished successfully (type: array
718
- (string, can be given multiple times))
719
- --cleanup Skip cleaning up build artifacts before the deployment
720
- --help Get help on this command
719
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
720
+ --run CMD Commands to execute after the deployment finished successfully (type: array
721
+ (string, can be given multiple times))
722
+ --help Get help on this command
721
723
 
722
724
  Examples:
723
725
 
724
726
  dpl cargo --token token
725
- dpl cargo --token token --run cmd --cleanup
727
+ dpl cargo --token token --allow_dirty --cleanup --run cmd
726
728
  ```
727
729
 
728
730
  Options can be given via env vars if prefixed with `CARGO_`. E.g. the option `--token` can be given
@@ -746,25 +748,25 @@ Description:
746
748
  Options:
747
749
 
748
750
  --user_id ID Chef Supermarket user name (type: string, required: true)
749
- --client_key KEY Client API key file name (type: string, required: true)
750
751
  --name NAME Cookbook name (type: string, alias: cookbook_name (deprecated, please use name),
751
752
  note: defaults to the name given in metadata.json or metadata.rb)
752
753
  --category CAT Cookbook category in Supermarket (type: string, required: true, alias:
753
754
  cookbook_category (deprecated, please use category), see:
754
755
  https://docs.getchef.com/knife_cookbook_site.html#id12)
756
+ --client_key KEY Client API key file name (type: string, default: client.pem)
755
757
  --dir DIR Directory containing the cookbook (type: string, default: .)
756
758
 
757
759
  Common Options:
758
760
 
759
- --run CMD Command to execute after the deployment finished successfully (type: array
761
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
762
+ --run CMD Commands to execute after the deployment finished successfully (type: array
760
763
  (string, can be given multiple times))
761
- --cleanup Skip cleaning up build artifacts before the deployment
762
764
  --help Get help on this command
763
765
 
764
766
  Examples:
765
767
 
766
- dpl chef_supermarket --user_id id --client_key key --category cat
767
- dpl chef_supermarket --user_id id --client_key key --category cat --name name --dir dir
768
+ dpl chef_supermarket --user_id id --category cat
769
+ dpl chef_supermarket --user_id id --category cat --name name --client_key key --dir dir
768
770
  ```
769
771
 
770
772
  Options can be given via env vars if prefixed with `CHEF_`.
@@ -797,9 +799,9 @@ Options:
797
799
 
798
800
  Common Options:
799
801
 
800
- --run CMD Command to execute after the deployment finished successfully (type: array
802
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
803
+ --run CMD Commands to execute after the deployment finished successfully (type: array
801
804
  (string, can be given multiple times))
802
- --cleanup Skip cleaning up build artifacts before the deployment
803
805
  --help Get help on this command
804
806
 
805
807
  Examples:
@@ -830,24 +832,25 @@ Options:
830
832
 
831
833
  --username USER Cloud Foundry username (type: string, required: true)
832
834
  --password PASS Cloud Foundry password (type: string, required: true)
833
- --organization ORG Cloud Foundry target organization (type: string, required: true)
834
- --space SPACE Cloud Foundry target space (type: string, required: true)
835
- --api URL Cloud Foundry api URL (type: string, required: true)
835
+ --organization ORG Cloud Foundry organization (type: string, required: true)
836
+ --space SPACE Cloud Foundry space (type: string, required: true)
837
+ --api URL Cloud Foundry api URL (type: string, default: https://api.run.pivotal.io)
836
838
  --app_name APP Application name (type: string)
837
- --buildpack PACK Custom buildpack name or Git URL (type: string)
839
+ --buildpack PACK Buildpack name or Git URL (type: string)
838
840
  --manifest FILE Path to the manifest (type: string)
839
841
  --[no-]skip_ssl_validation Skip SSL validation
840
842
  --[no-]v3 Use the v3 API version to push the application
841
843
 
842
844
  Common Options:
843
845
 
844
- --run CMD Command to execute after the deployment finished successfully (type: array
846
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
847
+ --run CMD Commands to execute after the deployment finished successfully (type: array
845
848
  (string, can be given multiple times))
846
- --cleanup Skip cleaning up build artifacts before the deployment
847
849
  --help Get help on this command
848
850
 
849
851
  Examples:
850
852
 
853
+ dpl cloudfoundry --username user --password pass --organization org --space space
851
854
  dpl cloudfoundry --username user --password pass --organization org --space space --api url
852
855
  ```
853
856
 
@@ -875,15 +878,15 @@ Options:
875
878
 
876
879
  Common Options:
877
880
 
878
- --run CMD Command to execute after the deployment finished successfully (type: array
881
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
882
+ --run CMD Commands to execute after the deployment finished successfully (type: array
879
883
  (string, can be given multiple times))
880
- --cleanup Skip cleaning up build artifacts before the deployment
881
884
  --help Get help on this command
882
885
 
883
886
  Examples:
884
887
 
885
888
  dpl cloud66 --redeployment_hook url
886
- dpl cloud66 --redeployment_hook url --run cmd --cleanup
889
+ dpl cloud66 --redeployment_hook url --cleanup --run cmd
887
890
  ```
888
891
 
889
892
  Options can be given via env vars if prefixed with `CLOUD66_`. E.g. the option `--redeployment_hook`
@@ -921,9 +924,9 @@ Options:
921
924
 
922
925
  Common Options:
923
926
 
924
- --run CMD Command to execute after the deployment finished successfully (type: array
927
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
928
+ --run CMD Commands to execute after the deployment finished successfully (type: array
925
929
  (string, can be given multiple times))
926
- --cleanup Skip cleaning up build artifacts before the deployment
927
930
  --help Get help on this command
928
931
 
929
932
  Examples:
@@ -956,15 +959,15 @@ Options:
956
959
 
957
960
  Common Options:
958
961
 
959
- --run CMD Command to execute after the deployment finished successfully (type: array
962
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
963
+ --run CMD Commands to execute after the deployment finished successfully (type: array
960
964
  (string, can be given multiple times))
961
- --cleanup Skip cleaning up build artifacts before the deployment
962
965
  --help Get help on this command
963
966
 
964
967
  Examples:
965
968
 
966
969
  dpl datica --target target
967
- dpl datica --target target --path path --run cmd --cleanup
970
+ dpl datica --target target --path path --cleanup --run cmd
968
971
  ```
969
972
 
970
973
  Options can be given via env vars if prefixed with `[CATALYZE_|DATICA_]`.
@@ -988,7 +991,8 @@ Options:
988
991
 
989
992
  Either api_key, or email and password are required.
990
993
 
991
- --api_key KEY Engine Yard API key (type: string)
994
+ --api_key KEY Engine Yard API key (type: string, note: can be obtained at
995
+ https://cloud.engineyard.com/cli)
992
996
  --email EMAIL Engine Yard account email (type: string)
993
997
  --password PASS Engine Yard password (type: string)
994
998
  --app APP Engine Yard application name (type: string, default: repo name)
@@ -998,9 +1002,9 @@ Options:
998
1002
 
999
1003
  Common Options:
1000
1004
 
1001
- --run CMD Command to execute after the deployment finished successfully (type: array
1005
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1006
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1002
1007
  (string, can be given multiple times))
1003
- --cleanup Skip cleaning up build artifacts before the deployment
1004
1008
  --help Get help on this command
1005
1009
 
1006
1010
  Examples:
@@ -1041,9 +1045,9 @@ Options:
1041
1045
 
1042
1046
  Common Options:
1043
1047
 
1044
- --run CMD Command to execute after the deployment finished successfully (type: array
1048
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1049
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1045
1050
  (string, can be given multiple times))
1046
- --cleanup Skip cleaning up build artifacts before the deployment
1047
1051
  --help Get help on this command
1048
1052
 
1049
1053
  Examples:
@@ -1098,9 +1102,11 @@ Options:
1098
1102
 
1099
1103
  Common Options:
1100
1104
 
1101
- --run CMD Command to execute after the deployment finished successfully (type: array
1105
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1106
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1102
1107
  (string, can be given multiple times))
1103
- --cleanup Skip cleaning up build artifacts before the deployment
1108
+ --strategy NAME GitHub Pages deployment strategy (type: string, default: git, known values: api,
1109
+ git)
1104
1110
  --help Get help on this command
1105
1111
 
1106
1112
  Examples:
@@ -1115,7 +1121,7 @@ be given as `GITHUB_TOKEN=<token>` or `PAGES_TOKEN=<token>`.
1115
1121
 
1116
1122
  ### GitHub Pages (API)
1117
1123
 
1118
- Support for deployments to GitHub Pages (API) is in **alpha**. Please see [Maturity Levels](https://github.com/travis-ci/dpl/#maturity-levels) for details.
1124
+ Support for deployments to GitHub Pages (API) is in **development**. Please see [Maturity Levels](https://github.com/travis-ci/dpl/#maturity-levels) for details.
1119
1125
 
1120
1126
  ```
1121
1127
  Usage: dpl pages api [options]
@@ -1137,21 +1143,23 @@ Description:
1137
1143
 
1138
1144
  Options:
1139
1145
 
1140
- --repo SLUG GitHub repo slug (type: string, default: repo slug)
1141
- --token TOKEN GitHub oauth token with repo permission (type: string, required: true, alias:
1142
- github_token)
1146
+ --repo SLUG GitHub repo slug (type: string, default: repo slug)
1147
+ --token TOKEN GitHub oauth token with repo permission (type: string, required: true, alias:
1148
+ github_token)
1143
1149
 
1144
1150
  Common Options:
1145
1151
 
1146
- --run CMD Command to execute after the deployment finished successfully (type: array
1147
- (string, can be given multiple times))
1148
- --cleanup Skip cleaning up build artifacts before the deployment
1149
- --help Get help on this command
1152
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1153
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1154
+ (string, can be given multiple times))
1155
+ --strategy NAME GitHub Pages deployment strategy (type: string, default: git, known values: api,
1156
+ git)
1157
+ --help Get help on this command
1150
1158
 
1151
1159
  Examples:
1152
1160
 
1153
1161
  dpl pages api --token token
1154
- dpl pages api --token token --repo slug --run cmd --cleanup
1162
+ dpl pages api --token token --repo slug --cleanup --run cmd --strategy api
1155
1163
  ```
1156
1164
 
1157
1165
  Options can be given via env vars if prefixed with `[GITHUB_|PAGES_]`. E.g. the option `--token` can
@@ -1174,9 +1182,10 @@ Description:
1174
1182
 
1175
1183
  Options:
1176
1184
 
1177
- Either api_key, or user and password are required.
1185
+ Either token, or username and password are required.
1178
1186
 
1179
- --api_key TOKEN GitHub oauth token (needs public_repo or repo permission) (type: string)
1187
+ --token TOKEN GitHub oauth token (needs public_repo or repo permission) (type: string, alias:
1188
+ api_key)
1180
1189
  --username LOGIN GitHub login name (type: string, alias: user)
1181
1190
  --password PASS GitHub password (type: string)
1182
1191
  --repo SLUG GitHub repo slug (type: string, default: repo slug)
@@ -1196,20 +1205,20 @@ Options:
1196
1205
 
1197
1206
  Common Options:
1198
1207
 
1199
- --run CMD Command to execute after the deployment finished successfully (type: array
1208
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1209
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1200
1210
  (string, can be given multiple times))
1201
- --cleanup Skip cleaning up build artifacts before the deployment
1202
1211
  --help Get help on this command
1203
1212
 
1204
1213
  Examples:
1205
1214
 
1206
- dpl releases --api_key token
1207
- dpl releases --password pass
1208
- dpl releases --api_key token --username login --repo slug --file glob --file_glob
1215
+ dpl releases --token token
1216
+ dpl releases --username login --password pass
1217
+ dpl releases --token token --repo slug --file glob --file_glob --overwrite
1209
1218
  ```
1210
1219
 
1211
- Options can be given via env vars if prefixed with `[GITHUB_|RELEASES_]`. E.g. the option
1212
- `--api_key` can be given as `GITHUB_API_KEY=<api_key>` or `RELEASES_API_KEY=<api_key>`.
1220
+ Options can be given via env vars if prefixed with `[GITHUB_|RELEASES_]`. E.g. the option `--token`
1221
+ can be given as `GITHUB_TOKEN=<token>` or `RELEASES_TOKEN=<token>`.
1213
1222
 
1214
1223
  ### Gleis
1215
1224
 
@@ -1237,9 +1246,9 @@ Options:
1237
1246
 
1238
1247
  Common Options:
1239
1248
 
1240
- --run CMD Command to execute after the deployment finished successfully (type: array
1249
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1250
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1241
1251
  (string, can be given multiple times))
1242
- --cleanup Skip cleaning up build artifacts before the deployment
1243
1252
  --help Get help on this command
1244
1253
 
1245
1254
  Examples:
@@ -1280,15 +1289,15 @@ Options:
1280
1289
  you do not specify a version, one will be generated for you (type: string)
1281
1290
  --verbosity LEVEL Adjust the log verbosity (type: string, default: warning)
1282
1291
  --[no-]promote Do not promote the deployed version (default: true)
1283
- --[no-]stop_previous_version Prevent your deployment from stopping the previously promoted version. This is
1284
- from the future, so might not work (yet). (default: true)
1292
+ --[no-]stop_previous_version Prevent the deployment from stopping a previously promoted version (default:
1293
+ true)
1285
1294
  --[no-]install_sdk Do not install the Google Cloud SDK (default: true)
1286
1295
 
1287
1296
  Common Options:
1288
1297
 
1289
- --run CMD Command to execute after the deployment finished successfully (type: array
1298
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1299
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1290
1300
  (string, can be given multiple times))
1291
- --cleanup Skip cleaning up build artifacts before the deployment
1292
1301
  --help Get help on this command
1293
1302
 
1294
1303
  Examples:
@@ -1317,29 +1326,38 @@ Description:
1317
1326
 
1318
1327
  Options:
1319
1328
 
1320
- --access_key_id ID GCS Interoperable Access Key ID (type: string, required: true)
1321
- --secret_access_key KEY GCS Interoperable Access Secret (type: string, required: true)
1329
+ Either key_file, or access_key_id and secret_access_key are required.
1330
+
1331
+ --key_file FILE Path to a GCS service account key JSON file (type: string)
1332
+ --access_key_id ID GCS Interoperable Access Key ID (type: string)
1333
+ --secret_access_key KEY GCS Interoperable Access Secret (type: string)
1322
1334
  --bucket BUCKET GCS Bucket (type: string, required: true)
1323
1335
  --local_dir DIR Local directory to upload from (type: string, default: .)
1324
1336
  --upload_dir DIR GCS directory to upload to (type: string)
1325
1337
  --[no-]dot_match Upload hidden files starting with a dot
1326
- --acl ACL Access control to set for uploaded objects (type: string)
1338
+ --acl ACL Access control to set for uploaded objects (type: string, default: private,
1339
+ known values: private, public-read, public-read-write, authenticated-read,
1340
+ bucket-owner-read, bucket-owner-full-control, see:
1341
+ https://cloud.google.com/storage/docs/reference-headers#xgoogacl)
1327
1342
  --[no-]detect_encoding HTTP header Content-Encoding to set for files compressed with gzip and compress
1328
1343
  utilities.
1329
1344
  --cache_control HEADER HTTP header Cache-Control to suggest that the browser cache the file. (type:
1330
- string)
1345
+ string, see:
1346
+ https://cloud.google.com/storage/docs/xml-api/reference-headers#cachecontrol)
1331
1347
 
1332
1348
  Common Options:
1333
1349
 
1334
- --run CMD Command to execute after the deployment finished successfully (type: array
1350
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1351
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1335
1352
  (string, can be given multiple times))
1336
- --cleanup Skip cleaning up build artifacts before the deployment
1337
1353
  --help Get help on this command
1338
1354
 
1339
1355
  Examples:
1340
1356
 
1341
- dpl gcs --access_key_id id --secret_access_key key --bucket bucket
1342
- dpl gcs --access_key_id id --secret_access_key key --bucket bucket --local_dir dir --upload_dir dir
1357
+ dpl gcs --bucket bucket --key_file file
1358
+ dpl gcs --bucket bucket --access_key_id id --secret_access_key key
1359
+ dpl gcs --bucket bucket
1360
+ dpl gcs --bucket bucket --key_file file --local_dir dir --upload_dir dir --dot_match
1343
1361
  ```
1344
1362
 
1345
1363
  Options can be given via env vars if prefixed with `GCS_`. E.g. the option `--access_key_id` can be
@@ -1368,15 +1386,15 @@ Options:
1368
1386
 
1369
1387
  Common Options:
1370
1388
 
1371
- --run CMD Command to execute after the deployment finished successfully (type: array
1389
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1390
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1372
1391
  (string, can be given multiple times))
1373
- --cleanup Skip cleaning up build artifacts before the deployment
1374
1392
  --help Get help on this command
1375
1393
 
1376
1394
  Examples:
1377
1395
 
1378
1396
  dpl hackage --username user --password user
1379
- dpl hackage --username user --password user --publish --run cmd --cleanup
1397
+ dpl hackage --username user --password user --publish --cleanup --run cmd
1380
1398
  ```
1381
1399
 
1382
1400
  Options can be given via env vars if prefixed with `HACKAGE_`. E.g. the option `--password` can be
@@ -1403,14 +1421,14 @@ Options:
1403
1421
  --username USER Hephy username (type: string, required: true)
1404
1422
  --password PASS Hephy password (type: string, required: true)
1405
1423
  --app APP Deis app (type: string, required: true)
1406
- --cli_version VER Install a specific hephy cli version (type: string, default: stable)
1424
+ --cli_version VER Install a specific Hephy CLI version (type: string, default: stable)
1407
1425
  --[no-]verbose Verbose log output
1408
1426
 
1409
1427
  Common Options:
1410
1428
 
1411
- --run CMD Command to execute after the deployment finished successfully (type: array
1429
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1430
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1412
1431
  (string, can be given multiple times))
1413
- --cleanup Skip cleaning up build artifacts before the deployment
1414
1432
  --help Get help on this command
1415
1433
 
1416
1434
  Examples:
@@ -1439,20 +1457,21 @@ Description:
1439
1457
 
1440
1458
  Options:
1441
1459
 
1442
- --api_key KEY Heroku API key (type: string, required: true)
1460
+ --api_key KEY Heroku API key (type: string, required: true)
1443
1461
 
1444
1462
  Common Options:
1445
1463
 
1446
- --run CMD Command to execute after the deployment finished successfully (type: array
1447
- (string, can be given multiple times))
1448
- --cleanup Skip cleaning up build artifacts before the deployment
1449
- --app APP Heroku app name (type: string, default: repo name)
1450
- --help Get help on this command
1464
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1465
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1466
+ (string, can be given multiple times))
1467
+ --strategy NAME Heroku deployment strategy (type: string, default: api, known values: api, git)
1468
+ --app APP Heroku app name (type: string, default: repo name)
1469
+ --help Get help on this command
1451
1470
 
1452
1471
  Examples:
1453
1472
 
1454
1473
  dpl heroku api --api_key key
1455
- dpl heroku api --api_key key --run cmd --cleanup --app app
1474
+ dpl heroku api --api_key key --cleanup --run cmd --strategy api --app app
1456
1475
  ```
1457
1476
 
1458
1477
  Options can be given via env vars if prefixed with `HEROKU_`. E.g. the option `--api_key` can be
@@ -1480,13 +1499,14 @@ Options:
1480
1499
  --api_key KEY Heroku API key (type: string)
1481
1500
  --username USER Heroku username (type: string, alias: user)
1482
1501
  --password PASS Heroku password (type: string)
1483
- --git URL type: string
1502
+ --git URL Heroku Git remote URL (type: string)
1484
1503
 
1485
1504
  Common Options:
1486
1505
 
1487
- --run CMD Command to execute after the deployment finished successfully (type: array
1506
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1507
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1488
1508
  (string, can be given multiple times))
1489
- --cleanup Skip cleaning up build artifacts before the deployment
1509
+ --strategy NAME Heroku deployment strategy (type: string, default: api, known values: api, git)
1490
1510
  --app APP Heroku app name (type: string, default: repo name)
1491
1511
  --help Get help on this command
1492
1512
 
@@ -1494,7 +1514,7 @@ Examples:
1494
1514
 
1495
1515
  dpl heroku git --api_key key
1496
1516
  dpl heroku git --username user --password pass
1497
- dpl heroku git --api_key key --git url --run cmd --cleanup --app app
1517
+ dpl heroku git --api_key key --git url --cleanup --run cmd --strategy api
1498
1518
  ```
1499
1519
 
1500
1520
  Options can be given via env vars if prefixed with `HEROKU_`. E.g. the option `--api_key` can be
@@ -1517,21 +1537,21 @@ Description:
1517
1537
 
1518
1538
  Options:
1519
1539
 
1520
- --slug SLUG Launchpad project slug (type: string, format: /^~[^\/]+\/[^\/]+\/[^\/]+$/, e.g.:
1521
- ~user-name/project-name/branch-name)
1522
1540
  --oauth_token TOKEN Launchpad OAuth token (type: string)
1523
1541
  --oauth_token_secret SECRET Launchpad OAuth token secret (type: string)
1542
+ --slug SLUG Launchpad project slug (type: string, format: /^~[^\/]+\/[^\/]+\/[^\/]+$/, e.g.:
1543
+ ~user-name/project-name/branch-name)
1524
1544
 
1525
1545
  Common Options:
1526
1546
 
1527
- --run CMD Command to execute after the deployment finished successfully (type: array
1547
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1548
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1528
1549
  (string, can be given multiple times))
1529
- --cleanup Skip cleaning up build artifacts before the deployment
1530
1550
  --help Get help on this command
1531
1551
 
1532
1552
  Examples:
1533
1553
 
1534
- dpl launchpad --slug slug --oauth_token token --oauth_token_secret secret --run cmd --cleanup
1554
+ dpl launchpad --oauth_token token --oauth_token_secret secret --slug slug --cleanup --run cmd
1535
1555
  ```
1536
1556
 
1537
1557
  Options can be given via env vars if prefixed with `LAUNCHPAD_`. E.g. the option `--oauth_token` can
@@ -1563,9 +1583,9 @@ Options:
1563
1583
 
1564
1584
  Common Options:
1565
1585
 
1566
- --run CMD Command to execute after the deployment finished successfully (type: array
1586
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1587
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1567
1588
  (string, can be given multiple times))
1568
- --cleanup Skip cleaning up build artifacts before the deployment
1569
1589
  --help Get help on this command
1570
1590
 
1571
1591
  Examples:
@@ -1606,9 +1626,9 @@ Options:
1606
1626
 
1607
1627
  Common Options:
1608
1628
 
1609
- --run CMD Command to execute after the deployment finished successfully (type: array
1629
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1630
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1610
1631
  (string, can be given multiple times))
1611
- --cleanup Skip cleaning up build artifacts before the deployment
1612
1632
  --help Get help on this command
1613
1633
 
1614
1634
  Examples:
@@ -1644,15 +1664,15 @@ Options:
1644
1664
 
1645
1665
  Common Options:
1646
1666
 
1647
- --run CMD Command to execute after the deployment finished successfully (type: array
1667
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1668
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1648
1669
  (string, can be given multiple times))
1649
- --cleanup Skip cleaning up build artifacts before the deployment
1650
1670
  --help Get help on this command
1651
1671
 
1652
1672
  Examples:
1653
1673
 
1654
1674
  dpl openshift --server server --token token --project project
1655
- dpl openshift --server server --token token --project project --app app --run cmd
1675
+ dpl openshift --server server --token token --project project --app app --cleanup
1656
1676
  ```
1657
1677
 
1658
1678
  Options can be given via env vars if prefixed with `OPENSHIFT_`. E.g. the option `--token` can be
@@ -1690,9 +1710,9 @@ Options:
1690
1710
 
1691
1711
  Common Options:
1692
1712
 
1693
- --run CMD Command to execute after the deployment finished successfully (type: array
1713
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1714
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1694
1715
  (string, can be given multiple times))
1695
- --cleanup Skip cleaning up build artifacts before the deployment
1696
1716
  --help Get help on this command
1697
1717
 
1698
1718
  Examples:
@@ -1728,15 +1748,15 @@ Options:
1728
1748
 
1729
1749
  Common Options:
1730
1750
 
1731
- --run CMD Command to execute after the deployment finished successfully (type: array
1751
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1752
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1732
1753
  (string, can be given multiple times))
1733
- --cleanup Skip cleaning up build artifacts before the deployment
1734
1754
  --help Get help on this command
1735
1755
 
1736
1756
  Examples:
1737
1757
 
1738
1758
  dpl puppetforge --username name --password pass
1739
- dpl puppetforge --username name --password pass --url url --run cmd --cleanup
1759
+ dpl puppetforge --username name --password pass --url url --cleanup --run cmd
1740
1760
  ```
1741
1761
 
1742
1762
  Options can be given via env vars if prefixed with `PUPPETFORGE_`. E.g. the option `--password` can
@@ -1778,9 +1798,9 @@ Options:
1778
1798
 
1779
1799
  Common Options:
1780
1800
 
1781
- --run CMD Command to execute after the deployment finished successfully (type: array
1801
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1802
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1782
1803
  (string, can be given multiple times))
1783
- --cleanup Skip cleaning up build artifacts before the deployment
1784
1804
  --help Get help on this command
1785
1805
 
1786
1806
  Examples:
@@ -1809,7 +1829,7 @@ Description:
1809
1829
 
1810
1830
  Options:
1811
1831
 
1812
- Either api_key, or user and password are required.
1832
+ Either api_key, or username and password are required.
1813
1833
 
1814
1834
  --api_key KEY Rubygems api key (type: string)
1815
1835
  --username USER Rubygems user name (type: string, alias: user)
@@ -1822,16 +1842,16 @@ Options:
1822
1842
 
1823
1843
  Common Options:
1824
1844
 
1825
- --run CMD Command to execute after the deployment finished successfully (type: array
1845
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1846
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1826
1847
  (string, can be given multiple times))
1827
- --cleanup Skip cleaning up build artifacts before the deployment
1828
1848
  --help Get help on this command
1829
1849
 
1830
1850
  Examples:
1831
1851
 
1832
1852
  dpl rubygems --api_key key
1833
- dpl rubygems --password pass
1834
- dpl rubygems --api_key key --username user --gem name --gemspec file --gemspec_glob glob
1853
+ dpl rubygems --username user --password pass
1854
+ dpl rubygems --api_key key --gem name --gemspec file --gemspec_glob glob --host url
1835
1855
  ```
1836
1856
 
1837
1857
  Options can be given via env vars if prefixed with `RUBYGEMS_`. E.g. the option `--api_key` can be
@@ -1869,9 +1889,9 @@ Options:
1869
1889
 
1870
1890
  Common Options:
1871
1891
 
1872
- --run CMD Command to execute after the deployment finished successfully (type: array
1892
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1893
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1873
1894
  (string, can be given multiple times))
1874
- --cleanup Skip cleaning up build artifacts before the deployment
1875
1895
  --help Get help on this command
1876
1896
 
1877
1897
  Examples:
@@ -1914,15 +1934,15 @@ Options:
1914
1934
 
1915
1935
  Common Options:
1916
1936
 
1917
- --run CMD Command to execute after the deployment finished successfully (type: array
1937
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1938
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1918
1939
  (string, can be given multiple times))
1919
- --cleanup Skip cleaning up build artifacts before the deployment
1920
1940
  --help Get help on this command
1921
1941
 
1922
1942
  Examples:
1923
1943
 
1924
1944
  dpl script --script script
1925
- dpl script --script script --run cmd --cleanup
1945
+ dpl script --script script --cleanup --run cmd
1926
1946
  ```
1927
1947
 
1928
1948
 
@@ -1950,15 +1970,15 @@ Options:
1950
1970
 
1951
1971
  Common Options:
1952
1972
 
1953
- --run CMD Command to execute after the deployment finished successfully (type: array
1973
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
1974
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1954
1975
  (string, can be given multiple times))
1955
- --cleanup Skip cleaning up build artifacts before the deployment
1956
1976
  --help Get help on this command
1957
1977
 
1958
1978
  Examples:
1959
1979
 
1960
1980
  dpl snap --token token
1961
- dpl snap --token token --snap str --channel chan --run cmd --cleanup
1981
+ dpl snap --token token --snap str --channel chan --cleanup --run cmd
1962
1982
  ```
1963
1983
 
1964
1984
  Options can be given via env vars if prefixed with `SNAP_`. E.g. the option `--token` can be given
@@ -1991,15 +2011,15 @@ Options:
1991
2011
 
1992
2012
  Common Options:
1993
2013
 
1994
- --run CMD Command to execute after the deployment finished successfully (type: array
2014
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
2015
+ --run CMD Commands to execute after the deployment finished successfully (type: array
1995
2016
  (string, can be given multiple times))
1996
- --cleanup Skip cleaning up build artifacts before the deployment
1997
2017
  --help Get help on this command
1998
2018
 
1999
2019
  Examples:
2000
2020
 
2001
2021
  dpl surge --login email --token token
2002
- dpl surge --login email --token token --domain name --project path --run cmd
2022
+ dpl surge --login email --token token --domain name --project path --cleanup
2003
2023
  ```
2004
2024
 
2005
2025
  Options can be given via env vars if prefixed with `SURGE_`. E.g. the option `--token` can be given
@@ -2034,9 +2054,9 @@ Options:
2034
2054
 
2035
2055
  Common Options:
2036
2056
 
2037
- --run CMD Command to execute after the deployment finished successfully (type: array
2057
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
2058
+ --run CMD Commands to execute after the deployment finished successfully (type: array
2038
2059
  (string, can be given multiple times))
2039
- --cleanup Skip cleaning up build artifacts before the deployment
2040
2060
  --help Get help on this command
2041
2061
 
2042
2062
  Examples:
@@ -2075,16 +2095,16 @@ Options:
2075
2095
 
2076
2096
  Common Options:
2077
2097
 
2078
- --run CMD Command to execute after the deployment finished successfully (type: array
2098
+ --cleanup Clean up build artifacts from the Git working directory before the deployment
2099
+ --run CMD Commands to execute after the deployment finished successfully (type: array
2079
2100
  (string, can be given multiple times))
2080
- --cleanup Skip cleaning up build artifacts before the deployment
2081
2101
  --help Get help on this command
2082
2102
 
2083
2103
  Examples:
2084
2104
 
2085
2105
  dpl transifex --api_token token
2086
2106
  dpl transifex --username name --password pass
2087
- dpl transifex --api_token token --hostname name --cli_version ver --run cmd --cleanup
2107
+ dpl transifex --api_token token --hostname name --cli_version ver --cleanup --run cmd
2088
2108
  ```
2089
2109
 
2090
2110
  Options can be given via env vars if prefixed with `TRANSIFEX_`. E.g. the option `--api_token` can
@@ -39,10 +39,11 @@ Dpl is generally optimized for usage on Linux systems.
39
39
 
40
40
  ## Installation
41
41
 
42
- Installation:
42
+ This version of dpl is currently released as an `alpha` preview release. In
43
+ order to install it, add the `--pre` flag:
43
44
 
44
45
  ```
45
- gem install dpl
46
+ gem install dpl --pre
46
47
  ```
47
48
 
48
49
  ## Usage
@@ -141,7 +141,8 @@ module Dpl
141
141
 
142
142
  def files
143
143
  files = Dir.glob('**/*', File::FNM_DOTMATCH)
144
- files = filter(files, '.ebignore') if file?('.ebignore')
144
+ ignore = %w(.ebignore .gitignore).detect { |file| file?(file) }
145
+ files = filter(files, ignore) if ignore
145
146
  files
146
147
  end
147
148
 
@@ -13,7 +13,7 @@ module Dpl
13
13
 
14
14
  env :engineyard, :ey
15
15
 
16
- opt '--api_key KEY', 'Engine Yard API key', secret: true
16
+ opt '--api_key KEY', 'Engine Yard API key', secret: true, note: 'can be obtained at https://cloud.engineyard.com/cli'
17
17
  opt '--email EMAIL', 'Engine Yard account email'
18
18
  opt '--password PASS', 'Engine Yard password', secret: true
19
19
  opt '--app APP', 'Engine Yard application name', default: :repo_name
@@ -17,8 +17,11 @@ module Dpl
17
17
 
18
18
  env :gcs
19
19
 
20
- opt '--access_key_id ID', 'GCS Interoperable Access Key ID', required: true, secret: true
21
- opt '--secret_access_key KEY', 'GCS Interoperable Access Secret', required: true, secret: true
20
+ required :key_file, [:access_key_id, :secret_access_key]
21
+
22
+ opt '--key_file FILE', 'Path to a GCS service account key JSON file'
23
+ opt '--access_key_id ID', 'GCS Interoperable Access Key ID', secret: true
24
+ opt '--secret_access_key KEY', 'GCS Interoperable Access Secret', secret: true
22
25
  opt '--bucket BUCKET', 'GCS Bucket', required: true
23
26
  opt '--local_dir DIR', 'Local directory to upload from', default: '.'
24
27
  opt '--upload_dir DIR', 'GCS directory to upload to'
@@ -27,10 +30,12 @@ module Dpl
27
30
  opt '--detect_encoding', 'HTTP header Content-Encoding to set for files compressed with gzip and compress utilities.'
28
31
  opt '--cache_control HEADER', 'HTTP header Cache-Control to suggest that the browser cache the file.', see: 'https://cloud.google.com/storage/docs/xml-api/reference-headers#cachecontrol'
29
32
 
30
- cmds install: 'curl -L %{URL} | tar xz -C ~ && ~/google-cloud-sdk/install.sh --path-update false --usage-reporting false --command-completion false',
31
- copy: 'gsutil %{gs_opts}cp %{copy_opts}-r %{source} %{target}'
33
+ cmds install: 'curl -L %{URL} | tar xz -C ~ && ~/google-cloud-sdk/install.sh --path-update false --usage-reporting false --command-completion false',
34
+ login_key: 'gcloud auth activate-service-account --key-file=%{key_file}',
35
+ copy: 'gsutil %{gs_opts}cp %{copy_opts}-r %{source} %{target}'
32
36
 
33
- msgs login: 'Authenticating with access key: %{access_key_id}'
37
+ msgs login_key: 'Authenticating with service account key file %{key_file}',
38
+ login_creds: 'Authenticating with access key: %{access_key_id}'
34
39
 
35
40
  errs copy: 'Failed uploading files.'
36
41
 
@@ -50,8 +55,7 @@ module Dpl
50
55
  end
51
56
 
52
57
  def login
53
- info :login
54
- write_boto
58
+ key_file? ? login_key : login_creds
55
59
  end
56
60
 
57
61
  def deploy
@@ -62,6 +66,15 @@ module Dpl
62
66
 
63
67
  private
64
68
 
69
+ def login_key
70
+ shell :login_key
71
+ end
72
+
73
+ def login_creds
74
+ info :login_creds
75
+ write_boto
76
+ end
77
+
65
78
  def write_boto
66
79
  write_file '~/.boto', interpolate(BOTO, opts, secure: true), 0600
67
80
  end
@@ -106,6 +106,7 @@ module Dpl
106
106
  opts = opts.select { |key, _| OCTOKIT_OPTS.include?(key) }
107
107
  compact(opts.merge(body: release_notes, draft: draft?))
108
108
  end
109
+ memoize :octokit_opts
109
110
 
110
111
  def with_tag(opts)
111
112
  return opts if tag_name? || draft?
@@ -134,6 +135,7 @@ module Dpl
134
135
  create_release.rels[:self].href
135
136
  end
136
137
  end
138
+ memoize :url
137
139
 
138
140
  def release
139
141
  releases.detect { |release| release.tag_name == local_tag }
@@ -141,7 +143,7 @@ module Dpl
141
143
 
142
144
  def create_release
143
145
  api.create_release(slug, local_tag, octokit_opts.merge(draft: true))
144
- rescue Octokit::NotFound => nf
146
+ rescue Octokit::NotFound
145
147
  error :insufficient_perm
146
148
  end
147
149
 
@@ -1,3 +1,3 @@
1
1
  module Dpl
2
- VERSION = '2.0.0.alpha.5'
2
+ VERSION = '2.0.0.alpha.6'
3
3
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: dpl
3
3
  version: !ruby/object:Gem::Version
4
- version: 2.0.0.alpha.5
4
+ version: 2.0.0.alpha.6
5
5
  platform: ruby
6
6
  authors:
7
7
  - Konstantin Haase
@@ -10,7 +10,7 @@ authors:
10
10
  autorequire:
11
11
  bindir: bin
12
12
  cert_chain: []
13
- date: 2019-09-11 00:00:00.000000000 Z
13
+ date: 2019-09-18 00:00:00.000000000 Z
14
14
  dependencies:
15
15
  - !ruby/object:Gem::Dependency
16
16
  name: cl