Overview# This is a note on how to serve images stored in Amazon S3 using Cantaloupe Image Server, one of the IIIF image servers.
As an alternative method for serving images stored in Amazon S3, I also introduced an approach in the following article. (The tools may have been updated since the article was written, so the instructions may not work exactly as described.)
Configuration# The official manual is available at the following link.
https://cantaloupe-project.github.io/manual/5.0/sources.html#S3Source
Edit the following file:
/cantaloupe-5.0.5/cantaloupe.properties
First, change source.static to S3Source.
# # # # # # s # # o # S # U ` s u # O # s H o r # U # e t u c # R # s t r e # C # p c . # E # o S e s # S # n o . t # # e u s a # # r t t # # s c a i # # o e t c # # u ` i # # r , c = # # c # # e ` = S # # J 3 # # f d F S # # o b i o # # r c l u # # S e r # # a o s c # # l u y e # # l r s # # c t # # r e e # # e ` m # # q , S # # u o # # e ` u # # s S r # # t 3 c # # s S e # # . o # # u # # A r # # v c # # a e # # i ` # # l , # # a # # b a # # l n # # e d # # # # v ` # # a A # # l z # # u u # # e r # # s e # # S # # a t # # r o # # e r # # a # # ` g # # F e # # i S # # l o # # e u # # s r # # y c # # s e # # t ` # # e . # # m # # S # # o # # u # # r # # c # # e # # ` ,
Next, configure S3Source.access_key_id, S3Source.secret_key, and S3Source.BasicLookupStrategy.bucket.name.
# # # # S # S # # # # S S # # # S # S - - 3 3 3 3 3 3 - S - ! S ! S ! S N i S S H ` d S ! S - 3 - ! o ! o ! e o t o o o S y o ! o - S - u u e t u u w c n u u - o - E r A r C : e h r r r a r N r - u - n c W c r e c c t i m c a c - r - d e S e e h t r e e o p i e m e - c - p . . d t h e . . t c . e . - e - o e r r e t a ; a s l L l B - - i n e e n p t c e o o l o o a - - n d g g t : s c c o o o o f s - - t p i i i / t e e r k k o k i - - o o o a / h e s e u k u t c - - U i n n l a i s t u p u p h L - - R n . s w s t _ _ p S p _ e o - - I t = s h k k t s s o - - . O f . i e e e o r ; t b k - - = n o a n y y b a r u u - - O l r m f u _ j t s a c p - - n y a o s i = e e e t k S - - l y z e d c g e e e t - - y n o o c r < t y g t r - - e u n a = s s ` t y a - - n e r . n m e . . h c t - - e d c a < c e = o e - - e e A o b n a r A S n g - - d d W m e u c e l c u B t y - - e S / a c t l r s a a . - - d f s o l e o i e s i b - - o a e b . s k w p r i n u - - f r c c t s e e t c i c - - o c u a y d L m L n k - - r A o r i k > o a o g e - - W u i n e v o n o t - - n S n t e y a k u k i . - - o t y d > l u a u m n - - n e . - u p l p a a - - - n c f e S . S g m - - A d r r s t t e e - - W p e o r r s S o d m a a a = i e r t t t e n n e e e e o < n t t l g g b d s i s ` y y b u p . a e B e c o l w a u k i s h s s s e n e i e e t t r c s r s e L v n . o a e a r o d m a k d . e t u e > h p l e S e r t g r a t a t h t e a e n g m y e s ` t e h t a o t n d i d n f g o r
With this, images stored in Amazon S3 are now referenced.
Other Notes# For uploading images to Amazon S3, I used the AWS CLI (Amazon Web Services Command Line Interface) with the following command.
a w s s 3 s y n c < p a t h t o l o c a l i m a g e f o l d e r > s 3 : / / < b u c k e t n a m e > / < S 3 p a t h > - e x c l u d e " * / . D S _ S t o r e " Summary# I hope this is helpful for using Cantaloupe Image Server.