Content publish
Last updated
Last updated
The Job serves as a critical component for publishing content/collection objects submitted for publishing within the system. It fulfils various essential functions to ensure a seamless and efficient publishing process:
Download and ECAR Packaging: The Job is responsible for downloading media files and packaging them into ECAR (E-content Archive) format, enabling offline consumption of content.
Collection Hierarchy Publishing: It handles the publishing of updated or edited collection hierarchy data, ensuring that changes are correctly reflected in the published content.
Metadata Update: The Job updates the metadata of content/collection object nodes with essential publish information, including ECAR paths, versionKey, pkgVersion, streamingUrl, status, and other relevant details.
Elastic Search Indexing: For efficient search and retrieval, the Job indexes collection leaf node objects to Elastic Search, enabling streamlined access to content data.
Redis Cache Clearing: To maintain data integrity and consistency, the Job clears cached node data from Redis, ensuring that users always access up-to-date information.
Output Topics: The Job generates output topics for post-publish processing, video stream generation (if streaming is enabled and the content is of streamable mimeType)
By performing these essential functions, the Job plays a crucial role in ensuring the successful and accurate publishing of content/collection objects. It ensures that published content is properly packaged, metadata is updated, indexing is efficient, and caches are cleared for optimal user experience. Ultimately, the Job contributes to a robust and reliable publishing process within the system.
During the deployment process, the configuration for all knowledge-platform-jobs is sourced from the sunbird-learning-platform repository. On the other hand, for local setups, the configuration is taken from the respective job folders within the knowledge-platform-jobs repository.
Kafka Topic:
Job configuration variables:
content.bundleLocation
Used to specify local/server folder location where artifacts are to be downloaded for ECAR bundling. Default value: "/data/contentBundle/"
content.isECARExtractionEnabled
Used to specify if the ECAR extraction is to be enabled to object 'version' and 'latest' cloud location using its 'snapshot' version. Default value: true
content.retry_asset_download_count
Used to specify number of times download attempt for assets part of content/collection object is to be done till it is successfully downloaded. Default value: 1
content.tmp_file_location
NOT USED
content.objectType
Used to specify list of valid objectTypes supported for publishing. Default value: ["Content", "ContentImage"]
content.mimeType
Used to specify list of valid mimeTypes supported for publishing. Default value: ["application/pdf"]
content.asset_download_duration
Used to specify time in seconds to wait for the asset download request to respond. Default value: "60 seconds"
content.stream.enabled
Used to check if streaming is enabled for published objects. If it is enabled, content rendenring is done using 'streamingUrl' attribute else via 'artifactUrl' Default value: false
content.stream.mimeType
Used to check if the mimeType of the object being published is of streamable type. If yes, event for video-stream-generator job is generated. Default value: ["video/mp4"]
content.artifact.size.for_online
Used to set the maximum size of the object (in bytes) that can be played by downloading beyond which "contentDisposition" is set to "online-only". Default value: 209715200
content.downloadFiles.spine
Used to specify list of attributes that store asset Urls which are to be downloaded from the mentioned Urls while packaging SPINE ECAR. Default value: ["appIcon"]
content.downloadFiles.full
Used to specify list of attributes that store asset Urls which are to be downloaded from the mentioned Urls while packaging FULL ECAR. Default value: ["appIcon", "grayScaleAppIcon", "artifactUrl", "itemSetPreviewUrl", "media"]
content.nested.fields
Used to specify the list of object properties that are of object types with nested attributes. Default value: ["badgeAssertions","targets","badgeAssociations"]
cloud_storage.folder.content
Used to specify the cloud store container folder name for content file storage/extraction etc. Default value: "container"
cloud_storage.folder.artifact
Used to specify the cloud store container folder name for artifact (media) files storage. Default value: "artifact"
contentTypeToPrimaryCategory
Used to specify the mapping between contentType and primaryCategory attributes using which object metadata is populated with the missing attribute among two. Default value: []
compositesearch.index.name
Used to specify the composite search index name where collection object nodes are synced with updated metadata. Default value: "compositesearch"
search.document.type
Used to specify the ElasticSearch document index type using which collection object nodes are synced with updated metadata. Default value: "cs"
master.category.validation.enabled
Used to specify whether object getting published is to be enriched with framework metadata. Default value: "Yes"
service.print.basePath
NOT USED
mimetype.allowed_extensions.word
Used to specify the list of file extensions allowed for uploaded content object. Default value: ["doc", "docx", "ppt", "pptx", "key", "odp", "pps", "odt", "wpd", "wps", "wks"]
enableDIALContextUpdate
Used to sepcify if the DIAL code context update data is to be computed using the linked/de-linked Dial codes of the content/collection.
Sample Kafka event:
Dependency:
Services: Content Service - composite search API
Jobs: 'post-publish-processor', 'video-stream-generator' & 'mvc-indexer'
