Re: Review Request 35981: Added persistent volume user guide.

2015-07-07 Thread Jie Yu


 On June 30, 2015, 12:14 a.m., Adam B wrote:
  docs/persistent-volume.md, line 56
  https://reviews.apache.org/r/35981/diff/1/?file=994064#file994064line56
 
  Can a volume/reservation created by one framework principal only be 
  destroyed/unreserved by a framework scheduler using the same principal? If 
  the principal is different, then the operation would fail, even if the role 
  or even frameworkId is identical?

We only look at the principal of an framework or an operator. The role does not 
matter because an operator does not have a role. The frameworkId is also 
irrelavent because framework B can unreserve/destroy a reservation/volume 
created by framework B as long as ACL allows it.


 On June 30, 2015, 12:14 a.m., Adam B wrote:
  docs/persistent-volume.md, lines 67-69
  https://reviews.apache.org/r/35981/diff/1/?file=994064#file994064line67
 
  You might need a blank line preceding this, and/or some indentation for 
  it to show up as a numbered list. Doesn't render properly as is.
  
  Unique per role per slave? So I could use the same volumeId for related 
  volume instances (e.g. my 'logging' or 'data' volumes), up to a max of one 
  per slave? But if I happen to launch another executor/task on a slave where 
  one of those volumes is already created/mounted, then I have to rename it 
  ('data2')?

Yes, this is in the design doc. Persistent volumes can be shared within a role, 
so it has to be unique per role.


 On June 30, 2015, 12:14 a.m., Adam B wrote:
  docs/persistent-volume.md, lines 120-122
  https://reviews.apache.org/r/35981/diff/1/?file=994064#file994064line120
 
  Any chance it could return the host_path too? Or do I have to go 
  digging through slave logs to figure out where my volume was created?

Why the framework wants to know that? This is similar to sandbox. Do we have a 
way to let the framework know about the location of the sandbox?


- Jie


---
This is an automatically generated e-mail. To reply, visit:
https://reviews.apache.org/r/35981/#review89827
---


