Jens Schumacher, Product Manager & Tim Pettersen, Development Team Lead Come and learn all about building plugins for Atlassian's shiny new product: Stash! Large amounts of Stash's functionality (including our SSH and HTTP hosting, our JIRA integration and the entire REST API) comes entirely from bundled plugins. This has driven a rich, clearly defined API and SPI and a strong commitment to backwards compatibility. Stash has been built from the ground up with plugins and plugin developers in mind. In this talk we'll inspire you with a broad look at what's available in the Stash API and SPI, as well as a peek at our low-level SCM API which provides a clean way to to interface directly with your repositories using Git. During the talk we'll be using lots of code examples and implementing a small plugin that shows off different facets of Stash's API, SPI and SCM API.

3. Jens Schumacher
Jay

4. Since Stash 1.0...

5. Since Stash 1.0...
141days

6. Since Stash 1.0...
141days
2 releases everyks
one 7
wee

7. Since Stash 1.0...
141days
2 releases everyks
one 7
wee
10 add-ons the Marketplace
in

8. Since Stash 1.0...
141days
2 releases everyks
one 7
wee
10 add-ons the Marketplace
in

9. Since Stash 1.0...
141days
2 releases everyks
one 7
wee
10 add-ons the Marketplace
in

10. 1000+customers

12. Stash 1.0 - 1.2

13. Enterprise Focus
Security & Access Control
Visibility
Integration

14. Permissions

15. Databases

16. End-User Features

17. Stash 1.3

18. Pull Requests

19. What is a Pull Request?
`

20. What is a Pull Request?
`
`

21. Pull Requests

22. Pull Requests

23. Pull Requests

24. Pull Requests

25. Pull Requests

26. Pull Requests

27. Pull Requests

28. Pull Requests

29. Stash 1.4

30. Pull Requests

31. Pull Requests

32. Pull Requests

33. Branch Permissions

34. Scale

35. 500+

36. Next
Tim Pettersen

37. Tour de Stash
Tim Pettersen, Atlassian

38. What is Stash?
MyRepo.git

39. What is Stash?
Git Hosting
SSH
MyRepo.git
HTTP

40. What is Stash?
Git Hosting Browsing
SSH Web UI
MyRepo.git
HTTP REST

41. What is Stash?
Git Hosting Browsing
SSH Web UI
MyRepo.git
HTTP REST
Integration
Commit Hooks
Events

42. What is Stash?
Git Hosting Browsing
SSH Web UI
MyRepo.git
HTTP REST
Integration
Code Changes
Commit Hooks
Pull Requests
Events

44. Ideas?

45. Plugin ideas?
• Toolchain integration
REST
• Issue tracking
Commit Hooks
• Continuous
Integration
Events
• IDEs

46. Plugin ideas?
• Reporting
• Metrics Web UI
• Static analysis
• File Rendering
• Business: PDF, DOC, XLS etc.
• Specialist: 3DS, OBJ, WAV, MOV etc.

47. Plugin ideas?
• Release management Events
• Code ‘bots’
Pull Requests
• Commit Hooks
• Auto-deployment Commit Hooks
• Pre-commit validation

48. Plugin ideas?
• Release management Events
• Code ‘bots’
Pull Requests
• Commit Hooks
• Auto-deployment Commit Hooks
• Pre-commit validation

49. Built on plugins,
for plugins
stash-spi webapp
stash-api bundled plugins
scm-git 3rd party plugins

50. First Class Citizens
• Features as plugins: driving continual
expansion of stash-api & stash-spi
• @Deprecated - no breaking changes
between releases
• Puppy-fooding!

51. DON’T PANIC!
• Atlassian Plugins 2
• SDK Support
• Atlassian Platform
• Velocity support (but prefer Soy)
• New Atlassian PDL

52. DON’T PANIC!
• Atlassian Plugins 2
• SDK Support
• Atlassian Platform
• Velocity support (but prefer Soy)
• New Atlassian PDL

53. stash-spi
stash-spi webapp
stash-api bundled plugins
scm-git 3rd party plugins

54. stash-spi
• Changeset indexing
• SSH end-points
• SCM request checks
• Form fragments

55. Example:
Beer O’Clock Plugin
http://tinyurl.com/stashlas-camp

56. Beer O’Clock Check
git
push
PermissionCheck
LicenseCheck
ThrottleCheck
repo.git

57. Beer O’Clock Check
git
push
PermissionCheck
LicenseCheck
ThrottleCheck
BeerOClockCheck
repo.git

58. Beer O’Clock Check

59. stash-api
stash-spi webapp
stash-api bundled plugins
scm-git 3rd party plugins

60. stash-api
• Services, services, services...
• server admin
• repositories & projects
• content & history
• users & groups
• permissioning
• 1:1 mapping with REST API

61. stash-api
• Events galore!
• Administration - users, groups,
permissions, server config
• Repositories & projects
• Hosting - pushes, pulls, throttling
• Sync & async

62. Example:
Load Monitor
http://tinyurl.com/stashlas-camp

64. Load Monitor
LoadMonitorListener
MailService

65. Load Monitor
LoadMonitor
LoadMonitorListener
FormFragment
MailService PluginSettingsFactory

66. stash-api
• RepositoryService repository CRUD
(incl. forks!)
• RepositoryMetadataService
branches & tags
• HistoryService file changes &
changesets
• ContentService diffs, content, blame

67. Scale, scale, scale!
• Throttling
• Streamy APIs
• Paging & hard limits

68. Don’t stress!
• Super-easy paging
• Transparent throttling
• Intelligent front-end

69. scm-git
stash-spi webapp
stash-api bundled plugins
scm-git 3rd party plugins

70. What is Git?
• Powerful distributed versioned
storage system
• Stash as a platform?
• History management
• Collaboration (branching/merging)

71. scm-git
• Low level git commands
• Easy process handling
• Typesafe builders
• Flexibility to create new commands

72. Example:
git-notes in Stash
http://tinyurl.com/stashlas-camp

74. git-notes in Stash
GitNotesService
ShowNote ShowNote
ScmClient
ExitHandler OutputHandler

75. git-notes in Stash
GitNotes git-notes
ContextProvider web-panel
GitNotesService
ShowNote ShowNote
ScmClient
ExitHandler OutputHandler

76. naughty!

77. naughty!
• Invoking Git on the request thread

78. naughty!
• Invoking Git on the request thread
• Failing to ask for a resource ticket

79. Thanks!
http://tinyurl.com/stashlas-camp