| # SOME DESCRIPTIVE TITLE. |
| # Copyright (C) 2014, Apache CloudStack |
| # This file is distributed under the same license as the Apache CloudStack package. |
| # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. |
| # |
| #, fuzzy |
| msgid "" |
| msgstr "" |
| "Project-Id-Version: Apache CloudStack 4.3\n" |
| "Report-Msgid-Bugs-To: \n" |
| "POT-Creation-Date: 2014-03-31 13:49-0400\n" |
| "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" |
| "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" |
| "Language-Team: LANGUAGE <LL@li.org>\n" |
| "MIME-Version: 1.0\n" |
| "Content-Type: text/plain; charset=UTF-8\n" |
| "Content-Transfer-Encoding: 8bit\n" |
| |
| #: ../../plugins.rst:2 |
| # 379a7814be5a45bcadcc0fd536656b4f |
| msgid "Plugins" |
| msgstr "" |
| |
| #: ../../plugins.rst:6 |
| # 276ba73433bd44b49f3176b4fdcaf5a9 |
| msgid "Storage Plugins" |
| msgstr "" |
| |
| #: ../../plugins.rst:8 |
| # 358954e5ae1b4bca9b9314f8cbd00da8 |
| msgid "This section gives an outline of how to implement a plugin to integrate a third-party storage provider. For details and an example, you will need to read the code." |
| msgstr "" |
| |
| #: ../../plugins.rst:12 |
| # bcbf1c53396a440f8f0a50ed5591f57b |
| msgid "Example code is available at: `plugins/storage/volume/sample`" |
| msgstr "" |
| |
| #: ../../plugins.rst:14 |
| # 7943819f1f8a49bfb21b6aedfc6864dd |
| msgid "Third party storage providers can integrate with CloudStack to provide either primary storage or secondary storage. For example, CloudStack provides plugins for Amazon Simple Storage Service (S3) or OpenStack Object Storage (Swift). The S3 plugin can be used for any object storage that supports the Amazon S3 interface." |
| msgstr "" |
| |
| #: ../../plugins.rst:20 |
| # e8a7044f1e9642cea286930007548cff |
| msgid "Additional third party object storages that do not support the S3 interface can be integrated with CloudStack by writing plugin software that uses the object storage plugin framework. Several new interfaces are available so that storage providers can develop vendor-specific plugins based on well-defined contracts that can be seamlessly managed by CloudStack." |
| msgstr "" |
| |
| #: ../../plugins.rst:27 |
| # 0a515957cb6e4b4bbe92c1331577f84f |
| msgid "Artifacts such as templates, ISOs and snapshots are kept in storage which CloudStack refers to as secondary storage. To improve scalability and performance, as when a number of hosts access secondary storage concurrently, object storage can be used for secondary storage. Object storage can also provide built-in high availability capability. When using object storage, access to secondary storage data can be made available across multiple zones in a region. This is a huge benefit, as it is no longer necessary to copy templates, snapshots etc. across zones as would be needed in an environment using only zone-based NFS storage." |
| msgstr "" |
| |
| #: ../../plugins.rst:37 |
| # 6648eb6e267b443f83e38ff557fa9dcd |
| msgid "The user enables a storage plugin through the UI. A new dialog box choice is offered to select the storage provider. Depending on which provider is selected, additional input fields may appear so that the user can provide the additional details required by that provider, such as a user name and password for a third-party storage account." |
| msgstr "" |
| |
| #: ../../plugins.rst:44 |
| # 79590964b2d94df7b8ee961a9f0e1c77 |
| msgid "Overview of How to Write a Storage Plugin" |
| msgstr "" |
| |
| #: ../../plugins.rst:46 |
| # 81da42c9a3fd43a6ae81de0def33d980 |
| msgid "To add a third-party storage option to CloudStack, follow these general steps (explained in more detail later in this section):" |
| msgstr "" |
| |
| #: ../../plugins.rst:49 |
| # a59f1b6a6401428b8df44ef5c815b529 |
| msgid "Implement the following interfaces in Java:" |
| msgstr "" |
| |
| #: ../../plugins.rst:51 |
| # d4706d7bd37f4ecfb17e700d567de04b |
| msgid "DataStoreDriver" |
| msgstr "" |
| |
| #: ../../plugins.rst:53 |
| # 4059bcbbcc9f42aea6d8eaaff7e19d45 |
| msgid "DataStoreLifecycle" |
| msgstr "" |
| |
| #: ../../plugins.rst:55 |
| # cd23139c1ca9496f95616a6447c7982f |
| msgid "DataStoreProvider" |
| msgstr "" |
| |
| #: ../../plugins.rst:57 |
| # 0b42430ad6754a7cb5d98d5ef1b9cfbb |
| msgid "VMSnapshotStrategy (if you want to customize the VM snapshot functionality)" |
| msgstr "" |
| |
| #: ../../plugins.rst:60 |
| # 58743ad0ef874f8a82ec02659f100b2c |
| msgid "Hardcode your plugin's required additional input fields into the code for the Add Secondary Storage or Add Primary Storage dialog box." |
| msgstr "" |
| |
| #: ../../plugins.rst:63 |
| # 3db5b1bcf41c43d2b41395ec10bb9f0a |
| msgid "Place your .jar file in `plugins/storage/volume/` or `plugins/storage/image/`." |
| msgstr "" |
| |
| #: ../../plugins.rst:65 |
| # cb55ad5ab266458ca52e817fff92e46c |
| msgid "Edit `/client/tomcatconf/componentContext.xml.in`." |
| msgstr "" |
| |
| #: ../../plugins.rst:67 |
| # eb20fc9877d64f35ab554e9466f4658f |
| msgid "Edit `client/pom.xml`." |
| msgstr "" |
| |
| #: ../../plugins.rst:70 |
| # 9688b201ec7a44d9bec3f68a3834f661 |
| msgid "Implementing DataStoreDriver" |
| msgstr "" |
| |
| #: ../../plugins.rst:72 |
| # 6b45021dacd74b4db08570aca747baaf |
| msgid "DataStoreDriver contains the code that CloudStack will use to provision the object store, when needed." |
| msgstr "" |
| |
| #: ../../plugins.rst:75 |
| #: ../../plugins.rst:99 |
| #: ../../plugins.rst:118 |
| # 110e2faf453d4019acc78dc1de958e03 |
| # 50d2a350ffdd446ebed3501451547a93 |
| # 36623b0788e84ae7b8fe9cbaa8793214 |
| msgid "You must implement the following methods:" |
| msgstr "" |
| |
| #: ../../plugins.rst:77 |
| # 978b91799e7a441483f89ee5094951c7 |
| msgid "getTO()" |
| msgstr "" |
| |
| #: ../../plugins.rst:79 |
| # c5f4d5267f494a3d8103694ff97230cc |
| msgid "getStoreTO()" |
| msgstr "" |
| |
| #: ../../plugins.rst:81 |
| # ceab640d5f294e33b654eeb341a236f6 |
| msgid "createAsync()" |
| msgstr "" |
| |
| #: ../../plugins.rst:83 |
| # d40f5f65b6c142e3982b32e617d13ee1 |
| msgid "deleteAsync()" |
| msgstr "" |
| |
| #: ../../plugins.rst:85 |
| #: ../../plugins.rst:135 |
| # 1c581d60ec8f437b946609e5005d4615 |
| # 6ee9c079baf14294b50ac646b0b17148 |
| msgid "The following methods are optional:" |
| msgstr "" |
| |
| #: ../../plugins.rst:87 |
| # a4ddd58fad6a4efab4f54031b45b1895 |
| msgid "resize()" |
| msgstr "" |
| |
| #: ../../plugins.rst:89 |
| # 07a3e3904a8f4e23ab9d2719ceadc3bb |
| msgid "canCopy() is optional. If you set it to true, then you must implement copyAsync()." |
| msgstr "" |
| |
| #: ../../plugins.rst:93 |
| # dfa07e5db908457d8cf4ab3ea629351f |
| msgid "Implementing DataStoreLifecycle" |
| msgstr "" |
| |
| #: ../../plugins.rst:95 |
| # 3508baad34c349f18bee1a469dbdd2f4 |
| msgid "DataStoreLifecycle contains the code to manage the storage operations for ongoing use of the storage. Several operations are needed, like create, maintenance mode, delete, etc." |
| msgstr "" |
| |
| #: ../../plugins.rst:101 |
| # be7eccc5cbf94427ab62c3ac621e0904 |
| msgid "initialize()" |
| msgstr "" |
| |
| #: ../../plugins.rst:103 |
| # 05c12b7857f9409a85b667444db0bf4b |
| msgid "maintain()" |
| msgstr "" |
| |
| #: ../../plugins.rst:105 |
| # e2cdf5a6cbfc40df9637fbd1625d0739 |
| msgid "cancelMaintain()" |
| msgstr "" |
| |
| #: ../../plugins.rst:107 |
| # c531bef6c8934f778fd67919afa4e0b2 |
| msgid "deleteDataStore()" |
| msgstr "" |
| |
| #: ../../plugins.rst:109 |
| # a37c6307cd0243c795a40ca093011f09 |
| msgid "Implement one of the attach\\*() methods depending on what scope you want the storage to have: attachHost(), attachCluster(), or attachZone()." |
| msgstr "" |
| |
| #: ../../plugins.rst:114 |
| # 8dfafd1749a144f7889ee0f225b66288 |
| msgid "Implementing DataStoreProvider" |
| msgstr "" |
| |
| #: ../../plugins.rst:116 |
| # b7400386153243b39742ffb719dda277 |
| msgid "DataStoreProvider contains the main code of the data store." |
| msgstr "" |
| |
| #: ../../plugins.rst:120 |
| # d46222d7926a42f19c4b4716e4afc608 |
| msgid "getDatastoreLifeCycle()" |
| msgstr "" |
| |
| #: ../../plugins.rst:122 |
| # a69737a8b6ab40d39e67a74c899e5574 |
| msgid "getDataStoreDriver()" |
| msgstr "" |
| |
| #: ../../plugins.rst:124 |
| # ce12672ec9844f7c8d88a9d3871e8bdd |
| msgid "getTypes(). Returns one or more types of storage for which this data store provider can be used. For secondary object storage, return IMAGE, and for a Secondary Staging Store, return ImageCache." |
| msgstr "" |
| |
| #: ../../plugins.rst:128 |
| # 683ccb9981724336886a1597876d99da |
| msgid "configure(). First initialize the lifecycle implementation and the driver implementation, then call registerDriver() to register the new object store provider instance with CloudStack." |
| msgstr "" |
| |
| #: ../../plugins.rst:132 |
| # 6eae2e2f3984408d83382a7e643ac1ea |
| msgid "getName(). Returns the unique name of your provider; for example, this can be used to get the name to display in the UI." |
| msgstr "" |
| |
| #: ../../plugins.rst:137 |
| # 1d479396becb4f31907471b9247b47cf |
| msgid "getHostListener() is optional; it's for monitoring the status of the host." |
| msgstr "" |
| |
| #: ../../plugins.rst:141 |
| # 52eaa6fa0b484432a9bd1bbc77a5c37d |
| msgid "Implementing VMSnapshotStrategy" |
| msgstr "" |
| |
| #: ../../plugins.rst:143 |
| # 9ad0037ad86d4a1b8d1f135cefbbc6c5 |
| msgid "VMSnapshotStrategy has the following methods:" |
| msgstr "" |
| |
| #: ../../plugins.rst:145 |
| # 20970991ba784f3b9d54cf1cfe12f8e6 |
| msgid "takeVMSnapshot()" |
| msgstr "" |
| |
| #: ../../plugins.rst:147 |
| # 9bff86587100420e93573c9bee23e992 |
| msgid "deleteVMSnapshot()" |
| msgstr "" |
| |
| #: ../../plugins.rst:149 |
| # 3a52e11272284484a6e72f035dee36c8 |
| msgid "revertVMSnapshot()" |
| msgstr "" |
| |
| #: ../../plugins.rst:151 |
| # f3306e4fc05f4c4fb6065e8be9ae7790 |
| msgid "canHandle(). For a given VM snapshot, tells whether this implementation of VMSnapshotStrategy can handle it." |
| msgstr "" |
| |
| #: ../../plugins.rst:155 |
| # 992261ff6c7e418da8e50ffc311bdd92 |
| msgid "Place the .jar File in the Right Directory" |
| msgstr "" |
| |
| #: ../../plugins.rst:157 |
| # 525e7141d0414c5990833d09bda59b48 |
| msgid "For a secondary storage plugin, place your .jar file here:" |
| msgstr "" |
| |
| #: ../../plugins.rst:163 |
| # 95400fb6d085440797180cf692b4bf94 |
| msgid "For a primary storage plugin, place your .jar file here:" |
| msgstr "" |
| |
| #: ../../plugins.rst:170 |
| # f9bace45b78d4ca1b3581f1978438637 |
| msgid "Edit Configuration Files" |
| msgstr "" |
| |
| #: ../../plugins.rst:172 |
| # 076d6a8e32c547ef9774ce76b6956107 |
| msgid "First, edit the following file tell CloudStack to include your .jar file. Add a line to this file to tell the CloudStack Management Server that it now has a dependency on your code:" |
| msgstr "" |
| |
| #: ../../plugins.rst:180 |
| # 41863713ce5b44af8daa29b52ea9b884 |
| msgid "Place some facts about your code in the following file so CloudStack can run it:" |
| msgstr "" |
| |
| #: ../../plugins.rst:187 |
| # b918b6ed56d140ff8013cb47574e0e42 |
| msgid "In the section “Deployment configurations of various adapters,” add this:" |
| msgstr "" |
| |
| #: ../../plugins.rst:194 |
| # 30190892871c43188cf466ccd65f65d7 |
| msgid "In the section “Storage Providers,” add this:" |
| msgstr "" |
| |
| #: ../../plugins.rst:203 |
| # 2ae7b51840ee4af992fc223832fc4671 |
| msgid "Minimum Required Interfaces" |
| msgstr "" |
| |
| #: ../../plugins.rst:205 |
| # 8b945071a1ca4028a8e4d66b660e9a37 |
| msgid "The classes, interfaces, and methods used by CloudStack from the Amazon Web Services (AWS) Java SDK are listed in this section. An object storage that supports the S3 interface is minimally required to support the below in order to be compatible with CloudStack." |
| msgstr "" |
| |
| #: ../../plugins.rst:211 |
| # 608dc2680b3647418a090b59602e0fae |
| msgid "Interface AmazonS3" |
| msgstr "" |
| |
| #: ../../plugins.rst:213 |
| # aee399034a2f4543badc14a61f4c271d |
| msgid "http://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/AmazonS3.html" |
| msgstr "" |
| |
| #: ../../plugins.rst:216 |
| #: ../../plugins.rst:292 |
| #: ../../plugins.rst:305 |
| # 524902fe6335491e90113db2e7dcf32c |
| # e98040534c694fa79fa31e2055d1952d |
| # 14a01140525943f992129262e3d80f7d |
| msgid "Modifier and Type" |
| msgstr "" |
| |
| #: ../../plugins.rst:216 |
| #: ../../plugins.rst:292 |
| #: ../../plugins.rst:305 |
| # 425d6aa0a9064b96a9ca0885a619c38d |
| # f6a0c9e17a6243779f44932ea5a23c89 |
| # 9a049f576a8e4962950b98430348d2a4 |
| msgid "Method and Description" |
| msgstr "" |
| |
| #: ../../plugins.rst:219 |
| # dab6c8ccc228474bbdee27d4828d4f54 |
| msgid "Bucket" |
| msgstr "" |
| |
| #: ../../plugins.rst:219 |
| # b5245e58b4104653874763bf3ebc456b |
| msgid "createBucket(String bucketName)" |
| msgstr "" |
| |
| #: ../../plugins.rst:221 |
| # 098525d2951148a3ab0b98ccc0daa468 |
| msgid "Creates a new Amazon S3 bucket with the specified name in the default (US) region, Region.US\\_Standard." |
| msgstr "" |
| |
| #: ../../plugins.rst:224 |
| #: ../../plugins.rst:246 |
| #: ../../plugins.rst:275 |
| #: ../../plugins.rst:279 |
| # 10e1e53e84814a759d18a529af6afb21 |
| # 19df007e41794cdcb5068190dc725b50 |
| # 9b936bfde7324c11bc53237bee0ab743 |
| # f9e2310af56643ea89a85e7a49179a42 |
| msgid "void" |
| msgstr "" |
| |
| #: ../../plugins.rst:224 |
| # d0edd5f0784c4d0d80b649435413969c |
| msgid "deleteObject(String bucketName, String key)" |
| msgstr "" |
| |
| #: ../../plugins.rst:226 |
| # b000a048de2c4b73a38deb0f3453329e |
| msgid "Deletes the specified object in the specified bucket." |
| msgstr "" |
| |
| #: ../../plugins.rst:228 |
| # 93db5db5c5d04b14996eee4cced36b84 |
| msgid "ObjectMetadata" |
| msgstr "" |
| |
| #: ../../plugins.rst:228 |
| # 6c36346fa1884122b6103c28b5d4bdd7 |
| msgid "getObject(GetObjectRequest getObjectRequest, File destinationFile)" |
| msgstr "" |
| |
| #: ../../plugins.rst:231 |
| # 733bb2a121894a158b4dbed604144383 |
| msgid "Gets the object metadata for the object stored in Amazon S3 under the specified bucket and key, and saves the object contents to the specified file." |
| msgstr "" |
| |
| #: ../../plugins.rst:235 |
| # 69058f54f58342d094836ad752e4d4e7 |
| msgid "S3Object" |
| msgstr "" |
| |
| #: ../../plugins.rst:235 |
| # 8e4699041a0a403594cff314173bad13 |
| msgid "getObject(String bucketName, String key)" |
| msgstr "" |
| |
| #: ../../plugins.rst:237 |
| # 565e5ccbf07643d8bdb2e31697118021 |
| msgid "Gets the object stored in Amazon S3 under the specified bucket and key." |
| msgstr "" |
| |
| #: ../../plugins.rst:240 |
| # e434609fbde942f7b2667a2bd2b74526 |
| msgid "URL" |
| msgstr "" |
| |
| #: ../../plugins.rst:240 |
| # 0049113021404c0398d28d0090fc4e86 |
| msgid "generatePresignedUrl(String bucketName, String key, Date expiration, HttpMethod method)" |
| msgstr "" |
| |
| #: ../../plugins.rst:243 |
| # 4a6a23c7ae664c61a5d54eab6c49bddd |
| msgid "Returns a pre-signed URL for accessing an Amazon S3 resource." |
| msgstr "" |
| |
| #: ../../plugins.rst:246 |
| # 904cfc6f8c244f8fbfc859e381069663 |
| msgid "deleteBucket(String bucketName)" |
| msgstr "" |
| |
| #: ../../plugins.rst:248 |
| # e1dac24bb0e14b4697219c79b113fd7f |
| msgid "Deletes the specified bucket." |
| msgstr "" |
| |
| #: ../../plugins.rst:250 |
| # 8cdb948275894bdb97c1b8b5f6e249ed |
| msgid "List<Bucket>" |
| msgstr "" |
| |
| #: ../../plugins.rst:250 |
| # 4948cb9aa0fe47b5a0b4133c51aac5ae |
| msgid "listBuckets()" |
| msgstr "" |
| |
| #: ../../plugins.rst:252 |
| # a7f7c254dfc743e6986d6f87157e8ca1 |
| msgid "Returns a list of all Amazon S3 buckets that the authenticated sender of the request owns." |
| msgstr "" |
| |
| #: ../../plugins.rst:255 |
| # 3e40fd85e1734299b80d1a20543aa634 |
| msgid "ObjectListing" |
| msgstr "" |
| |
| #: ../../plugins.rst:255 |
| # bb216e1e97f64c06b56d8b5d63f55e6f |
| msgid "listObjects(String bucketName, String prefix)" |
| msgstr "" |
| |
| #: ../../plugins.rst:257 |
| # 410a7878aa1a423a8924f0639fd9d503 |
| msgid "Returns a list of summary information about the objects in the specified bucket." |
| msgstr "" |
| |
| #: ../../plugins.rst:260 |
| #: ../../plugins.rst:264 |
| #: ../../plugins.rst:269 |
| # c9d4c91129ea44d3b04bc4fec6625e45 |
| # bdebb85f1c164924b617faf009556842 |
| # 07c5d99ac05a4fa288989e3abc26136a |
| msgid "PutObjectResult" |
| msgstr "" |
| |
| #: ../../plugins.rst:260 |
| # a026c1f32bfb4bb5880c29ae0a65e253 |
| msgid "putObject(PutObjectRequest putObjectRequest)" |
| msgstr "" |
| |
| #: ../../plugins.rst:262 |
| # 4f55cf31f4d241e1822a673575690fd8 |
| msgid "Uploads a new object to the specified Amazon S3 bucket." |
| msgstr "" |
| |
| #: ../../plugins.rst:264 |
| # 3bc33b26a775484088543c50ccd242b9 |
| msgid "putObject(String bucketName, String key, File file)" |
| msgstr "" |
| |
| #: ../../plugins.rst:266 |
| # 7da2800a6855410ba7aba90d4eb247f9 |
| msgid "Uploads the specified file to Amazon S3 under the specified bucket and key name." |
| msgstr "" |
| |
| #: ../../plugins.rst:269 |
| # 84b1447f696947f188e49d20266ab31a |
| msgid "putObject(String bucketName, String key, InputStream input, ObjectMetadata metadata)" |
| msgstr "" |
| |
| #: ../../plugins.rst:272 |
| # ffd50b9c64944d7c94b59db13f429502 |
| msgid "Uploads the specified input stream and object metadata to Amazon S3 under the specified bucket and key name." |
| msgstr "" |
| |
| #: ../../plugins.rst:275 |
| # 6ff9f7752d544dce87370cff755b5c04 |
| msgid "setEndpoint(String endpoint)" |
| msgstr "" |
| |
| #: ../../plugins.rst:277 |
| # bb223a72df024071bd3fcf9a104ea867 |
| msgid "Overrides the default endpoint for this client." |
| msgstr "" |
| |
| #: ../../plugins.rst:279 |
| # a1c7af6f2ced47df89b4f06a106004ea |
| msgid "setObjectAcl(String bucketName, String key, CannedAccessControlList acl)" |
| msgstr "" |
| |
| #: ../../plugins.rst:282 |
| # fc1eb83daba44fb8b3d7c874b1b78eb4 |
| msgid "Sets the CannedAccessControlList for the specified object in Amazon S3 using one of the pre-configured CannedAccessControlLists." |
| msgstr "" |
| |
| #: ../../plugins.rst:287 |
| # 0ca9dc98fa69442da459049fa130bb3e |
| msgid "*Class TransferManager*" |
| msgstr "" |
| |
| #: ../../plugins.rst:289 |
| # af0a0cd7fe054fa0b429690eb93d7f08 |
| msgid "http://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/transfer/TransferManager.html" |
| msgstr "" |
| |
| #: ../../plugins.rst:295 |
| #: ../../plugins.rst:308 |
| # 3bf5fd4667e14704827091487cba6732 |
| # 063f2d2856ac430f82e49cb6a131a104 |
| msgid "Upload" |
| msgstr "" |
| |
| #: ../../plugins.rst:295 |
| #: ../../plugins.rst:308 |
| # 85985bdb07bb4407ac643217da6cc939 |
| # bcb6b7381776465fbad331f3a2f1fa72 |
| msgid "upload(PutObjectRequest putObjectRequest)" |
| msgstr "" |
| |
| #: ../../plugins.rst:297 |
| #: ../../plugins.rst:310 |
| # bae421e1a5db4ee7a2dab5d554ec7198 |
| # aa005a5c26e74b76a91b4f14cefed7b1 |
| msgid "Schedules a new transfer to upload data to Amazon S3." |
| msgstr "" |
| |
| #: ../../plugins.rst:300 |
| # 62992df00ab34f92971b3885d85b3bfc |
| msgid "*Class PutObjectRequest*" |
| msgstr "" |
| |
| #: ../../plugins.rst:302 |
| # e6c803af72274ebc9580b6a7f60bdb67 |
| msgid "http://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/model/PutObjectRequest.html" |
| msgstr "" |
| |
| #: ../../plugins.rst:315 |
| # 047cb9e48a3d481c934d16c02bd9a87d |
| msgid "Third Party UI Plugins" |
| msgstr "" |
| |
| #: ../../plugins.rst:317 |
| # be7d0e07285f4351bda1ceb9a1fb337b |
| msgid "Using the new third-party plugin framework, you can write and install extensions to CloudStack. The installed and enabled plugins will appear in the UI alongside the other features. The code for the plugin is simply placed in a special directory within CloudStack’s installed code at any time after CloudStack installation. The new plugin appears only when it is enabled by the cloud administrator." |
| msgstr "" |
| |
| #: ../../plugins.rst:328 |
| # 21c50cf0d5564016b44442790fe84fb1 |
| msgid "The left navigation bar of the CloudStack UI has a new Plugins button to help you work with UI plugins." |
| msgstr "" |
| |
| #: ../../plugins.rst:332 |
| # 3181ee393ee54ca0bec634ac6c3ff3ff |
| msgid "How to Write a Plugin: Overview" |
| msgstr "" |
| |
| #: ../../plugins.rst:334 |
| # 7e214f0cab7b4e82bc7b17125b4d573d |
| msgid "The basic procedure for writing a plugin is:" |
| msgstr "" |
| |
| #: ../../plugins.rst:336 |
| # 08098d9c051a422f9f119e12fb801b90 |
| msgid "Write the code and create the other files needed. You will need the plugin code itself (in Javascript), a thumbnail image, the plugin listing, and a CSS file." |
| msgstr "" |
| |
| #: ../../plugins.rst:344 |
| # 23807d67ae0347b3bf61aac8b62dab08 |
| msgid "All UI plugins have the following set of files:" |
| msgstr "" |
| |
| #: ../../plugins.rst:359 |
| # 26387214ce7d4db38de919e4af305edc |
| msgid "The same files must also be present at `/tomcat/webapps/client/plugins`." |
| msgstr "" |
| |
| #: ../../plugins.rst:362 |
| # 88678459528c45bcb71214b6c06cbe00 |
| msgid "The CloudStack administrator adds the folder containing your plugin code under the CloudStack PLUGINS folder." |
| msgstr "" |
| |
| #: ../../plugins.rst:369 |
| # b7a4f78ddc254478acac9a6d4896db7f |
| msgid "The administrator also adds the name of your plugin to the plugin.js file in the PLUGINS folder." |
| msgstr "" |
| |
| #: ../../plugins.rst:376 |
| # b4a1e6dcbbe943b7b02eff49df570e25 |
| msgid "The next time the user refreshes the UI in the browser, your plugin will appear in the left navigation bar." |
| msgstr "" |
| |
| #: ../../plugins.rst:384 |
| # ad4d6a6816c34431bad231e9fdf8b2c4 |
| msgid "How to Write a Plugin: Implementation Details" |
| msgstr "" |
| |
| #: ../../plugins.rst:386 |
| # 32860106c46f407caa5037981b45fd0a |
| msgid "This section requires an understanding of JavaScript and the CloudStack API. You don't need knowledge of specific frameworks for this tutorial (jQuery, etc.), since the CloudStack UI handles the front-end rendering for you." |
| msgstr "" |
| |
| #: ../../plugins.rst:391 |
| # d43ce7e869b44abb8aa8ced854031f33 |
| msgid "There is much more to the CloudStack UI framework than can be described here. The UI is very flexible to handle many use cases, so there are countless options and variations. The best reference right now is to read the existing code for the main UI, which is in the /ui folder. Plugins are written in a very similar way to the main UI." |
| msgstr "" |
| |
| #: ../../plugins.rst:397 |
| # c983b0a3b2e34f47891a7f3e21d300aa |
| msgid "**Create the directory to hold your plugin.**" |
| msgstr "" |
| |
| #: ../../plugins.rst:399 |
| # 7fcc90ae1483437c8452ecd3a63cb12e |
| msgid "All plugins are composed of set of required files in the directory /ui/plugins/pluginID, where pluginID is a short name for your plugin. It's recommended that you prefix your folder name (for example, bfMyPlugin) to avoid naming conflicts with other people's plugins." |
| msgstr "" |
| |
| #: ../../plugins.rst:405 |
| # cea645979e1e42dfa9fb8a4e6c835b14 |
| msgid "In this example, the plugin is named csMyFirstPlugin." |
| msgstr "" |
| |
| #: ../../plugins.rst:418 |
| # dac80f13146d46d69f6024199420a5f1 |
| msgid "**Change to your new plugin directory.**" |
| msgstr "" |
| |
| #: ../../plugins.rst:425 |
| # 4649d30c029947efb26e9689fe4d0a42 |
| msgid "**Set up the listing.**" |
| msgstr "" |
| |
| #: ../../plugins.rst:427 |
| # da3530d14f3141bf8fd825e1d590183a |
| msgid "Add the file `config.js`, using your favorite editor." |
| msgstr "" |
| |
| #: ../../plugins.rst:433 |
| # 7a6b02d1946d4f2293b3fec3d21d8545 |
| msgid "Add the following content to config.js. This information will be displayed on the plugin listing page in the UI:" |
| msgstr "" |
| |
| #: ../../plugins.rst:449 |
| # e5bb9ce4c369479cbe7cc590e7865105 |
| msgid "**Add a new main section.**" |
| msgstr "" |
| |
| #: ../../plugins.rst:451 |
| # c6a54f8b6b2542779303438bf225ead2 |
| msgid "Add the file csMyFirstPlugin.js, using your favorite editor." |
| msgstr "" |
| |
| #: ../../plugins.rst:457 |
| # e9a74896a2564517ab0b1cad702af069 |
| msgid "Add the following content to csMyFirstPlugin.js:" |
| msgstr "" |
| |
| #: ../../plugins.rst:477 |
| # 6b508943154f4a91ad9212145454b729 |
| msgid "**Register the plugin.**" |
| msgstr "" |
| |
| #: ../../plugins.rst:479 |
| # 99232d63e1574ee0a219e4f47db26c12 |
| msgid "You now have the minimal content needed to run the plugin, so you can activate the plugin in the UI by adding it to plugins.js. First, edit the file:" |
| msgstr "" |
| |
| #: ../../plugins.rst:489 |
| # aecc1460eb7a4f39bfc2974ccbd9c8df |
| msgid "Now add the following to plugins.js:" |
| msgstr "" |
| |
| #: ../../plugins.rst:500 |
| # dda46490dded4befab18cc890e4a8685 |
| msgid "**Check the plugin in the UI.**" |
| msgstr "" |
| |
| #: ../../plugins.rst:502 |
| # 64676cd9d1b945ccbb61f2660ad70c96 |
| msgid "First, copy all the plugin code that you have created so far to `/tomcat/webapps/client/plugins`. Then refresh the browser and click Plugins in the side navigation bar. You should see your new plugin." |
| msgstr "" |
| |
| #: ../../plugins.rst:506 |
| # 3b028f17d2f94b28966e30fe979808a7 |
| msgid "**Make the plugin do something.**" |
| msgstr "" |
| |
| #: ../../plugins.rst:508 |
| # 6c65b20c7e6f487ca68539eab0b480d3 |
| msgid "Right now, you just have placeholder content in the new plugin. It's time to add real code. In this example, you will write a basic list view, which renders data from an API call. You will list all virtual machines owned by the logged-in user. To do this, replace the 'show' function in the plugin code with a 'listView' block, containing the required syntax for a list view. To get the data, use the listVirtualMachines API call. Without any parameters, it will return VMs only for your active user. Use the provided 'apiCall' helper method to handle the server call. Of course, you are free to use any other method for making the AJAX call (for example, jQuery's $.ajax method)." |
| msgstr "" |
| |
| #: ../../plugins.rst:520 |
| # 813e82c6e71c4a11b86c8fcb1997906b |
| msgid "First, open your plugin's JavaScript source file in your favorite editor:" |
| msgstr "" |
| |
| #: ../../plugins.rst:529 |
| # 2d33a542619b4d55a0e9f87a9516a1dd |
| msgid "Add the following code in csMyFirstPlugin.js:" |
| msgstr "" |
| |
| #: ../../plugins.rst:573 |
| # 436498903a8348ca82d0c2b7e7c474bd |
| msgid "**Test the plugin.**" |
| msgstr "" |
| |
| #: ../../plugins.rst:575 |
| # fc6df374ec774dcca802ea34ff7af4c1 |
| msgid "First, copy all the plugin code that you have created so far to `/tomcat/webapps/client/plugins`. Then refresh the browser. You can see that your placeholder content was replaced with a list table, containing 4 columns of virtual machine data." |
| msgstr "" |
| |
| #: ../../plugins.rst:580 |
| # ac308906d1774a4181bf17b00da818ea |
| msgid "**Add an action button.**" |
| msgstr "" |
| |
| #: ../../plugins.rst:582 |
| # 83bd0fe3cefa45a393d1a3ff21a4ce34 |
| msgid "Let's add an action button to the list view, which will reboot the VM. To do this, add an actions block under listView. After specifying the correct format, the actions will appear automatically to the right of each row of data." |
| msgstr "" |
| |
| #: ../../plugins.rst:592 |
| # 7d22cbd6ab2c4a4da120584e0b7e9dfb |
| msgid "Now add the following new code in csMyFirstPlugin.js. (The dots ... show where we have omitted some existing code for the sake of space. Don't actually cut and paste that part):" |
| msgstr "" |
| |
| #: ../../plugins.rst:677 |
| # 5acc3c90549c46adaff6a95a22b18e8d |
| msgid "**Add the thumbnail icon.**" |
| msgstr "" |
| |
| #: ../../plugins.rst:679 |
| # 645ff826822448548982c45e8aa9e189 |
| msgid "Create an icon file; it should be square, about 50x50 pixels, and named `icon.png`. Copy it into the same directory with your plugin code: `cloudstack/ui/plugins/csMyFirstPlugin/icon.png`." |
| msgstr "" |
| |
| #: ../../plugins.rst:683 |
| # dc9c9e24edb440f6a5daefbe14510efe |
| msgid "**Add the stylesheet.**" |
| msgstr "" |
| |
| #: ../../plugins.rst:685 |
| # 176437827f1047cbbfb1eb8b39f7f054 |
| msgid "Create a CSS file, with the same name as your `.js` file. Copy it into the same directory with your plugin code: `cloudstack/ui/plugins/csMyFirstPlugin/csMyFirstPlugin.css`." |
| msgstr "" |
| |