On July 7, 2015, 12:34 p.m., Michael Park wrote:
 
 ---
 This is an automatically generated e-mail. To reply, visit:
 https://reviews.apache.org/r/35981/
 ---
 
 (Updated July 7, 2015, 12:34 p.m.)
 
 
 Review request for mesos, Adam B, Jie Yu, and Timothy Chen.
 
 
 Bugs: MESOS-2405
 https://issues.apache.org/jira/browse/MESOS-2405
 
 
 Repository: mesos
 
 
 Description
 ---
 
 The Github rendered version is available [here]( 
 https://github.com/mesosphere/mesos/blob/user-docs/docs/persistent-volume.md)
 
 
 Diffs
 -
 
   docs/persistent-volume.md PRE-CREATION 
 
 Diff: https://reviews.apache.org/r/35981/diff/
 
 
 Testing
 ---
 
 Documentation.
 
 
 Thanks,
 
 Michael Park
 




Re: Review Request 35981: Added persistent volume user guide.

2015-07-07 Thread Adam B


 On June 29, 2015, 5:14 p.m., Adam B wrote:
  docs/persistent-volume.md, line 169
  https://reviews.apache.org/r/35981/diff/1/?file=994064#file994064line169
 
  There is no `volumes` field. Just a `resources` field, where each 
  resource in the list must contain a `disk.volume` to be destroyed.
 
 Michael Park wrote:
 I was actually referring to:
 
 ```
 message Create {
   repeated Resource volumes = 1;
 }
 ```

I see, so the inconsistency was in the example json, not in the comment. 
Dropping this issue in favor of new ones.


- Adam


---
This is an automatically generated e-mail. To reply, visit:
https://reviews.apache.org/r/35981/#review89827
---


On June 29, 2015, 10:59 p.m., Michael Park wrote:
 
 ---
 This is an automatically generated e-mail. To reply, visit:
 https://reviews.apache.org/r/35981/
 ---
 
 (Updated June 29, 2015, 10:59 p.m.)
 
 
 Review request for mesos, Adam B, Jie Yu, and Timothy Chen.
 
 
 Bugs: MESOS-2405
 https://issues.apache.org/jira/browse/MESOS-2405
 
 
 Repository: mesos
 
 
 Description
 ---
 
 The Github rendered version is available [here]( 
 https://github.com/mesosphere/mesos/blob/user-docs/docs/persistent-volume.md)
 
 
 Diffs
 -
 
   docs/persistent-volume.md PRE-CREATION 
 
 Diff: https://reviews.apache.org/r/35981/diff/
 
 
 Testing
 ---
 
 Documentation.
 
 
 Thanks,
 
 Michael Park
 




Re: Review Request 35981: Added persistent volume user guide.

2015-06-29 Thread Jie Yu

---
This is an automatically generated e-mail. To reply, visit:
https://reviews.apache.org/r/35981/#review89773
---

Ship it!


LGTM overall! Thanks a lot, mpark!


docs/persistent-volume.md (lines 23 - 24)
https://reviews.apache.org/r/35981/#comment142569

We don't store 'principal' in DiskInfo yet. Maybe add a coming soon 
somewhere as well?



docs/persistent-volume.md (line 29)
https://reviews.apache.org/r/35981/#comment142571

via the `acceptOffers` API (or the `ACCEPT` call in the new API).



docs/persistent-volume.md (lines 63 - 64)
https://reviews.apache.org/r/35981/#comment142574

by sending the following `Offer::Operation` message via the `acceptOffers` 
API.



docs/persistent-volume.md (lines 67 - 69)
https://reviews.apache.org/r/35981/#comment142576

The numbering is not correct:)



docs/persistent-volume.md (line 68)
https://reviews.apache.org/r/35981/#comment142577

We only support non nested relative container path right now.



docs/persistent-volume.md (line 69)
https://reviews.apache.org/r/35981/#comment142579

Please call out that 'RO' is not supported yet.



docs/persistent-volume.md (line 168)
https://reviews.apache.org/r/35981/#comment142580

sending the `Offer::Operation` message via the `acceptOffers` API.


- Jie Yu


On June 28, 2015, 3:35 a.m., Michael Park wrote:
 
 ---
 This is an automatically generated e-mail. To reply, visit:
 https://reviews.apache.org/r/35981/
 ---
 
 (Updated June 28, 2015, 3:35 a.m.)
 
 
 Review request for mesos, Adam B, Jie Yu, and Timothy Chen.
 
 
 Bugs: MESOS-2405
 https://issues.apache.org/jira/browse/MESOS-2405
 
 
 Repository: mesos
 
 
 Description
 ---
 
 The Github rendered version is available [here]( 
 https://github.com/mesosphere/mesos/blob/user-docs/docs/persistent-volume.md)
 
 
 Diffs
 -
 
   docs/persistent-volume.md PRE-CREATION 
 
 Diff: https://reviews.apache.org/r/35981/diff/
 
 
 Testing
 ---
 
 Documentation.
 
 
 Thanks,
 
 Michael Park
 




Re: Review Request 35981: Added persistent volume user guide.

2015-06-29 Thread Adam B

---
This is an automatically generated e-mail. To reply, visit:
https://reviews.apache.org/r/35981/#review89827
---


Nice work! Just a few cleanups and questions/clarifications.


docs/persistent-volume.md (line 16)
https://reviews.apache.org/r/35981/#comment142630

s/containig/containing/



docs/persistent-volume.md (line 20)
https://reviews.apache.org/r/35981/#comment142631

s/Reservation/the Reservation doc/



docs/persistent-volume.md (line 56)
https://reviews.apache.org/r/35981/#comment142632

Can a volume/reservation created by one framework principal only be 
destroyed/unreserved by a framework scheduler using the same principal? If the 
principal is different, then the operation would fail, even if the role or even 
frameworkId is identical?



docs/persistent-volume.md (lines 67 - 69)
https://reviews.apache.org/r/35981/#comment142633

You might need a blank line preceding this, and/or some indentation for it 
to show up as a numbered list. Doesn't render properly as is.

Unique per role per slave? So I could use the same volumeId for related 
volume instances (e.g. my 'logging' or 'data' volumes), up to a max of one per 
slave? But if I happen to launch another executor/task on a slave where one of 
those volumes is already created/mounted, then I have to rename it ('data2')?



docs/persistent-volume.md (lines 120 - 122)
https://reviews.apache.org/r/35981/#comment142635

Any chance it could return the host_path too? Or do I have to go digging 
through slave logs to figure out where my volume was created?



docs/persistent-volume.md (lines 135 - 136)
https://reviews.apache.org/r/35981/#comment142637

Even after you destroy the volume, it still won't be garbage-collected in 
0.23. Coming Soon: https://issues.apache.org/jira/browse/MESOS-2408



docs/persistent-volume.md (line 169)
https://reviews.apache.org/r/35981/#comment142641

There is no `volumes` field. Just a `resources` field, where each resource 
in the list must contain a `disk.volume` to be destroyed.


- Adam B


On June 27, 2015, 8:35 p.m., Michael Park wrote:
 
 ---
 This is an automatically generated e-mail. To reply, visit:
 https://reviews.apache.org/r/35981/
 ---
 
 (Updated June 27, 2015, 8:35 p.m.)
 
 
 Review request for mesos, Adam B, Jie Yu, and Timothy Chen.
 
 
 Bugs: MESOS-2405
 https://issues.apache.org/jira/browse/MESOS-2405
 
 
 Repository: mesos
 
 
 Description
 ---
 
 The Github rendered version is available [here]( 
 https://github.com/mesosphere/mesos/blob/user-docs/docs/persistent-volume.md)
 
 
 Diffs
 -
 
   docs/persistent-volume.md PRE-CREATION 
 
 Diff: https://reviews.apache.org/r/35981/diff/
 
 
 Testing
 ---
 
 Documentation.
 
 
 Thanks,
 
 Michael Park
 




Re: Review Request 35981: Added persistent volume user guide.

2015-06-29 Thread Michael Park


 On June 29, 2015, 7:09 p.m., Jie Yu wrote:
  docs/persistent-volume.md, lines 23-24
  https://reviews.apache.org/r/35981/diff/1/?file=994064#file994064line23
 
  We don't store 'principal' in DiskInfo yet. Maybe add a coming soon 
  somewhere as well?

I put it at the end actually. Do you think it would read better if we maybe put 
it at the beginning?

 Persistent volumes can be created by __operators__ and authorized
 __frameworks__. We require a `principal` from the operator or
 framework in order to authenticate/authorize the operations.
 [Authorization](authorization.md) is specified via the existing
 ACL mechanism. (___Coming Soon___)

 Persistent volumes can be created by __operators__ and authorized
 __frameworks__. ___Coming Soon___: We require a `principal` from
 the operator or framework in order to authenticate/authorize the
 operations. [Authorization](authorization.md) is specified via
 the existing ACL mechanism.


 On June 29, 2015, 7:09 p.m., Jie Yu wrote:
  docs/persistent-volume.md, lines 67-69
  https://reviews.apache.org/r/35981/diff/1/?file=994064#file994064line67
 
  The numbering is not correct:)

This is actually a markdown feature I learned about:

```
It’s important to note that the actual numbers you use to mark the list have no 
effect on the HTML output Markdown produces. The HTML Markdown produces from 
the above list is:

ol
liBird/li
liMcHale/li
liParish/li
/ol
If you instead wrote the list in Markdown like this:

1.  Bird
1.  McHale
1.  Parish
or even:

3. Bird
1. McHale
8. Parish
you’d get the exact same HTML output.
```

It allows us to not have to update all of the other numbers if we were to add 
more items, remove an item or even rearrange them. It's already used in 
`docs/release-guide.md` at the end: `Update external tooling`.


- Michael


---
This is an automatically generated e-mail. To reply, visit:
https://reviews.apache.org/r/35981/#review89773
---


On June 28, 2015, 3:35 a.m., Michael Park wrote:
 
 ---
 This is an automatically generated e-mail. To reply, visit:
 https://reviews.apache.org/r/35981/
 ---
 
 (Updated June 28, 2015, 3:35 a.m.)
 
 
 Review request for mesos, Adam B, Jie Yu, and Timothy Chen.
 
 
 Bugs: MESOS-2405
 https://issues.apache.org/jira/browse/MESOS-2405
 
 
 Repository: mesos
 
 
 Description
 ---
 
 The Github rendered version is available [here]( 
 https://github.com/mesosphere/mesos/blob/user-docs/docs/persistent-volume.md)
 
 
 Diffs
 -
 
   docs/persistent-volume.md PRE-CREATION 
 
 Diff: https://reviews.apache.org/r/35981/diff/
 
 
 Testing
 ---
 
 Documentation.
 
 
 Thanks,
 
 Michael Park
 




Re: Review Request 35981: Added persistent volume user guide.

2015-06-29 Thread Michael Park


 On June 30, 2015, 12:14 a.m., Adam B wrote:
  docs/persistent-volume.md, line 169
  https://reviews.apache.org/r/35981/diff/1/?file=994064#file994064line169
 
  There is no `volumes` field. Just a `resources` field, where each 
  resource in the list must contain a `disk.volume` to be destroyed.

I was actually referring to:

```
message Create {
  repeated Resource volumes = 1;
}
```


- Michael


---
This is an automatically generated e-mail. To reply, visit:
https://reviews.apache.org/r/35981/#review89827
---


On June 30, 2015, 5:50 a.m., Michael Park wrote:
 
 ---
 This is an automatically generated e-mail. To reply, visit:
 https://reviews.apache.org/r/35981/
 ---
 
 (Updated June 30, 2015, 5:50 a.m.)
 
 
 Review request for mesos, Adam B, Jie Yu, and Timothy Chen.
 
 
 Bugs: MESOS-2405
 https://issues.apache.org/jira/browse/MESOS-2405
 
 
 Repository: mesos
 
 
 Description
 ---
 
 The Github rendered version is available [here]( 
 https://github.com/mesosphere/mesos/blob/user-docs/docs/persistent-volume.md)
 
 
 Diffs
 -
 
   docs/persistent-volume.md PRE-CREATION 
 
 Diff: https://reviews.apache.org/r/35981/diff/
 
 
 Testing
 ---
 
 Documentation.
 
 
 Thanks,
 
 Michael Park
 




Review Request 35981: Added persistent volume user guide.

2015-06-27 Thread Michael Park

---
This is an automatically generated e-mail. To reply, visit:
https://reviews.apache.org/r/35981/
---

Review request for mesos, Adam B, Jie Yu, and Timothy Chen.


Bugs: MESOS-2405
https://issues.apache.org/jira/browse/MESOS-2405


Repository: mesos


Description
---

The Github rendered version is available [here]( 
https://github.com/mesosphere/mesos/blob/user-docs/docs/persistent-volume.md)


Diffs
-

  docs/persistent-volume.md PRE-CREATION 

Diff: https://reviews.apache.org/r/35981/diff/


Testing
---

Documentation.


Thanks,

Michael Park



Re: Review Request 35981: Added persistent volume user guide.

2015-06-27 Thread Mesos ReviewBot

---
This is an automatically generated e-mail. To reply, visit:
https://reviews.apache.org/r/35981/#review89655
---


Patch looks great!

Reviews applied: [32982, 35981]

All tests passed.

- Mesos ReviewBot


On June 28, 2015, 3:35 a.m., Michael Park wrote:
 
 ---
 This is an automatically generated e-mail. To reply, visit:
 https://reviews.apache.org/r/35981/
 ---
 
 (Updated June 28, 2015, 3:35 a.m.)
 
 
 Review request for mesos, Adam B, Jie Yu, and Timothy Chen.
 
 
 Bugs: MESOS-2405
 https://issues.apache.org/jira/browse/MESOS-2405
 
 
 Repository: mesos
 
 
 Description
 ---
 
 The Github rendered version is available [here]( 
 https://github.com/mesosphere/mesos/blob/user-docs/docs/persistent-volume.md)
 
 
 Diffs
 -
 
   docs/persistent-volume.md PRE-CREATION 
 
 Diff: https://reviews.apache.org/r/35981/diff/
 
 
 Testing
 ---
 
 Documentation.
 
 
 Thanks,
 
 Michael Park