[ { "path": ".gitignore", "content": ".idea\n.aws-credentials\n.terraform\n*terraform.tfvars\n*.tfstate\n*.tfstate.backup\n*.terraform.tfstate.lock.info\ncredentials.txt\n.terraform.lock.hcl\n*.tfvars\n*.pem\n\n### docker-compose kitchen\n.data\nhsperfdata_root\n\n### Ignore till reviewd\nto-be-reviewed\n\n\n\n\n### coding-tasks\n\nnode_modules\npackage-lock.json\n\n\n### ansible-kitchen\n\n.vagrant\n*.retry\n.venv\n\n# pre and post tasks folders (user defined)\npre_tasks/\npost_tasks/\n.kitchen/\n.kitchen.local.yml\n.bundle\n\n\n## python\n__pycache__\n\n\n## go\npkg\nbin\n\n## node\n.env\n\n## python\nvenv\n\n## Temp\nhome/infrastructure-as-code/terraform/oci/task-004-kubernetes-cluster/\nhome/infrastructure-as-code/terraform/oci/task-005-set-up-resource-discovery/\n\n## tmp\ntmp\n\n## Private\n.private" }, { "path": "README.md", "content": "# Home\n\n> [Auto](https://github.com/codeaprendiz/learn_fullstack/blob/main/home/php/intermediate/taskset_intermediate_php/task_004_createGlobalMarkdownTable/generate-readme.php) generated ReadMe. Number of tasks: 473\n\n- [cloud certifications](#cloud_certifications)\n- [cloud providers](#cloud_providers)\n- [containers](#containers)\n- [databases](#databases)\n- [devops blogs](#devops_blogs)\n- [infrastructure as code](#infrastructure_as_code)\n- [interview](#interview)\n- [observability](#observability)\n- [os and concepts](#os_and_concepts)\n- [productivity tools](#productivity_tools)\n- [security](#security)\n- [web servers](#web_servers)\n\n## cloud_certifications\n\n| aws |\n|-------------------------------------------|\n| [Tasks: 1](home/cloud_certifications/aws) |\n\n## cloud_providers\n\n| aws | azure | gcp | oci |\n|--------------------------------------|-----------------------------------------|---------------------------------------|--------------------------------------|\n| [Tasks: 9](home/cloud_providers/aws) | [Tasks: 11](home/cloud_providers/azure) | [Tasks: 42](home/cloud_providers/gcp) | [Tasks: 3](home/cloud_providers/oci) |\n\n## containers\n\n| docker | docker_compose | kubernetes |\n|-------------------------------------|---------------------------------------------|-----------------------------------------|\n| [Tasks: 33](home/containers/docker) | [Tasks: 16](home/containers/docker_compose) | [Tasks: 67](home/containers/kubernetes) |\n\n## databases\n\n| mongo | mssql | mysql | oracle19c | postgreSQL |\n|----------------------------------|-----------------------------------|----------------------------------|--------------------------------------|---------------------------------------|\n| [Tasks: 4](home/databases/mongo) | [Tasks: 38](home/databases/mssql) | [Tasks: 6](home/databases/mysql) | [Tasks: 1](home/databases/oracle19c) | [Tasks: 7](home/databases/postgreSQL) |\n\n## devops_blogs\n\n\n## infrastructure_as_code\n\n| ansible | aws_terraform | gcp_terraform | oci_terraform |\n|--------------------------------------------------|--------------------------------------------------------|-------------------------------------------------------|-------------------------------------------------------|\n| [Tasks: 10](home/infrastructure_as_code/ansible) | [Tasks: 31](home/infrastructure_as_code/terraform/aws) | [Tasks: 8](home/infrastructure_as_code/terraform/gcp) | [Tasks: 4](home/infrastructure_as_code/terraform/oci) |\n\n## interview\n\n| coding_assignments |\n|------------------------------------------------|\n| [Tasks: 11](home/interview/coding_assignments) |\n\n## observability\n\n| metrics | opentelemetry | prometheus |\n|----------------------------------------|----------------------------------------------|-------------------------------------------|\n| [Tasks: 3](home/observability/metrics) | [Tasks: 2](home/observability/opentelemetry) | [Tasks: 3](home/observability/prometheus) |\n\n## os_and_concepts\n\n| commands_linux | commands_windows | concepts_linux |\n|---------------------------------------------------|---------------------------------------------------|--------------------------------------------------|\n| [Tasks: 131](home/os_and_concepts/commands_linux) | [Tasks: 7](home/os_and_concepts/commands_windows) | [Tasks: 14](home/os_and_concepts/concepts_linux) |\n\n## productivity_tools\n\n| |\n|-------------------------------------|\n| [Tasks: 6](home/productivity_tools) |\n\n## security\n\n| trivy |\n|---------------------------------|\n| [Tasks: 1](home/security/trivy) |\n\n## web_servers\n\n| nginx |\n|------------------------------------|\n| [Tasks: 4](home/web_servers/nginx) |\n" }, { "path": "ReadMe_static.md", "content": "# ToDos\n\n- SAST\n- DAST\n- IAST\n\n- Checkmarx\n- Trivy\n- SonarQube\n" }, { "path": "_config.yml", "content": "theme: jekyll-theme-cayman" }, { "path": "home/cloud_certifications/aws/ReadMe.md", "content": "# taskset_aws_cloud_certifications\n\n> [Auto](https://github.com/codeaprendiz/learn_fullstack/blob/main/home/php/intermediate/taskset_intermediate_php/task_004_createGlobalMarkdownTable/generate-readme.php) generated ReadMe. Number of tasks: 1\n\n| Task | Description |\n|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------|\n| task_001 | [task_001_aws_certified_solutions_architect_professional](taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional) |\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/ReadMe.md", "content": "[Cheat Sheet - AWS Pro Path](https://tutorialsdojo.com/aws-certified-solutions-architect-professional)\n\n[Free AWS Learning Plan](https://explore.skillbuilder.aws/learn/signin)\n\n[Comparision of AWS Services](https://tutorialsdojo.com/comparison-of-aws-services)\n\n- [API Gateway](apiGateway.md)\n- [Application DiscoveryService](applicationDiscoveryService.md)\n- [Aurora](aurora.md)\n- [Backup](backup.md)\n- [Batch](batch.md)\n- [Best Practices](bestPractices.md)\n- [Billing And Cost Management](billingAndCostManagement.md)\n- [Certificate Manager](certificateManager.md)\n- [Cloud Adoption Readiness Tool CART](cloudAdoptionReadinessTool.md)\n- [Cloud Formation](cloudFormation.md)\n- [Cloud Front](cloudFront.md)\n- [CloudHSM](cloudHSM.md)\n- [CloudSearch](cloudSearch.md)\n- [CloudTrail](cloudTrail.md)\n- [CloudWatch](cloudwatch.md)\n- [CloudWatchLogs](cloudWatchLogs.md)\n- [CodeBuild](codeBuild.md)\n- [CodeCommit](codeCommit.md)\n- [CodeDeploy](codeDeploy.md)\n- [CodePipeline](codePipeline.md)\n- [Cognito](cognito.md)\n- [Command Line Interface](commandLineInterface.md)\n- [Config](config.md)\n- [Connect](connect.md)\n- [ControlTower](awsControlTower.md)\n- [Data Migration Service](dataMigrationService.md)\n- [DeveloperToolsConsole](developerToolsConsole.md)\n- [Direct Connect](directConnect.md)\n- [Dynamo DB](dynamodb.md)\n- [EC2](ec2.md)\n- [EC2 Autoscaling](ec2AutoScaling.md)\n- [ECS](ecs.md)\n- [ElasticBeanStalk](elasticBeanStalk.md)\n- [Event Bridge](eventBridge.md)\n- [Elastic Cache](elasticCache.md)\n- [Elastic File System](elasticFileSystem.md)\n- [Elastic Load Balancing](elasticLoadBalancing.md)\n- [Guard Duty](guardDuty.md)\n- [IAM](iam.md)\n- [Inspector](inspector.md)\n- [Kinesis](kinesis.md)\n- [Lambda](lambda.md)\n- [Lex](lex.md)\n- [Macie](macie.md)\n- [Mechanical Turk](mechanicalTurk.md)\n- [Migration Hub](migrationHub.md)\n- [OpsWorks](opsworks.md)\n- [Organization](organizations.md)\n- [Quick Sight](quickSight.md)\n- [RDS](rds.md)\n- [Redshift](redShift.md)\n- [Rekognition](rekognition.md)\n- [Resource Access Manager](resourceAccessManager.md)\n- [Route53](route53.md)\n- [S3](s3.md)\n- [SageMaker](sageMaker.md)\n- [Schema Conversion Tool](schemaConversionTool.md)\n- [Secrets Manager](secretsManager.md)\n- [Security Token Service](securityTokenService.md)\n- [Serverless Application Model](serverlessApplicationModel.md)\n- [Server Migration Service](serverMigrationService.md)\n- [Service Catalog](serviceCatalog.md)\n- [Shield](shield.md)\n- [Simple Notification Service](simpleNotificationService.md)\n- [Simple Queue Service](simpleQueueService.md)\n- [Simple Workflow Service](simpleWorkflowService.md)\n- [Single Sing-On](singleSignOn.md)\n- [Snowball](snowball.md)\n- [Snowball Edge](snowballEdge.md)\n- [Storage Gatway](storageGateway.md)\n- [System Manager](systemManager.md)\n- [Transcribe](transcribe.md)\n- [VPC](vpc.md)\n- [WAF](waf.md)\n- [Web Identify Federation](webIdentifyFederation.md)\n- [Well-Architected](wellArchitected.md)\n- [Whitepapers](whitepapers.md)" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/apiGateway.md", "content": "# API Gateway\n\n- [CheatSheet - API Gateway](https://tutorialsdojo.com/amazon-api-gateway)\n- [CheatSheet - How to invalidate API gateway cache](https://tutorialsdojo.com/how-to-invalidate-api-gateway-cache)\n- [FAQs - API Gateway](https://aws.amazon.com/api-gateway/faqs)\n\n## Enabling API caching to enhance responsiveness\n\n[Enabling API caching to enhance responsiveness](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-caching.html)\n\n- You can enable API caching in Amazon API Gateway to cache your endpoint's responses.\n- With caching, you can reduce the number of calls made to your endpoint and also improve the latency of requests to your API.\n- When you enable caching for a stage, API Gateway caches responses from your endpoint for a specified time-to-live (TTL) period, in seconds.\n- API Gateway then responds to the request by looking up the endpoint response from the cache instead of making a request to your endpoint\n- The default TTL value for API caching is 300 seconds. The maximum TTL value is 3600 seconds. TTL=0 means caching is disabled.\n\n## Working with WebSocket APIs\n\n[Working with WebSocket APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-websocket-api.html)\n\n- A WebSocket API in API Gateway is a collection of WebSocket routes that are integrated with backend HTTP endpoints, Lambda functions, or other AWS services.\n- API Gateway WebSocket APIs are bidirectional. A client can send messages to a service, and services can independently send messages to clients\n- This bidirectional behavior enables richer client/service interactions because services can push data to clients without requiring clients to make an explicit request\n- WebSocket APIs are often used in real-time applications such as chat applications, collaboration platforms, multiplayer games, and financial trading platforms.\n\n\n### Use @connections commands in your backend service\n\n[Use @connections commands in your backend service](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-how-to-call-websocket-api-connections.html)\n\nYour backend service can use the following WebSocket connection HTTP requests to send a callback message to a connected client, get connection information, or disconnect the client\n\n```bash\nPOST https://{api-id}.execute-api.us-east-1.amazonaws.com/{stage}/@connections/{connection_id}\n```\n\n### Lambda Integration\n\n#### Understand API Gateway Lambda proxy integration\n\n[Understand API Gateway Lambda proxy integration](https://docs.aws.amazon.com/apigateway/latest/developerguide/set-up-lambda-proxy-integrations.html)\n\n- Amazon API Gateway Lambda proxy integration is a simple, powerful, and nimble mechanism to build an API with a setup of a single API method\n- The Lambda proxy integration allows the client to call a single Lambda function in the backend. \n- The function accesses many resources or features of other AWS services, including calling other Lambda functions.\n\n\n## Tutorials\n\n### Tutorial: Create a REST API as an Amazon Kinesis proxy in API Gateway\n\n[Tutorial: Create a REST API as an Amazon Kinesis proxy in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/integrating-api-with-aws-services-kinesis.html)\n\n\n## Notes\n\n- Lambda can scale faster than the regular Auto Scaling feature of Amazon EC2, Amazon Elastic Beanstalk, or Amazon ECS. This is because AWS Lambda is more lightweight than other computing services" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/applicationDiscoveryService.md", "content": "# AWS Application Discovery Service\n\n[What Is AWS Application Discovery Service?](https://docs.aws.amazon.com/application-discovery/latest/userguide/what-is-appdiscovery.html)\n\n- AWS Application Discovery Service helps you plan your migration to the AWS cloud by collecting usage and configuration data about your on-premises servers.\n- Application Discovery Service is integrated with AWS Migration Hub, which simplifies your migration tracking as it aggregates your migration status information into a single console. \n- You can view the discovered servers, group them into applications, and then track the migration status of each application from the Migration Hub console in your home region.\n- All discovered data is stored in your AWS Migration Hub home region. \n- Therefore, you must set your home region in the Migration Hub console or with CLI commands before performing any discovery and migration activities. \n- Your data can be exported for analysis in Microsoft Excel or AWS analysis tools such as Amazon Athena and Amazon QuickSight.\n- Application Discovery Service offers two ways of performing discovery and collecting data about your on-premises servers:\n - Agentless discovery can be performed by deploying the AWS Agentless Discovery Connector (OVA file) through your VMware vCenter\n - Agent-based discovery can be performed by deploying the AWS Application Discovery Agent on each of your VMs and physical servers.\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/aurora.md", "content": "# Aurora\n\n[Cheat Sheet - RDS](https://tutorialsdojo.com/amazon-relational-database-service-amazon-rds)\n\n[What is Amazon Aurora?](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html)\n\n- Amazon Aurora (Aurora) is a fully managed relational database engine that's compatible with MySQL and PostgreSQL\n- The code, tools, and applications you use today with your existing MySQL and PostgreSQL databases can be used with Aurora.\n- With some workloads, Aurora can deliver up to five times the throughput of MySQL and up to three times the throughput of PostgreSQL without requiring changes to most of your existing applications.\n\n## Amazon Aurora DB clusters\n\n[Amazon Aurora DB clusters](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.html)\n\n- An Amazon Aurora DB cluster consists of one or more DB instances and a cluster volume that manages the data for those DB instances.\n- An Aurora cluster volume is a virtual database storage volume that spans multiple Availability Zones, with each Availability Zone having a copy of the DB cluster data.\n - Primary DB instance – Supports read and write operations, and performs all of the data modifications to the cluster volume. Each Aurora DB cluster has one primary DB instance.\n - Aurora Replica – Connects to the same storage volume as the primary DB instance and supports only read operations. Each Aurora DB cluster can have up to 15 Aurora Replicas in addition to the primary DB instance\n\n### Amazon Aurora storage and reliability\n\n[Amazon Aurora storage and reliability](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.StorageReliability.html)\n\n- Aurora data is stored in the cluster volume, which is a single, virtual volume that uses solid state drives (SSDs).\n- A cluster volume consists of copies of the data across three Availability Zones in a single AWS Region\n- Aurora cluster volumes automatically grow as the amount of data in your database increases. \n- An Aurora cluster volume can grow to a maximum size of 128 tebibytes (TiB). \n- Even though an Aurora cluster volume can grow up to 128 tebibytes (TiB), you are only charged for the space that you use in an Aurora cluster volume.\n\n### High availability for Amazon Aurora\n\n[High availability for Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Concepts.AuroraHighAvailability.html)\n\n- The Amazon Aurora architecture involves separation of storage and compute\n- The data remains safe even if some or all of the DB instances in the cluster become unavailable.\n\n\n## Managing DB instance\n\n[Working with storage for Amazon RDS DB instances](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html)\n\n- To specify how you want your data stored in Amazon RDS, choose a storage type and provide a storage size when you create or modify a DB instance.\n- Later, you can increase the amount or change the type of storage by modifying the DB instance.\n\n### Overview of Amazon Aurora global databases\n\n[Overview of Amazon Aurora global databases](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database.html#aurora-global-database-overview)\n\n- Amazon Aurora global databases span multiple AWS Regions, enabling low latency global reads and providing fast recovery from the rare outage that might affect an entire AWS Region. \n- An Aurora global database has a primary DB cluster in one Region, and up to five secondary DB clusters in different Regions.\n\n### Connecting to an Amazon Aurora global database\n\nHow you connect to an Aurora global database depends on whether you need to write to the database or read from the database:\n- For read-only requests or queries, you connect to the reader endpoint for the Aurora cluster in your AWS Region.\n- To run data manipulation language (DML) or data definition language (DDL) statements, you connect to the cluster endpoint for the primary cluster. This endpoint might be in a different AWS Region than your application." }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/awsControlTower.md", "content": "# ControlTower\n\n- AWS Organizations is an account management service that lets you consolidate multiple AWS accounts into an organization that you create and centrally manage\n- With Organizations, you can create member accounts and invite existing accounts to join your organization. \n- You can organize those accounts into groups and attach policy-based controls\n- In AWS Control Tower, Organizations helps centrally manage billing; control access, compliance, and security; and share resources across your member AWS accounts. \n- Accounts are grouped into logical groups, called organizational units (OUs)" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/backup.md", "content": "# AWS Backup\n\n## Restoring a Storage Gateway volume\n\n[Restoring a Storage Gateway volume](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-storage-gateway.html)\n\n- If you are restoring an AWS Storage Gateway volume snapshot, you can choose to restore the snapshot as an Storage Gateway volume or as an Amazon EBS volume." }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/batch.md", "content": "# Batch\n\n[What Is AWS Batch?](https://docs.aws.amazon.com/batch/latest/userguide/what-is-batch.html)\n\n[Cheat Sheet - AWS Batch](https://tutorialsdojo.com/aws-batch)\n\n- helps you to run batch computing workloads on the AWS Cloud\n- is a common way for developers, scientists, and engineers to access large amounts of compute resources\n- removes the undifferentiated heavy lifting of configuring and managing the required infrastructure, similar to traditional batch computing software\n- This service can efficiently provision resources in response to jobs submitted in order to eliminate capacity constraints, reduce compute costs, and deliver results quickly.\n\n\n## Compute environment\n\n[Compute environment](https://docs.aws.amazon.com/batch/latest/userguide/compute_environments.html)\n\n- Job queues are mapped to one or more compute environments. \n- Compute environments contain the Amazon ECS container instances that are used to run containerized batch jobs\n\n\n\n## Use Cases\n\n[AWS Batch Use cases](https://aws.amazon.com/batch/use-cases)\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/bestPractices.md", "content": "# Best Practices\n\n## Migration Strategies\n\n[CheatSheet - aws-migration-strategies-the-6-rs](https://tutorialsdojo.com/aws-migration-strategies-the-6-rs)\n\n[Phase 2: Plan](https://docs.aws.amazon.com/prescriptive-guidance/latest/strategy-database-migration/planning-phase.html)\n\n\n6 Application Migration Strategies: “The 6 R’s”\n\n- Rehosting : Otherwise known as `lift-and-shift`.\n - large legacy migration scenario where the organization is looking to scale its migration quickly to meet a business case, we find that the majority of applications are rehosted.\n- Replatforming : I sometimes call this `lift-tinker-and-shift`.\n - Here you might make a few cloud (or other) optimizations in order to achieve some tangible benefit, but you aren’t otherwise changing the core architecture of the application.\n - You may be looking to reduce the amount of time you spend managing database instances by migrating to a database-as-a-service platform like Amazon Relational Database Service (Amazon RDS), or migrating your application to a fully managed platform like Amazon Elastic Beanstalk.\n\n- Repurchasing : Moving to a different product.\n - I most commonly see repurchasing as a move to a SaaS platform. \n- Refactoring / Re-architecting : Re-imagining how the application is architected and developed, typically using cloud-native features.\n - This is typically driven by a strong business need to add features, scale, or performance that would otherwise be difficult to achieve in the application’s existing environment.\n- Retire : Get rid of.\n - Once you’ve discovered everything in your environment, you might ask each functional area who owns each application. \n - We’ve found that as much as 10% (I’ve seen 20%) of an enterprise IT portfolio is no longer useful, and can simply be turned off. \n- Retain : Usually this means “revisit” or do nothing (for now).\n - Maybe you’re still riding out some depreciation, aren’t ready to prioritize an application that was recently upgraded, or are otherwise not inclined to migrate some applications. \n - You should only migrate what makes sense for the business;\n\n## Disaster Recovery\n\n[Disaster Recovery Slides](https://www.slideshare.net/AmazonWebServices/disaster-recovery-options-with-aws)" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/billingAndCostManagement.md", "content": "# Billing And Cost Management\n\n[What is AWS Billing?](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-what-is.html)\n\n[CheatSheet - AWS Billing And Cost Management](https://tutorialsdojo.com/aws-billing-and-cost-management)\n\n\n## Consolidated billing for AWS Organization\n\n### Reserved Instances\n\n#### Turning off reserved instances and Savings Plans discount sharing\n\n- The management account of an organization can turn off Reserved Instance (RI) discount and Savings Plans discount sharing for any accounts in that organization, including the management account\n- This means that RIs and Savings Plans discounts aren't shared between any accounts that have sharing turned off. \n- To share an RI or Savings Plans discount with an account, both accounts must have sharing turned on\n\n[Cost Alloc Tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)\n- After you activate cost allocation tags, AWS uses the cost allocation tags\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/certificateManager.md", "content": "# Certificate Manager\n\n[AWS Certificate Manager](https://aws.amazon.com/certificate-manager)\n\n- AWS Certificate Manager is a service that lets you easily provision, manage, and deploy public and private Secure Sockets Layer/Transport Layer Security (SSL/TLS) certificates for use with AWS services and your internal connected resources. \n- SSL/TLS certificates are used to secure network communications and establish the identity of websites over the Internet as well as resources on private networks.\n\n\n> To use a certificate with Elastic Load Balancing for the same site (the same fully qualified domain name, or FQDN, or set of FQDNs) in a different Region, you must request a new certificate for each Region in which you plan to use it.\n\n> Two use an ACM certificate with Amazon CloudFront, you must request the certificate in the US East (N. Virginia) region.\n\n\n### Services integrated with AWS Certificate Manager\n\n\n[Services integrated with AWS Certificate Manager](https://docs.aws.amazon.com/acm/latest/userguide/acm-services.html)\n\n## FAQs\n\n[FAQs](https://aws.amazon.com/certificate-manager/faqs)" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/cloudAdoptionReadinessTool.md", "content": "# AWS Cloud Adoption Readiness Tool (CART)\n\n[AWS Cloud Adoption Readiness Tool (CART)](https://cloudreadiness.amazonaws.com/#/cart)\n\n\n- Assess your organization’s cloud migration readiness with sixteen questions and set a path for cloud adoption success.\n- The AWS Cloud Adoption Readiness Tool (CART) helps organizations of all sizes develop efficient and effective plans for cloud adoption and enterprise cloud migrations. \n- This 16-question online survey and assessment report details your cloud migration readiness across six perspectives including business, people, process, platform, operations, and security.\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/cloudFormation.md", "content": "# CloudFormation\n\n[What is AWS CloudFormation?](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)\n\n[Cheat Sheet - AWS CloudFormation](https://tutorialsdojo.com/aws-cloudformation)\n\n[Cheat Sheet - aws-cloudformation-stacksets-and-nested-stacks](https://tutorialsdojo.com/aws-cloudformation-stacksets-and-nested-stacks)\n\n[Cheat Sheet - Elastic Beanstalk vs CloudFormation vs OpsWorks vs CodeDeploy](https://tutorialsdojo.com/elastic-beanstalk-vs-cloudformation-vs-opsworks-vs-codedeploy)\n\n- AWS CloudFormation is a service that helps you model and set up your AWS resources so that you can spend less time managing those resources and more time focusing on your applications that run in AWS.\n- You create a template that describes all the AWS resources that you want (like Amazon EC2 instances or Amazon RDS DB instances), and CloudFormation takes care of provisioning and configuring those resources for you.\n\n\n\n### Working with AWS CloudFormation StackSets\n\n[AWS CloudFormation StackSets](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html)\n\n- AWS CloudFormation StackSets extends the functionality of stacks by enabling you to create, update, or delete stacks across multiple accounts and Regions with a single operation.\n\n### Updating stacks using change sets\n\n[Updating stacks using change sets](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-changesets.html)\n\n- When you need to update a stack, understanding how your changes will affect running resources before you implement them can help you update stacks with confidence\n- Change sets allow you to preview how proposed changes to a stack might impact your running resources, for example, whether your changes will delete or replace any critical resources, AWS CloudFormation makes the changes to your stack only when you decide to execute the change set, allowing you to decide whether to proceed with your proposed changes or explore other changes by creating another change set.\n\n```bash\n CloudFormation CLI create-change-set\n```\n\n### Conditionally create resources for a production, development, or test stack\n\n[Conditionally create resources for a production, development, or test stack](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/conditions-sample-templates.html)\n\n- In some cases, you might want to create stacks that are similar but with minor tweaks. \n- For example, you might have a template that you use for production applications. \n- You want to create the same production stack so that you can use it for development or testing.\n\n### Exporting stack output values\n\n[Exporting stack output values](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-exports.html)\n\n- To share information between stacks, export a stack's output values. \n- Other stacks that are in the same AWS account and region can import the exported values.\n\n### Listing stacks that import an exported output value\n\n[Listing stacks that import an exported output value](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-imports.html)\n\n- When you export an output value, stacks that are in the same AWS account and region can import that value. \n- To see which stacks are importing a particular output value, use the list import action.\n\n\n### DeletionPolicy attribute\n\n[DeletionPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html)\n\n- With the DeletionPolicy attribute you can preserve, and in some cases, backup a resource when its stack is deleted. \n- You specify a DeletionPolicy attribute for each resource that you want to control. \n- If a resource has no DeletionPolicy attribute, AWS CloudFormation deletes the resource by default.\n\n> The default policy is Snapshot for AWS::RDS::DBCluster resources and for AWS::RDS::DBInstance resources that don't specify the DBClusterIdentifier property.\n\n\n**DeletionPolicy options**\n\n- Delete\n - CloudFormation deletes the resource and all its content if applicable during stack deletion\n - By default, if you don't specify a DeletionPolicy, CloudFormation deletes your resources.\n- Retain\n - CloudFormation keeps the resource without deleting the resource or its contents when its stack is deleted.\n- Snapshot\n - For resources that support snapshots, CloudFormation creates a snapshot for the resource before deleting it\n\n\n### UpdateReplacePolicy attribute\n\n[UpdateReplacePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-updatereplacepolicy.html)\n\n- Use the UpdateReplacePolicy attribute to retain or, in some cases, backup the existing physical instance of a resource when it's replaced during a stack update operation.\n- When you initiate a stack update, AWS CloudFormation updates resources based on differences between what you submit and the stack's current template and parameters. \n- If you update a resource property that requires that the resource be replaced, CloudFormation recreates the resource during the update. \n- Recreating the resource generates a new physical ID.\n\n\n### Walkthrough: Refer to resource outputs in another AWS CloudFormation stack\n\n[Walkthrough: Refer to resource outputs in another AWS CloudFormation stack](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/walkthrough-crossstackref.html)\n\n- To export resources from one AWS CloudFormation stack to another, create a cross-stack reference. Cross-stack references let you use a layered or service-oriented architecture. \n- Instead of including all resources in a single stack, you create related AWS resources in separate stacks; then you can refer to required resource outputs from other stacks. \n- By restricting cross-stack references to outputs, you control the parts of a stack that are referenced by other stacks.\n\n\n- There are some limitations if there is a cross-stack reference\n between two CloudFormation stacks. Stack A cannot be deleted if it has a resource output\n that is referenced by stack B.\n- You cannot modify the output value that is referenced by\n another stack\n- you can update stack B to remove the cross-stack reference.\n\n\n### Custom resources\n\n[Custom resources](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-custom-resources.html)\n\n\n- Custom resources enable you to write custom provisioning logic in templates that AWS CloudFormation runs anytime you create, update (if you changed the custom resource), or delete stacks. \n- For example, you might want to include resources that aren't available as AWS CloudFormation resource types. \n- You can include those resources by using custom resources.\n\n**How custom resources work**\n\n- The template developer defines a custom resource in their template, which includes a service token and any input data parameters. Depending on the custom resource, the input data might be required; however, the service token is always required.\n- The service token specifies where AWS CloudFormation sends requests to, such as an Amazon SNS topic ARN or an AWS Lambda function ARN\n\n\n \n## Intrinsic Functions\n\n[Intrinsic function reference](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference.html)\n\n- AWS CloudFormation provides several built-in functions that help you manage your stacks. Use intrinsic functions in your templates to assign values to properties that are not available until runtime.\n\n\n### Using dynamic references to specify template values\n\n\n[Using dynamic references to specify template values](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/dynamic-references.html)\n\n- Dynamic references provide a compact, powerful way for you to specify external values that are stored and managed in other services, such as the Systems Manager Parameter Store, in your stack templates. \n- When you use a dynamic reference, CloudFormation retrieves the value of the specified reference when necessary during stack and change set operations.\n- CloudFormation currently supports the following dynamic reference patterns:\n - ssm, for plaintext values stored in AWS Systems Manager Parameter Store.\n - ssm-secure, for secure strings stored in AWS Systems Manager Parameter Store.\n - secretsmanager, for entire secrets or specific secret values that are stored in AWS Secrets Manager.\n\n\n\n### Fn::GetAtt\n\n[Fn::GetAtt](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html)\n\n- The Fn::GetAtt intrinsic function returns the value of an attribute from a resource in the template\n\n## Blogs\n\n[Use CloudFormation StackSets to Provision Resources Across Multiple AWS Accounts and Regions](https://aws.amazon.com/blogs/aws/use-cloudformation-stacksets-to-provision-resources-across-multiple-aws-accounts-and-regions)\n\n\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/cloudFront.md", "content": "# Cloudfront\n\n[Cheat Sheet - Cloudfront](https://tutorialsdojo.com/amazon-cloudfront)\n\n[geoproximity-routing-vs-geolocation-routing](https://tutorialsdojo.com/latency-routing-vs-geoproximity-routing-vs-geolocation-routing)\n\n## What is Amazon CloudFront?\n\n[What is Amazon CloudFront?](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Introduction.html)\n\n- Amazon CloudFront is a web service that speeds up distribution of your static and dynamic web content, such as .html, .css, .js, and image files, to your users. \n- CloudFront delivers your content through a worldwide network of data centers called edge locations. \n- When a user requests content that you're serving with CloudFront, the request is routed to the edge location that provides the lowest latency (time delay), so that content is delivered with the best possible performance.\n\n- If the content is already in the edge location with the lowest latency, CloudFront delivers it immediately.\n\n- If the content is not in that edge location, CloudFront retrieves it from an origin that you've defined—such as an Amazon S3 bucket, a MediaPackage channel, or an HTTP server (for example, a web server) that you have identified as the source for the definitive version of your content.\n\n\n## Restricting the geographic distribution of your content\n\n[Restricting the geographic distribution of your content](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/georestrictions.html)\n\n- You can use geo restriction, also known as geo blocking, to prevent users in specific geographic locations from accessing content that you're distributing through a CloudFront distribution. \n- To use geo restriction, you have two options:\n\n - Use the CloudFront geo restriction feature. \n - Use this option to restrict access to all of the files that are associated with a distribution and to restrict access at the country level.\n\n - Use a third-party geolocation service. Use this option to restrict access to a subset of the files that are associated with a distribution or to restrict access at a finer granularity than the country level.\n\n## Optimizing Caching and availability\n\n### Optimizing high availability with CloudFront origin failover\n\n[Optimizing high availability with CloudFront origin failover](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/high_availability_origin_failover.html)\n\n\n- You can set up CloudFront with origin failover for scenarios that require high availability. \n- To get started, you create an origin group with two origins: a primary and a secondary. \n- If the primary origin is unavailable, or returns specific HTTP response status codes that indicate a failure, CloudFront automatically switches to the secondary origin.\n\n\n## Configuring secure access and restricting access to content\n\n### Using field-level encryption to help protect sensitive data\n\n[Using field-level encryption to help protect sensitive data](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/field-level-encryption.html)\n\n- With Amazon CloudFront, you can enforce secure end-to-end connections to origin servers by using HTTPS\n- Field-level encryption adds an additional layer of security that lets you protect specific data throughout system processing so that only certain applications can see it.\n- Field-level encryption allows you to enable your users to securely upload sensitive information to your web servers.\n- The sensitive information provided by your users is encrypted at the edge, close to the user, and remains encrypted throughout your entire application stack. \n- This encryption ensures that only applications that need the data and have the credentials to decrypt it are able to do so.\n- To use field-level encryption, when you configure your CloudFront distribution, specify the set of fields in POST requests that you want to be encrypted, and the public key to use to encrypt them. \n- You can encrypt up to 10 data fields in a request\n\n\n### Using AWS WAF to control access to your content\n\n[Using AWS WAF to control access to your content](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-awswaf.html)\n\n- AWS WAF is a web application firewall that lets you monitor the HTTP and HTTPS requests that are forwarded to CloudFront, and lets you control access to your content\n- Based on conditions that you specify, such as the values of query strings or the IP addresses that requests originate from, CloudFront responds to requests either with the requested content or with an HTTP status code 403 (Forbidden). \n\n### Restricting access to Amazon S3 content by using an origin access identity (OAI)\n\n[Restricting access to Amazon S3 content by using an origin access identity (OAI)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-restricting-access-to-s3.html)\n\nTo restrict access to content that you serve from Amazon S3 buckets, follow these steps:\n- Create a special CloudFront user called an origin access identity (OAI) and associate it with your distribution\n- Configure your S3 bucket permissions so that CloudFront can use the OAI to access the files in your bucket and serve them to your users. Make sure that users can’t use a direct URL to the S3 bucket to access a file there.\n\n### Restricting access to files on custom origins\n\n[Restricting access to files on custom origins](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-overview.html#forward-custom-headers-restrict-access)\n\n- If you use a custom origin, you can optionally set up custom headers to restrict access. \n- But by using custom headers, you can further restrict access to your content so that users can access it only through CloudFront, not directly. \n- To require that users access content through CloudFront, change the following settings in your CloudFront distributions:\n - Origin Custom Headers: Configure CloudFront to forward custom headers to your origin.\n\n## Serving private content with signed URLs and signed cookies\n\n[Serving private content with signed URLs and signed cookies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html)\n\n- Many companies that distribute content over the internet want to restrict access to documents, business data, media streams, or content that is intended for selected users, for example, users who have paid a fee.\n - Require that your users access your private content by using special CloudFront signed URLs or signed cookies.\n - Require that your users access your content by using CloudFront URLs, not URLs that access content directly on the origin server (for example, Amazon S3 or a private HTTP server).\n\n## Optimizing caching and availability\n\n### Increasing the proportion of requests that are served directly from the CloudFront caches (cache hit ratio)\n\n[Increasing the proportion of requests that are served directly from the CloudFront caches (cache hit ratio)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cache-hit-ratio.html)\n\n- You can improve performance by increasing the proportion of your viewer requests that are served directly from the CloudFront cache instead of going to your origin servers for content. \n- This is known as improving the cache hit ratio.\n\n- Specifying how long CloudFront caches your objects\n - To increase your cache hit ratio, you can configure your origin to add a Cache-Control max-age directive to your objects, and specify the longest practical value for max-age\n\n\n### Requiring HTTPS for communication between viewers and CloudFront\n\n[Requiring HTTPS for communication between viewers and CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-https-viewers-to-cloudfront.html)\n\n- You can configure one or more cache behaviors in your CloudFront distribution to require HTTPS for communication between viewers and CloudFront. \n- You also can configure one or more cache behaviors to allow both HTTP and HTTPS, so that CloudFront requires HTTPS for some objects but not for others. \n- The configuration steps depend on which domain name you're using in object URLs:\n\n - If you're using the domain name that CloudFront assigned to your distribution, such as d111111abcdef8.cloudfront.net, you change the Viewer Protocol Policy setting for one or more cache behaviors to require HTTPS communication. In that configuration, CloudFront provides the SSL/TLS certificate.\n - If you're using your own domain name, such as example.com, you need to change several CloudFront settings. You also need to use an SSL/TLS certificate provided by AWS Certificate Manager (ACM), or import a certificate from a third-party certificate authority into ACM or the IAM certificate store.\n\n\n### Managing how long content stays in the cache (expiration)\n\n[Managing how long content stays in the cache (expiration)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html)\n\n- You can control how long your files stay in a CloudFront cache before CloudFront forwards another request to your origin\n - If the CloudFront cache already has the latest version, the origin returns a status code 304 Not Modified.\n - If the CloudFront cache does not have the latest version, the origin returns a status code 200 OK and the latest version of the file.\n\n\n\n## Customizing at the edge with Lambda@Edge\n\n[Customizing at the edge with Lambda@Edge](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/lambda-at-the-edge.html)\n\n- Lambda@Edge is an extension of AWS Lambda, a compute service that lets you execute functions that customize the content that CloudFront delivers.\n\n- When you associate a CloudFront distribution with a Lambda@Edge function, CloudFront intercepts requests and responses at CloudFront edge locations. You can execute Lambda functions when the following CloudFront events occur:\n - When CloudFront receives a request from a viewer (viewer request)\n - Before CloudFront forwards a request to the origin (origin request)\n - When CloudFront receives a response from the origin (origin response)\n - Before CloudFront returns the response to the viewer (viewer response)\n\n[Get started creating and using Lambda@Edge functions](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/lambda-edge-how-it-works.html)\n\n\n## Request and response behavior for custom origins\n\n### User-Agent header\n\n[User-Agent header](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/RequestAndResponseBehaviorCustomOrigin.html#request-custom-user-agent-header)\n\n- If you want CloudFront to cache different versions of your objects based on the device that a user is using to view your content, we recommend that you configure CloudFront to forward one or more of the following headers to your custom origin:\n - CloudFront-Is-Desktop-Viewer\n - CloudFront-Is-Mobile-Viewer\n - CloudFront-Is-SmartTV-Viewer\n - CloudFront-Is-Tablet-Viewer\n\n## Blogs\n\n[How do I use CloudFront to serve a static website hosted on Amazon S3?](https://aws.amazon.com/premiumsupport/knowledge-center/cloudfront-serve-static-website)\n\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/cloudHSM.md", "content": "# CloudHSM\n\n[AWS CloudHSM](https://aws.amazon.com/cloudhsm)\n\n\n- AWS CloudHSM is a cloud-based hardware security module (HSM) that enables you to easily generate and use your own encryption keys on the AWS Cloud\n\n\n## Improve Your Web Server's Security with SSL/TLS Offload in AWS CloudHSM\n\n[Improve Your Web Server's Security with SSL/TLS Offload in AWS CloudHSM](https://docs.aws.amazon.com/cloudhsm/latest/userguide/ssl-offload.html)\n\n- Web servers and their clients (web browsers) can use Secure Sockets Layer (SSL) or Transport Layer Security (TLS). \n- These protocols confirm the identity of the web server and establish a secure connection to send and receive webpages or other data over the internet. This is commonly known as HTTPS.\n\n\n### How SSL/TLS Offload with AWS CloudHSM Works\n\n\n[How SSL/TLS Offload with AWS CloudHSM Works](https://docs.aws.amazon.com/cloudhsm/latest/userguide/ssl-offload-overview.html)\n\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/cloudTrail.md", "content": "# CloudTrail\n\n[Cheat Sheet - AWS CloudTrail](https://tutorialsdojo.com/aws-cloudtrail)\n\n## What Is AWS CloudTrail?\n\n\n[What Is AWS CloudTrail?](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html)\n\n- AWS CloudTrail is an AWS service that helps you enable governance, compliance, and operational and risk auditing of your AWS account. \n- Actions taken by a user, role, or an AWS service are recorded as events in CloudTrail. \n- Events include actions taken in the AWS Management Console, AWS Command Line Interface, and AWS SDKs and APIs.\n\n\n### Global service events \n\n[Global service events](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-concepts.html#cloudtrail-concepts-global-service-events)\n\n- For most services, events are recorded in the region where the action occurred. \n- For global services such as AWS Identity and Access Management (IAM), AWS STS, and Amazon CloudFront, events are delivered to any trail **that includes global services**.\n\n## Identities\n\n### Logging IAM and AWS STS API calls with AWS CloudTrail\n\n[Logging IAM and AWS STS API calls with AWS CloudTrail](https://docs.aws.amazon.com/IAM/latest/UserGuide/cloudtrail-integration.html)\n\n- IAM and AWS STS are integrated with AWS CloudTrail, a service that provides a record of actions taken by an IAM user or role. \n- CloudTrail captures all API calls for IAM and AWS STS as events, including calls from the console and from API calls. \n- If you create a trail, you can enable continuous delivery of CloudTrail events to an Amazon S3 bucket. \n- If you don't configure a trail, you can still view the most recent events in the CloudTrail console in Event history\n\n## Blogs\n\n- [How to Audit Cross-Account Roles Using AWS CloudTrail and Amazon CloudWatch Events](https://aws.amazon.com/blogs/security/how-to-audit-cross-account-roles-using-aws-cloudtrail-and-amazon-cloudwatch-events)" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/cloudWatchLogs.md", "content": "# CloudWatch Logs\n\n- You can use Amazon CloudWatch Logs to monitor, store, and access your log files from Amazon Elastic Compute Cloud (Amazon EC2) instances, AWS CloudTrail, Route 53, and other sources.\n- CloudWatch Logs enables you to centralize the logs from all of your systems, applications, and AWS services that you use, in a single, highly scalable service. \n- CloudWatch Logs enables you to see all of your logs, regardless of their source, as a single and consistent flow of events ordered by time, and you can query them and sort them based on other dimensions, group them by specific fields, create custom computations with a powerful query language, and visualize log data in dashboards.\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/cloudsearch.md", "content": "# CloudSearch\n\n[Amazon CloudSearch](https://aws.amazon.com/cloudsearch)\n\n[Cheat Sheet - Amazon CloudSearch](https://tutorialsdojo.com/amazon-cloudsearch)\n\n- Amazon CloudSearch is a managed service in the AWS Cloud that makes it simple and cost-effective to set up, manage, and scale a search solution for your website or application." }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/cloudwatch.md", "content": "# CloudWatch\n\n[Cheat Sheet - CloudWatch](https://tutorialsdojo.com/amazon-cloudwatch)\n\n[cloudwatch-agent-vs-ssm-agent-vs-custom-daemon-scripts](https://tutorialsdojo.com/cloudwatch-agent-vs-ssm-agent-vs-custom-daemon-scripts)\n\n## Schedule Expressions for Rules\n\n[Schedule Expressions for Rules](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html)\n\n- You can create rules that self-trigger on an automated schedule in CloudWatch Events using cron or rate expressions. \n- All scheduled events use UTC time zone and the minimum precision for schedules is 1 minute.\n\n## Analyzing log data with CloudWatch Logs Insights\n\n[Analyzing log data with CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)\n\n- CloudWatch Logs Insights enables you to interactively search and analyze your log data in Amazon CloudWatch Logs\n- You can perform queries to help you more efficiently and effectively respond to operational issues\n- If an issue occurs, you can use CloudWatch Logs Insights to identify potential causes and validate deployed fixes\n\n\n### Installing the CloudWatch agent on on-premises servers\n\n[Installing the CloudWatch agent on on-premises servers](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-premise.html)\n\n- If you have downloaded the CloudWatch agent on one computer and created the agent configuration file you want, you can use that configuration file to install the agent on other on-premises servers.\n\n## Using Amazon CloudWatch alarms\n\n[Using Amazon CloudWatch alarms](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)\n\n- You can create both metric alarms and composite alarms in CloudWatch.\n - A metric alarm \n - watches a single CloudWatch metric or the result of a math expression based on CloudWatch metrics. \n - The alarm performs one or more actions based on the value of the metric or expression relative to a threshold over a number of time periods. \n - The action can be sending a notification to an Amazon SNS topic, performing an Amazon EC2 action or an Amazon EC2 Auto Scaling action, or creating an OpsItem or incident in Systems Manager\n - A composite alarm \n - includes a rule expression that takes into account the alarm states of other alarms that you have created. \n - The composite alarm goes into ALARM state only if all conditions of the rule are met. \n - The alarms specified in a composite alarm's rule expression can include metric alarms and other composite alarms.\n\n\n## Creating metrics from log events using filters\n\n- You can search and filter the log data coming into CloudWatch Logs by creating one or more metric filters. \n- Metric filters define the terms and patterns to look for in log data as it is sent to CloudWatch Logs. \n- CloudWatch Logs uses these metric filters to turn log data into numerical CloudWatch metrics that you can graph or set an alarm on.\n\n### Creating metric filters\n\n[Creating metric filters](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/MonitoringPolicyExamples.html)\n\n\n\n[Monitoring deployments with Amazon CloudWatch Events](https://docs.aws.amazon.com/codedeploy/latest/userguide/monitoring-cloudwatch-events.html)\n\n\n- You can use Amazon CloudWatch Events to detect and react to changes in the state of an instance or a deployment (an \"event\") in your CodeDeploy operations. \n- Then, based on rules you create, CloudWatch Events will invoke one or more target actions when a deployment or instance enters the state you specify in a rule. \n- Depending on the type of state change, you might want to send notifications, capture state information, take corrective action, initiate events, or take other actions. \n- You can select the following types of targets when using CloudWatch Events as part of your CodeDeploy operations:\n - AWS Lambda functions\n - Kinesis streams\n - Amazon SQS queues\n \nBuilt-in targets (EC2 CreateSnapshot API call, EC2 RebootInstances API call, EC2 StopInstances API call , and EC2 TerminateInstances API call)\n\nAmazon SNS topics\n\n\n```bash\nThe following are some use cases:\nUse a Lambda function to pass a notification to a Slack channel whenever deployments fail.\nPush data about deployments or instances to a Kinesis stream to support comprehensive, real-time status monitoring.\nUse CloudWatch alarm actions to automatically stop, terminate, reboot, or recover Amazon EC2 instances when a deployment or instance event you specify occurs.\n```\n\n[dynamic-dns-for-route-53](https://aws.amazon.com/blogs/compute/building-a-dynamic-dns-for-route-53-using-cloudwatch-events-and-lambda/)\n\n[Real-time processing of log data with subscriptions](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Subscriptions.html)\n\n- You can use subscriptions to get access to a real-time feed of log events from CloudWatch Logs and have it delivered to other services such as an Amazon Kinesis stream, an Amazon Kinesis Data Firehose stream, or AWS Lambda for custom processing, analysis, or loading to other systems\n\n[Sending and Receiving Events Between AWS Accounts](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEvents-CrossAccountEventDelivery.html)\n\n\nThe overall process is as follows:\n\n- On the receiver account, edit the permissions on the default event bus to allow specified AWS accounts, an organization, or all AWS accounts to send events to the receiver account.\n- On the sender account, set up one or more rules that have the receiver account's default event bus as the target.\n- On the receiver account, set up one or more rules that match events that come from the sender account.\n\n\n#### Creating metrics for log events using filter\n\n##### Filter and Pattern Syntax\n\n[Filter and pattern syntax](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html)\n\n- You can use metric filters to search for and match terms, phrases, or values in your log events. When a metric filter finds one of the terms, phrases, or values in your log events, you can increment the value of a CloudWatch metric. For example, you can create a metric filter to search for and count the occurrence of the word ERROR in your log events.\n- When a metric filter finds one of the matching terms, phrases, or values in your log events, it increments the count in the CloudWatch metric by the amount you specify for Metric Value. The metric value is aggregated and reported every minute.\n\n##### Example: Count HTTP 404 codes\n\n- Example: Count HTTP 404 codes\n```bash\nFor Filter Pattern, type [IP, UserInfo, User, Timestamp, RequestInfo, StatusCode=404, Bytes]. \n```\n\n\n#### Publishing custom metrics\n\n[Publishing custom metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/publishingMetrics.html)\n\n[put-metric-data¶](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-data.html)\n\n- You can publish your own metrics to CloudWatch using the AWS CLI or an API. You can view statistical graphs of your published metrics with the AWS Management Console.\n\n- instead of calling put-metric-data multiple times for three data points that are within 3 seconds of each other, you can aggregate the data into a statistic set that you publish with one call, using the --statistic-values parameter.\n\n```bash\naws cloudwatch put-metric-data --metric-name PageViewCount --namespace MyService --statistic-values Sum=11,Minimum=2,Maximum=5,SampleCount=3 --timestamp 2016-10-14T12:00:00.000Z\n```\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/codeBuild.md", "content": "\n### CodeBuild\n\n[Create a build project (console)](https://docs.aws.amazon.com/codebuild/latest/userguide/create-project-console.html)\n\n- We recommend that you store an environment variable with a sensitive value, such as an AWS access key ID, an AWS secret access key, or a password as a parameter in Amazon EC2 Systems Manager Parameter Store or AWS Secrets Manager.\n\n[Docker images provided by CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-available.html)\n\n[Extending AWS CodeBuild with Custom Build Environments](https://aws.amazon.com/blogs/devops/extending-aws-codebuild-with-custom-build-environments/)\n\n- Build environments are Docker images that include a complete file system with everything required to build and test your project.\n To use a custom build environment in a CodeBuild project, you build a container image for your platform that contains your build tools,\n push it to a Docker container registry such as Amazon EC2 Container Registry (ECR), and reference it in the project configuration. When\n building your application, CodeBuild will retrieve the Docker image from the container registry specified in the project configuration\n and use the environment to compile your source code, run your tests, and package your application." }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/codeCommit.md", "content": "> Revision Count: 1\n\n# CodeCommit\n\n[Cheat Sheet - AWS CodeCommit](https://tutorialsdojo.com/aws-codecommit)\n\n## Manage triggers for a repository\n\n[Manage triggers for an AWS CodeCommit repository](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-notify.html)\n\n- You can configure a CodeCommit repository so that code pushes or other events trigger actions, such as sending a notification from Amazon Simple Notification Service (Amazon SNS) or invoking a function in AWS Lambda. \n- You can create up to 10 triggers for each CodeCommit repository.\n- Data in AWS CodeCommit repositories is already encrypted in transit as well as at rest.\n\n### Example: Create an AWS CodeCommit trigger for an Amazon SNS topic\n\n[Example: Create an AWS CodeCommit trigger for an Amazon SNS topic](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-notify-sns.html)\n\n- You can create a trigger for a CodeCommit repository so that events in that repository trigger notifications from an Amazon Simple Notification Service (Amazon SNS) topic\n\n\n### Example: Create an AWS CodeCommit trigger for an AWS Lambda function\n\n[Example: Create an AWS CodeCommit trigger for an AWS Lambda function](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-notify-lambda.html)\n\n- You can create a trigger for a CodeCommit repository so that events in the repository invoke a Lambda function. \n\n\n### Example: auth-and-access-control-iam-identity-based-access-control\n\n[auth-and-access-control-iam-identity-based-access-control](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-iam-identity-based-access-control.html#identity-based-policies-example-4)\n\n- To restrict push to master\n\n```json\n{ \"Effect\": \"Allow\",\n\"Action\": [\n\"codecommit:GitPush\",\n\"codecommit:Merge*\" ],\n\"Resource\": [ \"arn:aws:codecommit:*:*:the-repo-name\" ],\n\"Condition\": {\n\"StringNotEquals\": {\n\"codecommit:References\": [ \"refs/heads/master\" ] }\n}\n}\n```\n\n\n### Migrate a Git repository to AWS CodeCommit\n\n\n[Share the CodeCommit repository](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-migrate-repository-existing.html#how-to-migrate-existing-share)\n\n- When you create a repository in CodeCommit, two endpoints are generated: one for HTTPS connections and one for SSH connections. \n- Both provide secure connections over a network\n\n### Using identity-based policies (IAM Policies) for CodeCommit\n\n[Using identity-based policies (IAM Policies) for CodeCommit](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-iam-identity-based-access-control.html)\n- An account administrator can attach permissions policies to IAM identities (users, groups, and roles) to grant permissions to perform operations on CodeCommit resources.\n- AWS manage policy AWSCodeCommitPowerUser allows users access to CodeCommit but disallows the action of deleting\n CodeCommit repositories.\n\n### Cross-account repository access: Actions for the administrator in AccountA\n\n\n[Cross-account repository access: Actions for the administrator in AccountA](https://docs.aws.amazon.com/codecommit/latest/userguide/cross-account-administrator-a.html)\n\nTo allow users or groups in AccountB to access a repository in AccountA, an AccountA administrator must:\n- Create a policy in AccountA that grants access to the repository.\n- Create a role in AccountA that can be assumed by IAM users and groups in AccountB.\n- Attach the policy to the role.\n\n[Cross-account repository access: Actions for the administrator in AccountB](https://docs.aws.amazon.com/codecommit/latest/userguide/cross-account-administrator-b.html)\n\nTo allow users or groups in AccountB to access a repository in AccountA, the AccountB\nadministrator must create a group in AccountB. This group must be configured with a policy having\naction `\"sts:AssumeRole` that allows group members to assume the role created by the AccountA administrator\n\n### Setup steps for SSH connections to AWS CodeCommit repositories on Linux, macOS, or Unix\n\n[Setup steps for SSH connections to AWS CodeCommit repositories on Linux, macOS, or Unix](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-ssh-unixes.html)\n\n- After you upload the SSH public key for the IAM user, the user can establish SSH connections to the CodeCommit repositories:\n\n#### Supported Operations\n\n[Change branch settings in AWS CodeCommit](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-change-branch.html)\n\n- You can change which branch to use as the default branch in the AWS CodeCommit console or with the AWS CLI. \n- For example, if you created your first commit using a Git client that set the default branch to master, you could create a branch named main, and then change the branch settings so that the new branch is set as the default branch for the repository.\n- To change other branch settings, you can use Git from a local repo connected to the CodeCommit repository.\n\n### Merge a pull request in an AWS CodeCommit repository\n\n[Merge a pull request in an AWS CodeCommit repository](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-merge-pull-request.html)\n\n- After your code has been reviewed and all approval rules (if any) on the pull request have been satisfied, you can merge a pull request in one of several ways: \n - You can use the console to merge your source branch to the destination branch using one of the available merge strategies, which also closes the pull request.\n - You can use the AWS CLI to merge and close the pull request using the fast-forward, squash, or 3-way merge strategy.\n - On your local computer, you can use the git merge command to merge the source branch into the destination branch, and then push your merged code to the destination branch\n\n#### Working with pull requests\n\n[Edit or delete an approval rule for a pull request](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-edit-delete-pull-request-approval-rule.html)\n\n- When you have an approval rule on a pull request, you cannot merge that pull request until its conditions have been met. \n- You can change the approval rules for pull requests to make it easier to satisfy their conditions, or to increase the rigor of reviews. You can change the number of users who must approve a pull request.\n\n#### Working with approval rule templates\n\n[Working with approval rule templates](https://docs.aws.amazon.com/codecommit/latest/userguide/approval-rule-templates.html)\n\n- You can create approval rules for pull requests. To automatically apply approval rules to some or all of the pull requests created in repositories, use approval rule templates. Approval rule templates help you customize your development workflows across repositories so that different branches have appropriate levels of approvals and control. You can define different rules for production and development branches. Those rules are applied every time a pull request that matches the rule conditions is created.\n\n#### Working with branches\n\n[Limit pushes and merges to branches in AWS CodeCommit](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-conditional-branch.html)\n\n- By default, any CodeCommit repository user who has sufficient permissions to push code to the repository can contribute to any branch in that repository.\n\n- For example, this policy denies pushing commits, merging branches, deleting branches, merging pull requests, and adding files to a branch named main and a branch named prod in a repository named MyDemoRepo:\n\n```json\n{\n \"Version\": \"2012-10-17\",\n \"Statement\": [\n {\n \"Effect\": \"Deny\",\n \"Action\": [\n \"codecommit:GitPush\",\n \"codecommit:DeleteBranch\",\n \"codecommit:PutFile\",\n \"codecommit:MergeBranchesByFastForward\",\n \"codecommit:MergeBranchesBySquash\",\n \"codecommit:MergeBranchesByThreeWay\",\n \"codecommit:MergePullRequestByFastForward\",\n \"codecommit:MergePullRequestBySquash\",\n \"codecommit:MergePullRequestByThreeWay\"\n ],\n \"Resource\": \"arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo\",\n \"Condition\": {\n \"StringEqualsIfExists\": {\n \"codecommit:References\": [\n \"refs/heads/main\", \n \"refs/heads/prod\"\n ]\n },\n \"Null\": {\n \"codecommit:References\": \"false\"\n }\n }\n }\n ]\n}\n```\n\n\n\n\n##### Configuring notifications for events in an AWS CodeCommit repository\n\n[Configuring notifications for events in an AWS CodeCommit repository](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-repository-email.html)\n\n- You can set up notification rules for a repository so that repository users receive emails about the repository event types you specify. \n- Notifications are sent when events match the notification rule settings. \n- You can create an Amazon SNS topic to use for notifications or use an existing one in your Amazon Web Services account\n\n#### Security\n\n[Using identity-based policies (IAM Policies) for CodeCommit](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-iam-identity-based-access-control.html#identity-based-policies-example-4)\n\n- identity-based policies demonstrate how an account administrator can attach permissions policies to IAM identities (users, groups, and roles) to grant permissions to perform operations on CodeCommit resources.\n\n- Example\n\n```josn\n{\n \"Version\": \"2012-10-17\",\n \"Statement\" : [\n {\n \"Effect\" : \"Allow\",\n \"Action\" : [\n \"codecommit:BatchGetRepositories\"\n ],\n \"Resource\" : [\n \"arn:aws:codecommit:us-east-2:111111111111:MyDestinationRepo\",\n \"arn:aws:codecommit:us-east-2:111111111111:MyDemo*\"\n ]\n }\n ]\n}\n```\n\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/codeDeploy.md", "content": "## Code Deploy\n\n[Register an on-premises instance with CodeDeploy](https://docs.aws.amazon.com/codedeploy/latest/userguide/on-premises-instances-register.html)\n\n[Use the register command (IAM user ARN) to register an on-premises instance](https://docs.aws.amazon.com/codedeploy/latest/userguide/instances-on-premises-register-instance.html)\n\nThe register command can create an IAM user for the server and register the server with CodeDeploy\n\n```bash\naws deploy register --instance-name AssetTag234AESDD --tags\nKey=Name,Value=CodeDeployDemo-OnPremise --region eu-west-1\n```\n\n[Manually remove on-premises instance tags from an on-premises instance](https://docs.aws.amazon.com/codedeploy/latest/userguide/on-premises-instances-operations-remove-tags.html)\n\nTypically, you remove an on-premises instance tag from an on-premises instance when that tag is no longer being used, or you want to remove the on-premises instance from any deployment groups that rely on that tag. You can use the AWS CLI or the AWS CodeDeploy console to remove on-premises instance tags from on-premises instances.\n\n[Create a deployment group for an in-place deployment (console)]()\n\n[Deployment configurations on an AWS Lambda compute platform](https://docs.aws.amazon.com/codedeploy/latest/userguide/deployment-configurations.html#deployment-configuration-lambda)\n\nThere are three ways traffic can shift during a deployment:\n\n- Canary: Traffic is shifted in two increments. You can choose from predefined canary options that specify the percentage of traffic shifted to your updated Lambda function version in the first increment and the interval, in minutes, before the remaining traffic is shifted in the second increment.\n- Linear: Traffic is shifted in equal increments with an equal number of minutes between each increment. You can choose from predefined linear options that specify the percentage of traffic shifted in each increment and the number of minutes between each increment.\n- All-at-once: All traffic is shifted from the original Lambda function to the updated Lambda function version all at once.\n\n\n### Working with Deployments\n\n[Stop a deployment with CodeDeploy](https://docs.aws.amazon.com/codedeploy/latest/userguide/deployments-stop.html)\n\n- You can use the CodeDeploy console, the AWS CLI, or the CodeDeploy APIs to stop deployments associated with your AWS account.\n\n[Redeploy and roll back a deployment with CodeDeploy](https://docs.aws.amazon.com/codedeploy/latest/userguide/deployments-rollback-and-redeploy.html#deployments-rollback-and-redeploy-manual-rollbacks)\n\n- CodeDeploy rolls back deployments by redeploying a previously deployed revision of an application as a new deployment. These rolled-back deployments are technically new deployments, with new deployment IDs, rather than restored versions of a previous deployment.\n- For an ongoing deployment, you can choose “Stop deployment” or “Stop and roll back deployment” for a deployment.\n\n[Working with deployment configurations in CodeDeploy](https://docs.aws.amazon.com/codedeploy/latest/userguide/deployment-configurations.html)\n\n- A deployment configuration is a set of rules and success and failure conditions used by CodeDeploy during a deployment. These rules and conditions are different, depending on whether you deploy to an EC2/On-Premises compute platform, AWS Lambda compute platform, or Amazon ECS compute platform.\n\n**Predefined deployment configurations for an EC2/on-premises compute platform**\n- Consider an example of 9 instances\n - CodeDeployDefault.AllAtOnce\t\n - In-place deployments: \n - attempts to deploy to all nine instances at once\n - The overall deployment succeeds if deployment to even a single instance is successful.\n - It fails only if deployments to all nine instances fail.\n - BlueGreen\n - Deployment to replacement environment: Follows the same deployment rules as CodeDeployDefault.AllAtOnce for in-place deployments.\n - Traffic rerouting: \n - Routes traffic to all instances in the replacement environment at once. \n - Succeeds if traffic is successfully rerouted to at least one instance. \n - Fails after rerouting to all instances fails.\n - CodeDeployDefault.HalfAtATime\t\n - CodeDeployDefault.OneAtATime\t\n\n**Deployment configurations on an AWS Lambda compute platform**\n\n- When you deploy to an AWS Lambda compute platform, the deployment configuration specifies the way traffic is shifted to the new Lambda function versions in your application\n - Canary: Traffic is shifted in two increments. You can choose from predefined canary options that specify the percentage of traffic shifted to your updated Lambda function version in the first increment and the interval, in minutes, before the remaining traffic is shifted in the second increment. \n - Linear: Traffic is shifted in equal increments with an equal number of minutes between each increment. You can choose from predefined linear options that specify the percentage of traffic shifted in each increment and the number of minutes between each increment. \n - All-at-once: All traffic is shifted from the original Lambda function to the updated Lambda function version all at once.\n\nPredefined deployment configurations for an AWS Lambda compute platform (for all please refer the documentation)\n- CodeDeployDefault.LambdaCanary10Percent5Minutes: Shifts 10 percent of traffic in the first increment. The remaining 90 percent is deployed five minutes later.\n- CodeDeployDefault.LambdaLinear10PercentEvery3Minutes : Shifts 10 percent of traffic every three minutes until all traffic is shifted.\n- CodeDeployDefault.LambdaAllAtOnce: Shifts all traffic to the updated Lambda functions at once.\n\n\n### Supported By\n\n**CanaryDeployment**\n- AWS Lambda\n- ECS\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/codePipeline.md", "content": "\n### CodePipeline\n\n[Grant approval permissions to an IAM user in CodePipeline](https://docs.aws.amazon.com/codepipeline/latest/userguide/approvals-iam-permissions.html)\n\n- attaching the AWSCodePipelineApproverAccess managed policy to an IAM user\n\n[Approve or reject an approval action in CodePipeline](https://docs.aws.amazon.com/codepipeline/latest/userguide/approvals-approve-or-reject.html)\n\n[Invoke an AWS Lambda function in a pipeline in CodePipeline](https://docs.aws.amazon.com/codepipeline/latest/userguide/actions-invoke-lambda-function.html)\n\n- Do not log the JSON event that CodePipeline sends to Lambda because this can result in user credentials being logged in CloudWatch Logs. The CodePipeline role uses a JSON event to pass temporary credentials to Lambda in the artifactCredentials field.\n\n[CodePipeline pipeline structure reference](https://docs.aws.amazon.com/codepipeline/latest/userguide/reference-pipeline-structure.html)\n\n- To specify parallel actions, use the same integer for each action you want to run in parallel. In the console, you can specify a serial sequence for an action by choosing Add action group at the level in the stage where you want it to run, or you can specify a parallel sequence by choosing Add action. Action group refers to a run order of one or more actions at the same level\n- different action groups have different runOrder values and their actions do not run in parallel.\n\n[Configure server-side encryption for artifacts stored in Amazon S3 for CodePipeline](https://docs.aws.amazon.com/codepipeline/latest/userguide/S3-artifact-encryption.html)\n\n```json\n{\n \"Version\": \"2012-10-17\",\n \"Id\": \"SSEAndSSLPolicy\",\n \"Statement\": [\n {\n \"Sid\": \"DenyUnEncryptedObjectUploads\",\n \"Effect\": \"Deny\",\n \"Principal\": \"*\",\n \"Action\": \"s3:PutObject\",\n \"Resource\": \"arn:aws:s3:::codepipeline-us-west-2-89050EXAMPLE/*\",\n \"Condition\": {\n \"StringNotEquals\": {\n \"s3:x-amz-server-side-encryption\": \"aws:kms\"\n }\n }\n },\n {\n \"Sid\": \"DenyInsecureConnections\",\n \"Effect\": \"Deny\",\n \"Principal\": \"*\",\n \"Action\": \"s3:*\",\n \"Resource\": \"arn:aws:s3:::codepipeline-us-west-2-89050EXAMPLE/*\",\n \"Condition\": {\n \"Bool\": {\n \"aws:SecureTransport\": \"false\"\n }\n }\n }\n ]\n}\n```\n\n\n[FAQ](https://aws.amazon.com/codepipeline/faqs/)\n\n- Pipeline actions occur in a specified order, in serial or in parallel, as determined in the configuration of the stage\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/cognito.md", "content": "> Revision Count: 0\n\n# AWS Cognito\n\n[What Is Amazon Cognito?](https://docs.aws.amazon.com/cognito/latest/developerguide/what-is-amazon-cognito.html)\n\n[Cheat Sheet - Cognito](https://tutorialsdojo.com/amazon-cognito)\n\n[Cheat Sheet - Amazon Cognito User and Identity Pools Explained](https://tutorialsdojo.com/amazon-cognito-user-pools-and-identity-pools-explained)\n\n- Amazon Cognito provides authentication, authorization, and user management for your web and mobile apps. \n- Your users can sign in directly with a user name and password, or through a third party such as Facebook, Amazon, Google or Apple.\n- The two main components of Amazon Cognito are user pools and identity pools. \n - User pools are user directories that provide sign-up and sign-in options for your app users. \n - Identity pools enable you to grant your users access to other AWS services. \n- You can use identity pools and user pools separately or together.\n\n\n## Amazon Cognito Identity Pools (Federated Identities)\n\n[Amazon Cognito Identity Pools (Federated Identities)](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-identity.html)\n\n- Amazon Cognito identity pools (federated identities) enable you to create unique identities for your users and federate them with identity providers.\n- With an identity pool, you can obtain temporary, limited-privilege AWS credentials to access other AWS services\n\n### Identity Pools (Federated Identities) External Identity Providers\n\n[Identity Pools (Federated Identities) External Identity Providers](https://docs.aws.amazon.com/cognito/latest/developerguide/external-identity-providers.html)\n\n- Using the logins property, you can set credentials received from an identity provider. \n- Moreover, you can associate an identity pool with multiple identity providers.\n- For example, you could set both the Facebook and Google tokens in the logins property, so that the unique Amazon Cognito identity would be associated with both identity provider logins\n- No matter which account the end user uses for authentication, Amazon Cognito returns the same user identifier.\n\n#### Open ID Connect Providers (Identity Pools)\n\n[Open ID Connect Providers (Identity Pools](https://docs.aws.amazon.com/cognito/latest/developerguide/open-id.html)\n\n- OpenID Connect is an open standard for authentication that is supported by a number of login providers\n- Amazon Cognito supports linking of identities with OpenID Connect providers that are configured through AWS Identity and Access Management.\n\n## Integrating Amazon Cognito with web and mobile apps\n\n[Integrating Amazon Cognito with web and mobile apps](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-integrate-apps.html)\n\n[simplifying-token-vending-machine-deployment-with-aws-cloudformation](https://aws.amazon.com/blogs/mobile/simplifying-token-vending-machine-deployment-with-aws-cloudformation)\n\n- By integrating Amazon Cognito with your client code, you connect your app to backend AWS functionality that aids authentication and authorization workflows.\n- Your app will use the Amazon Cognito API to, for example, create new users in your user pool, retrieve user pool tokens, and obtain temporary credentials from your identity pool. \n- To integrate Amazon Cognito with your web or mobile app, use the SDKs and libraries that the AWS Amplify framework provides.\n\n\n### Amazon Cognito user pools\n\n[Amazon Cognito user pools](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-identity-pools.html)\n\n- A user pool is a user directory in Amazon Cognito. \n- With a user pool, your users can sign in to your web or mobile app through Amazon Cognito. \n- Your users can also sign in through social identity providers like Google, Facebook, Amazon, or Apple, and through SAML identity providers. \n- Whether your users sign in directly or through a third party, all members of the user pool have a directory profile that you can access through a Software Development Kit (SDK).\n\n## SSO FAQs\n\n[Single Sign On FAQs](https://aws.amazon.com/single-sign-on/faqs)\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/commandLineInterface.md", "content": "# Command Line Interface\n\n\n## Configuration AWS CLI\n\n### Using an HTTP proxy\n\n[Using an HTTP proxy](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-proxy.html)\n\n- To access AWS through proxy servers, you can configure the HTTP_PROXY and HTTPS_PROXY environment variables with either the DNS domain names or IP addresses and port numbers that your proxy servers use." }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/config.md", "content": "# Config\n\n[What Is AWS Config?](https://docs.aws.amazon.com/config/latest/developerguide/WhatIsConfig.html)\n\n- AWS Config provides a detailed view of the configuration of AWS resources in your AWS account. This includes how the resources are related to one another and how they were configured in the past so that you can see how the configurations and relationships change over time\n\n[Cheat Sheet - AWS Config](https://tutorialsdojo.com/aws-config)\n\n- AWS Config provides a detailed view of the configuration of AWS resources in your AWS account.\n- This includes how the resources are related to one another and how they were configured in the past so that you can see how the configurations and relationships change over time.\n- An AWS resource is an entity you can work with in AWS, such as an Amazon Elastic Compute Cloud (EC2) instance, an Amazon Elastic Block Store (EBS) volume, a security group, or an Amazon Virtual Private Cloud (VPC). \n\nWith AWS Config, you can do the following:\n\n- Evaluate your AWS resource configurations for desired settings.\n- Get a snapshot of the current configurations of the supported resources that are associated with your AWS account.\n- Retrieve configurations of one or more resources that exist in your account.\n- Retrieve historical configurations of one or more resources.\n- Receive a notification whenever a resource is created, modified, or deleted.\n- View relationships between resources. For example, you might want to find all resources that use a particular security group.\n\n[AWS Config](https://aws.amazon.com/config/)\n\n- AWS Config is a service that enables you to assess, audit, and evaluate the configurations of your AWS resources.\n- Config continuously monitors and records your AWS resource configurations and allows you to automate the evaluation of recorded configurations against desired configurations. \n- With Config, you can review changes in configurations and relationships between AWS resources, dive into detailed resource configuration histories, and determine your overall compliance against the configurations specified in your internal guidelines.\n\n## AWS Config Managed Rules\n\n[AWS Config Managed Rules](https://docs.aws.amazon.com/config/latest/developerguide/evaluate-config_use-managed-rules.html)\n\n- AWS Config provides AWS managed rules, which are predefined, customizable rules that AWS Config uses to evaluate whether your AWS resources comply with common best practices.\n- For example, you could use a managed rule to quickly start assessing whether your Amazon Elastic Block Store (Amazon EBS) volumes are encrypted or whether specific tags are applied to your resources\n- You can set up and activate these rules without writing the code to create an AWS Lambda function, which is required if you want to create custom rules.\n- The AWS Config console guides you through the process of configuring and activating a managed rule.\n\nThe evaluation triggers are defined as part of the rule, and they can include the following types:\n\n- Configuration changes\n - AWS Config triggers the evaluation when any resource that matches the rule's scope changes in configuration. The evaluation runs after AWS Config sends a configuration item change notification.\n- Periodic\n - AWS Config runs evaluations for the rule at a frequency that you choose (for example, every 24 hours).\n\n\n### Managed Rules\n\n[List of AWS Config Managed Rules](https://docs.aws.amazon.com/config/latest/developerguide/managed-rules-by-aws-config.html)\n\n- [approved-amis-by-id](https://docs.aws.amazon.com/config/latest/developerguide/approved-amis-by-id.html)\n - Checks if running instances are using specified AMIs. Specify a list of approved AMI IDs. Running instances with AMIs that are not on this list are NON_COMPLIANT.\n\n\n---\n\n\n\n\n\n\n\n### Viewing Compliance History Timeline for Resources\n\n[Viewing Compliance History Timeline for Resources](https://docs.aws.amazon.com/config/latest/developerguide/view-compliance-history.html)\n\n- AWS Config supports storing compliance state changes of resources as evaluated by AWS Config Rules. The resource compliance history is presented in the form of a timeline. The timeline captures changes as ConfigurationItems over a period of time for a specific resource.\n\n### AWS Config Rules\n\n#### Specifying Triggers\n\n[Specifying Triggers for AWS Config Rules](https://docs.aws.amazon.com/config/latest/developerguide/evaluate-config-rules.html)\n\n- When you add a rule to your account, you can specify when you want AWS Config to run the rule; this is called a trigger. AWS Config evaluates your resource configurations against the rule when the trigger occurs.\n- There are two types of triggers:\n - Configuration changes\n - Periodic\n\n#### Managing Rules\n\n##### restricted-ssh\n\n[restricted-ssh](https://docs.aws.amazon.com/config/latest/developerguide/restricted-ssh.html)\n\n- Checks if the incoming SSH traffic for the security groups is accessible. The rule is COMPLIANT when IP addresses of the incoming SSH traffic in the security groups are restricted (CIDR other than 0.0.0.0/0). This rule applies only to IPv4.\n\n#### Remediating Noncompliant AWS Resources by AWS Config Rules\n\n[Remediating Noncompliant AWS Resources by AWS Config Rules](https://docs.aws.amazon.com/config/latest/developerguide/remediation.html)\n\n- AWS Config allows you to remediate noncompliant resources that are evaluated by AWS Config Rules. AWS Config applies remediation using AWS Systems Manager Automation documents. These documents define the actions to be performed on noncompliant AWS resources evaluated by AWS Config Rules.\n\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/connect.md", "content": "# Connect\n\n\n[Amazon Connect](https://aws.amazon.com/connect)\n\n- Provide superior customer service at a lower cost with an easy-to-use omnichannel cloud contact center\n\n\n## Blogs\n\n[Easily set up interactive messages for your Amazon Connect chatbot](https://aws.amazon.com/blogs/contact-center/easily-set-up-interactive-messages-for-your-amazon-connect-chatbot)" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/dataMigrationService.md", "content": "# Data Migration Service\n\n[AWS Data Migration Service](https://aws.amazon.com/dms)\n\n\n[Cheatsheet - AWS Data Migration Service](https://tutorialsdojo.com/aws-database-migration-service)\n\n- AWS Database Migration Service (AWS DMS) helps you migrate databases to AWS quickly and securely. \n- The source database remains fully operational during the migration, minimizing downtime to applications that rely on the database. \n- The AWS Database Migration Service can migrate your data to and from the most widely used commercial and open-source databases.\n- AWS Database Migration Service supports homogeneous migrations such as Oracle to Oracle, as well as heterogeneous migrations between different database platforms, such as Oracle or Microsoft SQL Server to Amazon Aurora\n\n\n## How AWS Database Migration Service works\n\n[How AWS Database Migration Service works](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Introduction.html)\n\n- AWS Database Migration Service (AWS DMS) is a web service that you can use to migrate data from a source data store to a target data store. \n- These two data stores are called endpoints. \n- You can migrate between source and target endpoints that use the same database engine, such as from an Oracle database to an Oracle database. \n- You can also migrate between source and target endpoints that use different database engines, such as from an Oracle database to a PostgreSQL database. \n- The only requirement to use AWS DMS is that one of your endpoints must be on an AWS service." }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/developerToolsConsole.md", "content": "### DeveloperToolsConsole\n\n[Security for features of the Developer Tools console](https://docs.aws.amazon.com/dtconsole/latest/userguide/security.html#security-notifications)\n\n- You can choose to limit the details included in notifications to only what is included in an event. This is referred to as the Basic detail type. These events contain exactly the same information as is sent to Amazon EventBridge and Amazon CloudWatch Events.\n\n[Create a notification rule for a repository](https://docs.aws.amazon.com/dtconsole/latest/userguide/getting-started-repository.html)\n\n- You can create notification rules to send notifications about repository events that are important to you.\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/directConnect.md", "content": "# Direct Connect\n\n[Cheat Sheet - Direct Connect](https://tutorialsdojo.com/aws-direct-connect)\n\n[AWS Whitepapaer - AWS Direct Connect](https://docs.aws.amazon.com/whitepapers/latest/aws-vpc-connectivity-options/aws-direct-connect.html)\n\n[How can I configure VPN as a backup for my AWS Direct Connect connection?](https://aws.amazon.com/premiumsupport/knowledge-center/configure-vpn-backup-dx)\n\n- AWS Direct Connect makes it easy to establish a dedicated connection from an on-premises network to one or more VPCs in the same region\n\n### Working with Direct Connect gateways\n\n[Working with Direct Connect gateways](https://docs.aws.amazon.com/directconnect/latest/UserGuide/direct-connect-gateways.html)\n\n\n## Blogs\n\n\n[Which type of virtual interface should I use to connect different resources in AWS?](https://aws.amazon.com/premiumsupport/knowledge-center/public-private-interface-dx)\n\n- AWS Direct Connect (DX) provides three types of virtual interfaces: public, private, and transit. How do I determine which type I should use to connect different resources (public or private) in AWS?\n\n - To connect to AWS resources that are reachable by a public IP address (such as an Amazon Simple Storage Service bucket) or AWS public endpoints, use a public virtual interface\n - To connect to your resources hosted in an Amazon Virtual Private Cloud (Amazon VPC) using their private IP addresses, use a private virtual interface. \n - To connect to your resources hosted in an Amazon VPC (using their private IP addresses) through a transit gateway, use a transit virtual interface\n\n\n [New – AWS Direct Connect Gateway – Inter-Region VPC Access](https://aws.amazon.com/blogs/aws/new-aws-direct-connect-gateway-inter-region-vpc-access/)\n\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/dynamodb.md", "content": "> Revision Count: 0\n\n# Dynamodb\n\n[Cheatsheet - Dynamodb](https://tutorialsdojo.com/amazon-dynamodb)\n\n- fast\n- highly scalable\n- highly available, \n- cost-effective \n- non-relational database service\n\n\n\n[Introduction](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Introduction.html)\n\nWhat Is Amazon DynamoDB?\n\nAmazon DynamoDB is a fully managed NoSQL database service that provides fast and predictable performance with seamless scalability. DynamoDB lets you offload the administrative burdens of operating and scaling a distributed database so that you don't have to worry about hardware provisioning, setup and configuration, replication, software patching, or cluster scaling. DynamoDB also offers encryption at rest, which eliminates the operational burden and complexity involved in protecting sensitive data\n\n[Best Practices for Storing Large Items and Attributes](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-use-s3-too.html)\n\n- Amazon DynamoDB currently limits the size of each item that you store in a table (see Service, Account, and Table Quotas in Amazon DynamoDB). If your application needs to store more data in an item than the DynamoDB size limit permits, you can try compressing one or more large attributes or breaking the item into multiple items (efficiently indexed by sort keys). You can also store the item as an object in Amazon Simple Storage Service (Amazon S3) and store the Amazon S3 object identifier in your DynamoDB item.\n\n\n**High Availability and Durability**\n\n- DynamoDB automatically spreads the data and traffic for your tables over a sufficient number of servers to handle your throughput and storage requirements, while maintaining consistent and fast performance. All of your data is stored on solid-state disks (SSDs) and is automatically replicated across multiple Availability Zones in an AWS Region, providing built-in high availability and data durability\n- You can use global tables to keep DynamoDB tables in sync across AWS Regions\n\n\n\n[Dynamodb best practices](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/best-practices.html)\n\n\n### Global Tables\n\n\n[Global Tables: Multi-Region Replication with DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GlobalTables.html)\n\n- Amazon DynamoDB global tables provide a fully managed solution for deploying a multiregion, multi-active database, without having to build and maintain your own replication solution.\n- With global tables you can specify the AWS Regions where you want the table to be available.\n- DynamoDB performs all of the necessary tasks to create identical tables in these Regions and propagate ongoing data changes to all of them.\n\n[Amazon DynamoDB global tables](https://aws.amazon.com/dynamodb/global-tables/)\n\n## Security\n\n### Identity and Access Management in Amazon DynamoDB\n\n[Identity and Access Management in Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/authentication-and-access-control.html)\n\n- Access to Amazon DynamoDB requires credentials. Those credentials must have permissions to access AWS resources, such as an Amazon DynamoDB table or an Amazon Elastic Compute Cloud (Amazon EC2) instance.\n - Authentication\n - Access Control\n\n\n## Error Handling with DynamoDB\n\n[Error Handling with DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.Errors.html)\n\n\n\n\n## Note\n\n- RDS MySQL is not as scalable and cost-effective as DynamoDB.\n- It is not recommended to store authorization tokens permanently on DynamoDB tables. These tokens should be generated upon user authentication and then temporarily saved on a DynamoDB for a fixed session length.\n\n\n## Blogs\n\n[New – Auto Scaling for Amazon DynamoDB](https://aws.amazon.com/blogs/aws/new-auto-scaling-for-amazon-dynamodb)" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/ec2.md", "content": "# EC2\n\n[Cheat Sheet - EBS](https://tutorialsdojo.com/amazon-ebs)\n\n[EC2](https://tutorialsdojo.com/amazon-elastic-compute-cloud-amazon-ec2)\n\n\n[dedicated-hosts](https://aws.amazon.com/ec2/dedicated-hosts)\n\n- Network Load Balancers do not use security groups.\n\n[iam-roles-for-amazon-ec2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html)\n\n- The AWS SDKs assume the IAM roles attached in the instances and get temporary credentials by interacting with the AWS STS service.\n\n[security-group-load-balancer](https://aws.amazon.com/premiumsupport/knowledge-center/security-group-load-balancer/)\n\n[How do I stop and start Amazon EC2 instances at regular intervals using Lambda?](https://aws.amazon.com/premiumsupport/knowledge-center/start-stop-lambda-cloudwatch)\n\nTo stop and start EC2 instances at regular intervals using Lambda, do the following:\n- Create a custom AWS Identity and Access Management (IAM) policy and execution role for your Lambda function. \n- Create Lambda functions that stop and start your EC2 instances. \n- Test your Lambda functions. \n- Create CloudWatch Events rules that trigger your function on a schedule.\n\nThis example setup is a simple solution. For a more robust solution, use the AWS Instance Scheduler\n\n\n## EC2 Spot\n\n### Getting Started with Amazon EC2 Spot Instances\n\n[Getting Started with Amazon EC2 Spot Instances](https://aws.amazon.com/ec2/spot/getting-started/)\n\n\n#### No Spot capacity available\n\n[Why am I receiving a \"no Spot capacity available\" error when trying to launch an Amazon EC2 Spot Instance?](https://aws.amazon.com/premiumsupport/knowledge-center/ec2-spot-instance-insufficient-capacity/)\n\n- Be flexible about which instance types you request and which Availability Zones you deploy your workload in\n\n\n[Spot Instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-spot-instances.html)\n\n\n### Elastic network interfaces\n\n[Elastic network interfaces](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html)\n\n- An elastic network interface is a logical networking component in a VPC that represents a virtual network card.\n\n### Multiple IP addresses\n\n[Multiple IP addresses](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/MultipleIP.html)\n\n- You can specify multiple private IPv4 and IPv6 addresses for your instances. \n- The number of network interfaces and private IPv4 and IPv6 addresses that you can specify for an instance depends on the instance type.\n\n## Fleets\n\n### Example 5: Launch a Spot Fleet using the diversified allocation strategy\n\n[Example 5: Launch a Spot Fleet using the diversified allocation strategy](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-fleet-examples.html#fleet-config5)\n\n- A best practice to increase the chance that a spot request can be fulfilled by EC2 capacity in the event of an outage in one of the Availability Zones is to diversify across zones.\n- For this scenario, include each Availability Zone available to you in the launch specification. And, instead of using the same subnet each time, use three unique subnets (each mapping to a different zone).\n\n### Dedicated Instances\n\n[Dedicated Instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/dedicated-instance.html)\n\n- Dedicated Instances are Amazon EC2 instances that run in a virtual private cloud (VPC) on hardware that's dedicated to a single customer. \n\n```bash\nTenancy type to be dedicated host.\n```\n\n## Storage\n\n### Amazon EBS volume types\n\n[Amazon EBS volume types](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-volume-types.html)\n\n- Solid state drives (SSD) — Optimized for transactional workloads involving frequent read/write operations with small I/O size, where the dominant performance attribute is IOPS.\n- Hard disk drives (HDD) — Optimized for large streaming workloads where the dominant performance attribute is throughput.\n- Previous generation — Hard disk drives that can be used for workloads with small datasets where data is accessed infrequently and performance is not of primary importance\n\nThere are several factors that can affect the performance of EBS volumes, such as instance configuration, I/O characteristics, and workload demand\n\n\n[Comparision of varios block storage types](https://aws.amazon.com/ebs/features)\n\n\n## Instances\n\n### Reserved Instances\n\n[Reserved Instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-reserved-instances.html)\n\n- Reserved Instances provide you with significant savings on your Amazon EC2 costs compared to On-Demand Instance pricing. \n- Reserved Instances are not physical instances, but rather a billing discount applied to the use of On-Demand Instances in your account.\n\n\n## Security\n\n#### Supported resource-level permissions for Amazon EC2 API actions\n\n[Supported resource-level permissions for Amazon EC2 API actions](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-policy-structure.html#ec2-supported-iam-actions-resources)\n\n- Resource-level permissions refers to the ability to specify which resources users are allowed to perform actions on. \n- Amazon EC2 has partial support for resource-level permissions. \n- This means that for certain Amazon EC2 actions, you can control when users are allowed to use those actions based on conditions that have to be fulfilled, or specific resources that users are allowed to use. \n- For example, you can grant users permissions to launch instances, but only of a specific type, and only using a specific AMI.\n\n\n## VM Import/Export\n\n[VM Import/Export](https://aws.amazon.com/ec2/vm-import)\n\n- VM Import/Export enables you to easily import virtual machine images from your existing environment to Amazon EC2 instances and export them back to your on-premises environment\n\n\n## Dynamic Scaling\n\n### Scaling based on Amazon SQS\n\n[Scaling based on Amazon SQS](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-using-sqs-queue.html)\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/ec2AutoScaling.md", "content": "# EC2 Autoscaling\n\n\n[Scheduled scaling for Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/schedule_time.html)\n\n- cooldown timer does not influence the scheduled activity\n\n[Cooldown](https://docs.aws.amazon.com/autoscaling/ec2/userguide/Cooldown.html)\n\n- even if the cooldown timer is running, the scheduled action takes high priority and executes immediately\n\n[Amazon EC2 Auto Scaling lifecycle hooks](https://docs.aws.amazon.com/autoscaling/ec2/userguide/lifecycle-hooks.html)\n\n- When a scale-out event occurs, your newly launched instance completes its startup sequence and transitions to a wait state. \n- While the instance is in a wait state, it runs a script to download and install the needed software packages for your application, \n making sure that your instance is fully ready before it starts receiving traffic. \n- When the script is finished installing software, it sends the complete-lifecycle-action command to continue.\n\n[AutoScalingReplacingUpdate policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-updatepolicy.html)\n\nTo specify how AWS CloudFormation handles replacement updates for an Auto Scaling group, use the AutoScalingReplacingUpdate policy. This policy enables you to specify whether AWS CloudFormation replaces an Auto Scaling group with a new one or replaces only the instances in the Auto Scaling group.\n\n### Supports Following Deployment Methods\n\n- AllAtOnce\n- HalfAtATime\n- OneAtATime. \n\n\nBut it does not support the canary type.\n\n### Auto Scaling groups with multiple instance types and purchase options\n\n- You can launch and automatically scale a fleet of On-Demand Instances and Spot Instances within a single Auto Scaling group. In addition to receiving discounts for using Spot Instances, you can use Reserved Instances or a Savings Plan to receive discounted rates of the regular On-Demand Instance pricing.\n\n\n\n\n## Autoscaling Groups\n\n[What is Amazon EC2 Auto Scaling?](https://docs.aws.amazon.com/autoscaling/ec2/userguide/what-is-amazon-ec2-auto-scaling.html)\n\n- Amazon EC2 Auto Scaling helps you ensure that you have the correct number of Amazon EC2 instances available to handle the load for your application. \n- You create collections of EC2 instances, called Auto Scaling groups\n- You can specify the minimum number of instances in each Auto Scaling group, and Amazon EC2 Auto Scaling ensures that your group never goes below this size. \n- You can specify the maximum number of instances in each Auto Scaling group, and Amazon EC2 Auto Scaling ensures that your group never goes above this size.\n\n\n### Elastic Load Balancing and Amazon EC2 Auto Scaling\n\n[Elastic Load Balancing and Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html)\n\n- Elastic Load Balancing automatically distributes your incoming application traffic across all the EC2 instances that you are running. \n- Elastic Load Balancing helps to manage incoming requests by optimally routing traffic so that no one instance is overwhelmed.\n- To use Elastic Load Balancing with your Auto Scaling group, attach the load balancer to your Auto Scaling group.\n- This registers the group with the load balancer, which acts as a single point of contact for all incoming web traffic to your Auto Scaling group.\n\n## Elastic Load Balancing\n\n### Attaching a load balancer to your Auto Scaling group\n\n[Attaching a load balancer to your Auto Scaling group](https://docs.aws.amazon.com/autoscaling/ec2/userguide/attach-load-balancer-asg.html)\n\n- Amazon EC2 Auto Scaling integrates with Elastic Load Balancing to help you to insert an Application Load Balancer, Network Load Balancer, Classic Load Balancer, or Gateway Load Balancer in front of your Auto Scaling group.\n- When you attach an Application Load Balancer, Network Load Balancer, or Gateway Load Balancer, you attach a target group. \n- Amazon EC2 Auto Scaling adds instances to the attached target group when they are launched. \n- You can attach one or multiple target groups, and configure health checks on a per target group basis.\n\n### Scaling based on Amazon SQS\n\n[Scaling based on Amazon SQS](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-using-sqs-queue.html)\n\n- There are some scenarios where you might think about scaling in response to activity in an Amazon SQS queue. \n- For example, suppose that you have a web app that lets users upload images and use them online.\n\n### Temporarily removing instances from your Auto Scaling group\n\n[Temporarily removing instances from your Auto Scaling group](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-enter-exit-standby.html)\n\n- You can put an instance that is in the InService state into the Standby state, update or troubleshoot the instance, and then return the instance to service. Instances that are on standby are still part of the Auto Scaling group, but they do not actively handle load balancer traffic.\n- Amazon EC2 Auto Scaling does not perform health checks on instances that are in a standby state.\n\n```bash\naws autoscaling enter-standby --instance-ids i-05b4f7d5be44822a6 \\\n --auto-scaling-group-name my-asg --should-decrement-desired-capacity\n```\n\n\n### Monitoring\n\n#### Health checks for Auto Scaling instances\n\n[Health checks for Auto Scaling instances](https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html)\n\nThe health status of an Auto Scaling instance is either healthy or unhealthy. All instances in your Auto Scaling group start in the healthy state. Instances are assumed to be healthy unless Amazon EC2 Auto Scaling receives notification that they are unhealthy. This notification can come from one or more of the following sources: Amazon EC2, Elastic Load Balancing (ELB), or a custom health check.\n\n**Instance health status**\n\nAmazon EC2 Auto Scaling can determine the health status of an instance using one or more of the following:\n\n- Status checks provided by Amazon EC2 to identify hardware and software issues that may impair an instance. The default health checks for an Auto Scaling group are EC2 status checks only.\n- Health checks provided by Elastic Load Balancing (ELB). These health checks are disabled by default but can be enabled.\n- Your custom health checks.\n\nUsing custom health checks\n\n```bash\naws autoscaling set-instance-health --instance-id i-123abc45d --health-status Unhealthy\n```\n\nHealth check grace period\n\n- By default, the health check grace period is 300 seconds when you create an Auto Scaling group from the AWS Management Console. Its default value is 0 seconds when you create an Auto Scaling group using the AWS CLI or an SDK.\n- If you add a lifecycle hook, the grace period does not start until the lifecycle hook actions are completed and the instance enters the InService state.\n\n\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/ecs.md", "content": "# ECS\n\n[Cheetsheet - ECS](https://tutorialsdojo.com/amazon-elastic-container-service-amazon-ecs/)\n\n[CheatSheet - Elastic Container Service (ECS) vs Lambda](https://tutorialsdojo.com/ec2-container-service-ecs-vs-lambda)\n\n[CheatSheet - AWS Fargate](https://tutorialsdojo.com/aws-fargate)\n\n[What is Amazon Elastic Container Service?](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html)\n\n- highly scalable, fast container management service that makes it easy to run, stop, and manage containers on a cluster\n- Your containers are defined in a task definition that you use to run individual tasks or tasks within a service\n- In this context, a service is a configuration that enables you to run and maintain a specified number of tasks simultaneously in a cluster. \n- You can run your tasks and services on a serverless infrastructure that is managed by AWS Fargate. Alternatively, for more control over your infrastructure, you can run your tasks and services on a cluster of Amazon EC2 instances that you manage.\n\n[What is ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html)\n\n[Target tracking scaling policies](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-autoscaling-targettracking.html)\n\n[How do I troubleshoot Amazon ECS tasks that take a long time to stop when the container instance is set to DRAINING?](https://aws.amazon.com/premiumsupport/knowledge-center/ecs-tasks-stop-delayed-draining/)\n\n[service_definition_parameters](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service_definition_parameters.html)\n\n- If a service is using the rolling update (ECS) deployment type, the minimumHealthyPercent represents a lower limit on the number of your service's tasks that must remain in the RUNNING state during a deployment\n- Minimum healthy percent represents a lower limit on the tasks. When the parameter is set to 100, the number of the service's running tasks would be equal or\n more than the desired count of tasks during a rolling update.\n\n[Blue/Green deployment with CodeDeploy](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-bluegreen.html)\n\n- You must configure the service to use either an Application Load Balancer or Network Load Balancer. Classic Load Balancers aren't supported\n\n> The Fargate launch type is unnecessary for the blue/green deployment type. The EC2 launch type is also supported.\n\n- When you initially create a CodeDeploy application and deployment group, you must specify the following:\n You must define two target groups for the load balancer\n\n## Using Spot Instances\n\n- A Spot Instance is an unused Amazon EC2 instance that is available for less than the On-Demand price.\n- The hourly price for a Spot Instance is called a Spot price\n\n\n### Spot Instance Draining\n\n- Amazon EC2 terminates, stops, or hibernates your Spot Instance when the Spot price exceeds the maximum price for your request or capacity is no longer available\n- Amazon EC2 provides a Spot Instance interruption notice, which gives the instance a two-minute warning before it is interrupted.\n- If Amazon ECS Spot Instance draining is enabled on the instance, ECS receives the Spot Instance interruption notice and places the instance in DRAINING status.\n- When a container instance is set to DRAINING, Amazon ECS prevents new tasks from being scheduled for placement on the container instance. \n- Service tasks on the draining container instance that are in the PENDING state are stopped immediately\n- If there are container instances in the cluster that are available, replacement service tasks are started on them.\n\n```bash\n# To enable Spot Instance draining for an existing container instance\n# Edit the /etc/ecs/ecs.config file and add the following:\n\nECS_ENABLE_SPOT_INSTANCE_DRAINING=true\n```\n\n\n[Four Steps to Run ECS Clusters on EC2 Spot Instances](https://aws.amazon.com/ec2/spot/containers-for-less/get-started/)\n\n\n## Task Definations\n\nAmazon ECS enables you to inject sensitive data into your containers by storing your sensitive data in either AWS Secrets Manager secrets or AWS Systems Manager Parameter Store parameters and then referencing them in your container definition.\n\n- Store the database credentials using the AWS Secrets Manager\n- encrypt them using AWS KMS\n- Create an IAM Role for your Amazon ECS task execution role\n - and reference it with your task definition which allows access to both KMS and AWS Secrets Manager\n- Within your container definition, specify secrets with the name of the environment variable to set in the container and the full ARN of the Secrets Manager secret which contains the sensitive data, to present to the container.\n> Systems Manager Parameter Store service doesn't provide dedicated storage with lifecycle management and key rotation, unlike Secrets Manager.\n\n\n### Amazon ECS task networking\n\n[Amazon ECS task networking](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html)\n\n- The networking behavior of Amazon ECS tasks hosted on Amazon EC2 instances is dependent on the network mode defined in the task definition. The following are the available network modes. Amazon ECS recommends using the awsvpc network mode unless you have a specific need to use a different network mode.\n - awsvpc — The task is allocated its own elastic network interface (ENI) and a primary private IPv4 address. This gives the task the same networking properties as Amazon EC2 instances.\n - bridge — The task utilizes Docker's built-in virtual network which runs inside each Amazon EC2 instance hosting the task.\n - host — The task bypasses Docker's built-in virtual network and maps container ports directly to the ENI of the Amazon EC2 instance hosting the task. As a result, you can't run multiple instantiations of the same task on a single Amazon EC2 instance when port mappings are used.\n - none — The task has no external network connectivity.\n\n- In order for you to use security groups and network monitoring tools at a more granular level within your ECS tasks, you have to use the awsvpc network mode\n\n## Troubleshooting\n\n### CannotPullContainer task errors\n\n[CannotPullContainer task errors](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_cannot_pull_image.html)\n\n[How can I resolve the Amazon ECR error \"CannotPullContainerError: API error\" in Amazon ECS?\n](https://aws.amazon.com/premiumsupport/knowledge-center/ecs-pull-container-api-error-ecr)\n\n- One reason : because a route to the internet doesn't exist:\n\n\n## Amazon ECS on AWS Fargate\n\n[Amazon ECS on AWS Fargate](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/AWS_Fargate.html)\n\n- AWS Fargate is a technology that you can use with Amazon ECS to run containers without having to manage servers or clusters of Amazon EC2 instances. \n- With AWS Fargate, you no longer have to provision, configure, or scale clusters of virtual machines to run containers" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/elasticBeanStalk.md", "content": "# ElasticBeanStalk\n\n\n[using-features.rolling-version-deploy](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/using-features.rolling-version-deploy.html)\n\n- AWS Elastic Beanstalk provides several options for how deployments are processed, including deployment policies (All at once, Rolling, Rolling with additional batch, Immutable, and Traffic splitting)\n- If you use blue/green deployment stratergy then two environments are required.\n\n[Blue/Green deployments with Elastic Beanstalk](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/using-features.CNAMESwap.html)\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/elasticCache.md", "content": "# Elastic Cache\n\n[Cheat Sheet - ElasticCache](https://tutorialsdojo.com/amazon-elasticache)\n\n\n## What is Amazon ElastiCache for Memcached?\n\n[What is Amazon ElastiCache for Memcached?](https://docs.aws.amazon.com/AmazonElastiCache/latest/mem-ug/WhatIs.html)\n\n- Amazon ElastiCache is a web service that makes it easy to set up, manage, and scale a distributed in-memory data store or cache environment in the cloud. \n- It provides a high-performance, scalable, and cost-effective caching solution. At the same time, it helps remove the complexity associated with deploying and managing a distributed cache environment.\n\n\n[Elastic Cache - How it works](https://aws.amazon.com/elasticache/)\n\n- fully managed, in-memory caching service supporting flexible, real-time use cases.\n- You can use ElastiCache for caching, which accelerates application and database performance, or as a primary data store for use cases that don't require durability like session stores, gaming leaderboards, streaming, and analytics.\n- ElastiCache is compatible with Redis and Memcached. " }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/elasticFileSystem.md", "content": "# Elastic File System\n\n[Cheat Sheet - AWS Elastic File System](https://tutorialsdojo.com/amazon-efs)\n\n[What is Amazon Elastic File System?](https://docs.aws.amazon.com/efs/latest/ug/whatisefs.html)\n\n- Amazon Elastic File System (Amazon EFS) provides a simple, serverless, set-and-forget elastic file system for use with AWS Cloud services and on-premises resources\n- It is built to scale on demand to petabytes without disrupting applications, growing and shrinking automatically as you add and remove files, eliminating the need to provision and manage capacity to accommodate growth\n- Amazon EFS supports the Network File System version 4 (NFSv4.1 and NFSv4.0) protocol, so the applications and tools that you use today work seamlessly with Amazon EFS. \n- Multiple compute instances, including Amazon EC2, Amazon ECS, and AWS Lambda, can access an Amazon EFS file system at the same time, providing a common data source for workloads and applications running on more than one compute instance or server." }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/elasticLoadBalancing.md", "content": "# Elastic Load Balancing\n\n[Cheat Sheet - ALB vs NLB vs CLB](https://tutorialsdojo.com/application-load-balancer-vs-network-load-balancer-vs-classic-load-balancer)\n\n### Health checks for your target groups\n\n[Health checks for your target groups](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/target-group-health-checks.html)\n\n- Your Application Load Balancer periodically sends requests to its registered targets to test their status. These tests are called health checks.\n\n> If a target group contains only unhealthy registered targets, the load balancer routes requests to all those targets, regardless of their health status.\n\n## Network LoadBalancer\n\n[Troubleshoot your Network Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-troubleshooting.html)\n\n\n### Target security groups\n\n[Target security groups](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/target-group-register-targets.html#target-security-groups)\n\n- When you register EC2 instances as targets, you must ensure that the security groups for these instances allow traffic on both the listener port and the health check port.\n\n\n[Deregistration delay](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html#deregistration-delay)\n\n\n\n## Notes\n\n- Network Load Balancers don't have associated security groups.\n\n\n## Blogs\n\n- [How do I attach a security group to my Elastic Load Balancer?](https://aws.amazon.com/premiumsupport/knowledge-center/security-group-load-balancer)\n\n- [AWS Elastic Load Balancing: Support for SSL Termination](https://aws.amazon.com/blogs/aws/elastic-load-balancer-support-for-ssl-termination)\n\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/eventBridge.md", "content": "# Event Bridge\n\n### What is event bridge\n[What Is Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)\n[Video - Intro to Event Bridge](https://youtu.be/TXh5oU_yo9M)\n\nAmazon EventBridge is a serverless event bus service that you can use to connect your applications with data from a variety of sources. EventBridge delivers a stream of real-time data from your applications, software as a service (SaaS) applications, and AWS services to targets such as AWS Lambda functions, HTTP invocation endpoints using API destinations, or event buses in other AWS accounts.\n\n#### Getting started with Amazon EventBridge\n\n[Getting started with Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-get-started.html)\n\nTo create a rule for events, you specify an action to take when EventBridge receives an event that matches the event pattern in the rule. When an event matches, EventBridge sends the event to the specified target and triggers the action defined in the rule.\n\n#### Event buses\n[Amazon EventBridge event buses](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html)\n\nAn event bus is a pipeline that receives events. Rules associated with the event bus evaluate events as they arrive. Each rule checks whether an event matches the rule's criteria. You associate a rule with a specific event bus, so the rule only applies to events received by that event bus.\n\n[Video - The following video describes what event buses are and explains some of the basics of them](https://youtu.be/LkEBBgWRKkI)\n\n[The following video covers the different event buses and when to use them](https://youtu.be/cB5-GTSJNqc)\n\n#### Receiving events from a SaaS partner\n[Receiving events from a SaaS partner with Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-saas.html)\n\n[Video - The following video covers SaaS integrations with EventBridge](https://youtu.be/zxFrM6z8Wdg)\n\n#### Targets\n\n[Sending and receiving Amazon EventBridge events between AWS accounts](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cross-account.html)\n\nYou can configure EventBridge to send and receive events between AWS accounts. When you configure EventBridge to send or receive events between accounts, you can specify which AWS accounts can send events to or receive events from the event bus in your account. \n\n[Video - The following video covers routing events between accounts](https://youtu.be/pX_xIW_EuCE)\n\n\n#### Decoupling larger applications with Amazon EventBridge\n[Decoupling larger applications with Amazon EventBridge](https://aws.amazon.com/blogs/compute/decoupling-larger-applications-with-amazon-eventbridge/)\n\n- you can use an event-based architecture to decouple services and functional areas of applications.\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/guardDuty.md", "content": "# AWS GuardDuty\n\n\n[What is Amazon GuardDuty?](https://docs.aws.amazon.com/guardduty/latest/ug/what-is-guardduty.html)\n\n- Amazon GuardDuty is a continuous security monitoring service that analyzes and processes the following Data sources: VPC Flow Logs, AWS CloudTrail management event logs, CloudTrail S3 data event logs, and DNS logs. It uses threat intelligence feeds, such as lists of malicious IP addresses and domains, and machine learning to identify unexpected and potentially unauthorized and malicious activity within your AWS environment. This can include issues like escalations of privileges, uses of exposed credentials, or communication with malicious IP addresses, or domains. For example, GuardDuty can detect compromised EC2 instances serving malware or mining bitcoin.\n\n[How to get started with security response automation on AWS](https://aws.amazon.com/blogs/security/how-get-started-security-response-automation-aws/)\n\n\n### Finding Types\n\n#### EC2 finding types\n\n- Recon:EC2/Portscan\n - Data source: VPC Flow Logs : This finding informs you that the listed EC2 instance in your AWS environment is engaged in a possible port scan attack because it is trying to connect to multiple ports over a short period of time. \n\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/iam.md", "content": "> Revision Count: 1\n\n\n# Identify And Access Management\n\n[Cheat Sheet - Identify And Access Management](https://tutorialsdojo.com/aws-identity-and-access-management-iam)\n\n[Cheat Sheet - SCP vs IAM](https://tutorialsdojo.com/service-control-policies-scp-vs-iam-policies)\n\n[Cheat Sheet - security-identity-services](https://tutorialsdojo.com/aws-cheat-sheets-security-identity-services)\n\n### Identity providers and federation\n\n[Enabling SAML 2.0 federated users to access the AWS Management Console](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-saml.html)\n\n- You can use a role to configure your SAML 2.0-compliant identity provider (IdP) and AWS to permit your federated users to access the AWS Management Console. \n- The role grants the user permissions to carry out tasks in the console.\n\n### Enabling custom identity broker access to the AWS console\n\n[Enabling custom identity broker access to the AWS console](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-custom-url.html)\n\n- You can write and run code to create a URL that lets users who sign in to your organization's network securely access the AWS Management Console. \n- The URL includes a sign-in token that you get from AWS and that authenticates the user to AWS.\n\n## Logging IAM and AWS STS API calls with AWS CloudTrail\n\n[Logging IAM and AWS STS API calls with AWS CloudTrail](https://docs.aws.amazon.com/IAM/latest/UserGuide/cloudtrail-integration.html)\n\n- IAM and AWS STS are integrated with AWS CloudTrail, a service that provides a record of actions taken by an IAM user or role.\n- CloudTrail captures all API calls for IAM and AWS STS as events, including calls from the console and from API calls. \n- If you create a trail, you can enable continuous delivery of CloudTrail events to an Amazon S3 bucket. \n- If you don't configure a trail, you can still view the most recent events in the CloudTrail console in Event history\n\n\n\n## How IAM roles differ from resource-based policies\n\n[How IAM roles differ from resource-based policies](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_compare-resource-policies.html)\n\n- For some AWS services, you can grant cross-account access to your resources.\n- To do this, you attach a policy directly to the resource that you want to share, instead of using a role as a proxy.\n- The resource that you want to share must support resource-based policies. \n- Unlike an identity-based policy, a resource-based policy specifies who (which principal) can access that resource.\n\n\n### Temporary security credentials in IAM\n\n[Temporary security credentials in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html)\n\n- You can use the AWS Security Token Service (AWS STS) to create and provide trusted users with temporary security credentials that can control access to your AWS resources.\n - Temporary security credentials are short-term, as the name implies. They can be configured to last for anywhere from a few minutes to several hours\n - Temporary security credentials are not stored with the user but are generated dynamically and provided to the user when requested.\n\n\n## Actions\n\n[UploadServerCertificate](https://docs.aws.amazon.com/IAM/latest/APIReference/API_UploadServerCertificate.html)\n\n- Uploads a server certificate entity for the AWS account. The server certificate entity includes a public key certificate, a private key, and an optional certificate chain, which should all be PEM-encoded.\n\n## Using an IAM role to grant permissions to applications running on Amazon EC2 instances\n\n[Using an IAM role to grant permissions to applications running on Amazon EC2 instances](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2.html#roles-usingrole-ec2instance-roles)\n- The administrator uses IAM to create the Get-pics role. \n- In the role's trust policy, the administrator specifies that only EC2 instances can assume the role\n- In the role's permission policy, the administrator specifies read-only permissions for the photos bucket.\n- A developer launches an EC2 instance and assigns the Get-pics role to that instance.\n- When the application runs, it obtains temporary security credentials from Amazon EC2 instance metadata,\n- Using the retrieved temporary credentials, the application accesses the photo bucket. \n- Because of the policy attached to the Get-pics role, the application has read-only permissions.\n\n## Tutorials\n\n### IAM tutorial: Delegate access across AWS accounts using IAM roles\n\n[IAM tutorial: Delegate access across AWS accounts using IAM roles](https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_cross-account-with-roles.html)\n\nThe above tutorial teaches you how to use a role to delegate access to resources in different AWS accounts that you own called Production and Development\n\n- Step 1: Create a role in the Production Account\n - First, you use the AWS Management Console to establish trust between the Production account (ID number 999999999999) and the Development account (ID number 111111111111). \n - You start by creating an IAM role named UpdateApp. \n - When you create the role, you define the Development account as a trusted entity and specify a permissions policy that allows trusted users to update the productionapp bucket.\n \n\n### Providing access to an IAM user in another AWS account that you own\n\n[Providing access to an IAM user in another AWS account that you own](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_aws-accounts.html)\n\n- You can grant your IAM users permission to switch to roles within your AWS account or to roles defined in other AWS accounts that you own.\n\n\n## Controlling access to AWS resources using tags\n\n[Controlling access to AWS resources using tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)\n\n- You can use tags to control access to your AWS resources that support tagging, including IAM resources. \n- Imagine that you have Amazon EC2 instances that are critical to your organization. \n- Instead of directly granting your users permission to terminate the instances, you can create a role with those privileges.\n\n- Example scenario using separate development and production accounts\n - In the production account, an administrator uses IAM to create the UpdateApp role in that account. \n - In the role, the administrator defines a trust policy that specifies the development account as a Principal, meaning that authorized users from the development account can use the UpdateApp role. \n - The administrator also defines a permissions policy for the role that specifies the read and write permissions to the Amazon S3 bucket named productionapp.\n - In the development account, an administrator grants members of the Developers group permission to switch to the role. \n - This is done by granting the Developers group permission to call the AWS Security Token Service (AWS STS) AssumeRole API for the UpdateApp role.\n - The user requests switches to the role\n - AWS STS returns temporary credentials\n - The temporary credentials allow access to the AWS resource\n\n\n## Using an IAM role to grant permissions to applications running on Amazon EC2 instances\n\n### Using instance profiles\n\n[Using instance profiles](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2_instance-profiles.html)\n\n- Use an instance profile to pass an IAM role to an EC2 instance.\n- you can and should use an IAM role to manage temporary credentials for applications that run on an EC2 instance\n\n## Identity federation in AWS\n\n[Identity federation in AWS](https://aws.amazon.com/identity/federation)\n\n- Identity federation is a system of trust between two parties for the purpose of authenticating users and conveying information needed to authorize their access to resources. \n- In this system, an identity provider (IdP) is responsible for user authentication, and a service provider (SP), such as a service or an application, controls access to resources.\n- By administrative agreement and configuration, the SP trusts the IdP to authenticate users and relies on the information provided by the IdP about them. \n- After authenticating a user, the IdP sends the SP a message, called an assertion, containing the user's sign-in name and other attributes that the SP needs to establish a session with the user and to determine the scope of resource access that the SP should grant. \n \n\n## Identity providers and federation\n\n- If you already manage user identities outside of AWS, you can use IAM identity providers instead of creating IAM users in your AWS account. \n- With an identity provider (IdP), you can manage your user identities outside of AWS and give these external user identities permissions to use AWS resources in your account\n\n\n## Providing access to externally authenticated users (identity federation)\n\n[Providing access to externally authenticated users (identity federation)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_federated-users.html)\n\n- Your users might already have identities outside of AWS, such as in your corporate directory. \n- If those users need to work with AWS resources (or work with applications that access those resources), then those users also need AWS security credentials. \n- You can use an IAM role to specify permissions for users whose identity is federated from your organization or a third-party identity provider (IdP).\n\n### Federating users of a mobile or web-based app with Amazon Cognito\n\n- If you create a mobile or web-based app that accesses AWS resources, the app needs security credentials in order to make programmatic requests to AWS. \n- For most mobile application scenarios, we recommend that you use Amazon Cognito.\n- for more advanced scenarios, you can work directly with a third-party service like Login with Amazon, Facebook, Google, or any IdP that is compatible with OpenID Connect (OIDC).\n\n\n### Federating users with SAML 2.0\n\n- If your organization already uses an identity provider software package that supports SAML 2.0 (Security Assertion Markup Language 2.0), you can create trust between your organization as an identity provider (IdP) and AWS as the service provider.\n- You can then use SAML to provide your users with federated single-sign on (SSO) to the AWS Management Console or federated access to call AWS API operations.\n\n### Federating users by creating a custom identity broker application\n\n- If your identity store is not compatible with SAML 2.0, then you can build a custom identity broker application to perform a similar function. \n- The broker application authenticates users, requests temporary credentials for users from AWS, and then provides them to the user to access AWS resources.\n\n\n\n## Premium Support\n\n[What's the difference between an AWS Organizations service control policy and an IAM policy?](https://console.aws.amazon.com/console/home?nc2=h_ct&src=header-signin&hashArgs=%23)\n\n## Blog\n\n[How to Establish Federated Access to Your AWS Resources by Using Active Directory User Attributes](https://aws.amazon.com/blogs/security/how-to-establish-federated-access-to-your-aws-resources-by-using-active-directory-user-attributes)\n\n\n\n\n\n\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/inspector.md", "content": "# AWS Inspector\n\n### Amazon Inspector rules packages and rules\n\n#### Common vulnerabilities and exposures\n\n[Common vulnerabilities and exposures](https://docs.aws.amazon.com/inspector/latest/userguide/inspector_cves.html)\n\n- The rules in this package help verify whether the EC2 instances in your assessment targets are exposed to common vulnerabilities and exposures (CVEs). Attacks can exploit unpatched vulnerabilities to compromise the confidentiality, integrity, or availability of your service or data. The CVE system provides a reference method for publicly known information security vulnerabilities and exposures.\n\n\n[Security best practices for Amazon Inspector](https://docs.aws.amazon.com/inspector/latest/userguide/inspector_security-best-practices.html)\n\n- Use Amazon Inspector rules to help determine whether your systems are configured securely.\n\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/kinesis.md", "content": "# Kinesis\n\n[CheatSheet - Amazon Kinesis](https://tutorialsdojo.com/amazon-kinesis)\n\n## Getting started with Amazon Kinesis Data Streams\n\n[Getting started with Amazon Kinesis Data Streams\n](https://aws.amazon.com/kinesis/data-streams/getting-started)\n\n- Amazon Kinesis Data Streams is a massively scalable, highly durable data ingestion and processing service optimized for streaming data. \n- You can configure hundreds of thousands of data producers to continuously put data into a Kinesis data stream. \n- Data will be available within milliseconds to your Amazon Kinesis applications, and those applications will receive data records in the order they were generated.\n\n## What Is Amazon Kinesis Data Streams?\n\n[What Is Amazon Kinesis Data Streams?](https://docs.aws.amazon.com/streams/latest/dev/introduction.html)\n\n- You can use Amazon Kinesis Data Streams to collect and process large streams of data records in real time.\n- You can create data-processing applications, known as Kinesis Data Streams applications. A typical Kinesis Data Streams application reads data from a data stream as data records.\n- You can send the processed records to dashboards, use them to generate alerts, dynamically change pricing and advertising strategies, or send data to a variety of other AWS services. \n\n\n### What Can I Do with Kinesis Data Streams?\n\n[What Can I Do with Kinesis Data Streams?](https://docs.aws.amazon.com/streams/latest/dev/introduction.html)\n\n- Accelerated log and data feed intake and processing\n - You can have producers push data directly into a stream. \n - For example, push system and application logs and they are available for processing in seconds. \n - This prevents the log data from being lost if the front end or application server fails\n\n\n ## Examples\n\n - [Capturing Web Page Scroll Progress with Amazon Kinesis](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/kinesis-examples-capturing-page-scrolling.html)" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/lambda.md", "content": "# Lambda\n\n[Cheat Sheet - AWS Lambda](https://tutorialsdojo.com/aws-lambda)\n\n[What is AWS Lambda?](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html)\n\n- Lambda is a compute service that lets you run code without provisioning or managing servers. \n- Lambda runs your code on a high-availability compute infrastructure and performs all of the administration of the compute resources, including server and operating system maintenance, capacity provisioning and automatic scaling, code monitoring and logging. \n- With Lambda, you can run code for virtually any type of application or backend service. \n- All you need to do is supply your code in one of the languages that Lambda supports.\n\n\n## Using AWS Lambda with CloudFront Lambda@Edge\n\n[Using AWS Lambda with CloudFront Lambda@Edge](https://docs.aws.amazon.com/lambda/latest/dg/lambda-edge.html)\n\n- Lambda@Edge lets you run Node.js and Python Lambda functions to customize content that CloudFront delivers, executing the functions in AWS locations closer to the viewer. \n- The functions run in response to CloudFront events, without provisioning or managing servers. You can use Lambda functions to change CloudFront requests and responses at the following points:\n - After CloudFront receives a request from a viewer (viewer request)\n - Before CloudFront forwards the request to the origin (origin request)\n - After CloudFront receives the response from the origin (origin response)\n - Before CloudFront forwards the response to the viewer (viewer respo\n\n\n## AWS Lambda Pricing\n\n[AWS Lambda Pricing](https://aws.amazon.com/lambda/pricing)\n\n- Lambda counts a request each time it starts executing in response to an event notification trigger, such as from Amazon Simple Notification Service (SNS) or Amazon EventBridge, or an invoke call, such as from Amazon API Gateway, or via the AWS SDK, including test invokes from the AWS Console.\n- Duration is calculated from the time your code begins executing until it returns or otherwise terminates, rounded up to the nearest 1 ms*. The price depends on the amount of memory you allocate to your function.\n\n## Lambda function scaling\n\n[Lambda function scaling](https://docs.aws.amazon.com/lambda/latest/dg/invocation-scaling.html#concurrent-execution-safety-limit)\n\n- The first time you invoke your function, AWS Lambda creates an instance of the function and runs its handler method to process the event.\n- When the function returns a response, it stays active and waits to process additional events.\n- If you invoke the function again while the first event is being processed, Lambda initializes another instance, and the function processes the two events concurrently\n- As more events come in, Lambda routes them to available instances and creates new instances as needed. \n- When the number of requests decreases, Lambda stops unused instances to free up scaling capacity for other functions.\n- The default regional concurrency limit starts at 1,000\n\n## Managing function\n\n### Managing Lambda reserved concurrency\n\n[Managing Lambda reserved concurrency](https://docs.aws.amazon.com/lambda/latest/dg/configuration-concurrency.html)\n\n- Concurrency is the number of requests that your function is serving at any given time. \n- When your function is invoked, Lambda allocates an instance of it to process the event. \n- When the function code finishes running, it can handle another request. \n- If the function is invoked again while a request is still being processed, another instance is allocated, which increases the function's concurrency. \n- The total concurrency for all of the functions in your account is subject to a per-region quota.\n\nThere are two types of concurrency controls available:\n- Reserved concurrency – Reserved concurrency guarantees the maximum number of concurrent instances for the function. When a function has reserved concurrency, no other function can use that concurrency. No charge for this\n- Provisioned concurrency – Provisioned concurrency initializes a requested number of execution environments so that they are prepared to respond immediately to your function's invocations. Note that configuring provisioned concurrency incurs charges to your AWS account.\n\n## Notes\n\n- AWS Lambda is suited for creating serverless/stateless APIs and costs cheaper than AWS Fargate.\n\n## Blogs\n\n[How do I troubleshoot Lambda function throttling with \"Rate exceeded\" and 429 \"TooManyRequestsException\" errors?](https://aws.amazon.com/premiumsupport/knowledge-center/lambda-troubleshoot-throttling)\n\n- Lambda functions are sometimes throttled to protect your resources and downstream applications. Even though Lambda automatically scales to accommodate incoming traffic, your function can still be throttled for various reasons\n\n\n[Understanding and Managing AWS Lambda Function Concurrency](https://aws.amazon.com/blogs/compute/managing-aws-lambda-function-concurrency)\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/lex.md", "content": "# Lex\n\n[Amazon Lex](https://aws.amazon.com/lex)\n\n[Cheat Sheet - Amazon Lex](https://tutorialsdojo.com/amazon-lex)\n\n- Build chatbots with conversational AI\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/macie.md", "content": "\n> Revision Count: 1\n\n# Macie\n\n[Macie](https://aws.amazon.com/macie/)\n\n[Cheat Sheet - Macie](https://tutorialsdojo.com/amazon-macie)\n\n- Amazon Macie is a fully managed data security and data privacy service that uses machine learning and pattern matching to discover and protect your sensitive data in AWS.\n\n- As organizations manage growing volumes of data, identifying and protecting their sensitive data at scale can become increasingly complex, expensive, and time-consuming. \n- Amazon Macie automates the discovery of sensitive data at scale and lowers the cost of protecting your data. \n- Macie automatically provides an inventory of Amazon S3 buckets including a list of unencrypted buckets, publicly accessible buckets, and buckets shared with AWS accounts outside those you have defined in AWS Organizations. \n- Then, Macie applies machine learning and pattern matching techniques to the buckets you select to identify and alert you to sensitive data, such as personally identifiable information (PII). " }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/mechanicalTurk.md", "content": "# Mechanical Turk\n\n[What is Mechanical Turk](https://docs.aws.amazon.com/AWSMechTurk/latest/AWSMechanicalTurkRequester/WhatIs.html)\n\n[Cheat Sheet - Mechanical Turk](https://tutorialsdojo.com/amazon-mechanical-turk)\n\n- Is a crowdsourcing marketplace that connects you with an on-demand, scalable, human workforce to complete tasks.\n- Using Mechanical Turk, you can programmatically direct tasks to the Mechanical Turk marketplace, where they can be completed by workers around the world.\n- Mechanical Turk allows you to access the intelligence, skills, and insights of a global workforce for tasks as varied as data categorization, moderation, data collection and analysis, behavioral studies, and image annotation.\n- Mechanical Turk is built around the concept of microtasks, which are small, atomic tasks that workers can complete in their web browser.\n- When you submit work to Mechanical Turk, you typically start by breaking it into smaller tasks on which workers can work independently. \n- In this way, a project involving categorizing 10,000 images becomes 10,000 individual microtasks that workers can complete." }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/migrationHub.md", "content": "# AWS Migration Hub\n\n[AWS Migration Services](https://tutorialsdojo.com/aws-cheat-sheets-migration-services)\n\n[What Is AWS Migration Hub?](https://docs.aws.amazon.com/migrationhub/latest/ug/whatishub.html)\n\n- AWS Migration Hub (Migration Hub) provides a single place to discover your existing servers, plan migrations, and track the status of each application migration. \n- The Migration Hub provides visibility into your application portfolio and streamlines planning and tracking. \n- You can visualize the connections and the status of the servers and databases that make up each of the applications you are migrating, regardless of which migration tool you are using.\n- Migration Hub supports migration status updates from the following tools:\n - AWS Application Migration Service (AWS MGN)–AWS Application Migration Service is the primary migration service recommended for lift-and-shift migrations to AWS\n - AWS Server Migration Service (AWS SMS)\n - AWS Database Migration Service (AWS DMS)\n - The ATADATA ATAmotion partner tool\n[Getting started with AWS Migration Hub](https://docs.aws.amazon.com/migrationhub/latest/ug/getting-started.html)\n\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/opswork.md", "content": "" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/opsworks.md", "content": "# OpsWorks\n\n[Cheat Sheet - AWS OpsWorks](https://tutorialsdojo.com/aws-opsworks/)\n\n- AWS OpsWorks is a configuration management service that provides managed instances of Chef and Puppet. \n- Chef and Puppet are automation platforms that allow you to use code to automate the configurations of your servers. \n- OpsWorks lets you use Chef and Puppet to automate how servers are configured, deployed, and managed across your Amazon EC2 instances or on-premises compute environments.\n\n\n\n[How to set up AWS OpsWorks Stacks auto healing notifications in Amazon CloudWatch Events](https://aws.amazon.com/blogs/mt/how-to-set-up-aws-opsworks-stacks-auto-healing-notifications-in-amazon-cloudwatch-events/)\n\n- Save the following event pattern as a file named OpsWorksAutoHealingPattern.json\n\n```json\n{\n \"source\": [\n \"aws.opsworks\"\n ],\n \"detail\": {\n \"initiated_by\": [\n \"auto-healing\"\n ]\n }\n}\n```" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/organizations.md", "content": "# Organizations\n\n[Cheat Sheet - AWS Organization](https://tutorialsdojo.com/aws-organizations)\n\n[Cheat Sheet - Multi-Account Multi-Region Data Aggregation On AWS Config\n](https://tutorialsdojo.com/multi-account-multi-region-data-aggregation-on-aws-config)\n\n[service-control-policies-scp-vs-iam-policies](https://tutorialsdojo.com/service-control-policies-scp-vs-iam-policies/)\n\n[What is AWS Organizations?](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_introduction.html)\n\n- AWS Organizations is an account management service that enables you to consolidate multiple AWS accounts into an organization that you create and centrally manage. \n- AWS Organizations includes account management and consolidated billing capabilities that enable you to better meet the budgetary, security, and compliance needs of your business. \n- As an administrator of an organization, you can create accounts in your organization and invite existing accounts to join the organization.\n\n\n## Using AWS Services\n\n\n### Using AWS Organizations with other AWS services\n\n[Using AWS Organizations with other AWS services](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)\n\n- You can use trusted access to enable a supported AWS service that you specify, called the trusted service, to perform tasks in your organization and its accounts on your behalf. \n- This involves granting permissions to the trusted service but does not otherwise affect the permissions for IAM users or roles. \n- When you enable access, the trusted service can create an IAM role called a service-linked role in every account in your organization whenever that role is needed. \n- That role has a permissions policy that allows the trusted service to do the tasks that are described in that service's documentation\n- The trusted service only creates service-linked roles when it needs to perform management actions on accounts, and not necessarily in all accounts of the organization.\n\n#### AWS Resource Access Manager and AWS Organizations\n\n- AWS Resource Access Manager (AWS RAM) enables you to share specified AWS resources that you own with other AWS accounts. \n- It's a centralized service that provides a consistent experience for sharing different types of AWS resources across multiple accounts.\n\nService-linked roles created when you enable integration\n\n- The following service-linked role is automatically created in your organization's management account when you enable trusted access. \n- This role allows AWS RAM to perform supported operations within your organization's accounts in your organization.\n- You can delete or modify this role only if you disable trusted access between AWS RAM and Organizations, or if you remove the member account from the organization.\n\n```bash\n AWSServiceRoleForResourceAccessManager\n``` \n\n\n## Managing Policies\n\n### Service control policies\n\n[Service control policies (SCPs)](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps.html)\n\n- Service control policies (SCPs) are a type of organization policy that you can use to manage permissions in your organization.\n- SCPs offer central control over the maximum available permissions for all accounts in your organization.\n- SCPs help you to ensure your accounts stay within your organization’s access control guidelines. \n- SCPs are available only in an organization that has all features enabled\n- An SCP defines a guardrail, or sets limits, on the actions that the account's administrator can delegate to the IAM users and roles in the affected accounts. \n- The administrator must still attach identity-based or resource-based policies to IAM users or roles, or to the resources in your accounts to actually grant permissions\n\n> AWS strongly recommends that you don't attach SCPs to the root of your organization without thoroughly testing the impact that the policy has on accounts.\n\n> SCPs do not affect any service-linked role. Service-linked roles enable other AWS services to integrate with AWS Organizations and can't be restricted by SCPs.\n\n\n## Tutorial: Monitor important changes to your organization with CloudWatch Events\n\n[Tutorial: Monitor important changes to your organization with CloudWatch Events](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_tutorials_cwe.html)\n\n- You start by configuring a rule that is triggered when users invoke specific AWS Organizations operations. \n- Next, you configure CloudWatch Events to run an AWS Lambda function when the rule is triggered, \n- and you configure Amazon SNS to send an email with details about the event.\n\n\n## Using other AWS Services\n\n### AWS Config and AWS Organizations\n\n[AWS Config and AWS Organizations\n](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-config.html)\n\n- Multi-account, multi-region data aggregation in AWS Config enables you to aggregate AWS Config data from multiple accounts and AWS Regions into a single account.\n- An aggregator is a resource type in AWS Config that collects AWS Config data from multiple source accounts and Regions. \n- Create an aggregator in the Region where you want to see the aggregated AWS Config data. \n- While creating an aggregator, you can choose to add either individual account IDs or your organization\n\n## Managing organizational units (OUs)\n\n[Managing organizational units (OUs)](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_ous.html)\n\n- You can use organizational units (OUs) to group accounts together to administer as a single unit.\n- you can attach a policy-based control to an OU, and all accounts within the OU automatically inherit the policy. \n- You can create multiple OUs within a single organization, and you can create OUs within other OUs. \n- Each OU can contain multiple accounts, and you can move accounts from one OU to another. \n- However, OU names must be unique within a parent OU or root.\n\n\n## Blogs\n\n[What's the difference between an AWS Organizations service control policy and an IAM policy?](https://aws.amazon.com/premiumsupport/knowledge-center/iam-policy-service-control-policy)\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/quickSight.md", "content": "\n\n\n### Quicksight\n\n[Quicksight](https://aws.amazon.com/quicksight/)\n\nQuickSight lets you easily create and publish interactive BI dashboards as well as receive answers in seconds through natural langauge queries. QuickSight dashboards can be accessed from any device, and seamlessly embedded into your applications, portals, and websites.\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/rds.md", "content": "# RDS\n\n[Cheat Sheet - RDS](https://tutorialsdojo.com/amazon-relational-database-service-amazon-rds)\n\n[RDS Read Replicas](https://aws.amazon.com/rds/features/read-replicas)\n\n- provide enhanced performance and durability for RDS database (DB) instances\n- They make it easy to elastically scale out beyond the capacity constraints of a single DB instance for read-heavy database workloads.\n- You can create one or more replicas of a given source DB Instance and serve high-volume application read traffic from multiple copies of your data\n- Read replicas can also be promoted when needed to become standalone DB instances\n- Read replicas are available in Amazon RDS for MySQL, MariaDB, PostgreSQL, Oracle, and SQL Server as well as Amazon Aurora.\n- You can reduce the load on your source DB instance by routing read queries from your applications to the read replica\n\n[Working with read replicas](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReadRepl.html)\n\n\n### Multi-AZ deployments for high availability\n\n[Multi-AZ deployments for high availability](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.MultiAZ.html)\n\n- Multi-AZ deployments can have one standby or two standby DB instances. \n- When the deployment has one standby DB instance, it's called a Multi-AZ DB instance deployment. \n - A Multi-AZ DB instance deployment has one standby DB instance that provides failover support, but doesn't serve read traffic. \n- When the deployment has two standby DB instances, it's called a Multi-AZ DB cluster deployment. \n - A Multi-AZ DB cluster deployment has standby DB instances that provide failover support and can also serve read traffic.\n\n\n## Backing up and restoring an Amazon RDS DB instance\n\n[Backing up and restoring an Amazon RDS DB instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_CommonTasks.BackupRestore.html)\n\n### Restoring a DB instance to a specified time\n\n- You can restore a DB instance to a specific point in time, creating a new DB instance.\n- RDS uploads transaction logs for DB instances to Amazon S3 every 5 minutes.\n- To see the latest restorable time for a DB instance, use the AWS CLI describe-db-instances command and look at the value returned in the LatestRestorableTime field for the DB instance.\n- To see the latest restorable time for each DB instance in the Amazon RDS console, choose Automated backups.\n\n### Amazon RDS DB instance storage\n\n[Amazon RDS DB instance storage](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html)\n\n- DB instances for Amazon RDS for MySQL, MariaDB, PostgreSQL, Oracle, and Microsoft SQL Server use Amazon Elastic Block Store (Amazon EBS) volumes for database and log storage.\n- Amazon RDS provides three storage types: General Purpose SSD (also known as gp2), Provisioned IOPS SSD (also known as io1), and magnetic (also known as standard)\n - General Purpose SSD – General Purpose SSD volumes offer cost-effective storage that is ideal for a broad range of workloads. \n - Provisioned IOPS – Provisioned IOPS storage is designed to meet the needs of I/O-intensive workloads, particularly database workloads, that require low I/O latency and consistent I/O throughput.\n - Magnetic – Amazon RDS also supports magnetic storage for backward compatibility. We recommend that you use General Purpose SSD or Provisioned IOPS for any new storage needs.\n\n### Setting the JVM TTL for DNS name lookups\n\n- The failover mechanism automatically changes the Domain Name System (DNS) record of the DB instance to point to the standby DB instance. As a result, you need to re-establish any existing connections to your DB instance. In a Java virtual machine (JVM) environment, due to how the Java DNS caching mechanism works, you might need to reconfigure JVM settings.\n- Because AWS resources use DNS name entries that occasionally change, we recommend that you configure your JVM with a TTL value of no more than 60 seconds.\n\n## NOTES\n\n- The Amazon RDS MySQL does not have a single reader endpoint for read replicas. You must use Amazon Aurora for MySQL to support this. Creating read replicas is recommended to increase the read performance of an RDS cluster.\n- Amazon RDS does not support certain features in Oracle such as Multitenant Database, Real Application Clusters (RAC), Unified Auditing, Database Vault, Recovery Manager (RMAN)\n\n## Blogs\n\n- [Understanding Burst vs. Baseline Performance with Amazon RDS and GP2](https://aws.amazon.com/blogs/database/understanding-burst-vs-baseline-performance-with-amazon-rds-and-gp2/)\n\n- [How to use CloudWatch metrics to decide between General Purpose or Provisioned IOPS for your RDS database](https://aws.amazon.com/blogs/database/how-to-use-cloudwatch-metrics-to-decide-between-general-purpose-or-provisioned-iops-for-your-rds-database)\n\n- [Amazon RDS Multi-AZ Deployments](https://aws.amazon.com/rds/features/multi-az)\n\n- [Amazon RDS – Multi-AZ Deployments For Enhanced Availability & Reliability](https://aws.amazon.com/blogs/aws/amazon-rds-multi-az-deployment)\n\n- [Implementing a disaster recovery strategy with Amazon RDS](https://aws.amazon.com/blogs/database/implementing-a-disaster-recovery-strategy-with-amazon-rds)" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/redShift.md", "content": "# RedShift\n\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/rekognition.md", "content": "# Rekognition\n\n[CheatSheet - AWS Rekognition](https://tutorialsdojo.com/amazon-rekognition)\n\n[What is Amazon Rekognition?](https://docs.aws.amazon.com/rekognition/latest/dg/what-is.html)\n\n\n## What is Amazon Rekognition?\n\n- Amazon Rekognition makes it easy to add image and video analysis to your applications. You just provide an image or video to the Amazon Rekognition API, and the service can identify objects, people, text, scenes, and activities. \n- It can detect any inappropriate content as well\n\n## Searching faces in a collection\n\n[Searching faces in a collection](https://docs.aws.amazon.com/rekognition/latest/dg/collections.html)\n\n- Amazon Rekognition can store information about detected faces in server-side containers known as collections\n- You can use the facial information that's stored in a collection to search for known faces in images, stored videos, and streaming videos. \n\n## Text detection\n\n- Extract skewed and distorted text from images and videos of street signs, social media posts, and product packaging.\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/resourceAccessManager.md", "content": "# Resource Access Manager\n\n[What is AWS Resource Access Manager?](https://docs.aws.amazon.com/ram/latest/userguide/what-is.html)\n\n- AWS Resource Access Manager (AWS RAM) helps you securely share the AWS resources that you create in one AWS account with other AWS accounts\n- If you have multiple AWS accounts, you can create a resource once and use AWS RAM to make that resource accessible to those other accounts.\n- If your account is managed by AWS Organizations, then you can share resources with all of the other accounts in the organization, or only those contained by one or more specified organizational units (OUs).\n- You can also share with specific AWS accounts by account ID, regardless of whether the account is part of an organization.\n\n## Sharing your AWS resources\n\n[Sharing your AWS resources](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html)\n\n- Enable resource sharing within AWS Organizations (optional)\n```bash\naws ram enable-sharing-with-aws-organization\n```" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/route53.md", "content": "# Route53\n\n[Cheat Sheet - AWS Route53](https://tutorialsdojo.com/amazon-route-53)\n\n[Cheat Sheet - AWS Database Migration Service](https://tutorialsdojo.com/aws-database-migration-service)\n\n\n## Working with hosted zones\n\n[Working with hosted zones](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/hosted-zones-working-with.html)\n\n- A hosted zone is a container for records, and records contain information about how you want to route traffic for a specific domain, such as example.com, and its subdomains (acme.example.com, zenith.example.com). A hosted zone and the corresponding domain have the same name. \n\n - Public hosted zones contain records that specify how you want to route traffic on the internet.\n - Private hosted zones contain records that specify how you want to route traffic in an Amazon VPC\n\n[How do I associate a Route 53 private hosted zone with a VPC in a different AWS account or Region?\n](https://aws.amazon.com/premiumsupport/knowledge-center/route53-private-hosted-zone)\n\n### Working with a private hosted zone\n\n#### Associating more VPCs with a private hosted zone\n\n[Associating more VPCs with a private hosted zone](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/hosted-zone-private-associate-vpcs.html)\n\n- You can use the Amazon Route 53 console to associate more VPCs with a private hosted zone if you created the hosted zone and the VPCs by using the same AWS account.\n\n#### Associating an Amazon VPC and a private hosted zone that you created with different AWS accounts\n\n[Associating an Amazon VPC and a private hosted zone that you created with different AWS accounts](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/hosted-zone-private-associate-vpcs-different-accounts.html)\n\n\n\n## Routing internet traffic to your AWS resources\n\n### Routing traffic to an ELB load balancer\n\n- To route domain traffic to an ELB load balancer, use Amazon Route 53 to create an alias record that points to your load balancer.\n- An alias record is a Route 53 extension to DNS. It's similar to a CNAME record, but you can create an alias record both for the root domain, such as example.com, and for subdomains, such as www.example.com.\n\n\n### Routing traffic to a website that is hosted in an Amazon S3 bucket\n\n[Routing traffic to a website that is hosted in an Amazon S3 bucket](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/RoutingToS3Bucket.html)\n\n- To route domain traffic to an S3 bucket, use Amazon Route 53 to create an alias record that points to your bucket.\n\n\n### Configuring a static website using a custom domain registered with Route 53\n\n[Configuring a static website using a custom domain registered with Route 53](https://docs.aws.amazon.com/AmazonS3/latest/userguide/website-hosting-custom-domain-walkthrough.html)\n\n\n## Creating Amazon Route 53 health checks and configuring DNS failover\n\n[Creating Amazon Route 53 health checks and configuring DNS failover](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover.html)\n\n- Amazon Route 53 health checks monitor the health and performance of your web applications, web servers, and other resources. Each health check that you create can monitor one of the following:\n - The health of a specified resource, such as a web server.\n - The status of other health checks.\n - The status of an Amazon CloudWatch alarm.\n - With Amazon Route 53 Application Recovery Controller, you can set up routing control health checks with DNS failover records to manage traffic failover for your application. \n\n\n## Choosing a routing policy\n\n[Choosing a routing policy](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html)\n\n- Simple routing policy – Use for a single resource that performs a given function for your domain, for example, a web server that serves content for the example.com website.\n- Failover routing policy – Use when you want to configure active-passive failover.\n- Geolocation routing policy – Use when you want to route traffic based on the location of your users.\n- Geoproximity routing policy – Use when you want to route traffic based on the location of your resources and, optionally, shift traffic from resources in one location to resources in another.\n- Latency routing policy – Use when you have resources in multiple AWS Regions and you want to route traffic to the Region that provides the best latency with less round-trip time.\n- Multivalue answer routing policy – Use when you want Route 53 to respond to DNS queries with up to eight healthy records selected at random.\n- Weighted routing policy – Use to route traffic to multiple resources in proportions that you specify\n\n\n\n\n\n### Configuring DNSSEC for a domain\n\n[Configuring DNSSEC for a domain](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-configure-dnssec.html)\n\n- Attackers sometimes hijack traffic to internet endpoints such as web servers by intercepting DNS queries and returning their own IP addresses to DNS resolvers in place of the actual IP addresses for those endpoints\n- Users are then routed to the IP addresses provided by the attackers in the spoofed response, for example, to fake websites.\n- You can protect your domain from this type of attack, known as DNS spoofing or a man-in-the-middle attack, by configuring Domain Name System Security Extensions (DNSSEC), a protocol for securing DNS traffic.\n\n\n## Configuring DNS Failover\n\n### Active-active and active-passive failover\n\n[Active-active and active-passive failover](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-types.html)\n\n- You can use Route 53 health checking to configure active-active and active-passive failover configurations. \n - You configure active-active failover using any routing policy (or combination of routing policies) other than failover, \n - and you configure active-passive failover using the failover routing policy.\n\n## Resolving DNS queries between VPCs and your network\n\n[Resolving DNS queries between VPCs and your network](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver.html)\n\n- When you create a VPC using Amazon VPC, Route 53 Resolver automatically uses a Resolver on the VPC to answer DNS queries for local Amazon VPC domain names for EC2 instances (ec2-192-0-2-44.compute-1.amazonaws.com) and records in private hosted zones (acme.example.com). \n- For all other domain names, Resolver performs recursive lookups against public name servers.\n\n- You also can integrate DNS resolution between Resolver and DNS resolvers on your network by configuring forwarding rules. Your network can include any network that is reachable from your VPC, such as the following:\n - The VPC itself\n - Another peered VPC\n - An on-premises network that is connected to AWS with AWS Direct Connect, a VPN, or a network address translation (NAT) gateway\n- Before you start to forward queries, you create Resolver inbound and/or outbound endpoints in the connected VPC. These endpoints provide a path for inbound or outbound queries:\n - Inbound endpoint: DNS resolvers on your network can forward DNS queries to Route 53 Resolver via this endpoint\n - This allows your DNS resolvers to easily resolve domain names for AWS resources such as EC2 instances or records in a Route 53 private hosted zone.\n - Outbound endpoint: Resolver conditionally forwards queries to resolvers on your network via this endpoint\n - To forward selected queries, you create Resolver rules that specify the domain names for the DNS queries that you want to forward (such as example.com), and the IP addresses of the DNS resolvers on your network that you want to forward the queries to\n\n[How do I configure a Route 53 Resolver inbound endpoint to resolve DNS records in my private hosted zone from my remote network?](https://aws.amazon.com/premiumsupport/knowledge-center/route53-resolve-with-inbound-endpoint)\n\n\n### Values specific for simple alias records\n\n[Values specific for simple alias records](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resource-record-sets-values-alias.html)\n\n- When you create alias records, you specify the following values\n - Routing policy\n - Record name\n - Value/route traffic to\n - Record type\n - Evaluate target health\n\n\n### Choosing between alias and non-alias records\n\n[Choosing between alias and non-alias records](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resource-record-sets-choosing-alias-non-alias.html)\n\n- Amazon Route 53 alias records provide a Route 53–specific extension to DNS functionality. \n- Alias records let you route traffic to selected AWS resources, such as CloudFront distributions and Amazon S3 buckets. \n- They also let you route traffic from one record in a hosted zone to another record.\n- Unlike a CNAME record, you can create an alias record at the top node of a DNS namespace, also known as the zone apex.\n\n\n## Blogs\n\n[Simplify DNS management in a multi-account environment with Route 53 Resolver](https://aws.amazon.com/blogs/security/simplify-dns-management-in-a-multiaccount-environment-with-route-53-resolver)" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/s3.md", "content": "# S3\n\n[Cheat Sheet - AWS S3](https://tutorialsdojo.com/amazon-s3)\n\n[Cheat Sheet - Amazon Glacier](https://tutorialsdojo.com/amazon-sqs)\n\n[Cheat Sheet - s3-pre-signed-urls-vs-cloudfront-signed-urls-vs-origin-access-identity-oai](https://tutorialsdojo.com/s3-pre-signed-urls-vs-cloudfront-signed-urls-vs-origin-access-identity-oai)\n\n[Cheat Sheet - s3-transfer-acceleration-vs-direct-connect-vs-vpn-vs-snowball-vs-snowmobile](https://tutorialsdojo.com/s3-transfer-acceleration-vs-direct-connect-vs-vpn-vs-snowball-vs-snowmobile)\n\n[What is Amazon S3?](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html)\n\n- Amazon Simple Storage Service (Amazon S3) is an object storage service that offers industry-leading scalability, data availability, security, and performance. \n\n[object-lifecycle-mgmt](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html)\n\n- storing logs in Amazon S3, and use lifecycle policies to archive to Amazon\n Glacier\n\n## Amazon S3 Event Notifications\n\n[Amazon S3 Event Notifications](https://docs.aws.amazon.com/AmazonS3/latest/userguide/NotificationHowTo.html)\n\n- You can use the Amazon S3 Event Notifications feature to receive notifications when certain events happen in your S3 bucket.\n- To enable notifications, you must first add a notification configuration that identifies the events you want Amazon S3 to publish and the destinations where you want Amazon S3 to send the notifications.\n- You store this configuration in the notification subresource that is associated with a bucket.\n\n[Tutorial: Using an Amazon S3 trigger to invoke a Lambda function](https://docs.aws.amazon.com/lambda/latest/dg/with-s3-example.html#with-s3-example-configure-event-source)\n\n\n### Replicating objects\n\n[Replicating objects](https://docs.aws.amazon.com/AmazonS3/latest/userguide/replication.html)\n\n- Replication enables automatic, asynchronous copying of objects across Amazon S3 buckets\n- Buckets that are configured for object replication can be owned by the same AWS account or by different accounts.\n- Objects may be replicated to a single destination bucket or multiple destination buckets. \n- By default, replication only supports copying new Amazon S3 objects after it is enabled. \n- You can use replication to copy existing objects and clone them to a different bucket, but in order to do so, you must contact AWS Support Center\n\n\n\n## Hosting a static website using Amazon S3\n\n[Hosting a static website using Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/WebsiteHosting.html)\n\n- You can use Amazon S3 to host a static website. On a static website, individual webpages include static content. They might also contain client-side scripts.\n\n\n## Server Side Encryption\n\n### Protecting data using server-side encryption\n\n[Protecting data using server-side encryption](https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html)\n\n- Server-side encryption is the encryption of data at its destination by the application or service that receives it.\n- Amazon S3 encrypts your data at the object level as it writes it to disks in its data centers and decrypts it for you when you access it. \n- As long as you authenticate your request and you have access permissions, there is no difference in the way you access encrypted or unencrypted objects. \n\nYou have three mutually exclusive options, depending on how you choose to manage the encryption keys.\n- Server-Side Encryption with Amazon S3-Managed Keys (SSE-S3)\n- Server-Side Encryption with KMS keys Stored in AWS Key Management Service (SSE-KMS)\n- Server-Side Encryption with Customer-Provided Keys (SSE-C)\n\n\n\n### Protecting data using server-side encryption with customer-provided encryption keys (SSE-C)\n\n[Protecting data using server-side encryption with customer-provided encryption keys (SSE-C)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html)\n\n- Server-side encryption is about protecting data at rest. \n- Server-side encryption encrypts only the object data, not object metadata.\n- Using server-side encryption with customer-provided encryption keys (SSE-C) allows you to set your own encryption keys\n- The only thing you do is manage the encryption keys you provide.\n\n### Protecting data using server-side encryption with Amazon S3-managed encryption keys (SSE-S3)\n\n[Protecting data using server-side encryption with Amazon S3-managed encryption keys (SSE-S3)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingServerSideEncryption.html)\n\n- Server-side encryption protects data at rest. \n- Amazon S3 encrypts each object with a unique key. \n- As an additional safeguard, it encrypts the key itself with a key that it rotates regularly. \n\n## Working with Buckets\n\n### Using Requester Pays buckets for storage transfers and usage\n\n[Using Requester Pays buckets for storage transfers and usage](https://docs.aws.amazon.com/AmazonS3/latest/userguide/RequesterPaysBuckets.html)\n\n- In general, bucket owners pay for all Amazon S3 storage and data transfer costs that are associated with their bucket. \n- However, you can configure a bucket to be a Requester Pays bucket. \n- With Requester Pays buckets, the requester instead of the bucket owner pays the cost of the request and the data download from the bucket.\n\n\n### Using versioning in S3 buckets\n\n[Using versioning in S3 buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Versioning.html)\n\n- Versioning in Amazon S3 is a means of keeping multiple variants of an object in the same bucket. \n- You can use the S3 Versioning feature to preserve, retrieve, and restore every version of every object stored in your buckets. \n\n### Configuring fast, secure file transfers using Amazon S3 Transfer Acceleration\n\n[Configuring fast, secure file transfers using Amazon S3 Transfer Acceleration](https://docs.aws.amazon.com/AmazonS3/latest/userguide/transfer-acceleration.html)\n\n- Amazon S3 Transfer Acceleration is a bucket-level feature that enables fast, easy, and secure transfers of files over long distances between your client and an S3 bucket. \n- Transfer Acceleration takes advantage of the globally distributed edge locations in Amazon CloudFront. \n- As the data arrives at an edge location, the data is routed to Amazon S3 over an optimized network path.\n\n**Why use Transfer Acceleration?**\n- Your customers upload to a centralized bucket from all over the world.\n- You transfer gigabytes to terabytes of data on a regular basis across continents.\n- You can't use all of your available bandwidth over the internet when uploading to Amazon S3.\n\n\n### Uploading and copying objects using multipart upload\n\n[Uploading and copying objects using multipart upload](https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html)\n\n[How can I optimize performance when I upload large files to Amazon S3?](https://aws.amazon.com/premiumsupport/knowledge-center/s3-upload-large-files)\n\n- Multipart upload allows you to upload a single object as a set of parts. \n- Each part is a contiguous portion of the object's data. \n- You can upload these object parts independently and in any order\n- If transmission of any part fails, you can retransmit that part without affecting other parts. \n- After all parts of your object are uploaded, Amazon S3 assembles these parts and creates the object. \n- In general, when your object size reaches 100 MB, you should consider using multipart uploads instead of uploading the object in a single operation.\n\n## Uploading objects using presigned URLs\n\n[Uploading objects using presigned URLs](https://docs.aws.amazon.com/AmazonS3/latest/userguide/PresignedUrlUploadObject.html)\n\n\n- A presigned URL gives you access to the object identified in the URL, provided that the creator of the presigned URL has permissions to access that object.\n- All objects and buckets by default are private. \n- The presigned URLs are useful if you want your user/customer to be able to upload a specific object to your bucket, but you don't require them to have AWS security credentials or permissions.\n\n## Managing your storage lifecycle\n\n[Managing your storage lifecycle](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html)\n\n\n## Amazon S3 Glacier storage classes\n\n[Amazon S3 Glacier storage classes](https://aws.amazon.com/s3/storage-classes/glacier)\n\n- The Amazon S3 Glacier storage classes are purpose-built for data archiving, providing you with the highest performance, most retrieval flexibility, and the lowest cost archive storage in the cloud\n\n## Notes\n\n[I accidentally denied everyone access to my Amazon S3 bucket. How do I regain access?](https://aws.amazon.com/premiumsupport/knowledge-center/s3-accidentally-denied-access/)\n\n- To get access to your bucket again, sign in to the Amazon S3 console as the AWS account root user, and then delete the bucket policy.\n\n\n#### put-bucket-policy\n\n[put-bucket-policy](https://docs.aws.amazon.com/cli/latest/reference/s3api/put-bucket-policy.html)\n\n- This example allows all users to retrieve any object in MyBucket except those in the MySecretFolder. It also grants put and delete permission to the root user of the AWS account 1234-5678-9012\n\n```bash\naws s3api put-bucket-policy --bucket MyBucket --policy file://policy.json\n```\n\n\n```json\n{\n \"Statement\": [\n {\n \"Effect\": \"Allow\",\n \"Principal\": \"*\",\n \"Action\": \"s3:GetObject\",\n \"Resource\": \"arn:aws:s3:::MyBucket/*\"\n },\n {\n \"Effect\": \"Deny\",\n \"Principal\": \"*\",\n \"Action\": \"s3:GetObject\",\n \"Resource\": \"arn:aws:s3:::MyBucket/MySecretFolder/*\"\n },\n {\n \"Effect\": \"Allow\",\n \"Principal\": {\n \"AWS\": \"arn:aws:iam::123456789012:root\"\n },\n \"Action\": [\n \"s3:DeleteObject\",\n \"s3:PutObject\"\n ],\n \"Resource\": \"arn:aws:s3:::MyBucket/*\"\n }\n ]\n}\n```\n\n### Managing Storage\n\n#### \n\n[How can I retrieve an Amazon S3 object that was deleted in a versioning-enabled bucket?](https://aws.amazon.com/premiumsupport/knowledge-center/s3-undelete-configuration/)\n\n- When you delete an object from a version-enabled bucket, Amazon S3 creates a delete marker for the object. The delete marker becomes the current version of the object, and the actual object becomes the previous version. With a delete marker, Amazon S3 responds to requests for the object as though the object was deleted. For example, if you send a GET request for the object, then Amazon S3 returns an error.\n\n\n## Blogs\n\n- [Building and Maintaining an Amazon S3 Metadata Index without Servers](https://aws.amazon.com/blogs/big-data/building-and-maintaining-an-amazon-s3-metadata-index-without-servers)\n\n - Amazon S3 is a simple key-based object store whose scalability and low cost make it ideal for storing large datasets\n - Its design enables S3 to provide excellent performance for storing and retrieving objects based on a known key.\n - Finding objects based on other attributes, however, requires doing a linear search using the LIST operation. \n - Because each listing can return at most 1000 keys, it may require many requests before finding the object. \n - Because of these additional requests, implementing attribute-based queries in S3 alone can be challenging.\n - A common solution is to build an external index that maps queryable attributes to the S3 object key\n - approach for building such an index using Amazon DynamoDB and AWS Lambda" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/sageMaker.md", "content": "# SageMaker\n\n[Cheat Sheet - SageMaker](https://tutorialsdojo.com/amazon-sagemaker)\n## What Is Amazon SageMaker?\n\n[What Is Amazon SageMaker?](https://docs.aws.amazon.com/sagemaker/latest/dg/whatis.html)\n\n- Amazon SageMaker is a fully managed machine learning service. \n- With SageMaker, data scientists and developers can quickly and easily build and train machine learning models, and then directly deploy them into a production-ready hosted environment\n- It provides an integrated Jupyter authoring notebook instance for easy access to your data sources for exploration and analysis, so you don't have to manage servers. - It also provides common machine learning algorithms that are optimized to run efficiently against extremely large data in a distributed environment. \n\n\n\n\n## Blogs\n\n- [Enable self-service, secured data science using Amazon SageMaker notebooks and AWS Service Catalog](https://aws.amazon.com/blogs/mt/enable-self-service-secured-data-science-using-amazon-sagemaker-notebooks-and-aws-service-catalog)\n\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/schemaConversionTool.md", "content": "# Schema Conversion Tool\n\n[What Is the AWS Schema Conversion Tool?](https://docs.aws.amazon.com/SchemaConversionTool/latest/userguide/CHAP_Welcome.html)\n\n- You can use the AWS Schema Conversion Tool (AWS SCT) to convert your existing database schema from one database engine to another. \n- You can convert relational OLTP schema, or data warehouse schema. \n- Your converted schema is suitable for an Amazon Relational Database Service (Amazon RDS) MySQL, MariaDB, Oracle, SQL Server, PostgreSQL DB, an Amazon Aurora DB cluster, or an Amazon Redshift cluster. \n- The converted schema can also be used with a database on an Amazon EC2 instance or stored as data on an Amazon S3 bucket.\n\n## Migrating data from an on-premises data warehouse to Amazon Redshift\n\n- You can use an AWS SCT agent to extract data from your on-premises data warehouse and migrate it to Amazon Redshift. The agent extracts your data and uploads the data to either Amazon S3 \n- or, for large-scale migrations, an AWS Snowball Edge device. \n- You can then use AWS SCT to copy the data to Amazon Redshift." }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/secretsManager.md", "content": "# Secrets Manager\n\n[Cheat Sheet - Secrets Manager](https://tutorialsdojo.com/aws-secrets-manager/)\n\n\n- AWS Secrets Manager helps you protect secrets needed to access your applications, services, and IT resources. \n- The service enables you to easily rotate, manage, and retrieve database credentials, API keys, and other secrets throughout their lifecycle. \n- Users and applications retrieve secrets with a call to Secrets Manager APIs, eliminating the need to hardcode sensitive information in plain text. \n- Secrets Manager offers secret rotation with built-in integration for Amazon RDS, Amazon Redshift, and Amazon DocumentDB. \n- Also, the service is extensible to other types of secrets, including API keys and OAuth tokens\n\n\n## Automate secret creation in AWS CloudFormation\n\n[Automate secret creation in AWS CloudFormation](https://docs.aws.amazon.com/secretsmanager/latest/userguide/integrating_cloudformation.html)\n\n[How to create and retrieve secrets managed in AWS Secrets Manager using AWS CloudFormation templates](https://aws.amazon.com/blogs/security/how-to-create-and-retrieve-secrets-managed-in-aws-secrets-manager-using-aws-cloudformation-template)\n\n- You can use AWS CloudFormation to create and reference secrets from within your AWS CloudFormation stack template. \n- You can create a secret and then reference it from another part of the template. \n- For example, you can retrieve the user name and password from the new secret and then use that to define the user name and password for a new database. \n- You can create and attach resource-based policies to a secret. \n- You can also configure rotation by defining a Lambda function in your template and associating the function with your new secret as its rotation Lambda function.\n\n- Secrets Manager provides the following resource types that you can use to create secrets in an AWS CloudFormation template:\n\n - AWS::SecretsManager::Secret – Creates a secret and stores it in Secrets Manager. You can specify a password or Secrets Manager can generate one for you.\n - AWS::SecretsManager::ResourcePolicy – Creates a resource-based policy and attaches it to the secret. A resource-based policy controls who can perform actions on the secret.\n - AWS::SecretsManager::RotationSchedule – Configures a secret to perform automatic periodic rotation using the specified Lambda rotation function.\n - AWS::SecretsManager::SecretTargetAttachment – Configures the secret with the details about the service or database that Secrets Manager needs to rotate the secret. For example, for an Amazon RDS DB instance, Secrets Manager adds the connection details and database engine type as entries in the SecureString property of the secret.\n\n " }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/securityTokenService.md", "content": "# Security Token Service\n\n## Actions\n\n### AssumeRole\n\n[AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)\n\n- Returns a set of temporary security credentials that you can use to access AWS resources that you might not normally have access to. \n- These temporary credentials consist of an access key ID, a secret access key, and a security token." }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/serverMigrationService.md", "content": "# Server Migration Service\n\n[Cheat Sheet - SMS](https://tutorialsdojo.com/aws-server-migration-service-sms)\n\n[What is AWS Server Migration Service?](https://docs.aws.amazon.com/server-migration-service/latest/userguide/server-migration.html)\n\n[AWS Server Migration Service – Server Migration to the Cloud Made Easy](https://aws.amazon.com/blogs/apn/aws-server-migration-service-server-migration-to-the-cloud-made-easy)\n\n- AWS Server Migration Service (AWS SMS) automates the migration of your on-premises VMware vSphere, Microsoft Hyper-V/SCVMM, and Azure virtual machines to the AWS Cloud.\n- AWS SMS incrementally replicates your server VMs as cloud-hosted Amazon Machine Images (AMIs) ready for deployment on Amazon EC2. Working with AMIs, you can easily test and update your cloud-based images before deploying them in production.\n\n\n## Migrate Application\n\n[Migrate applications using AWS SMS](https://docs.aws.amazon.com/server-migration-service/latest/userguide/application-migration.html)\n\n- AWS Server Migration Service supports the automated migration of multi-server application stacks from your on-premises data center to Amazon EC2\n- Where server migration is accomplished by replicating a single server as an Amazon Machine Image (AMI), application migration replicates all of the servers in an application as AMIs and generates an AWS CloudFormation template to launch them in a coordinated fashion.\n\n\n\n[Using Amazon CloudWatch Events and AWS Lambda with AWS SMS](https://docs.aws.amazon.com/server-migration-service/latest/userguide/cwe-sms.html)\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/serverlessApplicationModel.md", "content": "# Serverless Applicaton Model\n\n\n[CheatSheet - AWS Serverless Application Model](https://tutorialsdojo.com/aws-serverless-application-model-sam)\n\n\n## What is the AWS Serverless Application Model (AWS SAM)?\n\n[What is the AWS Serverless Application Model (AWS SAM)?](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/what-is-sam.html)\n\n- The AWS Serverless Application Model (AWS SAM) is an open-source framework that you can use to build serverless applications on AWS.\n\n### Deploying serverless applications gradually\n\n- If you use AWS SAM to create your serverless application, it comes built-in with CodeDeploy to provide gradual Lambda deployments. With just a few lines of configuration, AWS SAM does the following for you:\n\n - Deploys new versions of your Lambda function, and automatically creates aliases that point to the new version.\n - Gradually shifts customer traffic to the new version until you're satisfied that it's working as expected, or you roll back the update.\n - Defines pre-traffic and post-traffic test functions to verify that the newly deployed code is configured correctly and your application operates as expected.\n - Rolls back the deployment if CloudWatch alarms are triggered.\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/serviceCatalog.md", "content": "# AWS Service Catalog\n\n[What Is AWS Service Catalog?](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/introduction.html)\n\n[Cheat Sheet - AWS Service Catalog](https://tutorialsdojo.com/aws-service-catalog)\n\n- AWS Service Catalog enables organizations to create and manage catalogs of IT services that are approved for AWS. \n- These IT services can include everything from virtual machine images, servers, software, databases, and more to complete multi-tier application architectures.\n- AWS Service Catalog allows organizations to centrally manage commonly deployed IT services, and helps organizations achieve consistent governance and meet compliance requirements. \n- End users can quickly deploy only the approved IT services they need, following the constraints set by your organization." }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/shield.md", "content": "# Shield\n\n[AWS Shield](https://docs.aws.amazon.com/waf/latest/developerguide/shield-chapter.html)\n\n[Cheat Sheet - AWS Shield](https://tutorialsdojo.com/aws-shield)\n\n- AWS Shield is a managed Distributed Denial of Service (DDoS) protection service that safeguards applications running on AWS.\n- AWS Shield provides always-on detection and automatic inline mitigations that minimize application downtime and latency\n- There are two tiers of AWS Shield - Standard and Advanced.\n\n- All AWS customers benefit from the automatic protections of AWS Shield Standard, at no additional charge\n- AWS Shield Standard defends against most common, frequently occurring network and transport layer DDoS attacks that target your web site or applications. \n- When you use AWS Shield Standard with Amazon CloudFront and Amazon Route 53, you receive comprehensive availability protection against all known infrastructure (Layer 3 and 4) attacks.\n- For higher levels of protection against attacks targeting your applications running on Amazon Elastic Compute Cloud (EC2), Elastic Load Balancing (ELB), Amazon CloudFront, AWS Global Accelerator and Amazon Route 53 resources, you can subscribe to AWS Shield Advanced. \n\n[AWS Shield - Managed DDoS protection](https://aws.amazon.com/shield/?whats-new-cards.sort-by=item.additionalFields.postDateTime&whats-new-cards.sort-order=desc)\n\n- AWS provides AWS Shield Standard and AWS Shield Advanced for protection against DDoS attacks. \n- AWS Shield Standard is automatically included at no extra cost beyond what you already pay for AWS WAF and your other AWS services.\n- You can add Shield Advanced protection for any of the following resource types:\n - Amazon CloudFront distributions\n - Amazon Route 53 hosted zones\n - AWS Global Accelerator accelerators\n - Application Load Balancers\n - Elastic Load Balancing (ELB) load balancers\n - Amazon Elastic Compute Cloud (Amazon EC2) Elastic IP addresses\n\n\n> There are two types of AWS Shield: the Standard one which is free and the Advanced type which has an additional cost of around $3,000 per month.\n\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/simpleNotificationService.md", "content": "# Simple Notification Service\n\n[Cheat Sheet - Simple Notification Service](https://tutorialsdojo.com/amazon-sns)\n\n[Mobile push notifications](https://docs.aws.amazon.com/sns/latest/dg/sns-mobile-application-as-subscriber.html)\n\n- With Amazon SNS, you have the ability to send push notification messages directly to apps on mobile devices. \n- Push notification messages sent to a mobile endpoint can appear in the mobile app as message alerts, badge updates, or even sound alerts.\n\n\n## What is Amazon SNS?\n\n[What is Amazon SNS?](https://docs.aws.amazon.com/sns/latest/dg/welcome.html)\n\n- Amazon Simple Notification Service (Amazon SNS) is a managed service that provides message delivery from publishers to subscribers (also known as producers and consumers). Publishers communicate asynchronously with subscribers by sending messages to a topic, which is a logical access point and communication channel. Clients can subscribe to the SNS topic and receive published messages using a supported endpoint type, such as Amazon Kinesis Data Firehose, Amazon SQS, AWS Lambda, HTTP, email, mobile push notifications, and mobile text messages (SMS).\n\n\n\n## Message Filtering\n\n[SNS message filtering](https://docs.aws.amazon.com/sns/latest/dg/sns-message-filtering.html)\n\n- By default, an Amazon SNS topic subscriber receives every message published to the topic. To receive a subset of the messages, a subscriber must assign a filter policy to the topic subscription.\n- A filter policy is a simple JSON object containing attributes that define which messages the subscriber receives. When you publish a message to a topic, Amazon SNS compares the message attributes to the attributes in the filter policy for each of the topic's subscriptions. If any of the attributes match, Amazon SNS sends the message to the subscriber\n\n### Subscription Filter Policies\n\n[Amazon SNS subscription filter policies](https://docs.aws.amazon.com/sns/latest/dg/sns-subscription-filter-policies.html)\n\n[Enriching Event-Driven Architectures with AWS Event Fork Pipelines](https://aws.amazon.com/blogs/compute/enriching-event-driven-architectures-with-aws-event-fork-pipelines/)\n\n- A subscription filter policy allows you to specify attribute names and assign a list of values to each attribute name. For more information, see Amazon SNS message filtering.\n\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/simpleQueueService.md", "content": "# Simple Queue Service\n\n[Cheat Sheet - Simple Queue Service](https://tutorialsdojo.com/amazon-sqs)\n\n## What is Amazon Simple Queue Service?\n\n[What is Amazon Simple Queue Service?](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/welcome.html)\n\n- Amazon Simple Queue Service (Amazon SQS) offers a secure, durable, and available hosted queue that lets you integrate and decouple distributed software systems and components." }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/simpleWorkflowService.md", "content": "# Simple Workflow Service\n\n[Simple Workflow Service](https://aws.amazon.com/swf/)\n\n[Cheat Sheet - SWF](https://tutorialsdojo.com/amazon-simple-workflow-amazon-swf)\n\n- Amazon SWF helps developers build, run, and scale background jobs that have parallel or sequential steps\n- You can think of Amazon SWF as a fully-managed state tracker and task coordinator in the Cloud.\n\n\n\n## FAQs\n\n[FAQ - SWF](https://aws.amazon.com/swf/faqs/)\n\n[](https://aws.amazon.com/swf/faqs/#:~:text=Processing%20large%20product%20catalogs%20using%20Amazon%20Mechanical%20Turk)" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/singleSignOn.md", "content": "> Revision Count: 1\n\n# Single Sign-On\n\n## What is AWS Single Sign-On?\n\n[What is AWS Single Sign-On?](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html)\n\n- AWS Single Sign-On is a cloud-based single sign-on (SSO) service that makes it easy to centrally manage SSO access to all of your AWS accounts and cloud applications\n- Specifically, it helps you manage SSO access and user permissions across all your AWS accounts in AWS Organizations. \n- AWS SSO-integrated applications as well as custom applications that support Security Assertion Markup Language (SAML) 2.0.\n\n## Connect to your Microsoft AD directory\n\n[Connect to your Microsoft AD directory](https://docs.aws.amazon.com/singlesignon/latest/userguide/manage-your-identity-source-ad.html)\n\n- With AWS Single Sign-On, administrators can connect their self-managed Active Directory (AD) or their AWS Managed Microsoft AD directory using AWS Directory Service. \n- This Microsoft AD directory defines the pool of identities that administrators can pull from when using the AWS SSO console to assign single sign-on (SSO) access. \n- After connecting their corporate directory to AWS SSO, administrators can then grant their AD users or groups access to AWS accounts, cloud applications, or both.\n\n\n## Notes\n\n- AWS SSO supports single sign-on to business applications through web browsers only.\n- AWS SSO supports only SAML 2.0–based applications so an OpenID Connect-compatible solution will not work here" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/snowball.md", "content": "# Snowball\n\n[Migrate Petabyte-Scale Data to the Cloud](https://aws.amazon.com/getting-started/projects/migrate-petabyte-scale-data/services-costs)\n\n- Snowball is a petabyte-scale data transport solution that uses secure appliances to transfer large amounts of data into and out of the AWS cloud. \n\n\n[Performance for AWS Snowball](https://docs.aws.amazon.com/snowball/latest/ug/performance.html)\n\n- Speeding Up Data Transfer\n\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/snowballEdge.md", "content": "# Snowball Edge\n\n[Cheat Sheet - AWS Snowball Edge](https://tutorialsdojo.com/aws-snowball-edge)\n\n## Transferring Files Using the Amazon S3 Interface\n\n### Batching Small Files\n\n[Batching Small Files](https://docs.aws.amazon.com/snowball/latest/developer-guide/batching-small-files.html)\n\n- Each copy operation has some overhead because of encryption\n- To speed up the process of transferring small files to your AWS Snowball Edge device, you can batch them together in a single archive.\n- When you batch files together, they can be auto-extracted when they are imported into Amazon S3, if they were batched in one of the supported archive formats.\n\n## Best Practices\n\n[Best Practices](https://docs.aws.amazon.com/snowball/latest/developer-guide/BestPractices.html)\n\nSpeeding Up Data Transfer\n\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/storageGateway.md", "content": "# Storage Gateway\n\n[Cheat Sheet - AWS Storage Gateway](https://tutorialsdojo.com/aws-storage-gateway)\n\n[How Storage Gateway works (architecture)](https://docs.aws.amazon.com/storagegateway/latest/userguide/StorageGatewayConcepts.html)\n\n\n- AWS Storage Gateway connects an on-premises software appliance with cloud-based storage to provide seamless integration with data security features between your on-premises IT environment and the AWS storage infrastructure.\n- You can use the service to store data in the Amazon Web Services Cloud for scalable and cost-effective storage that helps maintain data security.\n- AWS Storage Gateway offers file-based file gateways (Amazon S3 File and Amazon FSx File), volume-based (Cached and Stored), and tape-based storage solutions\n\n\n\n[Storage Gateway](https://aws.amazon.com/storagegateway)\n\n- AWS Storage Gateway is a set of hybrid cloud storage services that provide on-premises access to virtually unlimited cloud storage.\n- Deliver low-latency data access to on-premises applications while leveraging the agility, economics and security capabilities of AWS in the cloud.\n- Provide on-premises applications access to cloud-backed storage without disruption to your business by maintaining user and application workflows.\n- Offer virtually unlimited cloud storage to users and applications without deploying new storage hardware.\n\n\n\n### Amazon S3 File Gateway\n\n[Amazon S3 File Gateway](https://docs.aws.amazon.com/storagegateway/latest/userguide/WhatIsStorageGateway.html)\n\n- Amazon S3 File Gateway supports a file interface into Amazon Simple Storage Service (Amazon S3) and combines a service and a virtual software appliance\n- By using this combination, you can store and retrieve objects in Amazon S3 using industry-standard file protocols such as Network File System (NFS) and Server Message Block (SMB).\n- The software appliance, or gateway, is deployed into your on-premises environment as a virtual machine (VM) running on VMware ESXi, Microsoft Hyper-V, or Linux Kernel-based Virtual Machine (KVM) hypervisor. \n- The gateway provides access to objects in S3 as files or file share mount points.\n\n### Amazon FSx File Gateway\n\n[Amazon FSx File Gateway](https://docs.aws.amazon.com/storagegateway/latest/userguide/WhatIsStorageGateway.html)\n\n- Amazon FSx File Gateway (FSx File) is a new file gateway type that provides low latency, and efficient access to in-cloud Amazon FSx for Windows File Server file shares from your on-premises facility.\n\n\n### File Gateway\n\n[File Gateway](https://aws.amazon.com/storagegateway/file/)\n\n- Nearly all enterprises, regardless of industry, have to store files, whether they are backups, media content, or files generated by specialized industry applications.\n- You can choose from two file gateway types for your latency-sensitive applications and workloads that require local caching and file protocol access. \n - Amazon S3 File Gateway enables you to store file data as objects in Amazon S3 cloud storage for data lakes, backups, and ML workflows. \n - For user or team file shares, and file-based application migrations, Amazon FSx File Gateway provides low-latency, on-premises access to fully managed file shares in Amazon FSx for Windows File Server.\n\n### Tape Gateway\n\n[Tape Gateway](https://docs.aws.amazon.com/storagegateway/latest/userguide/WhatIsStorageGateway.html)\n\n- A tape gateway provides cloud-backed virtual tape storage. \n- The tape gateway is deployed into your on-premises environment as a VM running on VMware ESXi, KVM, or Microsoft Hyper-V hypervisor.\n\n\n[Tape Gateway](https://aws.amazon.com/storagegateway/vtl/)\n\n- Tape Gateway enables you to replace using physical tapes on premises with virtual tapes in AWS without changing existing backup workflows.\n- Tape Gateway encrypts data between the gateway and AWS for secure data transfer, and compresses data and transitions virtual tapes between Amazon S3 and Amazon S3 Glacier, or Amazon S3 Glacier Deep Archive, to minimize storage costs.\n- you can't directly fetch the media files from your tape gateway in real-time since this is backed up using Glacier.\n\n> Set up a tape gateway appliance on-premises and connect it to your AWS Storage Gateway\n\n\n### Volume Gateway\n\n[Volume Gateway](https://docs.aws.amazon.com/storagegateway/latest/userguide/WhatIsStorageGateway.html)\n\n- A volume gateway provides cloud-backed storage volumes that you can mount as Internet Small Computer System Interface (iSCSI) devices from your on-premises application servers.\n- The volume gateway is deployed into your on-premises environment as a VM running on VMware ESXi, KVM, or Microsoft Hyper-V hypervisor.\n\n- The gateway supports the following volume configurations:\n - Cached volumes\n - You store your data in Amazon Simple Storage Service (Amazon S3) and retain a copy of frequently accessed data subsets locally\n - Stored volumes\n - If you need low-latency access to your entire dataset, first configure your on-premises gateway to store all your data locally. Then asynchronously back up point-in-time snapshots of this data to Amazon S3.\n\n\n## How Storage Gateway works (architecture)\n\n[How Storage Gateway works (architecture)](https://docs.aws.amazon.com/storagegateway/latest/userguide/StorageGatewayConcepts.html#volume-gateway-concepts)\n\n\n## AWS Storage Gateway quotas\n\n[AWS Storage Gateway quotas](https://docs.aws.amazon.com/storagegateway/latest/userguide/resource-gateway-limits.html#resource-volume-limits)\n\n\n\n\n## Security\n\n### Configuring CHAP authentication for your volumes\n\n[Configuring CHAP authentication for your volumes](https://docs.aws.amazon.com/storagegateway/latest/userguide/GettingStartedConfigureChap.html)\n\n- In Storage Gateway, your iSCSI (Internet Small Computer System Interface) initiators connect to your volumes as iSCSI targets. \n- Storage Gateway uses Challenge-Handshake Authentication Protocol (CHAP) to authenticate iSCSI and initiator connections.\n- CHAP provides protection against playback attacks by requiring authentication to access storage volume targets.\n\n\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/systemManager.md", "content": "> Revision Count: 1\n\n# System Manager\n\n[What is AWS Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html)\n\n[Cheat Sheet - AWS Systems Manager](https://tutorialsdojo.com/aws-systems-manager)\n\n- AWS Systems Manager (formerly known as SSM)\n- you can use to view and control your infrastructure on AWS\n- you can view operational data from multiple AWS services and automate operational tasks across your AWS resources.\n- helps you maintain security and compliance by scanning your managed instances and reporting on (or taking corrective action on) any policy violations it detects.\n- Systems Manager is comprised of individual capabilities, which are grouped into five categories: \n - Operations Management, \n - Application Management, \n - Change Management, \n - Node Management, \n - and Shared Resources.\n\n\n## Systems Manager Patch Manager\n\n[AWS Systems Manager Patch Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-patch.html)\n\n- Patch Manager, a capability of AWS Systems Manager, automates the process of patching managed instances with both security related and other types of updates\n- You can use Patch Manager to apply patches for both operating systems and applications. (On Windows Server, application support is limited to updates for applications released by Microsoft.) \n- You can use Patch Manager to install Service Packs on Windows instances and perform minor version upgrades on Linux instances. \n- You can patch fleets of Amazon Elastic Compute Cloud (Amazon EC2) instances, edge devices, or your on-premises servers and virtual machines (VMs) by operating system type. \n- You can install patches on a regular basis by scheduling patching to run as a Systems Manager maintenance window task.\n- Patch Manager integrates with AWS Identity and Access Management (IAM), AWS CloudTrail, and Amazon EventBridge to provide a secure patching experience that includes event notifications and the ability to audit usage.\n- Patch Manager uses `patch baselines`, which include rules for auto-approving patches within days of their release, in addition to a list of approved and rejected patches. \n- You can install patches on a regular basis by scheduling patching to run as a Systems Manager maintenance window task. You can also install patches individually or to large groups of managed nodes by using tags. (Tags are keys that help identify and sort your resources within your organization.) \n- You can add tags to your patch baselines themselves when you create or update them.\n\n\n\n\n## Monitoring\n\n### Sending SSM Agent logs to CloudWatch Logs\n\n[Sending SSM Agent logs to CloudWatch Logs](https://docs.aws.amazon.com/systems-manager/latest/userguide/monitoring-ssm-agent.html)\n\n- AWS Systems Manager Agent (SSM Agent) is Amazon software that runs on your EC2 instances and your hybrid instances (on-premises instances and virtual machines) that are configured for Systems Manager\n- SSM Agent processes requests from the Systems Manager service in the cloud and configures your machine as specified in the request\n\n\n## Application Management\n\n### AWS Systems Manager Parameter Store\n\n[AWS Systems Manager Parameter Store](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html)\n\n- Parameter Store, a capability of AWS Systems Manager, provides secure, hierarchical storage for configuration data management and secrets management\n- You can store data such as passwords, database strings, Amazon Machine Image (AMI) IDs, and license codes as parameter values\n- You can store values as plain text or encrypted data\n- Parameter Store is also integrated with Secrets Manager\n\n### Setting up AWS Systems Manager for hybrid environments\n\n[Setting up AWS Systems Manager for hybrid environments](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html)\n\nConfiguring your hybrid environment for Systems Manager allows you to do the following:\n- Create a consistent and secure way to remotely manage your hybrid workloads from one location using the same tools or scripts.\n- Centralize access control for actions that can be performed on your servers and VMs by using AWS Identity and Access Management (IAM).\n- Centralize auditing and your view into the actions performed on your servers and VMs by recording all actions in AWS CloudTrail.\n- Centralize monitoring by configuring Amazon EventBridge and Amazon Simple Notification Service (Amazon SNS) to send notifications about service execution success.\n\n\n#### Step 7: (Optional) Create Systems Manager service roles\n\n[Step 7: (Optional) Create Systems Manager service roles](https://docs.aws.amazon.com/systems-manager/latest/userguide/setup-service-role.html)\n\n- This topic explains the difference between a service role and a service-linked role for AWS Systems Manager. It also explains when you need to create or use either type of role.\n- Service role: \n - A service role is an AWS Identity and Access Management (IAM) that grants permissions to an AWS service so that the service can access AWS resources. \n - Only a few Systems Manager scenarios require a service role. \n - When you create a service role for Systems Manager, you choose the permissions to grant in order for it to access or interact with other AWS resources.\n- Service-linked role: \n - A service-linked role is predefined by Systems Manager and includes all the permissions that the service requires to call other AWS services on your behalf.\n\n\n### About SSM documents for patching managed nodes\n\n[About SSM documents for patching managed nodes](https://docs.aws.amazon.com/systems-manager/latest/userguide/patch-manager-ssm-documents.html)\n\nThe five recommended SSM documents include:\n- AWS-ConfigureWindowsUpdate\n- AWS-InstallWindowsUpdates\n- AWS-RunPatchBaseline\n- AWS-RunPatchBaselineAssociation\n- AWS-RunPatchBaselineWithHooks\n\n### About patching schedules using maintenance windows\n\n[About patching schedules using maintenance windows](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-patch-scheduletasks.html)\n\n- After you configure a patch baseline (and optionally a patch group), you can apply patches to your node by using a maintenance window. \n- A maintenance window can reduce the impact on server availability by letting you specify a time to perform the patching process that doesn't interrupt business operations.\n\n### AWS Systems Manager Automation\n\n[AWS Systems Manager Automation](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-automation.html)\n\n- Automation, a capability of AWS Systems Manager, simplifies common maintenance and deployment tasks of Amazon Elastic Compute Cloud (Amazon EC2) instances and other AWS resources.\n - Build automations to configure and manage instances and AWS resources.\n - Create custom runbooks or use pre-defined runbooks maintained by AWS.\n - Receive notifications about Automation tasks and runbooks by using Amazon EventBridge.\n - Monitor Automation progress and details by using the Systems Manager console.\n\n\n\n### Actions\n\n#### DeleteParameter\n\n- Delete a parameter from the system. After deleting a parameter, wait for at least 30 seconds to create a parameter with the same name.\n\n\n\n## Notes\n\n- The AWS Systems Manager Run Command is primarily used to remotely manage the configuration of your managed instances while AWS Systems Manager State Manager is just a configuration management service that automates the process of keeping your Amazon EC2 and hybrid infrastructure in a state that you define\n\n\n## Blogs\n\n- [Patching your Windows EC2 instances using AWS Systems Manager Patch Manager](https://aws.amazon.com/blogs/mt/patching-your-windows-ec2-instances-using-aws-systems-manager-patch-manager)\n - For example, you can create patch groups for different environments/tagged instances such as development, test, and production\n - you can install patches on a regular basis by scheduling patching to run as a Maintenance Windows task\n - A patch baseline defines which patches should and shouldn’t be installed on your instances. \n - You can individually specify approved or rejected patches, or you can use auto-approval rules to specify that certain types of updates (for example, critical updates), should automatically be approved for patching.\n - AWS Systems Manager Maintenance Windows let you define a schedule for when to perform potentially disruptive actions on your instances such as patching an operating system (OS), updating drivers, or installing software. \n - Each Maintenance Window has a schedule, a duration, a set of registered targets, and a set of registered tasks. " }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/transcribe.md", "content": "# Transcribe\n\n[Cheat Sheet - Transcribe](https://tutorialsdojo.com/amazon-transcribe)\n\n- Amazon Transcribe is an AWS service that makes it easy for customers to convert speech-to-text. \n\n## How Amazon Transcribe works\n\n[How Amazon Transcribe works](https://docs.aws.amazon.com/transcribe/latest/dg/how-it-works.html)\n\n- Amazon Transcribe analyzes audio files that contain speech and uses advanced machine learning techniques to transcribe the voice data into text\n\n\n## Actions\n\n### StartTranscriptionJob\n\n[StartTranscriptionJob](https://docs.aws.amazon.com/transcribe/latest/dg/API_StartTranscriptionJob.html)\n\n- Starts an asynchronous job to transcribe speech to text.\n\n\n\n\n\n\n## FAQs\n\n[FAQs](https://aws.amazon.com/transcribe/faqs)" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/vpc.md", "content": "# VPC\n\n[Cheat Sheet - AWS VPC](https://tutorialsdojo.com/amazon-vpc)\n[Cheat Sheet - VPC Peering](https://tutorialsdojo.com/vpc-peering)\n[Cheat Sheet - AWS Transit Gateway](https://tutorialsdojo.com/aws-transit-gateway)\n\n\n\n\n## Network ACLs\n\n[Network ACLs](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-network-acls.html)\n\n- A network access control list (ACL) is an optional layer of security for your VPC that acts as a firewall for controlling traffic in and out of one or more subnets. \n- You might set up network ACLs with rules similar to your security groups in order to add an additional layer of security to your VPC.\n\n## VPC Networking Components\n\n## NAT gateways\n\n[NAT gateways](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html)\n\n- A NAT gateway is a Network Address Translation (NAT) service. \n- You can use a NAT gateway so that instances in a private subnet can connect to services outside your VPC but external services cannot initiate a connection with those instances.\n\n- When you create a NAT gateway, you specify one of the following connectivity types:\n - Public – (Default) Instances in private subnets can connect to the internet through a public NAT gateway, but cannot receive unsolicited inbound connections from the internet.\n - Private – Instances in private subnets can connect to other VPCs or your on-premises network through a private NAT gateway. \n - You can route traffic from the NAT gateway through a transit gateway or a virtual private gateway. \n - You cannot associate an elastic IP address with a private NAT gateway.\n \n\n### NAT instances\n\n[NAT instances](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_NAT_Instance.html)\n\n- You can create your own AMI that provides network address translation and use your AMI to launch an EC2 instance as a NAT instance. \n- You launch a NAT instance in a public subnet to enable instances in the private subnet to initiate outbound IPv4 traffic to the internet or other AWS services, but prevent the instances from receiving inbound traffic initiated on the internet.\n\n### NAT devices for your VPC\n\n[NAT devices for your VPC](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat.html)\n\n\n\n### Compare NAT gateways and NAT instances\n\n[Compare NAT gateways and NAT instances](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-comparison.html)\n\n\n\n## VPC peering\n\n[VPC peering](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-peering.html)\n\n- A VPC peering connection is a networking connection between two VPCs that enables you to route traffic between them privately. \n- Instances in either VPC can communicate with each other as if they are within the same network. \n- You can create a VPC peering connection between your own VPCs, with a VPC in another AWS account, or with a VPC in a different AWS Region.\n\n\n### Configurations with specific routes\n\n[Configurations with specific routes](https://docs.aws.amazon.com/vpc/latest/peering/peering-configurations-partial-access.html)\n\n[One VPC peered with two VPCs using longest prefix match](https://docs.aws.amazon.com/vpc/latest/peering/peering-configurations-partial-access.html#one-to-two-vpcs-lpm)\n\n\n## Route Tables\n\n### Example routing options\n\n[Example routing options](https://docs.aws.amazon.com/vpc/latest/userguide/route-table-options.html)\n\n\n\n\n\n## VPC Flow Logs\n\n[VPC Flow Logs](https://docs.aws.amazon.com/vpc/latest/userguide/flow-logs.html)\n\n- VPC Flow Logs is a feature that enables you to capture information about the IP traffic going to and from network interfaces in your VPC.\n- Flow log data can be published to Amazon CloudWatch Logs or Amazon S3.\n- After you create a flow log, you can retrieve and view its data in the chosen destination.\n\n- Flow logs can help you with a number of tasks, such as:\n - Diagnosing overly restrictive security group rules\n - Monitoring the traffic that is reaching your instance\n - Determining the direction of the traffic to and from the network interfaces\n\n## VPC Endpoints\n\n### Interface VPC endpoints (AWS PrivateLink)\n\n[Interface VPC endpoints (AWS PrivateLink)](https://docs.aws.amazon.com/vpc/latest/privatelink/vpce-interface.html)\n\n- An interface VPC endpoint (interface endpoint) allows you to connect to services powered by AWS PrivateLink\n- These services include some AWS services, services hosted by other AWS customers and Partners in their own VPCs (referred to as endpoint services), and supported AWS Marketplace Partner services. \n- The owner of the service is the service provider, and you, as the principal creating the interface endpoint, are the service consumer.\n\n[How do I configure security and network ACLs for my interface-based Amazon VPC endpoint for endpoint services?](https://aws.amazon.com/premiumsupport/knowledge-center/security-network-acl-vpc-endpoint)\n\n> When you create an Amazon VPC endpoint interface with AWS PrivateLink, an Elastic Network Interface is created inside of the subnet that you specify. This interface VPC endpoint (interface endpoint) inherits the network ACL of the associated subnet. You must associate a security group with the interface endpoint to protect incoming and outgoing requests.\n\n## DNS support for your VPC\n\n[DNS attributes in your VPC](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-dns.html#vpc-dns-support)\n\nDNS attributes in your VPC\n\n- enableDnsHostnames\t\n- enableDnsSupport\n\n> IF both attributes are enabled, an instance launched into the VPC receives a public DNS hostname IF it is assigned a public IPv4 address or an Elastic IP address at creation.\n\n## DHCP options sets for your VPC\n\n[DHCP options sets for your VPC](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_DHCP_Options.html)\n\n- The Dynamic Host Configuration Protocol (DHCP) provides a standard for passing configuration information to hosts on a TCP/IP network. \n- The options field of a DHCP message contains configuration parameters, including the domain name, domain name server, and the netbios-node-type.\n- When you create a VPC, we automatically create a set of DHCP options and associate them with the VPC. You can configure your own DHCP options set for your VPC.\n\n\n### Work with shared VPCs\n\n[Blog - VPC sharing: A new approach to multiple accounts and VPC management](https://aws.amazon.com/blogs/networking-and-content-delivery/vpc-sharing-a-new-approach-to-multiple-accounts-and-vpc-management)\n\n[Work with shared VPCs](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-sharing.html)\n\n- VPC sharing allows multiple AWS accounts to create their application resources, such as Amazon EC2 instances, Amazon Relational Database Service (RDS) databases, Amazon Redshift clusters, and AWS Lambda functions, into shared, centrally-managed virtual private clouds (VPCs)\n- In this model, the account that owns the VPC (owner) shares one or more subnets with other accounts (participants) that belong to the same organization from AWS Organizations\n- After a subnet is shared, the participants can view, create, modify, and delete their application resources in the subnets shared with them. \n- Participants cannot view, modify, or delete resources that belong to other participants or the VPC owner.\n\n\n[VPC Flow Logs](https://docs.aws.amazon.com/vpc/latest/userguide/flow-logs.html)\n\nVPC Flow Logs is a feature that enables you to capture information about the IP traffic going to and from network interfaces in your VPC. Flow log data can be published to Amazon CloudWatch Logs or Amazon S3. \n\n\n### Internetwork traffic privacy in Amazon VPC\n\n[Internetwork traffic privacy in Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Security.html)\n\n- Security groups: Security groups act as a firewall for associated Amazon EC2 instances, controlling both inbound and outbound traffic at the instance level.\n- Network access control lists (ACLs): Network ACLs act as a firewall for associated subnets, controlling both inbound and outbound traffic at the subnet level.\n- Flow logs: Flow logs capture information about the IP traffic going to and from network interfaces in your VPC.\n- Traffic mirroring: You can copy network traffic from an elastic network interface of an Amazon EC2 instance.\n\n\n## Blogs\n\n- [How to set up an outbound VPC proxy with domain whitelisting and content filtering](https://aws.amazon.com/blogs/security/how-to-set-up-an-outbound-vpc-proxy-with-domain-whitelisting-and-content-filtering)\n\n- [How to set up an outbound VPC proxy with domain whitelisting and content filtering](https://aws.amazon.com/blogs/security/how-to-set-up-an-outbound-vpc-proxy-with-domain-whitelisting-and-content-filtering)\n\n - Controlling outbound communication from your Amazon Virtual Private Cloud (Amazon VPC) to the internet is an important part of your overall preventive security controls. \n - By limiting outbound traffic to certain trusted domains (called “whitelisting”) you help prevent instances from downloading malware, communicating with bot networks, or attacking internet hosts." }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/waf.md", "content": "# WAF\n\n[AWS WAF](https://aws.amazon.com/waf/)\n\n[Cheat Sheet - AWS WAF](https://tutorialsdojo.com/aws-waf)\n\n- AWS WAF is a web application firewall that helps protect your web applications or APIs against common web exploits and bots that may affect availability, compromise security, or consume excessive resources.\n- AWS WAF gives you control over how traffic reaches your applications by enabling you to create security rules that control bot traffic and block common attack patterns, such as SQL injection or cross-site scripting.\n- You can also customize rules that filter out specific traffic patterns.\n\n## What are AWS WAF, AWS Shield, and AWS Firewall Manager?\n\n[What are AWS WAF, AWS Shield, and AWS Firewall Manager?](https://docs.aws.amazon.com/waf/latest/developerguide/what-is-aws-waf.html)\n\n- AWS WAF is a web application firewall that lets you monitor the HTTP and HTTPS requests that are forwarded to an Amazon CloudFront distribution, an Amazon API Gateway REST API, an Application Load Balancer, or an AWS AppSync GraphQL API.\n- AWS WAF also lets you control access to your content. Based on conditions that you specify, such as the IP addresses that requests originate from or the values of query strings, Amazon CloudFront, Amazon API Gateway, Application Load Balancer, or AWS AppSync responds to requests either with the requested content or with an HTTP 403 status code (Forbidden).\n\n\n\n\n[White paper - aws-waf-owasp](https://d0.awsstatic.com/whitepapers/Security/aws-waf-owasp.pdf)\n\n[Prepare for the OWASP Top 10 Web Application Vulnerabilities Using AWS WAF](https://aws.amazon.com/blogs/aws/prepare-for-the-owasp-top-10-web-application-vulnerabilities-using-aws-waf-and-our-new-white-paper/)" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/webIdentifyFederation.md", "content": "# Web Identify Federation\n\n[web identity federation](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_oidc.html)\n\n- Imagine that you are creating a mobile app that accesses AWS resources, such as a game that runs on a mobile device and stores player and score information using Amazon S3 and DynamoDB.\n- build your app so that it requests temporary AWS security credentials dynamically when needed using web identity federation. The supplied temporary credentials map to an AWS role that has only the permissions needed to perform the tasks required by the mobile app.\n- With web identity federation, you don't need to create custom sign-in code or manage your own user identities. Instead, users of your app can sign in using a well-known external identity provider (IdP), such as Login with Amazon, Facebook, Google, or any other OpenID Connect (OIDC)-compatible IdP. They can receive an authentication token, and then exchange that token for temporary security credentials in AWS that map to an IAM role with permissions to use the resources in your AWS account" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/wellArchitected.md", "content": "# Well-Architected\n\n## Plan for Disaster Recovery (DR)\n\n[Cheat Sheet - backup-and-restore-vs-pilot-light-vs-warm-standby-vs-multi-site](https://tutorialsdojo.com/backup-and-restore-vs-pilot-light-vs-warm-standby-vs-multi-site)\n\n[Plan for Disaster Recovery (DR)](https://docs.aws.amazon.com/wellarchitected/latest/reliability-pillar/plan-for-disaster-recovery-dr.html)\n\n- Having backups and redundant workload components in place is the start of your DR strategy. RTO and RPO are your objectives for restoration of your workload\n - Recovery Time Objective (RTO) is defined by the organization. RTO is the maximum acceptable delay between the interruption of service and restoration of service. This determines what is considered an acceptable time window when service is unavailable.\n - Recovery Point Objective (RPO) is defined by the organization. RPO is the maximum acceptable amount of time since the last data recovery point. This determines what is considered an acceptable loss of data between the last recovery point and the interruption of service.\n\nWhen architecting a multi-region disaster recovery strategy for your workload, you should choose one of the following multi-region strategies.\n- Backup and restore (RPO in hours, RTO in 24 hours or less): \n- Pilot light (RPO in minutes, RTO in hours)\n- Warm standby (RPO in seconds, RTO in minutes)\n- Multi-region (multi-site) active-active (RPO near zero, RTO potentially zero)\n" }, { "path": "home/cloud_certifications/aws/taskset_aws_cloud_certifications/task_001_aws_certified_solutions_architect_professional/whitepapers.md", "content": "# Whitepapers\n\n[Network-to-Amazon VPC connectivity options](https://docs.aws.amazon.com/whitepapers/latest/aws-vpc-connectivity-options/network-to-amazon-vpc-connectivity-options.html)\n\n[AWS Direct Connect + VPN](https://docs.aws.amazon.com/whitepapers/latest/aws-vpc-connectivity-options/aws-direct-connect-vpn.html)\n\n- With AWS Direct Connect + VPN, you can combine AWS Direct Connect dedicated network connections with the Amazon VPC VPN. AWS Direct Connect **public VIF** established a dedicated network connection between your network to public AWS resources, such as an Amazon virtual private gateway IPsec endpoint. The following figure illustrates this option.\n- You must use a public virtual interface for your AWS Direct Connect (DX) connection and not a private one\n\n\n- [Blue Green Deployments](https://d0.awsstatic.com/whitepapers/AWS_Blue_Green_Deployments.pdf)\n- [Clone a Stack in AWS OpsWorks and Update DNS](https://docs.aws.amazon.com/whitepapers/latest/blue-green-deployments/clone-a-stack-in-aws-opsworks-and-update-dns.html)\n - AWS OpsWorks utilizes the concept of stacks, which are logical groupings of AWS resources (EC2 instances, Amazon RDS, Elastic Load Balancing, and so on) that have a common purpose and should be logically managed together\n- [Building a Scalable and Secure Multi-VPC AWS Network Infrastructure](https://d1.awsstatic.com/whitepapers/building-a-scalable-and-secure-multi-vpc-aws-network-infrastructure.pdf)\n\n- [Centralized egress to internet](https://docs.aws.amazon.com/whitepapers/latest/building-scalable-secure-multi-vpc-network-infrastructure/centralized-egress-to-internet.html)\n\n - Deploying a NAT Gateway in every spoke VPC can become expensive because you pay an hourly charge for every NAT Gateway you deploy (see Amazon VPC pricing), so centralizing it could be a viable option. \n - To centralize, we create an egress VPC in the network services account and route all egress traffic from the spoke VPCs via a NAT Gateway sitting in this VPC leveraging Transit Gateway\n\n- [Transit Gateway](https://docs.aws.amazon.com/whitepapers/latest/building-scalable-secure-multi-vpc-network-infrastructure/transit-gateway.html)\n - AWS Transit Gateway provides a hub and spoke design for connecting VPCs and on-premises networks as a fully managed service without requiring you to provision virtual appliances like the Cisco CSRs.\n\n- [AWS Transit Gateway](https://docs.aws.amazon.com/whitepapers/latest/aws-vpc-connectivity-options/aws-transit-gateway.html)\n\n - AWS Transit Gateway is a highly available and scalable service to consolidate the AWS VPC routing configuration for a region with a hub-and- spoke architecture. \n - Each spoke VPC only needs to connect to the Transit Gateway to gain access to other connected VPCs. \n - Transit Gateway across different regions can peer with each other to enable VPC communications across regions. \n - With large number of VPCs, Transit Gateway provides simpler VPC-to-VPC communication management over VPC Peering\n\n- [Security Groups and Network Access Control Lists (Network ACLs) (BP5)](https://docs.aws.amazon.com/whitepapers/latest/aws-best-practices-ddos-resiliency/security-groups-and-network-access-control-lists-nacls-bp5.html)\n- [Using AWS for Disaster Recovery](https://aws.amazon.com/blogs/aws/new-whitepaper-use-aws-for-disaster-recovery)\n- [Overview of Deployment Options on AWS](https://docs.aws.amazon.com/whitepapers/latest/overview-deployment-options/aws-deployment-services.html)\n- [AWS Best Practices for DDoS Resiliency](https://docs.aws.amazon.com/whitepapers/latest/aws-best-practices-ddos-resiliency/welcome.html)\n\n" }, { "path": "home/cloud_providers/aws/ReadMe-static.md", "content": "# AWS Taskset\nReferences\n\n- [copy-data-from-an-s3-bucket-in-one-account-and-region-to-another-account-and-region](https://docs.aws.amazon.com/prescriptive-guidance/latest/patterns/copy-data-from-an-s3-bucket-in-one-account-and-region-to-another-account-and-region.html)\n" }, { "path": "home/cloud_providers/aws/ReadMe.md", "content": "# taskset_aws_cloud_providers\n\n> [Auto](https://github.com/codeaprendiz/learn_fullstack/blob/main/home/php/intermediate/taskset_intermediate_php/task_004_createGlobalMarkdownTable/generate-readme.php) generated ReadMe. Number of tasks: 9\n\n| Task | Description |\n|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| task_001 | [task_001_kms](taskset_aws_cloud_providers/task_001_kms) |\n| task_002 | [task_002_monitoring_msk](taskset_aws_cloud_providers/task_002_monitoring_msk) |\n| task_003 | [task_003_redirection_using_s3_cloudfront](taskset_aws_cloud_providers/task_003_redirection_using_s3_cloudfront) |\n| task_004 | [task_004_trigger_codebuild_PR_events__eventbridge__static_branc](taskset_aws_cloud_providers/task_004_trigger_codebuild_PR_events__eventbridge__static_branc) |\n| task_005 | [task_005_trigger_codebuild_PR_events__eventbridge__lambda__dynamic_branches](taskset_aws_cloud_providers/task_005_trigger_codebuild_PR_events__eventbridge__lambda__dynamic_branches) |\n| task_006 | [task_006_codebuild_codecommit_test_reports_gradle](taskset_aws_cloud_providers/task_006_codebuild_codecommit_test_reports_gradle) |\n| task_007 | [task_007_codebuild_codecommit_test_reports_mvn](taskset_aws_cloud_providers/task_007_codebuild_codecommit_test_reports_mvn) |\n| task_008 | [task_008_trigger_lambda_from_codecommit_using_event_bridge](taskset_aws_cloud_providers/task_008_trigger_lambda_from_codecommit_using_event_bridge) |\n| task_009 | [task_009_pass_vars_dynamically_from_codebuild_to_codepipeline](taskset_aws_cloud_providers/task_009_pass_vars_dynamically_from_codebuild_to_codepipeline) |\n" }, { "path": "home/cloud_providers/aws/taskset_aws_cloud_providers/task_001_kms/ReadMe.md", "content": "### Objective\n\nTo use the AWS KMS to encrypt and decrypt data using the aws kms\n\nInputs : \n1) You have already created a CUSTOMER MANAGER KEY using the AWS console with the alias\nname as `master`\n2) You have also created an IAM user with policy `AWSKeyManagementServicePowerUser`\n\n\nDocs and Links referred\n\n[aws kms generate-data-key](https://docs.aws.amazon.com/cli/latest/reference/kms/generate-data-key.html)\n\n[youtube](https://www.youtube.com/watch?v=f3APF1dP8w0&t=604s&ab_channel=EnlearAcademy)\n\n#### Step 1\n\nConfigure the AWS account using the right region and correct access keys\n\n```bash\n$ aws configure \nAWS Access Key ID [****************]: \nAWS Secret Access Key [****************]: \nDefault region name [ap-south-1]: \nDefault output format [None]: \n```\n\n#### Step 2\n\nLet's list the aliases first to validate\n\n```bash\n$ aws kms list-aliases | grep master | grep -v \"arn\"\n \"AliasName\": \"alias/master\",\n```\n\n#### Step 3\n\nGenerate the symmetric keys using `generate-data-key` method. Note that these\nkeys are base64 encoded.\n\n```bash\n$ aws kms generate-data-key --key-id alias/master --key-spec AES_256 --region ap-south-1\n{\n \"CiphertextBlob\": \"your_key_in_cipher_text\",\n \"Plaintext\": \"your_key_in_plain_text\",\n \"KeyId\": \"your_key_aws_arn\"\n}\n```\n\n#### Step 4\n\nDecode you keys and save them in files\n\n```bash\n$ echo \"your_key_in_cipher_text\" | base64 --decode > ciphertextblob\n\n$ echo \"your_key_in_plain_text\" | base64 --decode > plaintext\n```\n\n#### Step 5\n\nLet's create a sensitive datafile\n\n```bash\n$ cat sensitivedatafile.txt \nThis is very sensitive data\nplease do not copy\ncopying the data is strictly prohibited\nokay you can copy the data.\n```\n\n#### Step 6\n\nEncrypt the sensitive data file\n\n```bash\n$ openssl enc -in ./sensitivedatafile.txt -out ./sensitivedatafile_encrypted.txt -e -aes256 -k ./plaintext\n```\n\n> NOTE: Delete your plaintext symmetric key now. We will only store the encrypted version of the plaintext key\n\n```bash\n$ mv plaintext ~/tmp/\n$ mv sensitivedatafile.txt /tmp/ \n```\n\nOkay, I moved it to `/tmp` just in case. But we need to remove! Very Important!\n\n#### Step 7\n\nNow the task is to decrypt the `sensitivedatafile_encrypted.txt` using the `ciphertextblob`.\nBoth of them are encrypted files.\n\nSo first we will get the plaintext version of our datakey using the aws cli\n\n```bash\n$ aws kms decrypt --ciphertext-blob fileb://ciphertextblob --region ap-south-1\n{\n \"KeyId\": \"aws_arn\",\n \"Plaintext\": \"your_plaintext_key\",\n \"EncryptionAlgorithm\": \"SYMMETRIC_DEFAULT\"\n}\n```\n\nDecode the key\n\n```bash\n$ echo \"your_plaintext_key\" | base64 --decode > plaintext\n```\n\n#### Step 8\n \nFinally decrypt the `sensitivedatafile_encrypted.txt` using the `plaintext` key you just obtained.\nWe will use the openssl library for the same\n\n```bash\n$ openssl enc -in ./sensitivedatafile_encrypted.txt -out ./sensitivedatafile_final.txt -d -aes256 -k ./plaintext \n\n$ cat sensitivedatafile_final.txt\nThis is very sensitive data\nplease do not copy\ncopying the data is strictly prohibited\nokay you can copy the data.\n```" }, { "path": "home/cloud_providers/aws/taskset_aws_cloud_providers/task_002_monitoring_msk/ReadMe.md", "content": "### Monitoring AWS MSK\nYou cannot know what you cannot see.\n\nYou can enable monitoring while setting up MSK. Check out their official documentation \nwhich is more than enough\n\n[AWS Docs](https://docs.aws.amazon.com/msk/latest/developerguide/monitoring.html)\n\n[Official Docs](https://kafka.apache.org/documentation/#monitoring)\n\n[Confluent Docs](https://docs.confluent.io/platform/current/kafka/monitoring.html)\n\n[kafka-lag-monitoring-and-metrics-at-appsflyer](https://www.confluent.io/blog/kafka-lag-monitoring-and-metrics-at-appsflyer/)\n\n#### What metrics we need to monitor\n\n[metrics-details.html#default-metric](https://docs.aws.amazon.com/msk/latest/developerguide/metrics-details.html#default-metrics)\n\n- Number of active controllers : Should always be one\n\n- Number of UnderReplicatedPartions : Should always be zero\n\n- Number of Offline Partitions : Should always be zero\n\n\n\n#### Why does lag matter?\nWhy does lag matter and why does it need to be treated differently than other metrics in the system?\nLag is a key performance indicator (KPI) for Kafka. When building an event streaming platform, the consumer group lag is one of the crucial metrics to monitor.\nAs mentioned earlier, when an application consumes messages from Kafka, it commits its offset in order to keep its position in the partition. When a consumer gets stuck for any reason—for example, an error, rebalance, or even a complete stop—it can resume from the last committed offset and continue from the same point in time.\nTherefore, lag is the delta between the last committed message to the last produced message. In other words, lag indicates how far behind your application is in processing up-to-date information.\nTo make matters worse, remember that Kafka persistence is based on retention, meaning that if your lag persists, you will lose data at some point in time. The goal is to keep lag to a minimum.\n\n" }, { "path": "home/cloud_providers/aws/taskset_aws_cloud_providers/task_003_redirection_using_s3_cloudfront/ReadMe.md", "content": "### Redirect Apex domain to another domain's subdomain with browser change in URL\n\nRequirements\n\n- firstdomain.com should be redirected to https://sub.seconddomain.com\n- http://firstdomain.com should be redirected to https://sub.seconddomain.com\n- https://firstdomain.com should be redirected to https://sub.seconddomain.com\n\n\nDocuments Referred\n\n[https://aws.amazon.com/premiumsupport/knowledge-center/route-53-redirect-to-another-domain](https://aws.amazon.com/premiumsupport/knowledge-center/route-53-redirect-to-another-domain)\n\n[stackoverflow](https://stackoverflow.com/questions/10115799/set-up-dns-based-url-forwarding-in-amazon-route53/14289082#14289082)\n\n\n#### S3 configuraton\n\n- Name of the bucket : firstdomain.com\n- Enable the static website hosting and Redirect requests for an object and set the `Hostname` to `sub.seconddomain.com`. Protocol should be `https`\n- Keep a copy of the website endpoint `http://firstdomain.com.s3-website.ap-south-1.amazonaws.com`\n\n\n### CloudFront configuration\n\n- Create cloudfront distribution with alternamte domain name as `firstdomain.com`\n- You will need to create an ACM certificate in `us-east-1` for the CloudFront, ensure that the \n ACM certificate supports the domians `*.firstdomain.com`, `firstdomain.com`, `www.firstdomain.com`, `*.seconddomain.com`, `seconddomain.com`, `www.seconddomain.com`\n- Keep the origin domain as `firstdomain.com.s3-website.ap-south-1.amazonaws.com`, what noted in previous step without the `http`\n- Origin Protocol should be `http` as for S3-website configuration only supports http requests. So the http port will also be 80\n- Viewer, protocol policy `Redirect HTTP to HTTPS`\n- You can keep all the HTTP methods as allowed\n- Make a not of the distribution domain name `https://something.cloudfront.net`\n\n\n### Route53 configuration\n\n- Go to the hosted zone `firstdomain.com` \n- Create an `Alias A IPv4` record for `firstdomain.com` pointing to `something.cloudfront.net`\n\n\n### Validation\n\n- When there is `cache miss` from the cloudfront\n\n```bash\n$ curl -I http://something.cloudfront.net -L\nHTTP/1.1 301 Moved Permanently\nServer: CloudFront\nDate: Thu, 12 Aug 2021 12:12:04 GMT\nContent-Type: text/html\nContent-Length: 183\nConnection: keep-alive\nLocation: https://something.cloudfront.net/\nX-Cache: Redirect from cloudfront\nVia: 1.1 5dd0dcc9e0464f63fa9f8c3a40.cloudfront.net (CloudFront)\nX-Amz-Cf-Pop: DEL54-C4\nX-Amz-Cf-Id: 5kX-_t55pHGTMaZt046sbSyS9geMsw8RagPXNGdiqthnV9HEJc18Rw==\n\nHTTP/2 301\ncontent-length: 0\nlocation: https://sub.seconddomain.com/\ndate: Thu, 12 Aug 2021 12:12:05 GMT\nserver: AmazonS3\nx-cache: Miss from cloudfront\nvia: 1.1 5ef0432e6c0ac31f0b8bdb72d3755f66.cloudfront.net (CloudFront)\nx-amz-cf-pop: DEL54-C4\nx-amz-cf-id: nZGDaK7tSmo4hwC6jlT9fLV5rjNglbNajvLtj0y54vROJg18Qislrg==\n\nHTTP/1.1 404 Not Found\nContent-Length: 19\nContent-Type: text/plain; charset=utf-8\nDate: Thu, 12 Aug 2021 12:12:04 GMT\nX-Content-Type-Options: nosniff\nConnection: keep-alive\n```\n\n- When there is `hit` from the cloudfront\n\n```bash\n$ curl -I http://something.cloudfront.net -L\nHTTP/1.1 301 Moved Permanently\nServer: CloudFront\nDate: Fri, 13 Aug 2021 11:17:07 GMT\nContent-Type: text/html\nContent-Length: 183\nConnection: keep-alive\nLocation: https://something.cloudfront.net/\nX-Cache: Redirect from cloudfront\nVia: 1.1 637fcf134a6acd248c904995685d8a65.cloudfront.net (CloudFront)\nX-Amz-Cf-Pop: DEL54-C4\nX-Amz-Cf-Id: MZa1056r6UIWlshM0FzGsVoAMtdVtkW8-5JMSb2JxngFIkC2kdNT4g==\n\nHTTP/2 301\ncontent-length: 0\nlocation: https://sub.seconddomain.com/\ndate: Thu, 12 Aug 2021 12:12:05 GMT\nserver: AmazonS3\nx-cache: Hit from cloudfront\nvia: 1.1 d074672a93d4cecfc24649b988ca81dc.cloudfront.net (CloudFront)\nx-amz-cf-pop: DEL54-C4\nx-amz-cf-id: lQyKipnkYjneJ27p1ox3-bLEbnrrV49dOIMq8iXyZtP1Q402rPBKEw==\nage: 83103\n\nHTTP/1.1 404 Not Found\nContent-Length: 19\nContent-Type: text/plain; charset=utf-8\nDate: Fri, 13 Aug 2021 11:17:07 GMT\nX-Content-Type-Options: nosniff\nConnection: keep-alive\n```\n\n\n### Issues you might face\n\n- Note that the CNAME is added to the CDN and is supported by the ACM certificate\n- Sometimes its just the cloudfront, because it take sometime to reflect the values. You can invalidate the cloudfront cache \n by using `Cache invalidation` for `*/`\n" }, { "path": "home/cloud_providers/aws/taskset_aws_cloud_providers/task_004_trigger_codebuild_PR_events__eventbridge__static_branc/ReadMe.md", "content": "# Trigger Codebuild on PR events using EventBridge (the hardcoded branch get's triggered)\n\n- [Trigger Codebuild on PR events using EventBridge (the hardcoded branch get's triggered)](#trigger-codebuild-on-pr-events-using-eventbridge-the-hardcoded-branch-gets-triggered)\n - [Docs Referred](#docs-referred)\n - [Existing Issue](#existing-issue)\n - [Create a repository in AWS CodeCommit](#create-a-repository-in-aws-codecommit)\n - [Create a CodeBuild project - codebuild-app](#create-a-codebuild-project---codebuild-app)\n - [Create Pipeline in CodePipeline](#create-pipeline-in-codepipeline)\n - [Commit to the repository and check if build get's triggered](#commit-to-the-repository-and-check-if-build-gets-triggered)\n - [Create EventBridge Rule](#create-eventbridge-rule)\n - [Create a PR and check if build gets triggered](#create-a-pr-and-check-if-build-gets-triggered)\n\n## Docs Referred\n\n[Automated Code Review on Pull Requests using AWS CodeCommit and AWS CodeBuild](https://aws.amazon.com/blogs/devops/automated-code-review-on-pull-requests-using-aws-codecommit-and-aws-codebuild/)\n\n## Existing Issue\n\nThe codebuild always runs against the same branch which is hardcoded in the codebuild project. We want to trigger the codebuild on PR events with the source branch as the PR branch.\n\n## Create a repository in AWS CodeCommit\n\n```bash\nmkdir tmp # tmp is added to .gitignore\ncd tmp\n```\n\n```bash\n# Make sure you upload your public key to AWS IAM user security credentials section\ncat ~/.ssh/config \nHost git-codecommit.*.amazonaws.com\n User \n IdentityFile ~/.ssh/id_rsa\n```\n\n## Create a CodeBuild project - codebuild-app\n\nRole Created automatically - `codebuild-app-codebuild-service-Role`\n\n## Create Pipeline in CodePipeline\n\nNew Role created `AWSCodePipelineServiceRole-xx-region-y-app-pipeline`\n\n## Commit to the repository and check if build get's triggered\n\n## Create EventBridge Rule\n\nRole created `Amazon_EventBridge_Invoke_CodeBuild_5492177`\n\nCreate a rule in default event bus\n\n## Create a PR and check if build gets triggered\n\n```bash\ngco -b \"feat_pr_3\"\necho \"test\" >> ReadMe.md\n```\n\n> Note: The submitted is rule/pr_event_rule but the branch name is `ref/heads/master`\n" }, { "path": "home/cloud_providers/aws/taskset_aws_cloud_providers/task_005_trigger_codebuild_PR_events__eventbridge__lambda__dynamic_branches/ReadMe.md", "content": "# Trigger codebuild PR events using EventBridge (Lambda, Dynamic Branches)\n\n- [Trigger codebuild PR events using EventBridge (Lambda, Dynamic Branches)](#trigger-codebuild-pr-events-using-eventbridge-lambda-dynamic-branches)\n - [Objective](#objective)\n - [Reasearch Links and docs with relevant information](#reasearch-links-and-docs-with-relevant-information)\n - [Create repo-a in Codecommit](#create-repo-a-in-codecommit)\n - [Create repo-b in Codecommit](#create-repo-b-in-codecommit)\n - [Create a codebuild project for repo-a - codebuild-repo-a](#create-a-codebuild-project-for-repo-a---codebuild-repo-a)\n - [Create a codebuild project for repo-b - codebuild-repo-b](#create-a-codebuild-project-for-repo-b---codebuild-repo-b)\n - [Create codepipeline for repo-a - codepipeline-repo-a](#create-codepipeline-for-repo-a---codepipeline-repo-a)\n - [Create codepipeline for repo-b - codepipeline-repo-b](#create-codepipeline-for-repo-b---codepipeline-repo-b)\n - [Create a lambda function to trigger respetive codebuilds](#create-a-lambda-function-to-trigger-respetive-codebuilds)\n - [Create a rule for repo-a in EventBridge to trigger the lambda function](#create-a-rule-for-repo-a-in-eventbridge-to-trigger-the-lambda-function)\n - [Create PR for repo-a](#create-pr-for-repo-a)\n - [Check logs for lambda in cloudwatch when PR is created](#check-logs-for-lambda-in-cloudwatch-when-pr-is-created)\n - [Logs in codebuild-repo-a](#logs-in-codebuild-repo-a)\n - [Create a rule for repo-b in EventBridge to trigger the lambda function](#create-a-rule-for-repo-b-in-eventbridge-to-trigger-the-lambda-function)\n - [Create PR for repo-b](#create-pr-for-repo-b)\n\n## Objective\n\n- The PR in codebuild get's raised always with the branch hardcoded in build project.\n- We want to trigger codebuild with PR branches which requires involvement of lambda function.\n\n## Reasearch Links and docs with relevant information\n\n[aws . codebuild . start-build](https://docs.aws.amazon.com/cli/latest/reference/codebuild/start-build.html)\n\nYou can start codebuild using commands dynamically. You can use the same command in lambda function to trigger the codebuild project.\n\n[docs.aws.amazon.com » Monitoring CodeCommit events in Amazon EventBridge and Amazon CloudWatch Events](https://docs.aws.amazon.com/codecommit/latest/userguide/monitoring-events.html#pullRequestStatusChanged)\n\nYou can get the payload from the event and use it in the lambda function for testing.\n\n[stackoverflow.com » Creating Lambda Function to Trigger Codebuild Project using Nodejs](https://stackoverflow.com/questions/56568921/creating-lambda-function-to-trigger-codebuild-project-using-nodejs)\n\nTrigger lambda using nodejs\n\n[docs.aws.amazon.com » Environment variables in build environments](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html)\n\nYou can use environment variables in the buildspec.yaml file to get the source branch and use it in the buildspec.yaml file\n\n## Create repo-a in Codecommit\n\n## Create repo-b in Codecommit\n\n## Create a codebuild project for repo-a - codebuild-repo-a\n\n## Create a codebuild project for repo-b - codebuild-repo-b\n\n## Create codepipeline for repo-a - codepipeline-repo-a\n\n## Create codepipeline for repo-b - codepipeline-repo-b\n\n## Create a lambda function to trigger respetive codebuilds\n\nCopy the code `lambda.py` to the lambda function\n\nClick on deploy to deploy the lambda function (your code get updated in the function)\n\nClick on Test and it should ask you to create a sample event using which we can test the lambda function\n\nGet the event from [docs.aws.amazon.com » Monitoring CodeCommit events in Amazon EventBridge and Amazon CloudWatch Events](https://docs.aws.amazon.com/codecommit/latest/userguide/monitoring-events.html#pullRequestStatusChanged) and paste it in the event\n\nClick on Test\n\nYou will get error\n\nAdd the permissions w.r.t to lambda_service_role (`codebuild-dynamic-communicator-role-py375219`) to trigger the codebuild project\n\n```json\n\t\t{\n \"Effect\": \"Allow\",\n \"Action\": \"codebuild:StartBuild\",\n \"Resource\": \"arn:aws:codebuild:xx-region-y:xxxxxxxxxxxxxx:project/*\"\n }\n```\n\n## Create a rule for repo-a in EventBridge to trigger the lambda function\n\nSelect default event bus and create rule\n\nGive the arn of codecommit repo-a as source with events as PR_STATUS_CHANGE\n\nSelect the target as lambda function\n\nCreate rule\n\n## Create PR for repo-a\n\nAdd a `buildspec.yaml` file in repo-a to know the latest commit changes and update the codebuild-project-a\n\n```bash\n$ gst\nOn branch feat_pr_from_repo_a\nChanges not staged for commit:\n deleted: repo_a__commit_4\nUntracked files:\n repo_a__commit_5\n```\n\nCreate the pull request\n\n### Check logs for lambda in cloudwatch when PR is created\n\n### Logs in codebuild-repo-a\n\nAdd commits to PR\n\n```bash\n$ gst\nOn branch feat_pr_from_repo_a\nChanges not staged for commit:\n deleted: repo_a__commit_5\n\nUntracked files:\n repo_a__commit_6\n\n# Push the changes as new commit\n```\n\nSee the build is triggered against PR branch\n\nLatest commit information is available in build logs\n\n```bash\n[Container] 2024/04/27 04:19:26.605628 Running command ls -ltrh\ntotal 4.0K\n-rw-r--r-- 1 root root 0 Apr 27 04:19 repo_a__commit_6\n-rw-r--r-- 1 root root 273 Apr 27 04:19 buildspec.yaml\n```\n\n> Note: The branch name is refs/heads/feat_pr_from_repo_a\n\n## Create a rule for repo-b in EventBridge to trigger the lambda function\n\n## Create PR for repo-b\n\n```bash\n$ git branch --show-current\nfeat_pr_from_repo_b_branch1\n\n$ gst \nOn branch feat_pr_from_repo_b_branch1\nChanges not staged for commit:\n deleted: repo_a__test5\nUntracked files:\n repo_a__test6\n# commit the changes\n```\n\nLogs of codebuild-repo-b\n\n```bash\n[Container] 2024/04/27 04:38:28.453263 Running command ls -ltrh\ntotal 4.0K\n-rw-r--r-- 1 root root 0 Apr 27 04:38 repo_a__test6\n-rw-r--r-- 1 root root 273 Apr 27 04:38 buildspec.yaml\n```\n\n> Note: The branch name is refs/heads/feat_pr_from_repo_b_branch1 and has latest commit\n" }, { "path": "home/cloud_providers/aws/taskset_aws_cloud_providers/task_005_trigger_codebuild_PR_events__eventbridge__lambda__dynamic_branches/buildspec.yaml", "content": "version: 0.2\n\nphases:\n install:\n commands:\n - echo \"Installing dependencies\"\n\n pre_build:\n commands:\n - echo \"Pre-build step\"\n\n build:\n commands:\n - echo \"Build phase\"\n - ls -ltrh\n\n post_build:\n commands:\n - echo \"Post-build step\"\n\n" }, { "path": "home/cloud_providers/aws/taskset_aws_cloud_providers/task_005_trigger_codebuild_PR_events__eventbridge__lambda__dynamic_branches/lambda.py", "content": "import json\nimport boto3\n\ndef lambda_handler(event, context):\n # Initialize the CodeBuild client\n codebuild = boto3.client('codebuild')\n\n # Print the raw event data\n print(\"Raw Event Data: for repob : 1\")\n print(json.dumps(event))\n\n detail = event.get(\"detail\", {})\n repository_names = detail.get(\"repositoryNames\", [])\n source_version = detail.get(\"sourceReference\", \"\")\n if source_version and repository_names:\n try:\n # If codecommit reponame is repo-a then codebuild project name will be codebuild-repo-a\n project_name = \"codebuild-\" + repository_names[0]\n print(f\"Project Name: {project_name}\")\n # Trigger the build\n response = codebuild.start_build(\n projectName=project_name,\n sourceVersion=source_version\n )\n print(\"CodeBuild Triggered Successfully\")\n print(response)\n except Exception as e:\n print(\"Failed to trigger CodeBuild\")\n print(str(e))\n else:\n print(\"No source version or project name provided, cannot trigger CodeBuild.\")\n\n # Return a successful response\n return {\n \"statusCode\": 200,\n \"body\": json.dumps(\"Event processed successfully\")\n }\n" }, { "path": "home/cloud_providers/aws/taskset_aws_cloud_providers/task_006_codebuild_codecommit_test_reports_gradle/ReadMe-static.md", "content": "# Building an Application with Spring Boot with Gradle Groovy, Unit Tests, and Reports\n\n- [Building an Application with Spring Boot with Gradle Groovy, Unit Tests, and Reports](#building-an-application-with-spring-boot-with-gradle-groovy-unit-tests-and-reports)\n - [Run the application](#run-the-application)\n - [Run Unit Tests](#run-unit-tests)\n - [Show reports directory](#show-reports-directory)\n\nFor more info about the project check in folder `learn_java/task_006` in repo `learn_fullstack`.\n\n> If you are getting import package errors then you can try opening only specific task in VS Code by running `code .` in the terminal. Every task is a separate project and has its own dependencies.\n\n```bash\n$ java --version\nopenjdk 21.0.2 2024-01-16\nOpenJDK Runtime Environment Homebrew (build 21.0.2)\nOpenJDK 64-Bit Server VM Homebrew (build 21.0.2, mixed mode, sharing)\n```\n\n## Run the application\n\n```bash\n# Install the dependencies using gradle kotlin\n./gradlew build\n# Run the application\n./gradlew bootRun\n```\n\nOutput\n\n```bash\n...\nwelcomePageNotAcceptableHandlerMapping\n<==========---> 80% EXECUTING [6m 2s]\n> :bootRun\n```\n\nValidate the application is running\n\n```bash\ncurl http://localhost:8080\n```\n\nOutput\n\n```bash\nGreetings from Spring Boot!\n```\n\n## Run Unit Tests\n\nRun the tests\n\n```bash\n# Run the tests\n./gradlew test\n# In a typical development workflow with Gradle, if the source code or tests have not been modified since the last build, Gradle will consider the tasks up-to-date and will not rerun them\n# To force Gradle to rerun the tests, you can use the --rerun-tasks option\n./gradlew test --rerun-tasks\n```\n\nOutput\n\n```bash\nBUILD SUCCESSFUL in 567ms\n4 actionable tasks: 4 up-to-date\n```\n\n## Show reports directory\n\n```bash\n./gradlew showDirs\n```\n\n```bash\n$ ./gradlew showDirs\n\n\n> Task :showDirs\nReports directory: .../learn_java/taskset/task_006_building_an_application_with_spring_boot__gradle_groovy__unit_tests__reports/build/reports\nTest results directory: .../learn_java/taskset/task_006_building_an_application_with_spring_boot__gradle_groovy__unit_tests__reports/build/test-results\n\nBUILD SUCCESSFUL in 522ms\n1 actionable task: 1 executed\n```\n" }, { "path": "home/cloud_providers/aws/taskset_aws_cloud_providers/task_006_codebuild_codecommit_test_reports_gradle/ReadMe.md", "content": "# Codebuild Codecommit Gradle Project Unit Tests Reports\n\n- [Codebuild Codecommit Gradle Project Unit Tests Reports](#codebuild-codecommit-gradle-project-unit-tests-reports)\n - [Create a repository in CodeCommit : repo-d](#create-a-repository-in-codecommit--repo-d)\n - [Create a codebuild project : repo-d](#create-a-codebuild-project--repo-d)\n - [Go to the Report Groups section](#go-to-the-report-groups-section)\n\n[docs.aws.amazon.com » Create a test report](https://docs.aws.amazon.com/codebuild/latest/userguide/report-create.html)\n\n[Test Reports with AWS CodeBuild](https://aws.amazon.com/blogs/devops/test-reports-with-aws-codebuild)\n\n[docs.aws.amazon.com » Working with reports](https://docs.aws.amazon.com/codebuild/latest/userguide/test-report.html)\n\n[docs.aws.amazon.com » View test reports](https://docs.aws.amazon.com/codebuild/latest/userguide/test-view-reports.html)\n\n[docs.gradle.org » Test reporting](https://docs.gradle.org/current/userguide/java_testing.html#test_reporting)\n\n## Create a repository in CodeCommit : repo-d\n\n## Create a codebuild project : repo-d\n\nUse the `buildspec.yml` file in the root of the project. Make sure you give the right path to the test reports in the `buildspec.yml` file.\nThe files get generated in the project in directory `build/test-results`.\n\nTrigger build manually using `Start build` button.\n\n```yaml\nreports:\n GradleReports:\n files:\n - '**/*.xml'\n base-directory: 'build/test-results'\n```\n\n## Go to the Report Groups section\n\nYou should see `repo-d-GradleReports` group.\n\n[aws cli » list-report-groups](https://docs.aws.amazon.com/cli/latest/reference/codebuild/list-report-groups.html)\n[stackoverflow » turn off pager](https://stackoverflow.com/questions/60122188/how-to-turn-off-the-pager-for-aws-cli-return-value)\n\n```bash\nAWS_PAGER=\"\" aws codebuild list-report-groups \n```\n\nGet the reports\n\n```bash\nAWS_PAGER=\"\" aws codebuild list-reports-for-report-group --report-group-arn <>\n```\n" }, { "path": "home/cloud_providers/aws/taskset_aws_cloud_providers/task_006_codebuild_codecommit_test_reports_gradle/buildspec.yaml", "content": "version: 0.2\n\nphases:\n install:\n runtime-versions:\n java: corretto21 # Assuming corretto21 is available, replace with the specific version available in AWS CodeBuild\n commands:\n - echo \"Checking Java version...\"\n - java -version\n - echo \"Checking Gradle version...\"\n - gradle -v\n\n pre_build:\n commands:\n - echo \"Preparing build...\"\n - echo \"Setting up JAVA_HOME...\"\n - export JAVA_HOME=$(dirname $(dirname $(readlink -f $(which javac))))\n - echo $JAVA_HOME\n\n build:\n commands:\n - echo \"Build started on `date`\"\n - echo \"Running Gradle tasks...\"\n - gradle clean build\n - gradle test\n\n post_build:\n commands:\n - echo \"Build and test steps completed\"\n\n\nreports:\n GradleReports:\n files:\n - '**/*.xml'\n base-directory: 'build/test-results'" }, { "path": "home/cloud_providers/aws/taskset_aws_cloud_providers/task_007_codebuild_codecommit_test_reports_mvn/ReadMe.md", "content": "# AWS Codebuild Test Reports\n\n- [AWS Codebuild Test Reports](#aws-codebuild-test-reports)\n - [Docs](#docs)\n - [Create a repository in CodeCommit : repo-d](#create-a-repository-in-codecommit--repo-d)\n - [Create a codebuild project : repo-d](#create-a-codebuild-project--repo-d)\n - [Go to the Report Groups section](#go-to-the-report-groups-section)\n\n## Docs\n\n[stackoverflow.com » Viewing Unit Test and Coverage Reports Generated in AWS CodeBuild](https://stackoverflow.com/questions/49664524/viewing-unit-test-and-coverage-reports-generated-in-aws-codebuild)\n\n[docs.aws.amazon.com » View test reports](https://docs.aws.amazon.com/codebuild/latest/userguide/test-view-reports.html)\n\n[docs.aws.amazon.com » Working with reports](https://docs.aws.amazon.com/codebuild/latest/userguide/test-report.html)\n\n[aws.amazon.com » Test Reports with AWS CodeBuild](https://aws.amazon.com/blogs/devops/test-reports-with-aws-codebuild/)\n\n## Create a repository in CodeCommit : repo-d\n\n## Create a codebuild project : repo-d\n\nUse the `buildspec.yml` file in the root of the project. Make sure you give the right path to the test reports in the `buildspec.yml` file.\nThe files get generated in the project in directory `target/surefire-reports`.\n\n```yaml\nreports: #New\n SurefireReports: # CodeBuild will create a report group called \"SurefireReports\".\n files: #Store all of the files\n - '**/*'\n base-directory: 'target/surefire-reports' # Location of the report\n```\n\nTrigger build manually using `Start build` button.\n\n## Go to the Report Groups section\n\nYou should see `repo-d-SurefireReports` group.\n\n[aws cli » list-report-groups](https://docs.aws.amazon.com/cli/latest/reference/codebuild/list-report-groups.html)\n\n[stackoverflow » turn off pager](https://stackoverflow.com/questions/60122188/how-to-turn-off-the-pager-for-aws-cli-return-value)\n\n```bash\nAWS_PAGER=\"\" aws codebuild list-report-groups \n```\n\nGet the reports\n\n```bash\nAWS_PAGER=\"\" aws codebuild list-reports-for-report-group --report-group-arn <>\n```\n" }, { "path": "home/cloud_providers/aws/taskset_aws_cloud_providers/task_007_codebuild_codecommit_test_reports_mvn/buildspec.yaml", "content": "version: 0.2\n\nphases:\n install:\n runtime-versions:\n java: corretto21 # Assuming corretto21 is available, replace with the specific version available in AWS CodeBuild\n commands:\n - echo \"Checking Java version...\"\n - java -version\n - echo \"Checking mvn version...\"\n - mvn -v\n build:\n commands:\n - java -version\n - echo Build started on `date`\n - mvn surefire-report:report #Running this task to execute unit tests and generate report.\nreports: #New\n SurefireReports: # CodeBuild will create a report group called \"SurefireReports\".\n files: #Store all of the files\n - '**/*'\n base-directory: 'target/surefire-reports' # Location of the report" }, { "path": "home/cloud_providers/aws/taskset_aws_cloud_providers/task_008_trigger_lambda_from_codecommit_using_event_bridge/ReadMe.md", "content": "# Trigger Lambda from Codecommit\n\n[https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-notify-lambda-cc.html](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-notify-lambda-cc.html)" }, { "path": "home/cloud_providers/aws/taskset_aws_cloud_providers/task_009_pass_vars_dynamically_from_codebuild_to_codepipeline/ReadMe.md", "content": "# Pass variables dynamically from CodePipeline to CodeBuild\n\n[https://docs.aws.amazon.com/codepipeline/latest/userguide/tutorials-pipeline-variables.html](https://docs.aws.amazon.com/codepipeline/latest/userguide/tutorials-pipeline-variables.html)\n\n```bash\naws codepipeline start-pipeline-execution --name MyVariablesPipeline --variables name=timeout,value=2000\n```\n" }, { "path": "home/cloud_providers/azure/ReadMe.md", "content": "# taskset_azure_cloud_providers\n\n> [Auto](https://github.com/codeaprendiz/learn_fullstack/blob/main/home/php/intermediate/taskset_intermediate_php/task_004_createGlobalMarkdownTable/generate-readme.php) generated ReadMe. Number of tasks: 11\n\n| Task | Description |\n|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| task_001 | [task_001_capture_web_app_logs_with_app_service_diagnostics_logging](taskset_azure_cloud_providers/task_001_capture_web_app_logs_with_app_service_diagnostics_logging) |\n| task_002 | [task_002_devbox](taskset_azure_cloud_providers/task_002_devbox) |\n| task_003 | [task_003_create_a_windows_virtual_machine](taskset_azure_cloud_providers/task_003_create_a_windows_virtual_machine) |\n| task_004 | [task_004_connect_to_windows_virtual_machine_via_rdp](taskset_azure_cloud_providers/task_004_connect_to_windows_virtual_machine_via_rdp) |\n| task_005 | [task_005_create_a_generalized_image](taskset_azure_cloud_providers/task_005_create_a_generalized_image) |\n| task_006 | [task_006_create_a_new_virtual_machine_from_a_managed_image](taskset_azure_cloud_providers/task_006_create_a_new_virtual_machine_from_a_managed_image) |\n| task_007 | [task_007_create_an_image_of_azure_vm_from_az_cli_and_provision_a_new_vm](taskset_azure_cloud_providers/task_007_create_an_image_of_azure_vm_from_az_cli_and_provision_a_new_vm) |\n| task_008 | [task_008_create_an_azure_virtual_machine](taskset_azure_cloud_providers/task_008_create_an_azure_virtual_machine) |\n| task_009 | [task_009_configure_network_access](taskset_azure_cloud_providers/task_009_configure_network_access) |\n| task_010 | [task_010_create_a_storage_blob](taskset_azure_cloud_providers/task_010_create_a_storage_blob) |\n| task_011 | [task_011_deploy_a_container_app](taskset_azure_cloud_providers/task_011_deploy_a_container_app) |\n" }, { "path": "home/cloud_providers/azure/taskset_azure_cloud_providers/task_001_capture_web_app_logs_with_app_service_diagnostics_logging/ReadMe.md", "content": "# Capture Web Application Logs with App Service Diagnostics Logging\n\n- [Capture Web Application Logs with App Service Diagnostics Logging](#capture-web-application-logs-with-app-service-diagnostics-logging)\n - [Learning objectives](#learning-objectives)\n - [Exercise - Enable and configure App Service application logging using the Azure portal](#exercise---enable-and-configure-app-service-application-logging-using-the-azure-portal)\n - [Use Azure CLI to deploy the webapp](#use-azure-cli-to-deploy-the-webapp)\n - [View live application logging with the log streaming service](#view-live-application-logging-with-the-log-streaming-service)\n - [View live application logging with the log streaming service using Azure CLI](#view-live-application-logging-with-the-log-streaming-service-using-azure-cli)\n - [Retrieve application log files](#retrieve-application-log-files)\n - [Exercise - Retrieve Application Log Files using Azure CLI and Kudu](#exercise---retrieve-application-log-files-using-azure-cli-and-kudu)\n\n[learn.microsoft.com » Capture Web Application Logs with App Service Diagnostics Logging](https://learn.microsoft.com/en-us/training/modules/capture-application-logs-app-service/)\n\n## Learning objectives\n\n- Enable app logging on an Azure Web App.\n- View live app logging activity with the log streaming service.\n- Retrieve app log files from an app with Kudu or the Azure CLI.\n\n### [Exercise - Enable and configure App Service application logging using the Azure portal](https://learn.microsoft.com/en-us/training/modules/capture-application-logs-app-service/3-enable-and-configure-app-service-application-logging-using-the-azure-portal)\n\n#### Use Azure CLI to deploy the webapp\n\nSet the variables\n\n```bash\ngitRepo=https://github.com/MicrosoftDocs/mslearn-capture-application-logs-app-service\nappName=\"contosofashions$RANDOM\"\nappPlan=\"contosofashionsAppPlan\"\nresourceGroup=learn-73039af5-5f45-4665-837f-e4523655e6cd\nstorageAccount=sa$appName\nappLocation=southeastasia\n```\n\nDeploy the webapp\n\n```bash\naz appservice plan create --name $appPlan --resource-group $resourceGroup --location $appLocation --sku FREE\naz webapp create --name $appName --resource-group $resourceGroup --plan $appPlan --deployment-source-url $gitRepo\n```\n\nCreate Storage Account\n\n```bash\naz storage account create -n $storageAccount -g $resourceGroup -l $appLocation --sku Standard_LRS\n```\n\n#### View live application logging with the log streaming service\n\nTo open the log stream, run the following command.\n\n```bash\naz webapp log tail --name --resource-group \n```\n\nReset user-level credentials\n\n```bash\naz webapp deployment user set --user-name --password \n```\n\nAfter you have created a set of credentials, run the following command to open the log stream. You're then prompted for the password.\n\n```bash\n# curl -u {username} https://{sitename}.scm.azurewebsites.net/api/logstream\n```\n\n### [View live application logging with the log streaming service using Azure CLI](https://learn.microsoft.com/en-us/training/modules/capture-application-logs-app-service/5-view-live-application-logging-activity-with-the-log-streaming-service-using-azure-cli)\n\nUse Azure CLI to view the live log stream\n\n```bash\n# az webapp log tail --resource-group learn-73039af5-5f45-4665-837f-e4523655e6cd --name contosofashions\naz webapp log tail --resource-group learn-73039af5-5f45-4665-837f-e4523655e6cd --name contosofashions10908\n2023-12-06T08:34:47 Welcome, you are now connected to log-streaming service. The default timeout is 2 hours. Change the timeout with the App Setting SCM_LOGSTREAM_TIMEOUT (in seconds). \n2023-12-06T08:35:16 PID[8672] Error Error message, in the Page_Load method for About.aspx\n2023-12-06T08:35:34 PID[8672] Error Error message, in the Page_Load method for Default.aspx\n\n# expetect logs\n```\n\n### Retrieve application log files\n\n- To download file system log files using the Azure CLI,\n\n```bash\naz webapp log download --log-file \\<_filename_\\>.zip --resource-group \\<_resource group name_\\> --name \\<_app name_\\>\n```\n\n### [Exercise - Retrieve Application Log Files using Azure CLI and Kudu](https://learn.microsoft.com/en-us/training/modules/capture-application-logs-app-service/7-retrieve-application-log-files-from-an-application-using-azure-cli-and-kudu)\n\n- In Cloud Shell, to download the logs to contosofashions.zip in the cloud share storage,\n\n```bash\n# az webapp log download --log-file contosofashions.zip --resource-group learn-73039af5-5f45-4665-837f-e4523655e6cd --name contosofashions\naz webapp log download --log-file contosofashions.zip --resource-group learn-73039af5-5f45-4665-837f-e4523655e6cd --name contosofashions10908\n```\n\n- In Cloud Shell, to show the log files contained in the downloaded contosofashions.zip file, run the following command.\n\n```bash\nzipinfo -1 contosofashions.zip\n```\n\n- In Cloud Shell, to extract just the app log file from the downloaded contosofashions.zip file, run the following command.\n\n```bash\nunzip -j contosofashions.zip LogFiles/Application/*.txt\n```\n\n- In Cloud Shell, to display the application log file, run the following command.\n\n```bash\ncode *.txt\n```\n\n" }, { "path": "home/cloud_providers/azure/taskset_azure_cloud_providers/task_002_devbox/ReadMe.md", "content": "# Devbox\n\n- [Devbox](#devbox)\n - [What is Microsoft Dev Box?](#what-is-microsoft-dev-box)\n - [Key concepts for Microsoft Dev Box](#key-concepts-for-microsoft-dev-box)\n - [Quickstart: Configure Microsoft Dev Box](#quickstart-configure-microsoft-dev-box)\n - [Create a dev center](#create-a-dev-center)\n - [Create a project](#create-a-project)\n - [Create a dev box definition](#create-a-dev-box-definition)\n - [Create a dev box pool](#create-a-dev-box-pool)\n - [Provide access to a dev box project](#provide-access-to-a-dev-box-project)\n - [Quickstart: Create and connect to a dev box by using the Microsoft Dev Box developer portal](#quickstart-create-and-connect-to-a-dev-box-by-using-the-microsoft-dev-box-developer-portal)\n - [Create a dev box](#create-a-dev-box)\n - [Connect to a dev box](#connect-to-a-dev-box)\n - [Microsoft Dev Box architecture overview](#microsoft-dev-box-architecture-overview)\n - [How does Microsoft Dev Box work?](#how-does-microsoft-dev-box-work)\n - [Microsoft Dev Box architecture](#microsoft-dev-box-architecture)\n - [Network connectivity](#network-connectivity)\n - [Microsoft Intune integration](#microsoft-intune-integration)\n - [Identity services](#identity-services)\n\n## [What is Microsoft Dev Box?](https://learn.microsoft.com/en-us/azure/dev-box/overview-what-is-microsoft-dev-box)\n\n- gives developers self-service access to ready-to-code cloud workstations called dev boxes\n- configure dev boxes with tools, source code, and prebuilt binaries\n- create your own customized image, or use a preconfigured image from Azure Marketplace\n- was designed with three organizational roles in mind: platform engineers, development team leads, and developers\n\n> A dev box is a virtual machine (VM) preconfigured with the tools and resources the developer needs for a project.\n\n![img](https://learn.microsoft.com/en-us/azure/dev-box/media/overview-what-is-microsoft-dev-box/dev-box-roles.png#lightbox)\n\n## [Key concepts for Microsoft Dev Box](https://learn.microsoft.com/en-us/azure/dev-box/concept-dev-box-concepts)\n\n## [Quickstart: Configure Microsoft Dev Box](https://learn.microsoft.com/en-us/azure/dev-box/quickstart-configure-dev-box-service)\n\nTwo phases\n\n- platform engineers configure the necessary Microsoft Dev Box resources through the Azure portal\n- users can proceed to the next phase, creating and managing their dev boxes through the developer portal\n\nsteps required to configure Microsoft Dev Box in the Azure portal.\n\n![img](https://learn.microsoft.com/en-us/azure/dev-box/media/quickstart-configure-dev-box-service/dev-box-build-stages.png#lightbox)\n\n### [Create a dev center](https://learn.microsoft.com/en-us/azure/dev-box/quickstart-configure-dev-box-service#create-a-dev-center)\n\nprovides a centralized place to manage a\n\n- collection of projects,\n- the configuration of available dev box images and sizes, and\n- the networking settings to enable access to organizational resources\n\n### [Create a project](https://learn.microsoft.com/en-us/azure/dev-box/quickstart-configure-dev-box-service#create-a-project)\n\n- Dev box projects enable you to manage team-level settings\n- These settings include providing access to development teams so developers can create dev boxes.\n\n### [Create a dev box definition](https://learn.microsoft.com/en-us/azure/dev-box/quickstart-configure-dev-box-service#create-a-dev-box-definition)\n\n- A dev box definition defines the VM image and the VM SKU (compute size + storage) that are used in the creation of the dev boxes.\n- The dev box definitions you create in a dev center are available for all projects associated with that dev center\n\n### [Create a dev box pool](https://learn.microsoft.com/en-us/azure/dev-box/quickstart-configure-dev-box-service#create-a-dev-box-pool)\n\n- A dev box pool is the collection of dev boxes that have the same settings, such as the dev box definition and network connection.\n- Developers that have access to the project in the dev center, can then choose to create a dev box from a dev box pool.\n- Dev box pools define the location of the dev boxes through the specified network connection\n\n### [Provide access to a dev box project](https://learn.microsoft.com/en-us/azure/dev-box/quickstart-configure-dev-box-service#provide-access-to-a-dev-box-project)\n\n- you must provide access for users through role assignments\n- Dev Box User role enables dev box users to create, manage, and delete their own dev boxes\n- You grant access for the user at the level of the project.\n\n## [Quickstart: Create and connect to a dev box by using the Microsoft Dev Box developer portal](https://learn.microsoft.com/en-us/azure/dev-box/quickstart-create-dev-box)\n\n### [Create a dev box](https://learn.microsoft.com/en-us/azure/dev-box/quickstart-create-dev-box#create-a-dev-box)\n\n### [Connect to a dev box](https://learn.microsoft.com/en-us/azure/dev-box/quickstart-create-dev-box#connect-to-a-dev-box)\n\n## [Microsoft Dev Box architecture overview](https://learn.microsoft.com/en-us/azure/dev-box/concept-dev-box-architecture)\n\n### [How does Microsoft Dev Box work?](https://learn.microsoft.com/en-us/azure/dev-box/concept-dev-box-architecture)\n\nThe following diagram gives an overview of the relationship between the different components in Microsoft Dev Box.\n\n![img](https://learn.microsoft.com/en-us/azure/dev-box/media/concept-dev-box-architecture/dev-box-concepts-overview.png#lightbox)\n\n- dev center\n - dev center is the top-level resource for Microsoft Dev Box\n - dev center contains the collection of projects and the shared resources for these projects, such as dev box definitions and network connections\n- project\n - A dev box project is the point of access for development teams.\n - You assign a developer the Dev Box User role to a project to grant the developer permissions to create dev boxes.\n- dev box definition\n - dev box definition specifies the configuration of the dev boxes, such as the virtual machine image and compute resources for the dev boxes.\n - can either choose a VM image from the Azure Marketplace, or use an Azure compute gallery to use custom VM images.\n- dev box pools\n - project contains the collection of dev box pools\n - dev box pool specifies the configuration for dev boxes, such as the dev box definition, the network connection, and other settings\n - The network connection that is associated with a dev box pool determines where the dev box is hosted\n- dev box\n - Developers can create a dev box from a dev box pool by using the developer portal.\n\n### [Microsoft Dev Box architecture](https://learn.microsoft.com/en-us/azure/dev-box/concept-dev-box-architecture#microsoft-dev-box-architecture)\n\nThe following diagrams show the logical architecture of Microsoft Dev Box.\n\n![img](https://learn.microsoft.com/en-us/azure/dev-box/media/concept-dev-box-architecture/dev-box-architecture-diagram.png#lightbox)\n\nFor the network connection, you can also choose between a Microsoft-hosted network connection, and an Azure network connection that you create in your own subscription\n\n### [Network connectivity](https://learn.microsoft.com/en-us/azure/dev-box/concept-dev-box-architecture#network-connectivity)\n\n- Network connections control where dev boxes are created and hosted, and enable you to connect to other Azure or corporate resources.\n- Depending on your level of control, you can use Microsoft-hosted network connections or bring your own Azure network connections.\n\n### [Microsoft Intune integration](https://learn.microsoft.com/en-us/azure/dev-box/concept-dev-box-architecture#microsoft-intune-integration)\n\n- Microsoft Intune is used to manage your dev boxes.\n- Every Dev Box user needs one Microsoft Intune license and can create multiple dev boxes.\n\n### [Identity services](https://learn.microsoft.com/en-us/azure/dev-box/concept-dev-box-architecture#identity-services)\n\nMicrosoft Dev Box uses Microsoft Entra ID and, optionally, on-premises Active Directory Domain Services (AD DS)." }, { "path": "home/cloud_providers/azure/taskset_azure_cloud_providers/task_003_create_a_windows_virtual_machine/ReadMe.md", "content": "# [Create a Windows virtual machine](https://learn.microsoft.com/en-us/training/modules/create-windows-virtual-machine-in-azure/3-exercise-create-a-vm)\n\n[Training Module » Create a Windows virtual machine in Azure](https://learn.microsoft.com/en-us/training/modules/create-windows-virtual-machine-in-azure/)\n" }, { "path": "home/cloud_providers/azure/taskset_azure_cloud_providers/task_004_connect_to_windows_virtual_machine_via_rdp/ReadMe.md", "content": "# [Connect to a Windows virtual machine using RDP](https://learn.microsoft.com/en-us/training/modules/create-windows-virtual-machine-in-azure/5-exercise-connect-to-a-windows-vm-using-rdp)\n\n[Training Module » Create a Windows virtual machine in Azure](https://learn.microsoft.com/en-us/training/modules/create-windows-virtual-machine-in-azure/)\n\nTo connect to an Azure VM with an RDP client, you'll need:\n\n- Public IP address of the VM (or private if the VM is configured to connect to your network)\n- Port number\n" }, { "path": "home/cloud_providers/azure/taskset_azure_cloud_providers/task_005_create_a_generalized_image/ReadMe.md", "content": "# [Create a generalized image](https://learn.microsoft.com/en-us/training/modules/customize-windows-server-iaas-virtual-machine-images/2-create-generalized-image)\n\n[Training Module » Customize Windows Server IaaS Virtual Machine images](https://learn.microsoft.com/en-us/training/modules/customize-windows-server-iaas-virtual-machine-images/)\n\n[Video Reference : Create a managed image of a generalized virtual machine in Azure](https://learn.microsoft.com/en-us/training/modules/customize-windows-server-iaas-virtual-machine-images/4-create-managed-image-generalized-virtual-machine-azure)\n\n[what's the difference between deallocated and stopped ?](https://learn.microsoft.com/en-us/answers/questions/574969/whats-the-difference-between-deallocated-and-stopp)\n\n## What are VM images?\n\n- When you create a VM, you must specify a VM image that contains a generalized operating system and optionally, other preconfigured software.\n- Azure uses the image to create a new virtual hard disk (VHD) from which it can start your VM\n\n## What is a generalized image?\n\n- After you create a VM and customize it by configuring and installing additional applications according to your requirements, you can save it as a new image.\n- The new image will be a set of VHDs from which you can create additional VMs.\n- However, you need to clean up the image first, because when you create a VM the operating system data is updated with several items, including:\n\n - The host name of your VM.\n - The administrator username and credentials.\n - Log files.\n - Security identifiers for various operating system services.\n\nThese items must be reset to their default settings before you capture an image. When you reset these items in a VM, you generalize the VM.\n\n## Generalize a VM\n\n- Use the Sysprep.exe tool to generalize a Windows VM\n\n![img](https://learn.microsoft.com/en-us/training/wwl-azure/customize-windows-server-iaas-virtual-machine-images/media/m6-system-preparation.png)\n\n- After the VM has been shut down, you should deallocate it while it's in this clean state.\n\n> [!NOTE] \n> The VM might display a state of Stopped, but it isn't deallocated.\n\nIf you're using the Azure CLI, run the following command instead:\n\n```bash\naz vm deallocate \\\n --resource-group \\\n --name \n```\n\n> [!TIP]\n> When you use the Azure portal to create an image from a VM it automatically deallocates the VM.\n\n> [!IMPORTANT]\n> Keep in mind that you continue to pay for compute resources if your VM is stopped but not deallocated.\n" }, { "path": "home/cloud_providers/azure/taskset_azure_cloud_providers/task_006_create_a_new_virtual_machine_from_a_managed_image/ReadMe.md", "content": "# [Create a new Virtual Machine from a managed image](https://learn.microsoft.com/en-us/training/modules/customize-windows-server-iaas-virtual-machine-images/3-create-new-virtual-machine-managed-image)\n\n[Video Reference - Create a Virtual Machine from a managed image](https://learn.microsoft.com/en-us/training/modules/customize-windows-server-iaas-virtual-machine-images/5-demonstration-create-virtual-machine-managed-image)\n\nAfter you have generalized the VM, you can create a managed image. You can then create new VMs from this managed image.\n\n> [!CAUTION]\n> Capturing a VM image from a VM will make the VM unusable. Furthermore, this action can't be undone.\n\n## Create a managed image from a generalized VM\n\nThe managed image you create will include all of the disks associated with the generalized VM\n\n> [!NOTE]\n> The VM is in stopped (deallocated) state before you create the image.\n\n```bash\naz image create \\\n --name \\\n --resource-group \\\n --source \n```\n\n## Create a new VM from a managed image\n\nTo create a new VM using Azure CLI, use the following command:\n\n```bash\naz vm create \\\n --resource-group \\\n --name \\\n --image \\\n --location \n```\n\nIf you review your list of VMs in the Azure portal, after creating your new VM from your managed image you'll notice that the new VM displays the source as Image.\n" }, { "path": "home/cloud_providers/azure/taskset_azure_cloud_providers/task_007_create_an_image_of_azure_vm_from_az_cli_and_provision_a_new_vm/ReadMe.md", "content": "# [Exercise - Create an image of an Azure VM from the Azure CLI and provision a new VM](https://learn.microsoft.com/en-us/training/modules/deploy-vms-from-vhd-templates/4-exercise-create-image-provision-vm?pivots=windows-cloud)\n\n## Set your default resource group\n\n```bash\naz configure --defaults group=\"learn-fcd3cc98-3fab-45d5-b679-f2ddfaf86f6c\"\n```\n\n## Create a virtual machine\n\nCreate\n\n```bash\naz vm create --name MyWindowsVM --image Win2019Datacenter --admin-username azureuser\n```\n\ninstall IIS and set up a default webpage:\n\n```bash\naz vm extension set --name CustomScriptExtension --vm-name MyWindowsVM --publisher Microsoft.Compute --settings '{\"commandToExecute\":\"powershell Add-WindowsFeature Web-Server; Add-Content -Path \\\"C:\\\\inetpub\\\\wwwroot\\\\Default.htm\\\" -Value $(hostname)\"}'\n```\n\nopen port 80 to the web server:\n\n```bash\naz vm open-port --name MyWindowsVM --port 80\n```\n\nget public ip\n\n```bash\necho http://$(az vm list-ip-addresses --name MyWindowsVM --query \"[].virtualMachine.network.publicIpAddresses[*].ipAddress\" --output tsv)\n```\n\n## Generalize the virtual machine\n\n![img](https://learn.microsoft.com/en-us/training/modules/deploy-vms-from-vhd-templates/media/4-sysprep.png)\n\ndeallocate the virtual machine\n\n```bash\naz vm deallocate --name MyWindowsVM\n```\n\ngeneralize the virtual machine:\n\n```bash\naz vm generalize --name MyWindowsVM\n```\n\n## Create a virtual machine image\n\n```bash\naz image create --name MyVMIMage --source MyWindowsVM\n```\n\n## Create a virtual machine by using the new image\n\nCreate a new virtual machine from the image:\n\n```bash\naz vm create --name MyVMFromImage --computer-name MyVMFromImage --image MyVMImage --admin-username azureuser\n```\n\nupdate the default web page with the server name:\n\n```bash\naz vm extension set --name CustomScriptExtension --vm-name MyVMFromImage --publisher Microsoft.Compute --settings '{\"commandToExecute\":\"powershell Clear-Content -Path \\\"C:\\\\inetpub\\\\wwwroot\\\\Default.htm\\\"; Add-Content -Path \\\"C:\\\\inetpub\\\\wwwroot\\\\Default.htm\\\" -Value $(hostname)\"}'\n```\n\nopen port 80 to the web server:\n\n```bash\naz vm open-port --name MyVMFromImage --port 80\n```\n\nget public ip\n\n```bash\necho http://$(az vm list-ip-addresses --name MyVMFromImage --query \"[].virtualMachine.network.publicIpAddresses[*].ipAddress\" --output tsv)\n```\n\n" }, { "path": "home/cloud_providers/azure/taskset_azure_cloud_providers/task_008_create_an_azure_virtual_machine/ReadMe.md", "content": "# [Create an Azure virtual machine](https://learn.microsoft.com/en-us/training/modules/describe-azure-compute-networking-services/3-exercise-create-azure-virtual-machine)\n\nrun the following az vm create command to create a Linux VM:\n\n```bash\naz vm create --resource-group \"\" --name my-vm --public-ip-sku Standard --image Ubuntu2204 --admin-username azureuser --generate-ssh-keys\n```\n\nRun the following az vm extension set command to configure Nginx on your VM:\n\n```bash\naz vm extension set --resource-group \"\" --vm-name my-vm --name customScript --publisher Microsoft.Azure.Extensions --version 2.1 --settings '{\"fileUris\":[\"https://raw.githubusercontent.com/MicrosoftDocs/mslearn-welcome-to-azure/master/configure-nginx.sh\"]}' --protected-settings '{\"commandToExecute\": \"./configure-nginx.sh\"}'\n```" }, { "path": "home/cloud_providers/azure/taskset_azure_cloud_providers/task_009_configure_network_access/ReadMe.md", "content": "# [Configure Network Access](https://learn.microsoft.com/en-us/training/modules/describe-azure-compute-networking-services/9-exercise-configure-network-access)\n\n> [!NOTE]\n> you can associate same NSG for multiple network interfaces and/or subnets\n\n> [!TIP]\n> A network interface (NIC) enables an Azure virtual machine (VM) to communicate with internet, Azure, and on-premises resources.\n\n[Create, change, or delete a network interface](https://learn.microsoft.com/en-us/azure/virtual-network/virtual-network-network-interface?tabs=azure-portal)\n\n[Network security groups](https://learn.microsoft.com/en-us/azure/virtual-network/network-security-groups-overview)\n\n[NSG-Can i assigned 1 NSG to multiple Instance , what is the limit](https://learn.microsoft.com/en-us/answers/questions/1353503/nsg-can-i-assigned-1-nsg-to-multiple-instance-what)\n\n## Access your web server\n\nList VMs\n\n```bash\naz vm list\n```\n\nGet VM IP\n\n```bash\nIPADDRESS=\"$(az vm list-ip-addresses --resource-group \"\" --name my-vm --query \"[].virtualMachine.network.publicIpAddresses[*].ipAddress\" --output tsv)\"\n```\n\ncurl to download homepage\n\n```bash\ncurl --connect-timeout 5 http://$IPADDRESS\n```\n\nOutput\n\n```bash\ncurl: (28) Failed to connect to 13.64.199.115 port 80 after 5002 ms: Timeout was reached\n```\n\n## List the current network security group rules\n\nRun the following az network nsg list command to list the network security groups that are associated with your VM:\n\n```bash\naz network nsg list --resource-group \"\" --query '[].name' --output tsv\n```\n\nOutput\n\n```bash\nmy-vmNSG\n```\n\nRun the following az network nsg rule list command to list the rules associated with the NSG named my-vmNSG:\n\n```bash\naz network nsg rule list --resource-group \"\" --nsg-name my-vmNSG\n```\n\n## Create the network security rule\n\nRun the following az network nsg rule create command to create a rule called allow-http that allows inbound access on port 80:\n\n```bash\naz network nsg rule create --resource-group \"\" --nsg-name my-vmNSG --name allow-http --protocol tcp --priority 100 --destination-port-range 80 --access Allow\n```\n\nValidate\n\n```bash\naz network nsg rule list --resource-group \"\" --nsg-name my-vmNSG --query '[].{Name:name, Priority:priority, Port:destinationPortRange, Access:access}' --output table\n```\n\nOutput\n\n```bash\nName Priority Port Access\n----------------- ---------- ------ --------\ndefault-allow-ssh 1000 22 Allow\nallow-http 100 80 Allow\n```\n\n## Access your web server again\n\n```bash\ncurl --connect-timeout 5 http://$IPADDRESS\n```\n\nOutput\n\n```bash\n

Welcome to Azure! My name is my-vm.

\n```\n\n## Resources created in security group\n\n```bash\naz resource list --resource-group --query \"[].type\" -o tsv\nMicrosoft.Storage/storageAccounts\nMicrosoft.Network/publicIPAddresses\nMicrosoft.Network/networkSecurityGroups\nMicrosoft.Network/virtualNetworks\nMicrosoft.Network/networkInterfaces\nMicrosoft.Compute/virtualMachines\nMicrosoft.Compute/disks\nMicrosoft.Compute/virtualMachines/extensions\n```\n" }, { "path": "home/cloud_providers/azure/taskset_azure_cloud_providers/task_010_create_a_storage_blob/ReadMe.md", "content": "# [Create a storage blob](https://learn.microsoft.com/en-us/training/modules/describe-azure-storage-services/5-exercise-create-storage-blob)\n\n## Create a storage account\n\n## Work with blob storage\n\n## Change the access level of your blob\n" }, { "path": "home/cloud_providers/azure/taskset_azure_cloud_providers/task_011_deploy_a_container_app/ReadMe.md", "content": "# [Exercise - Deploy a container app](https://learn.microsoft.com/en-us/training/modules/implement-azure-container-apps/3-exercise-deploy-app)\n\n## Prepare your environment\n\nInstall the Azure Container Apps extension for the CLI.\n\n```bash\naz extension add --name containerapp --upgrade\n```\n\nRegister the Microsoft.App namespace.\n\n```bash\naz provider register --namespace Microsoft.App\n```\n\nRegister the Microsoft.OperationalInsights provider for the Azure Monitor Log Analytics workspace\n\n```bash\naz provider register --namespace Microsoft.OperationalInsights\n```\n\nSet environment variables used later in this exercise. Replace with a region near you.\n\n```bash\nRANOM=22388202393912\nmyRG=az204-appcont-rg\nmyLocation=eastus\nmyAppContEnv=az204-env-$RANDOM\n```\n\nCreate the resource group for your container app.\n\n```bash\naz group create \\\n --name $myRG \\\n --location $myLocation\n```\n\n## Create an environment\n\n```bash\naz containerapp env create \\\n --name $myAppContEnv \\\n --resource-group $myRG \\\n --location $myLocation\n```\n\n## Create a container app\n\n```bash\naz containerapp create \\\n --name my-container-app \\\n --resource-group $myRG \\\n --environment $myAppContEnv \\\n --image mcr.microsoft.com/azuredocs/containerapps-helloworld:latest \\\n --target-port 80 \\\n --ingress 'external' \\\n --query properties.configuration.ingress.fqdn\n```\n\n## Verify deployment\n\nSelect the link returned by the az containerapp create command to verify the container app is running.\n\n## Clean up resources\n\n```bash\naz group delete --name $myRG\n```" }, { "path": "home/cloud_providers/gcp/ReadMe-static.md", "content": "# GCP Taskset\n\nReferences\n\n- [docs/regions-zones](https://cloud.google.com/compute/docs/regions-zones)\n- [https://cloud.google.com/about/locations](https://cloud.google.com/about/locations)\n- [docs/creating-managing-projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects)\n- [docs/grant-role-console](https://cloud.google.com/iam/docs/grant-role-console)\n- [shell/docs](https://cloud.google.com/shell/docs)\n- [architecture/identity](https://cloud.google.com/architecture/identity)\n- [docs/cloud-platform-resource-hierarchy](https://cloud.google.com/resource-manager/docs/cloud-platform-resource-hierarchy)\n- [https://cloud.google.com/products/calculator](https://cloud.google.com/products/calculator)\n- [service-accounts](https://www.cloudskillsboost.google/course_sessions/2028816/video/343131)\n- [cloud identify](https://www.cloudskillsboost.google/course_sessions/2028816/video/343132)\n" }, { "path": "home/cloud_providers/gcp/ReadMe.md", "content": "# taskset_gcp_cloud_providers\n\n> [Auto](https://github.com/codeaprendiz/learn_fullstack/blob/main/home/php/intermediate/taskset_intermediate_php/task_004_createGlobalMarkdownTable/generate-readme.php) generated ReadMe. Number of tasks: 42\n\n| Task | Description |\n|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| task_001 | [task_001_create_budget__and_alerts](taskset_gcp_cloud_providers/task_001_create_budget__and_alerts) |\n| task_001 | [task_001_intro_console_projects_iam_apis](taskset_gcp_cloud_providers/task_001_intro_console_projects_iam_apis) |\n| task_002 | [task_002_getting_started_with_cloud_market_place](taskset_gcp_cloud_providers/task_002_getting_started_with_cloud_market_place) |\n| task_002 | [task_002_getting_started_with_cloud_market_place__lamp_stack](taskset_gcp_cloud_providers/task_002_getting_started_with_cloud_market_place__lamp_stack) |\n| task_003 | [task_003_vpc_networking_and_google_compute_engine](taskset_gcp_cloud_providers/task_003_vpc_networking_and_google_compute_engine) |\n| task_004 | [task_004_getting_started_with_cloud_storage_and_cloud_sql__php](taskset_gcp_cloud_providers/task_004_getting_started_with_cloud_storage_and_cloud_sql__php) |\n| task_005 | [task_005_getting_started_with_gke__nginx](taskset_gcp_cloud_providers/task_005_getting_started_with_gke__nginx) |\n| task_006 | [task_006_hello_cloud_run__node](taskset_gcp_cloud_providers/task_006_hello_cloud_run__node) |\n| task_007 | [task_007_building_a_devops_pipeline__python](taskset_gcp_cloud_providers/task_007_building_a_devops_pipeline__python) |\n| task_008 | [task_008_deploying_app_to_app_engine_and_gke_and_cloudrun](taskset_gcp_cloud_providers/task_008_deploying_app_to_app_engine_and_gke_and_cloudrun) |\n| task_008 | [task_008_deploying_app_to_app_engine_and_gke_and_cloudrun__python](taskset_gcp_cloud_providers/task_008_deploying_app_to_app_engine_and_gke_and_cloudrun__python) |\n| task_009 | [task_009_monitoring_applications_in_gcp__python](taskset_gcp_cloud_providers/task_009_monitoring_applications_in_gcp__python) |\n| task_010 | [task_010_alerting_in_google_cloud](taskset_gcp_cloud_providers/task_010_alerting_in_google_cloud) |\n| task_010 | [task_010_alerting_in_google_cloud__python](taskset_gcp_cloud_providers/task_010_alerting_in_google_cloud__python) |\n| task_011 | [task_011_service_monitoring__node](taskset_gcp_cloud_providers/task_011_service_monitoring__node) |\n| task_011 | [task_011_service_monitoring__node_app](taskset_gcp_cloud_providers/task_011_service_monitoring__node_app) |\n| task_012 | [task_012_monitoring_and_dashboarding_multiple_projects_from_a_single_workspace](taskset_gcp_cloud_providers/task_012_monitoring_and_dashboarding_multiple_projects_from_a_single_workspace) |\n| task_012 | [task_012_monitoring_and_dashboarding_multiple_projects_from_a_single_workspace__nginx](taskset_gcp_cloud_providers/task_012_monitoring_and_dashboarding_multiple_projects_from_a_single_workspace__nginx) |\n| task_013 | [task_013_compute_logging_and_monitoring](taskset_gcp_cloud_providers/task_013_compute_logging_and_monitoring) |\n| task_014 | [task_014_log_analysis](taskset_gcp_cloud_providers/task_014_log_analysis) |\n| task_014 | [task_014_log_analysis_cloud_run__node](taskset_gcp_cloud_providers/task_014_log_analysis_cloud_run__node) |\n| task_015 | [task_015_cloud_audit_logs](taskset_gcp_cloud_providers/task_015_cloud_audit_logs) |\n| task_015 | [task_015_cloud_storage_audit_logs](taskset_gcp_cloud_providers/task_015_cloud_storage_audit_logs) |\n| task_016 | [task_016_analyzing_network_traffic_with_vpc_flow_logs](taskset_gcp_cloud_providers/task_016_analyzing_network_traffic_with_vpc_flow_logs) |\n| task_017 | [task_017_application_performance_management](taskset_gcp_cloud_providers/task_017_application_performance_management) |\n| task_017 | [task_017_application_performance_management__python_and_nodejs](taskset_gcp_cloud_providers/task_017_application_performance_management__python_and_nodejs) |\n| task_018 | [task_018_2inst_2buckets_2iam](taskset_gcp_cloud_providers/task_018_2inst_2buckets_2iam) |\n| task_019 | [task_019_working_with_cloud_build](taskset_gcp_cloud_providers/task_019_working_with_cloud_build) |\n| task_020 | [task_020_deploying_google_kubernetes_engine](taskset_gcp_cloud_providers/task_020_deploying_google_kubernetes_engine) |\n| task_021 | [task_021_creating_google_kubernetes_engine_deployments](taskset_gcp_cloud_providers/task_021_creating_google_kubernetes_engine_deployments) |\n| task_022 | [task_022_configuring_persistent_storage_for_google_kubernetes_engine](taskset_gcp_cloud_providers/task_022_configuring_persistent_storage_for_google_kubernetes_engine) |\n| task_023 | [task_023_anthos_service_mesh_walkthrough](taskset_gcp_cloud_providers/task_023_anthos_service_mesh_walkthrough) |\n| task_024 | [task_024_observing_anthos_services](taskset_gcp_cloud_providers/task_024_observing_anthos_services) |\n| task_025 | [task_025_managing_traffic_with_anthos_service_mesh](taskset_gcp_cloud_providers/task_025_managing_traffic_with_anthos_service_mesh) |\n| task_026 | [task_026_securing_traffic_through_anthos_service_mesh](taskset_gcp_cloud_providers/task_026_securing_traffic_through_anthos_service_mesh) |\n| task_027 | [task_027_cloud_source_repositories_overview](taskset_gcp_cloud_providers/task_027_cloud_source_repositories_overview) |\n| task_028 | [task_028_managing_deployments_using_kubernetes_engine](taskset_gcp_cloud_providers/task_028_managing_deployments_using_kubernetes_engine) |\n| task_029 | [task_029_trouble_shooting_workloads_on_gke_for_sre](taskset_gcp_cloud_providers/task_029_trouble_shooting_workloads_on_gke_for_sre) |\n| task_030 | [task_030_minimal_nodejs_app_dockerize_google_artifact_registry](taskset_gcp_cloud_providers/task_030_minimal_nodejs_app_dockerize_google_artifact_registry) |\n| task_031 | [task_031_hello_node_kubernetes__node](taskset_gcp_cloud_providers/task_031_hello_node_kubernetes__node) |\n| task_032 | [task_032_setting_up_jenkins_on_kubernetes_engine](taskset_gcp_cloud_providers/task_032_setting_up_jenkins_on_kubernetes_engine) |\n| task_033 | [task_033_continuous_delivery_with_jenkins_in_kubernetes_engine](taskset_gcp_cloud_providers/task_033_continuous_delivery_with_jenkins_in_kubernetes_engine) |\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_001_create_budget__and_alerts/ReadMe.md", "content": "## Create budget and alerts\n\n[billing/docs/how-to/budgets](https://cloud.google.com/billing/docs/how-to/budgets)\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_001_intro_console_projects_iam_apis/ReadMe.md", "content": "# Get Familiar With Console, Projects, Roles And Permissions, APIs And Services\n\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n**High Level Objectives**\n- Searching though available products and services in the GCP console.\n- Accessing projects in console.\n- Accessing roles and permissions in console i.e. Identify and Access Management\n- Enable specific API for any product\n\n\n\n**Skills**\n- gcp\n- gcp-console\n- gcp-projects\n- gcp-iam\n- gcp-apis\n\n\n\n> Task : Searching through the available products and services\n\n## Project\n\n\n- A Google Cloud [project](https://cloud.google.com/docs/overview/#projects) is an organizing entity for your Google Cloud resources. It often contains resources and services.\n- Your project has a name, number, and ID\n\n> Task : How do we see all the projects\n\n## Roles and permissions\n\n[IAM Overview](https://cloud.google.com/iam/docs/overview)\n[course_sessions/2028816/video/343130](https://www.cloudskillsboost.google/course_sessions/2028816/video/343130)\n\n- Google Cloud also contains a collection of permissions and roles that define who has access to what resources\n- You can use the [CloudIAM](https://cloud.google.com/iam/) console for the same.\n\n> Task : How do we navigate to CloudIAM console\n\n\n## APIs And Services\n\n- When you create your own Google Cloud projects outside of the lab environment, you will have to enable APIs yourself.\n\n> Task : Enable the Dialogflow API\n\n\n\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_002_getting_started_with_cloud_market_place/ReadMe.md", "content": "# Getting Started With Cloud Marketplace\n\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n> Task : We will use the Cloud MarketPlace to deploy a LAMP stack\n\n## High Level Tasks\n\n- Search for \"LAMP Packaged by Bitnami\" in the Marketplace\n- Launch\n- You should see the status as deployed as it is completed\n- Go to the site address\n- SSH\n- In the created SSH window\n\n```bash\ncd /opt/bitnami\n\nsudo sh -c 'echo \"\" > apache2/htdocs/phpinfo.php'\n```\n\n- Open the `SITE_ADDRESS` again to view your changes" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_002_getting_started_with_cloud_market_place__lamp_stack/ReadMe.md", "content": "# Getting Started With Cloud Marketplace\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n**High Level Objectives**\n- To launch a LAMP stack from GCP marketplace\n- Validate the changes by going to the public endpoint created\n\n\n\n**Skills**\n- gcp\n- cloud-marketplace\n\n\n\n\n\n> Task : We will use the Cloud MarketPlace to deploy a LAMP stack\n\n## High Level Tasks\n\n- Search for \"LAMP Packaged by Bitnami\" in the Marketplace\n- Launch\n- You should see the status as deployed as it is completed\n- Go to the site address\n- SSH\n- In the created SSH window\n\n```bash\ncd /opt/bitnami\n\nsudo sh -c 'echo \"\" > apache2/htdocs/phpinfo.php'\n```\n\n- Open the `SITE_ADDRESS` again to view your changes" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_003_vpc_networking_and_google_compute_engine/ReadMe.md", "content": "# Getting started with VPC Networking and Google Compute Engine\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n**High Level Objectives**\n- Explore the default network\n- Delete the firewall rules and default network\n- Create VPC network and VM instances\n- Explore the connectivity for VM instances\n\n\n\n**Skills**\n- gcp\n- gcp-networking\n- gcp-compute-engine\n- gcp-vpc-networking\n- gcp-vm-instance\n- gcp-ssh\n\n\n\n## Explore the default network\n\n\n- View the subnets\n- View the routes\n - Notice that there is a route for each subnet and one for the Default internet gateway (0.0.0.0/0)\n- View the Firewall rules\n - there are 4 Ingress firewall rules for the default network:\n - default-allow-icmp\n - default-allow-rdp\n - default-allow-ssh\n - default-allow-internal\n - Note: These firewall rules allow ICMP, RDP, and SSH ingress traffic from anywhere (0.0.0.0/0) and all TCP, UDP, and ICMP traffic within the network (10.128.0.0/9). The Targets, Filters, Protocols/ports, and Action columns explain these rules.\n\n## Delete the Firewall Rules and Default Network (only for testing, don't do it in production :) )\n\n- Delete the Firewall rules\n- Delete the default network\n- Try to create a VM instance\n - Notice the error\n\n\n## Create a VPC network and VM instances\n\n- Create a VPC using automode `mynetwork`\n- Create a VM instance in us-central1\n\n| Property | Value |\n|----------|---------------|\n| Name | mynet-us-vm |\n| Region | us-central1 |\n| Zone | us-central1-c |\n\n- The Internal IP should be 10.128.0.2 because 10.128.0.1 is reserved for the gateway and you have not configured any other instances in that subnet.\n\n- Create a VM instance in europe-central2\n\n| Property | Value |\n|----------|-------------------|\n| Name | mynet-eu-vm |\n| Region | europe-central2 |\n| Zone | europe-central2-a |\n\n- The Internal IP should be 10.186.0.2 because 10.186.0.1 is reserved for the gateway and you have not configured any other instances in that subnet.\n\n## Explore the connectivity for VM instances\n\n- For mynet-us-vm, click SSH to launch a terminal and connect.\n\n```bash\nping -c 3 \nping -c 3 \n```\n\n- Remove the allow-icmp firewall rules\n\n```bash\nping -c 3 \n# The 100% packet loss indicates that you cannot ping mynet-eu-vm's external IP. This is expected because you deleted the allow-icmp firewall rule!\nping -c 3 \n```\n\n- Remove the allow-custom firewall rules\n\n```bash\n# Note: The 100% packet loss indicates that you cannot ping mynet-eu-vm's internal IP. This is expected because you deleted the allow-custom firewall rule!\nping -c 3 \n```\n\n- Remove the allow-ssh firewall rules\n - Note: The Connection failed message indicates that you cannot SSH to mynet-us-vm because you deleted the allow-ssh firewall rule!\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_004_getting_started_with_cloud_storage_and_cloud_sql__php/ReadMe.md", "content": "# Getting Started with Cloud Storage and Cloud SQL\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n**High Level Objectives**\n- Deploy a webserver VM instance\n- Create a Cloud Storage bucket using gsutil command line\n- Create a Cloud SQL instance\n- Configure the application in compute engine instance to use Cloud SQL\n- Configure the application in compute engine instance to use Cloud Storage Object\n\n\n\n**Skills**\n- gcp\n- cloud storage\n- cloud sql\n- php\n- cloud storage object\n- vm instance\n\n## Deploy a WebServer VM instance\n\n- Create instance `bloghost` with `Debian GNU/Linux 11 (bullseye)` image and ensure that you allow `http` traffic\n- Add the following startup script\n\n```bash\napt-get update\napt-get install apache2 php php-mysql -y\nservice apache2 restart\n```\n\n## Create a Cloud Storage bucket using the gsutil command line\n\n- Use cloudshell for the following\n\n```bash\nexport LOCATION=US\n\necho $DEVSHELL_PROJECT_ID \n\n## Create bucket\ngsutil mb -l $LOCATION gs://$DEVSHELL_PROJECT_ID\n\n## Copy image from public bucket to your local i.e. cloudshell\ngsutil cp gs://cloud-training/gcpfci/my-excellent-blog.png my-excellent-blog.png\n\n## Copy from cloudshell to new bucket\ngsutil cp my-excellent-blog.png gs://$DEVSHELL_PROJECT_ID/my-excellent-blog.png\n\n## Modify the Access Control List of the object you just created so that it is readable by everyone\ngsutil acl ch -u allUsers:R gs://$DEVSHELL_PROJECT_ID/my-excellent-blog.png\n```\n\n## Create the Cloud SQL instance\n\n- Create SQL instance with db engine as MySQL, instance id as `blog-db`, password as `rootpass`\n- Use Single Zone\n- Wait for it to get created\n- Go to `Users` and add user `blogdbuser` and give password as `blogdbuserpassword`\n- Go to `Connections`. Give name as `web front end`. For external IP give `bloghostVM_public_ip/32`\n\n\n## Configure an application in a Compute Engine instance to use Cloud SQL\n\n- SSH to bloghost\n- Run the following\n\n```bash\ncd /var/www/html\nsudo vi index.php\n```\n- and paste content into the file\n\n```php\n\nWelcome to my excellent blog\n\n

Welcome to my excellent blog

\n\n\n```\n\n- Save and restart\n\n```bash\nsudo service apache2 restart\n```\n\n- Visit `bloghostVM_publicIP/index.php`\n- Edit the file and add `CLOUDSQLIP` and `DBPASSWORD`\n- Restart and visit again\n\n## Configure an application in a Compute Engine instance to use a Cloud Storage object\n\n- Go to buckets and copy public url of `my-excellent-blog.png`\n- Add this to index.php\n\n```html\n \n```\n- Restart and visit again\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_004_getting_started_with_cloud_storage_and_cloud_sql__php/index.php", "content": "\nWelcome to my excellent blog\n\n

Welcome to my excellent blog

\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_005_getting_started_with_gke__nginx/ReadMe.md", "content": "# Getting started with GKE\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n**High Level Objectives**\n- Check if required APIs are enabled\n- Start a Kubernetes Engine Cluster \n- Run and deploy nginx container\n- Expose deployment via LB\n- Validate the changes by going to the external IP created.\n\n\n\n**Skills**\n- gcp\n- gke\n- kubernetes\n- container\n- nginx\n- loadbalancer\n- cloudshell\n- external ip\n\n\n## Check if the APIs are enabled\n\n- Kubernetes Engine API\n- Container Registry API\n\n## Start a Kubernetes Engine cluster \n\n- Run the following commands in cloudshell\n\n```bash\n# Set the zone\nexport MY_ZONE=us-central1-a\n\n# Create k8s cluster\ngcloud container clusters create webfrontend --zone $MY_ZONE --num-nodes 2\n```\n\n- Once completed\n\n```bash\nkubectl get nodes\n```\n\n## Run and deploy a container\n\n```bash\n# Deploy nginx container\nkubectl create deploy nginx --image=nginx:1.17.10\n\n# Check the pods\nkubectl get pods\n\n# Expose the deployment to the internet by creating the LoadBalancer type of Service\nkubectl expose deployment nginx --port 80 --type LoadBalancer\n\n# Check the services\nkubectl get services\n\n# Note no external IP is created yet.\n```\n\n- Once the external IP is created, visit the pubic IP. You should see the nginx page.\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_006_hello_cloud_run__node/ReadMe.md", "content": "# Hello Cloud Run\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n**High Level Objectives**\n- Enable CloudRun API, configure Shell env\n- Write a sample minimal node application\n- Containerize app using CloudBuild\n- Upload to container Registry\n- Deploy the application to CloudRun\n\n\n\n**Skills**\n- gcp\n- cloudrun\n- nodejs\n- docker\n- cloudbuild\n- artifactregistry\n- cloudshell\n- webpreview\n- cloudshelleditor\n\n\n## Enable the Cloud Run API and configure your Shell environment\n\n- Run the following in cloud shell\n\n```bash\ngcloud services enable run.googleapis.com\n\n## Set the compute region\ngcloud config set compute/region us-central1\n\n## Set the LOCATION ENV variable\nLOCATION=\"us-central1\"\n```\n\n\n## Write the sample node application\n\n- Run the following in cloud shell\n\n```bash\nmkdir helloworld && cd helloworld\ntouch package.json\n```\n\n- package.json\n\n```json\n{\n \"name\": \"helloworld\",\n \"description\": \"Simple hello world sample in Node\",\n \"version\": \"1.0.0\",\n \"main\": \"index.js\",\n \"scripts\": {\n \"start\": \"node index.js\"\n },\n \"dependencies\": {\n \"express\": \"^4.17.1\"\n }\n}\n```\n\n- Create file `index.js`\n\n```bash\ntouch index.js\n```\n\n- index.js\n\n```\nconst express = require('express');\nconst app = express();\nconst port = process.env.PORT || 8080;\napp.get('/', (req, res) => {\n const name = process.env.NAME || 'World';\n res.send(`Hello ${name}!`);\n});\napp.listen(port, () => {\n console.log(`helloworld: listening on port ${port}`);\n});\n```\n\n## Containerize your app using CloudBuild and upload it to Artifact Registry\n\n- Create a docker file\n\n- Dockerfile\n\n```\n# Use the official lightweight Node.js 12 image.\n# https://hub.docker.com/_/node\nFROM node:12-slim\n# Create and change to the app directory.\nWORKDIR /usr/src/app\n# Copy application dependency manifests to the container image.\n# A wildcard is used to ensure copying both package.json AND package-lock.json (when available).\n# Copying this first prevents re-running npm install on every code change.\nCOPY package*.json ./\n# Install production dependencies.\n# If you add a package-lock.json, speed your build by switching to 'npm ci'.\n# RUN npm ci --only=production\nRUN npm install --only=production\n# Copy local code to the container image.\nCOPY . ./\n# Run the web service on container startup.\nCMD [ \"npm\", \"start\" ]\n```\n\n\n- Let's build the container using `CloudBuild` \n\n```bash\ngcloud builds submit --tag gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld\n\n## List the images\ngcloud container images list\n```\n\n- You can go to `CloudBuild` on the console as well and check\n\n- Run the image locally\n\n```bash\ndocker run -d -p 8080:8080 gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld\n```\n\n- Preview the same in the WebPreview\n\n## Deploy to Cloud Run\n\n- Run the following in cloud shell\n\n```bash\n# allow-unauthenticated flag in the command above makes your service publicly accessible.\n# When prompted confirm the service name by pressing Enter\ngcloud run deploy --image gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld --allow-unauthenticated --region=$LOCATION\n\n# On success, the command line displays the service URL\n```\n\n- You can now visit your deployed container by opening the service URL in any browser window.\n\n\n## Clean up\n\n```bash\n# Delete the helloworld container image\ngcloud container images delete gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld\n\n# delete the cloudrun service\ngcloud run services delete helloworld --region=us-central1\n```" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_006_hello_cloud_run__node/hello-world-node/Dockerfile", "content": "# Use the official lightweight Node.js 12 image.\n# https://hub.docker.com/_/node\nFROM node:12-slim\n# Create and change to the app directory.\nWORKDIR /usr/src/app\n# Copy application dependency manifests to the container image.\n# A wildcard is used to ensure copying both package.json AND package-lock.json (when available).\n# Copying this first prevents re-running npm install on every code change.\nCOPY package*.json ./\n# Install production dependencies.\n# If you add a package-lock.json, speed your build by switching to 'npm ci'.\n# RUN npm ci --only=production\nRUN npm install --only=production\n# Copy local code to the container image.\nCOPY . ./\n# Run the web service on container startup.\nCMD [ \"npm\", \"start\" ]" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_006_hello_cloud_run__node/hello-world-node/index.js", "content": "const express = require('express');\nconst app = express();\nconst port = process.env.PORT || 8080;\napp.get('/', (req, res) => {\n const name = process.env.NAME || 'World';\n res.send(`Hello ${name}!`);\n});\napp.listen(port, () => {\n console.log(`helloworld: listening on port ${port}`);\n});" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_006_hello_cloud_run__node/hello-world-node/package.json", "content": "{\n \"name\": \"helloworld\",\n \"description\": \"Simple hello world sample in Node\",\n \"version\": \"1.0.0\",\n \"main\": \"index.js\",\n \"scripts\": {\n \"start\": \"node index.js\"\n },\n \"dependencies\": {\n \"express\": \"^4.17.1\"\n }\n}" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_007_building_a_devops_pipeline__python/Dockerfile", "content": "FROM python:3.7\nWORKDIR /app\nCOPY . .\nRUN pip install gunicorn\nRUN pip install -r requirements.txt\nENV PORT=80\nCMD exec gunicorn --bind :$PORT --workers 1 --threads 8 main:app" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_007_building_a_devops_pipeline__python/ReadMe.md", "content": "# Building a DevOps Pipeline\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n**High Level Objectives**\n- Create a Git repository\n- Create a simple Python application\n- Test Your web application in Cloud Shell\n- Define a Docker build\n- Manage Docker images with Cloud Build and Container Registry\n- Automate builds with triggers\n- Test your build changes\n\n\n\n**Skills**\n- gcp\n- devops\n- python\n- docker\n- cloud-build\n- cloud-shell\n- cloud-registry\n\n\n\n\n\n![.images/devops-pipeline.png](.images/devops-pipeline.png)\n\n\n\n\n### Create a Git repository\n\n- Use service `Source Repositories`\n- Name : `devops-repo`\n- Create\n- Activate CloudShell\n- Clone the repo\n\n```bash\nmkdir gcp-course\ncd gcp-course\ngcloud source repos clone devops-repo\ncd devops-repo\n```\n\n### Create a simple Python application\n\n- Create the req files and folders\n- Run the following\n\n\n```bash\ncd ~/gcp-course/devops-repo\ngit add --all\n\ngit config --global user.email \"you@example.com\"\ngit config --global user.name \"Your Name\"\n\ngit commit -a -m \"Initial Commit\"\n\ngit push origin master\n```\n\n- Create Dockerfile\n\n### Manage Docker images with Cloud Build and Container Registry\n\n```bash\ncd ~/gcp-course/devops-repo\necho $DEVSHELL_PROJECT_ID\ngcloud builds submit --tag gcr.io/$DEVSHELL_PROJECT_ID/devops-image:v0.1 .\n```\n\n- Check the CloudBuild and ContainerRegistry now\n\n- Let's deploy the container to compute\n\n> Container Image : gcr.io//devops-image:v0.1\n\n- Allow http traffic\n\n```bash\ncd ~/gcp-course/devops-repo\ngit add --all\n\ngit commit -am \"Added Docker Support\"\n\ngit push origin master\n```\n\n- Visit the public IP now\n\n\n### Automate builds with triggers\n\n- Go to the CloudBuild\n- Create Trigger\n- Select `devops-repo` and `.*(any branch)`\n- Choose `Dockerfile` for configuration\n- Create\n- Manually run the trigger once\n- Go to history and check the builds \n- Check the container registry for the new folder `devops-repo`\n- Make changes in the `main.py` file and commit again.\n\n```bash\ncd ~/gcp-course/devops-repo\ngit commit -a -m \"Testing Build Trigger\"\ngit push origin master\n```\n\n### Test your build changes\n\n- Check the build history in CloudBuilds and copy the Image link, format should be gcr.io/qwiklabs-gcp-00-f23112/devops-repoxx34345xx.\n- Create a new compute engine with the new tag and allow http traffic" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_007_building_a_devops_pipeline__python/main.py", "content": "from flask import Flask, render_template, request\napp = Flask(__name__)\n@app.route(\"/\")\ndef main():\n model = {\"title\": \"Hello DevOps Fans.\"}\n return render_template('index.html', model=model)\nif __name__ == \"__main__\":\n app.run(host='0.0.0.0', port=8080, debug=True, threaded=True)" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_007_building_a_devops_pipeline__python/requirements.txt", "content": "Flask==2.0.3" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_007_building_a_devops_pipeline__python/templates/index.html", "content": "{% extends \"layout.html\" %}\n{% block content %}\n
\n
\n

{{model.title}}

\n
\n
\n{% endblock %}" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_007_building_a_devops_pipeline__python/templates/layout.html", "content": "\n\n\n {{model.title}}\n \n \n\n\n
\n {% block content %}{% endblock %}\n
\n
\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_008_deploying_app_to_app_engine_and_gke_and_cloudrun/Dockerfile", "content": "FROM python:3.7\nWORKDIR /app\nCOPY . .\nRUN pip install gunicorn\nRUN pip install -r requirements.txt\nENV PORT=8080\nCMD exec gunicorn --bind :$PORT --workers 1 --threads 8 main:app" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_008_deploying_app_to_app_engine_and_gke_and_cloudrun/ReadMe.md", "content": "# Deploying same Python app to AppEngine, GKE, CloudRun\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n## Objective\n\n![img.png](.images/arch-objective.png)\n\n```bash\ndocker build -t test-python .\n\ndocker run --rm -p 8080:8080 test-python\n```\n\n- Web Preview\n\n## Deploy to App Engine\n\n- Create file app.yaml\n\n```bash\n# create App Engine application \ngcloud app create --region=us-central\n\n# Deploy the app using\ngcloud app deploy --version=one --quiet\n```\n\n- Navigate to App Engine dashboard\n- Click on the URL\n- Make changes in the `main.py` and run the following\n\n```bash\n# The --no-promote parameter tells App Engine to continue serving requests with the old version\ngcloud app deploy --version=two --no-promote --quiet\n```\n\n- Now visit the URL again. You should see the same version of code.\n- Go to versions in the console \n- Click on version 2 link to test it.\n\n- Select split traffic and change to version 2 and save\n- Visit the URL again and refresh\n\n## Deploy the Kubernetes\n\n- Create Manual k8s cluster with all defaults set\n- Connect to the cluster\n\n```bash\nkubectl get nodes\n```\n\n- Make changes in `main.py` and run the following\n\n- Create the k8s-manifests.yaml file\n\n- Enter the following commands to use Cloud Build to create the image and store it in Container Registry\n\n```bash\n# Check the image tag created in the output\ngcloud builds submit --tag gcr.io/$DEVSHELL_PROJECT_ID/devops-image:v0.2 .\n\n# Replace this tag in the k8s-manifests.yaml\n```\n\n- Apply the changes\n\n```bash\nkubectl apply -f k8s-manifests.yaml\n\nkubectl get pods\n\nkubectl get svc\n```\n\n- Visit the external IP created by the service\n\n## Deploy to CloudRun\n\n- Make changes in the `main.py` file\n\n- Trigger build in CloudBuild\n\n```bash\ngcloud builds submit --tag gcr.io/$DEVSHELL_PROJECT_ID/cloud-run-image:v0.1 .\n```\n\n- Go to Cloudrun in the console\n\n- Give `Service name` as `hello-cloud-run` \n- Autoscaling max 6\n- Authentication as `Allow unauthenticated invocations`\n- Keep the `Container, Connections, Security ` as Default\n- Create\n- Visit the URL created\n\n\n\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_008_deploying_app_to_app_engine_and_gke_and_cloudrun/app.yaml", "content": "# For AppEngine\nruntime: python37" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_008_deploying_app_to_app_engine_and_gke_and_cloudrun/k8s-manifests.yaml", "content": "---\napiVersion: apps/v1\nkind: Deployment\nmetadata:\n name: devops-deployment\n labels:\n app: devops\n tier: frontend\nspec:\n replicas: 3\n selector:\n matchLabels:\n app: devops\n tier: frontend\n template:\n metadata:\n labels:\n app: devops\n tier: frontend\n spec:\n containers:\n - name: devops-demo\n image: \n ports:\n - containerPort: 8080\n---\napiVersion: v1\nkind: Service\nmetadata:\n name: devops-deployment-lb\n labels:\n app: devops\n tier: frontend-lb\nspec:\n type: LoadBalancer\n ports:\n - port: 80\n targetPort: 8080\n selector:\n app: devops\n tier: frontend" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_008_deploying_app_to_app_engine_and_gke_and_cloudrun/main.py", "content": "from flask import Flask, render_template, request\napp = Flask(__name__)\n@app.route(\"/\")\ndef main():\n model = {\"title\": \"Hello DevOps Fans.\"}\n return render_template('index.html', model=model)\nif __name__ == \"__main__\":\n app.run(host='0.0.0.0', port=8080, debug=True, threaded=True)" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_008_deploying_app_to_app_engine_and_gke_and_cloudrun/requirements.txt", "content": "Flask==2.0.3" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_008_deploying_app_to_app_engine_and_gke_and_cloudrun/templates/index.html", "content": "{% extends \"layout.html\" %}\n{% block content %}\n
\n
\n

{{model.title}}

\n
\n
\n{% endblock %}" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_008_deploying_app_to_app_engine_and_gke_and_cloudrun/templates/layout.html", "content": "\n\n\n {{model.title}}\n \n \n\n\n
\n {% block content %}{% endblock %}\n
\n
\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_008_deploying_app_to_app_engine_and_gke_and_cloudrun__python/Dockerfile", "content": "FROM python:3.7\nWORKDIR /app\nCOPY . .\nRUN pip install gunicorn\nRUN pip install -r requirements.txt\nENV PORT=8080\nCMD exec gunicorn --bind :$PORT --workers 1 --threads 8 main:app" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_008_deploying_app_to_app_engine_and_gke_and_cloudrun__python/ReadMe.md", "content": "# Deploying same Python app to AppEngine, GKE, CloudRun\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n**High Level Objectives**\n- Create a minimal python app, dockerize the app \n- Deploy to App Engine \n- Deploy to Kubernetes Engine \n- Deploy to Cloud Run\n\n\n\n**Skills**\n- gcp\n- python\n- docker\n- kubernetes\n- cloud run\n- app engine\n- cloud build\n\n\n![img.png](.images/arch-objective.png)\n\n```bash\ndocker build -t test-python .\n\ndocker run --rm -p 8080:8080 test-python\n```\n\n- Web Preview\n\n## Deploy to App Engine\n\n- Create file app.yaml\n\n```bash\n# create App Engine application \ngcloud app create --region=us-central\n\n# Deploy the app using\ngcloud app deploy --version=one --quiet\n```\n\n- Navigate to App Engine dashboard\n- Click on the URL\n- Make changes in the `main.py` and run the following\n\n```bash\n# The --no-promote parameter tells App Engine to continue serving requests with the old version\ngcloud app deploy --version=two --no-promote --quiet\n```\n\n- Now visit the URL again. You should see the same version of code.\n- Go to versions in the console \n- Click on version 2 link to test it.\n\n- Select split traffic and change to version 2 and save\n- Visit the URL again and refresh\n\n## Deploy the Kubernetes\n\n- Create Manual k8s cluster with all defaults set\n- Connect to the cluster\n\n```bash\nkubectl get nodes\n```\n\n- Make changes in `main.py` and run the following\n\n- Create the k8s-manifests.yaml file\n\n- Enter the following commands to use Cloud Build to create the image and store it in Container Registry\n\n```bash\n# Check the image tag created in the output\ngcloud builds submit --tag gcr.io/$DEVSHELL_PROJECT_ID/devops-image:v0.2 .\n\n# Replace this tag in the k8s-manifests.yaml\n```\n\n- Apply the changes\n\n```bash\nkubectl apply -f k8s-manifests.yaml\n\nkubectl get pods\n\nkubectl get svc\n```\n\n- Visit the external IP created by the service\n\n## Deploy to CloudRun\n\n- Make changes in the `main.py` file\n\n- Trigger build in CloudBuild\n\n```bash\ngcloud builds submit --tag gcr.io/$DEVSHELL_PROJECT_ID/cloud-run-image:v0.1 .\n```\n\n- Go to Cloudrun in the console\n\n- Give `Service name` as `hello-cloud-run` \n- Autoscaling max 6\n- Authentication as `Allow unauthenticated invocations`\n- Keep the `Container, Connections, Security ` as Default\n- Create\n- Visit the URL created\n\n\n\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_008_deploying_app_to_app_engine_and_gke_and_cloudrun__python/app.yaml", "content": "# For AppEngine\nruntime: python37" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_008_deploying_app_to_app_engine_and_gke_and_cloudrun__python/k8s-manifests.yaml", "content": "---\napiVersion: apps/v1\nkind: Deployment\nmetadata:\n name: devops-deployment\n labels:\n app: devops\n tier: frontend\nspec:\n replicas: 3\n selector:\n matchLabels:\n app: devops\n tier: frontend\n template:\n metadata:\n labels:\n app: devops\n tier: frontend\n spec:\n containers:\n - name: devops-demo\n image: \n ports:\n - containerPort: 8080\n---\napiVersion: v1\nkind: Service\nmetadata:\n name: devops-deployment-lb\n labels:\n app: devops\n tier: frontend-lb\nspec:\n type: LoadBalancer\n ports:\n - port: 80\n targetPort: 8080\n selector:\n app: devops\n tier: frontend" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_008_deploying_app_to_app_engine_and_gke_and_cloudrun__python/main.py", "content": "from flask import Flask, render_template, request\napp = Flask(__name__)\n@app.route(\"/\")\ndef main():\n model = {\"title\": \"Hello DevOps Fans.\"}\n return render_template('index.html', model=model)\nif __name__ == \"__main__\":\n app.run(host='0.0.0.0', port=8080, debug=True, threaded=True)" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_008_deploying_app_to_app_engine_and_gke_and_cloudrun__python/requirements.txt", "content": "Flask==2.0.3" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_008_deploying_app_to_app_engine_and_gke_and_cloudrun__python/templates/index.html", "content": "{% extends \"layout.html\" %}\n{% block content %}\n
\n
\n

{{model.title}}

\n
\n
\n{% endblock %}" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_008_deploying_app_to_app_engine_and_gke_and_cloudrun__python/templates/layout.html", "content": "\n\n\n {{model.title}}\n \n \n\n\n
\n {% block content %}{% endblock %}\n
\n
\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_009_monitoring_applications_in_gcp__python/Dockerfile", "content": "FROM python:3.7\nWORKDIR /app\nCOPY . .\nRUN pip install gunicorn\nRUN pip install -r requirements.txt\nENV PORT=8080\nCMD exec gunicorn --bind :$PORT --workers 1 --threads 8 main:app" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_009_monitoring_applications_in_gcp__python/ReadMe.md", "content": "# Monitoring Applications in GCP\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n**High Level Objectives**\n- Deploy and test the python app locally on gcp console \n- Deploy an application to App Engine and examine the Cloud logs\n- View the Profiler Information\n- Explore Cloud Trace\n- Monitor resources using Dashboards\n- Create uptime checks and alerts\n\n**Skills**\n- gcp\n- python\n- docker\n- app engine\n- cloud build\n- cloud profiler\n- cloud trace\n- cloud monitoring\n- cloud logging\n- cloud uptime checks\n- cloud alerting\n- cloud dashboards\n\n\n### Deploy and test the python app locally on gcp console\n\n\n- Run the following in google cloud shell\n\n```bash\n# confirm that you are authenticated\ngcloud auth list\n\n# to confirm that you are using the correct project for this lab\ngcloud config list project\n```\n\n- Create folder\n\n```bash\nmkdir gcp-logging\ncd gcp-logging\n\n# Create the required files over here \n```\n\n- Enable API\n\n```bash\n# Profiler has to be enabled in the project\ngcloud services enable cloudprofiler.googleapis.com\n```\n\n- Build and test locally\n\n```bash\ndocker build -t test-python .\n\ndocker run --rm -p 8080:8080 test-python\n\n# Check the web Preview now\n```\n\n\n### Deploy an application to App Engine and examine the Cloud logs\n\n\n```bash\n# Create app engine\ngcloud app create --region=us-central\n\n# deploy your app\ngcloud app deploy --version=one --quiet\n```\n\n- Check the App Engine URL\n- Go to `Tools` and check the `Logs`. Logs should indicate that Profiler has started and profiles are being generated\n\n\n### View the Profiler Information\n\n- Go the `Profiler`. Check the current insights.\n- Start compute instance in any region other than `us-central1`\n- SSH\n\n```bash\nsudo apt update\nsudo apt install apache2-utils -y\nnohup ab -n 1000 -c 10 https://.appspot.com/ > nohup1.out &\nnohup ab -n 1000 -c 10 https://.appspot.com/ > nohup2.out &\nnohup ab -n 1000 -c 10 https://.appspot.com/ > nohup3.out &\n```\n\n- Now go back to `Profiler` and check again\n\n### Explore Cloud Trace\n\n- Go to `Trace`\n- SSH\n\n```bash\nnohup ab -n 1000 -c 10 https://.appspot.com/ > nohup4.out &\nnohup ab -n 1000 -c 10 https://.appspot.com/ > nohup5.out &\nnohup ab -n 1000 -c 10 https://.appspot.com/ > nohup6.out &\n```\n\n### Monitor resources using Dashboards\n\n- Go to `Monitoring` -> `Dashboards`\n- Check `App Engine` dashboard\n- Check `VM Instances` dashboard\n- Click on `Create Dashboard`\n\n### Create uptime checks and alerts\n\n- Select `Uptime Checks`\n\n| Property | Value |\n|-------------------------|-------------------------------|\n| Title | App Engine Uptime Check |\n| App Engine Uptime Check | HTTPS |\n| Hostname | .appspot.com |\n| Resource Type | URL |\n| Path | / |\n| Check Frequency | 1 minute |\n\n\n- `Test`\n- Alert and Notification `Uptime Check Alert`\n- Create `Notification channels`\n- Create one with `temp-email` [https://temp-mail.org/en/](https://temp-mail.org/en)\n- Save\n- Navigate to `App Engine` and `Disable application`. Check URL, it should work anymore\n- Return to `Monitoring` and click `Uptime checks`. It should be `Failing`\n- Click `Alerting`, An incident should be fired. Check your email.\n- Now enable application in `AppEngine`. Everything should be resolved. Check your email." }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_009_monitoring_applications_in_gcp__python/app.yaml", "content": "# For AppEngine\nruntime: python37" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_009_monitoring_applications_in_gcp__python/main.py", "content": "from flask import Flask, render_template, request\nimport googlecloudprofiler\n\n\napp = Flask(__name__)\n@app.route(\"/\")\ndef main():\n model = {\"title\": \"Hello DevOps Fans.\"}\n return render_template('index.html', model=model)\n\n# This code simply turns Profiler on. Once on, Profiler starts reporting application metrics to Google Cloud\ntry:\n googlecloudprofiler.start(verbose=3)\nexcept (ValueError, NotImplementedError) as exc:\n print(exc)\n\nif __name__ == \"__main__\":\n app.run(host='0.0.0.0', port=8080, debug=True, threaded=True)\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_009_monitoring_applications_in_gcp__python/requirements.txt", "content": "Flask==2.0.3\nitsdangerous==2.0.1\nJinja2==3.0.3\ngoogle-cloud-profiler==3.0.6\nprotobuf==3.20.1" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_009_monitoring_applications_in_gcp__python/templates/index.html", "content": "{% extends \"layout.html\" %}\n{% block content %}\n
\n
\n

{{model.title}}

\n
\n
\n{% endblock %}" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_009_monitoring_applications_in_gcp__python/templates/layout.html", "content": "\n\n\n {{model.title}}\n \n \n\n\n
\n {% block content %}{% endblock %}\n
\n
\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_010_alerting_in_google_cloud/ReadMe.md", "content": "# Alerting in Google Cloud\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n## Objectives\n\nDownload a sample app from GitHub.\n\nDeploy an application to App Engine.\n\nCreate uptime checks and alerts.\n\nCreate an alerting policy with the CLI." }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_010_alerting_in_google_cloud__python/Dockerfile", "content": "FROM python:3.7\nWORKDIR /app\nCOPY . .\nRUN pip install gunicorn\nRUN pip install -r requirements.txt\nENV PORT=8080\nCMD exec gunicorn --bind :$PORT --workers 1 --threads 8 main:app" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_010_alerting_in_google_cloud__python/ReadMe.md", "content": "# Alerting in Google Cloud - Python App - App Engine\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n**High Level Objectives**\n- Run the app locally on gcp console\n- Deploy to App Engine\n- Examine the App Engine Logs\n- Create an App Engine latency alert\n- Creating an Alerting Policy with the CLI\n\n\n\n**Skills**\n- gcp\n- python\n- app engine\n- app engine logs\n- alerting\n- alerting policy\n\n\n\n### Run the app locally on gcp console\n\n```bash\nsudo pip3 install -r requirements.txt\npython3 main.py\n```\n\n- Web Preview\n\n### Deploy to App Engine\n\n- Create file app.yaml\n\n```bash\n# create App Engine application \ngcloud app create --region=us-central\n\n# Deploy the app using\ngcloud app deploy --version=one --quiet\n```\n\n- Navigate to App Engine dashboard\n- Click on the URL\n\n\n### Examine the App Engine Logs\n\n- `Tools` -> `Logs`\n\n### Create an App Engine latency alert\n\n#### Check current application latency in Metrics explorer\n\n\n- `Monitoring` > `Metrics explorer` \n- `Resource & Metric` > `GAE Application` > `Http` > `Response latency` (Wait and hard refresh the page if required)\n- `Aggregator` to `mean`\n- Advanced options : `Aligner` to `99th percentile`\n\nThis show the average time it took our application to return a response to the fastest 99% of requests, cutting off 1% of anomalies.\n\n\n#### Create an alert based on the same metric\n\n- `Monitoring` > `Alerting`\n- Add new notification channel. Give temporary email [temp-mail.org](https://temp-mail.org/en/)\n- `Alerting` > `Create Policy`\n- `Select a metric` > `Resource & Metric` > `GAE Application` > `Http` > `Response latency` (Wait and hard refresh the page if required)\n- `Apply` > Set `rolling window` to `1 min`\n- `Any time series violates` the `Condition` `is above` a Threshold of `8000`ms, it should trigger an alert.\n- Set `condition name` to `Response latency [MEAN] for 99th% over 8s`\n- Next and select notification channel\n- Name the alert `Hello too slow` > `Next` > `Create Policy`\n\n- Run this on the gcp console\n\n```bash\nwhile true; do curl -s https://$DEVSHELL_PROJECT_ID.appspot.com/sleepy200 | grep -e \"\" -e \"sleep\";sleep .$[( $RANDOM % 10 )]s;done\n```\n- Check after 5 mins - `Monitoring` > `Alerting`\n- Check temp email. \n- `Acknowledge Incident` and see the difference\n\n\n### Creating an Alerting Policy with the CLI\n\n- Run on gcp console\n\n```bash\ngcloud alpha monitoring policies create --policy-from-file=\"app-engine-error-percent-policy.json\"\n```\n- Check the new policy created in console\n- Run \n\n```bash\nwhile true; do curl -s https://$DEVSHELL_PROJECT_ID.appspot.com/random500error | grep -e \"<title>\" -e \"error\";sleep .$[( $RANDOM % 10 )]s;done\n```\n\n- `Monitoring` > `Alerting`, wait another few minutes.\n- Check your temp email agin" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_010_alerting_in_google_cloud__python/app-engine-error-percent-policy.json", "content": "{\n \"displayName\": \"HTTP error count exceeds 1 percent for App Engine apps\",\n \"combiner\": \"OR\",\n \"conditions\": [\n {\n \"displayName\": \"Ratio: HTTP 500s error-response counts / All HTTP response counts\",\n \"conditionThreshold\": {\n \"filter\": \"metric.label.response_code>=\\\"500\\\" AND metric.label.response_code<\\\"600\\\" AND metric.type=\\\"appengine.googleapis.com/http/server/response_count\\\" AND resource.type=\\\"gae_app\\\"\",\n \"aggregations\": [\n {\n \"alignmentPeriod\": \"60s\",\n \"crossSeriesReducer\": \"REDUCE_SUM\",\n \"groupByFields\": [\n \"project\",\n \"resource.label.module_id\",\n \"resource.label.version_id\"\n ],\n \"perSeriesAligner\": \"ALIGN_DELTA\"\n }\n ],\n \"denominatorFilter\": \"metric.type=\\\"appengine.googleapis.com/http/server/response_count\\\" AND resource.type=\\\"gae_app\\\"\",\n \"denominatorAggregations\": [\n {\n \"alignmentPeriod\": \"60s\",\n \"crossSeriesReducer\": \"REDUCE_SUM\",\n \"groupByFields\": [\n \"project\",\n \"resource.label.module_id\",\n \"resource.label.version_id\"\n ],\n \"perSeriesAligner\": \"ALIGN_DELTA\"\n }\n ],\n \"comparison\": \"COMPARISON_GT\",\n \"thresholdValue\": 0.01,\n \"duration\": \"0s\",\n \"trigger\": {\n \"count\": 1\n }\n }\n }\n ]\n}" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_010_alerting_in_google_cloud__python/app.yaml", "content": "# For AppEngine\nruntime: python37" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_010_alerting_in_google_cloud__python/main.py", "content": "import time\nimport random\nimport json\nfrom flask import Flask, render_template, request\n\napp = Flask(__name__)\n\n@app.route(\"/\")\ndef home():\n model = {\"title\": \"Hello DevOps Fans.\"}\n return render_template('index.html', model=model)\n\n# when you want to have 10 seconds delay in response\n@app.route(\"/sleepy200\")\ndef sleepy200():\n model = {\"title\": \"Hello DevOps Fans. I just woke up from sleep\"}\n time.sleep(10)\n return render_template('index.html', model=model)\n\n\n# The route should give random 500 error\n@app.route(\"/random500error\")\ndef random500():\n num = random.randrange(20)\n if num == 0:\n return json.dumps({\"error\": 'Error thrown randomly'}), 500\n else:\n model = {\"title\": \"Still 200 OK, try again :) .\"}\n return render_template('index.html', model=model)\n\nif __name__ == \"__main__\":\n app.run(host='0.0.0.0', port=8080, debug=True, threaded=True)" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_010_alerting_in_google_cloud__python/requirements.txt", "content": "Flask==2.0.3" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_010_alerting_in_google_cloud__python/templates/index.html", "content": "{% extends \"layout.html\" %}\n{% block content %}\n<div class=\"jumbotron\">\n <div class=\"container\">\n <h1>{{model.title}}</h1>\n </div>\n</div>\n{% endblock %}" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_010_alerting_in_google_cloud__python/templates/layout.html", "content": "<!doctype html>\n<html lang=\"en\">\n<head>\n <title>{{model.title}}\n \n \n\n\n
\n {% block content %}{% endblock %}\n
\n
\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_011_service_monitoring__node/ReadMe.md", "content": "# Service Monitoring\n\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n[haggman/HelloLoggingNodeJS.git](https://github.com/haggman/HelloLoggingNodeJS.git)\n\n**High Level Objectives**\n- Deploy the test nodejs app \n- Use Service Monitoring to create an availability SLO\n- Create an alert tied to your SLO\n- Trigger the alert\n\n**Skills**\n- gcp\n- nodejs\n- app engine\n- app engine logs\n- alerting\n- service monitoring\n- service level objective\n- error budget\n- error reporting\n- monitoring\n\n\n### Deploy the test nodejs app\n\n- Clone the repo\n\n```bash\ngit clone https://github.com/haggman/HelloLoggingNodeJS.git\n\ncd HelloLoggingNodeJS\n```\n\n- Create new App Engine app\n\n```bash\ngcloud app create --region=us-central\n```\n- Deploy the Hello Logging app to App Engine\n\n```bash\ngcloud app deploy\n```\n\n- Test the URL\n\n### Use Service Monitoring to create an availability SLO, Create an alert tied to your SLO\n\n- Place some load on application\n\n```bash\n# The loop generates ten requests per second. \n# The URL is to the /random-error route, which generates an error about every 1000 requests, \n# so you should see approximately 1 error every 100s.\nwhile true; \\\ndo curl -s https://$DEVSHELL_PROJECT_ID.appspot.com/random-error \\\n-w '\\n' ;sleep .1s;done\n```\n\n- `App Engine` > `Dashboard`\n- Check `Server Errors`\n- Navigation menu to go to `Error Reporting`. Notice the error is also being caught here\n- Navigation menu to go to `Monitoring` > `Services` > `default` > `+Create SLO` \n - `Availability` to `Request based`\n - `Period type` to `Rolling` and `Period Length` to `7 days`\n - Set `Goal` to `99.5%`\n - Create\n\n\n\n### Create an alert tied to your SLO\n\n- Expand the new SLO and investigate the information it displays\n- Check three tabs, `Service level indicator`, `Error budget`, and `Alerts firing`\n- `Alerts firing` > `CREATE SLO ALERT`\n- `Display Name` to `Really short window test`\n- `Lookback duration` to `10` minutes and `burn rate threshold` to `1.5`\n- Create notification channel and select it\n- Next and create\n\n\n\n### Trigger the alert\n\n- In the `index.js` file\n - Scroll to the /random-error route found at approximately line 126 and modify the value next to Math.random from 1000 to 20\n- Run\n\n```bash\ngcloud app deploy\n\nwhile true; \\\ndo curl -s https://$DEVSHELL_PROJECT_ID.appspot.com/random-error \\\n-w '\\n' ;sleep .1s;done\n```\n\n- Wait for sometime and notice the new alert triggered." }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_011_service_monitoring__node_app/ReadMe.md", "content": "# Service Monitoring\n\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n[haggman/HelloLoggingNodeJS.git](https://github.com/haggman/HelloLoggingNodeJS.git)\n\n## High Level Objectives\n\n- Deploy the test nodejs app \n- Use Service Monitoring to create an availability SLO\n- Create an alert tied to your SLO\n- Trigger the alert\n\n### Deploy the test nodejs app\n\n- Clone the repo\n\n```bash\ngit clone https://github.com/haggman/HelloLoggingNodeJS.git\n\ncd HelloLoggingNodeJS\n```\n\n- Create new App Engine app\n\n```bash\ngcloud app create --region=us-central\n```\n- Deploy the Hello Logging app to App Engine\n\n```bash\ngcloud app deploy\n```\n\n- Test the URL\n\n### Use Service Monitoring to create an availability SLO, Create an alert tied to your SLO\n\n- Place some load on application\n\n```bash\n# The loop generates ten requests per second. \n# The URL is to the /random-error route, which generates an error about every 1000 requests, \n# so you should see approximately 1 error every 100s.\nwhile true; \\\ndo curl -s https://$DEVSHELL_PROJECT_ID.appspot.com/random-error \\\n-w '\\n' ;sleep .1s;done\n```\n\n- `App Engine` > `Dashboard`\n- Check `Server Errors`\n- Navigation menu to go to `Error Reporting`. Notice the error is also being caught here\n- Navigation menu to go to `Monitoring` > `Services` > `default` > `+Create SLO` \n - `Availability` to `Request based`\n - `Period type` to `Rolling` and `Period Length` to `7 days`\n - Set `Goal` to `99.5%`\n - Create\n\n\n\n### Create an alert tied to your SLO\n\n- Expand the new SLO and investigate the information it displays\n- Check three tabs, `Service level indicator`, `Error budget`, and `Alerts firing`\n- `Alerts firing` > `CREATE SLO ALERT`\n- `Display Name` to `Really short window test`\n- `Lookback duration` to `10` minutes and `burn rate threshold` to `1.5`\n- Create notification channel and select it\n- Next and create\n\n\n\n### Trigger the alert\n\n- In the `index.js` file\n - Scroll to the /random-error route found at approximately line 126 and modify the value next to Math.random from 1000 to 20\n- Run\n\n```bash\ngcloud app deploy\n\nwhile true; \\\ndo curl -s https://$DEVSHELL_PROJECT_ID.appspot.com/random-error \\\n-w '\\n' ;sleep .1s;done\n```\n\n- Wait for sometime and notice the new alert triggered." }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_012_monitoring_and_dashboarding_multiple_projects_from_a_single_workspace/ReadMe.md", "content": "# Monitoring and Dashboarding Multiple Projects from a Single Workspace\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n## High Level Objectives\n\n- Configure Resource Projects\n- Create a Monitoring Workspace and link the two worker projects into it\n- Create and configure Monitoring groups\n- Create and test an uptime check\n\n\nWe need to have 3 different Projects.\nThe first project (ID 1) will be the monitoring workspace host project. \nProjects ID 2 and ID 3 will be the monitored/resource projects. \nPer Google's recommended best practices, the project we use to host the monitoring workspace will not be one of the projects actually housing monitored resources.\n\n\n### Configure Resource Projects\n\n- Label Project ID 1 as Monitoring Project.\n- Label Project ID 2 as Worker 1.\n- Label Project ID 3 as Worker 2.\n\n- Launch `NGINX Open Source Packaged by Bitnami` from `Marketplace` in `Worker 1` and `Worker 2` projects\n\n### Create a Monitoring Workspace and link the two worker projects into it\n\n- Go to `Monitoring Project`\n- `Monitoring` > `Overview` > `Settings`\n- Add `Worker 1` and `Worker 2`\n- Choose `Use this project as the scoping project`\n- Save and go to `Dashboards`. Take few minutes for explore.\n\n### Create and configure Monitoring groups\n- Go to each `Worker` Project\n- Assign labels to both VMs in `Worker 1` and `Worker 2`\n - `component:frontend`\n - `stage:dev/test`\n\n- Create Resource Group\n- `Monitoring` > `Groups` > `Create` > Name : Frontend Servers\n- Give `component` = `frontend` criteria. You should see 2 instances\n- Create a `Sub Group`, Keep the first criteria as same. Give second as `stage` = `dev`\n- Check the UI when done\n\n### Create and test an uptime check\n\n- Create an uptime check for the Frontend Servers group\n- Check out how an uptime check handles failure\n- What can Cloud Monitoring, Logging, and Alerting tell us?\n\n### Create a custom dashboard\n\n- Create a developer dashboard and add an uptime chart to it\n- Add and test a CPU utilization chart to the dashboard\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_012_monitoring_and_dashboarding_multiple_projects_from_a_single_workspace__nginx/ReadMe.md", "content": "# Monitoring and Dashboarding Multiple Projects from a Single Workspace\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n**High Level Objectives**\n- Configure Resource Projects\n- Create a Monitoring Workspace and link the two worker projects into it\n- Create and configure Monitoring groups\n- Create and test an uptime check\n\n\n**Skills**\n- gcp\n- monitoring\n- dashboarding\n- multiple projects\n- monitoring groups\n- uptime check\n\n\nWe need to have 3 different Projects.\nThe first project (ID 1) will be the monitoring workspace host project. \nProjects ID 2 and ID 3 will be the monitored/resource projects. \nPer Google's recommended best practices, the project we use to host the monitoring workspace will not be one of the projects actually housing monitored resources.\n\n\n### Configure Resource Projects\n\n- Label Project ID 1 as Monitoring Project.\n- Label Project ID 2 as Worker 1.\n- Label Project ID 3 as Worker 2.\n\n- Launch `NGINX Open Source Packaged by Bitnami` from `Marketplace` in `Worker 1` and `Worker 2` projects\n\n### Create a Monitoring Workspace and link the two worker projects into it\n\n- Go to `Monitoring Project`\n- `Monitoring` > `Overview` > `Settings`\n- Add `Worker 1` and `Worker 2`\n- Choose `Use this project as the scoping project`\n- Save and go to `Dashboards`. Take few minutes for explore.\n\n### Create and configure Monitoring groups\n- Go to each `Worker` Project\n- Assign labels to both VMs in `Worker 1` and `Worker 2`\n - `component:frontend`\n - `stage:dev/test`\n\n- Create Resource Group\n- `Monitoring` > `Groups` > `Create` > Name : Frontend Servers\n- Give `component` = `frontend` criteria. You should see 2 instances\n- Create a `Sub Group`, Keep the first criteria as same. Give second as `stage` = `dev`\n- Check the UI when done\n\n### Create and test an uptime check\n\n- Create an uptime check for the Frontend Servers group\n- Check out how an uptime check handles failure\n- What can Cloud Monitoring, Logging, and Alerting tell us?\n\n### Create a custom dashboard\n\n- Create a developer dashboard and add an uptime chart to it\n- Add and test a CPU utilization chart to the dashboard\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_013_compute_logging_and_monitoring/ReadMe.md", "content": "# Compute Logging And Monitoring\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n**High Level Objectives**\n- Set up a VM and a GKE cluster.\n- Install and use the logging and monitoring agents for Compute Engine.\n- Add a service to the GKE cluster and examine its logs and metrics.\n\n**Skills**\n- gcp\n- vm\n- gke\n- logging agent\n- monitoring agent\n- logs and metrics\n\n\n### Set up a VM and a GKE cluster\n\nCreate VM\n\n- Name : `web-server-vm`\n- Boot Disk : `Debian GNU/Linux 10 (buster)`\n- `Allow HTTP traffic`\n- SSH\n\n```bash\nsudo apt-get update\nsudo apt-get install nginx\nsudo nginx -v\n\nURL=URL_to_your_server\n\nwhile true; do curl -s $URL | grep -oP \".*\"; \\\nsleep .1s;done\n\n# Check to make sure you have the requisite scopes to perform logging and monitoring.\n\n# We need logging.write and monitoring.write\ncurl --silent --connect-timeout 1 -f -H \"Metadata-Flavor: Google\" \\\nhttp://169.254.169.254/computeMetadata/v1/instance/service-accounts/default/scopes\n\n# Download the script, add the monitoring agent repo to apt, and install the agent.\ncurl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh\nsudo bash add-monitoring-agent-repo.sh --also-install\n\n# Start the monitoring agent:\nsudo service stackdriver-agent start\n\n# Install the logging agent:\ncurl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh\nsudo bash add-logging-agent-repo.sh --also-install\n\n# Check status of both\nsudo service google-fluentd status\nsudo service stackdriver-agent status\n\n# To fully integrate the server, you enable the status information handler in \n\n# Nginx by adding a configuration file to the Nginx configuration directory:\n(cd /etc/nginx/conf.d/ && sudo curl -O https://raw.githubusercontent.com/Stackdriver/stackdriver-agent-service-configs/master/etc/nginx/conf.d/status.conf)\n\n# Reload nginx service\nsudo service nginx reload\n\n# Enable the Nginx monitoring plugin:\n(cd /opt/stackdriver/collectd/etc/collectd.d/ && sudo curl -O https://raw.githubusercontent.com/Stackdriver/stackdriver-agent-service-configs/master/etc/collectd.d/nginx.conf)\n\n# Restart the monitoring agent\nsudo service stackdriver-agent restart\n```\n\nCreate GKE Cluster\n\n- Name : `gke-cluster`\n\n### Use the logging and monitoring agents for Compute Engine\n\n- Monitoring > Metrics Explorer\n- Resource & Metric : VM Instance > Instance > CPU utilization\n - Filter instance_name = web-server-vm : Apply\n\n- Resource & Metric : VM Instance > nginx > Requests : Apply\n\n### Add a service to the GKE cluster and examine its logs and metrics\n\n- Cloud Shell\n\n```bash\n# Enable the Cloud Build API as it is needed in a few steps\ngcloud services enable cloudbuild.googleapis.com\n\ngit clone https://github.com/haggman/HelloLoggingNodeJS.git\n\n# Take a few mins to check the code\n\n# Submit the Dockerfile to Google's Cloud Build to generate a container and store it in your Container Registry:\ngcloud builds submit --tag gcr.io/$DEVSHELL_PROJECT_ID/hello-logging-js .\n\n# Edit k8sapp.yaml and replace the $GCLOUD_PROJECT with actual ID\n\n# Connect to cluster and\nkubectl apply -f k8sapp.yaml\n\nkubectl get services\n\nURL=url_to_k8s_app\nwhile true; do curl -s $URL -w \"\\n\"; sleep .1s;done\n```\n\n\n- Monitoring > Dashboards > GKE > VIEW ALL and enable Sparklines and click Apply\n- Switch to the Workloads tab. This is focused on the deployed workloads, grouped by namespace\n- Finally, scroll to the Kubernetes Services tab and expand hello-logging-service\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_014_log_analysis/ReadMe.md", "content": "# Log Analysis\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n## High Level Objectives\n\n- Set up and deploy a test application.\n- Explore the log entries generated by the test application.\n- Create and use a logs-based metric.\n- Export application logs to BigQuery.\n\n### Set up and deploy a test application.\n\n- Enable APIs\n\n```bash\ngcloud services enable cloudbuild.googleapis.com \\\nrun.googleapis.com \\\ncompute.googleapis.com \\\ncloudprofiler.googleapis.com\n```\n\n\n- Clone\n\n```bash\ngit clone https://github.com/haggman/HelloLoggingNodeJS.git\n```\n\n- Change error rate\n\n```node\n//Generates an uncaught exception every 20 requests\napp.get('/random-error', (req, res) => {\n error_rate = parseInt(req.query.error_rate) || 20\n let errorNum = (Math.floor(Math.random() * error_rate) + 1);\n if (errorNum==1) {\n console.log(\"Called /random-error, and it's about to error\");\n doesNotExist();\n }\n console.log(\"Called /random-error, and it worked\");\n res.send(\"Worked this time.\");\n});\n```\n\n- Build and deploy\n\n```bash\nsh rebuildService.sh\n\n# Set URL ENV\nURL=$(gcloud run services list --platform managed --format=\"value(URL)\" | grep hello-logging)\n\necho $URL\n\n# Add some traffic\nwhile true; \\\ndo curl -s $URL/random-error \\\n-w '\\n' ;sleep .1s;done\n```\n\n\n### Explore the log files for a test application\n\n- Cloud Run Revision > hello-logging\n\n\n### Create and use a logs-based metric\n\n- Modify while loop to hit different endpoint\n\n```bash\nwhile true; \\\ndo curl -s $URL/score \\\n-w '\\n' ;sleep .1s;done\n```\n\n- Explore the logs generated\n - Cloud Run Revision > hello-logging\n\n- Change the `/score` route with below code.\n - Notice how the message contents are now properties of the output object, and how the printed message is the JSON object stringified.\n\n```node\n//Basic NodeJS app built with the express server\napp.get('/score', (req, res) => {\n //Random score, the contaierID is a UUID unique to each\n //runtime container (testing was done in Cloud Run).\n //funFactor is a random number 1-100\n let score = Math.floor(Math.random() * 100) + 1;\n let output = {\n message: '/score called',\n score: score,\n containerID: containerID,\n funFactor: funFactor\n };\n console.log(JSON.stringify(output));\n //Basic message back to browser\n res.send(`Your score is a ${score}. Happy?`);\n});\n```\n\n- Rebuild and deploy\n\n```bash\nsh rebuildService.sh\n```\n\n- Restart the loop\n\n```bash\nwhile true; \\\ndo curl -s $URL/score \\\n-w '\\n' ;sleep .1s;done\n```\n\n- Explore logs again and examine the new format.\n- Create a score logs-based metric using field `jsonPayload.score`\n- Create Dashboard using this metric\n\n\n### Export application logs to BigQuery\n\n- Modify while loop again\n\n```bash\nwhile true; \\\ndo curl -s $URL/random-error \\\n-w '\\n' ;sleep .1s;done\n```\n\n- Explore logs again and validate the change\n- Create and execute a query to pull just the textPayloads that start with ReferenceError\n\n```roomsql\nSELECT\n textPayload\nFROM\n `[project-id].hello_logging_logs.run_googleapis_com_stderr_[date]`\nWHERE\n textPayload LIKE 'ReferenceError%'\n```\n\n- To do a count, modify the query to count these entries:\n```roomsql\nSELECT\n count(textPayload)\nFROM\n `[project-id].hello_logging_logs.run_googleapis_com_stderr_[date]`\nWHERE\n textPayload LIKE 'ReferenceError%'\n```\n\n- To check the error percentage, build a query that compares the total requests to the ReferenceError% requests.\n\n```roomsql\nSELECT\n errors / total_requests\nFROM (\n SELECT\n (\n SELECT\n COUNT(*)\n FROM\n `[project-id].hello_logging_logs.run_googleapis_com_requests_[date]`) AS total_requests,\n (\n SELECT\n COUNT(textPayload)\n FROM\n `[project-id].hello_logging_logs.run_googleapis_com_stderr_[date]`\n WHERE\n textPayload LIKE 'ReferenceError%') AS errors)\n```" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_014_log_analysis_cloud_run__node/ReadMe.md", "content": "# Log Analysis\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n**High Level Objectives**\n- Set up and deploy a test node application to cloud run.\n- Explore the log entries generated by the test application.\n- Create and use a logs-based metric.\n- Export application logs to BigQuery.\n\n**Skills**\n- gcp\n- cloud run\n- logging\n- metrics\n- bigquery\n- nodejs\n- logs-based metrics\n\n### Set up and deploy a test application.\n\n- Enable APIs\n\n```bash\ngcloud services enable cloudbuild.googleapis.com \\\nrun.googleapis.com \\\ncompute.googleapis.com \\\ncloudprofiler.googleapis.com\n```\n\n\n- Clone\n\n```bash\ngit clone https://github.com/haggman/HelloLoggingNodeJS.git\n```\n\n- Change error rate\n\n```node\n//Generates an uncaught exception every 20 requests\napp.get('/random-error', (req, res) => {\n error_rate = parseInt(req.query.error_rate) || 20\n let errorNum = (Math.floor(Math.random() * error_rate) + 1);\n if (errorNum==1) {\n console.log(\"Called /random-error, and it's about to error\");\n doesNotExist();\n }\n console.log(\"Called /random-error, and it worked\");\n res.send(\"Worked this time.\");\n});\n```\n\n- Build and deploy\n\n```bash\nsh rebuildService.sh\n\n# Set URL ENV\nURL=$(gcloud run services list --platform managed --format=\"value(URL)\" | grep hello-logging)\n\necho $URL\n\n# Add some traffic\nwhile true; \\\ndo curl -s $URL/random-error \\\n-w '\\n' ;sleep .1s;done\n```\n\n\n### Explore the log files for a test application\n\n- Cloud Run Revision > hello-logging\n\n\n### Create and use a logs-based metric\n\n- Modify while loop to hit different endpoint\n\n```bash\nwhile true; \\\ndo curl -s $URL/score \\\n-w '\\n' ;sleep .1s;done\n```\n\n- Explore the logs generated\n - Cloud Run Revision > hello-logging\n\n- Change the `/score` route with below code.\n - Notice how the message contents are now properties of the output object, and how the printed message is the JSON object stringified.\n\n```node\n//Basic NodeJS app built with the express server\napp.get('/score', (req, res) => {\n //Random score, the contaierID is a UUID unique to each\n //runtime container (testing was done in Cloud Run).\n //funFactor is a random number 1-100\n let score = Math.floor(Math.random() * 100) + 1;\n let output = {\n message: '/score called',\n score: score,\n containerID: containerID,\n funFactor: funFactor\n };\n console.log(JSON.stringify(output));\n //Basic message back to browser\n res.send(`Your score is a ${score}. Happy?`);\n});\n```\n\n- Rebuild and deploy\n\n```bash\nsh rebuildService.sh\n```\n\n- Restart the loop\n\n```bash\nwhile true; \\\ndo curl -s $URL/score \\\n-w '\\n' ;sleep .1s;done\n```\n\n- Explore logs again and examine the new format.\n- Create a score logs-based metric using field `jsonPayload.score`\n- Create Dashboard using this metric\n\n\n### Export application logs to BigQuery\n\n- Modify while loop again\n\n```bash\nwhile true; \\\ndo curl -s $URL/random-error \\\n-w '\\n' ;sleep .1s;done\n```\n\n- Explore logs again and validate the change\n- Create and execute a query to pull just the textPayloads that start with ReferenceError\n\n```roomsql\nSELECT\n textPayload\nFROM\n `[project-id].hello_logging_logs.run_googleapis_com_stderr_[date]`\nWHERE\n textPayload LIKE 'ReferenceError%'\n```\n\n- To do a count, modify the query to count these entries:\n```roomsql\nSELECT\n count(textPayload)\nFROM\n `[project-id].hello_logging_logs.run_googleapis_com_stderr_[date]`\nWHERE\n textPayload LIKE 'ReferenceError%'\n```\n\n- To check the error percentage, build a query that compares the total requests to the ReferenceError% requests.\n\n```roomsql\nSELECT\n errors / total_requests\nFROM (\n SELECT\n (\n SELECT\n COUNT(*)\n FROM\n `[project-id].hello_logging_logs.run_googleapis_com_requests_[date]`) AS total_requests,\n (\n SELECT\n COUNT(textPayload)\n FROM\n `[project-id].hello_logging_logs.run_googleapis_com_stderr_[date]`\n WHERE\n textPayload LIKE 'ReferenceError%') AS errors)\n```" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_015_cloud_audit_logs/ReadMe.md", "content": "# Cloud Audit Logs\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n\n## High Level Objectives\n\n- Enable data access logs on Cloud Storage.\n- Generate admin and data access activity.\n- View Audit logs.\n\n### Enable data access logs on Cloud Storage\n\n\n- Navigation Menu > IAM & Admin > Audit Logs.\n- Scroll or use Filter to locate `Google Cloud Storage`, then check the box next to it. This should display the Info Panel with options on LOG TYPE.\n- Select Admin Read, Data Read and Data Write, and then click SAVE.\n\n\n### Generate some admin and data access activity\n\n```bash\n# Use gsutil to create a Cloud Storage bucket with the same name as your project:\ngsutil mb gs://$DEVSHELL_PROJECT_ID\n\n# Make sure the bucket successfully created:\ngsutil ls\n\n# Create a simple \"Hello World\" type of text file and upload it to your bucket:\necho \"Hello World!\" > sample.txt\ngsutil cp sample.txt gs://$DEVSHELL_PROJECT_ID\n\n# Verify the file is in the bucket:\ngsutil ls gs://$DEVSHELL_PROJECT_ID\n\n# Create a new auto mode network named mynetwork, then create a new virtual machine and place it on the new network:\ngcloud compute networks create mynetwork --subnet-mode=auto\ngcloud compute instances create default-us-vm \\\n--zone=us-west4-b --network=mynetwork\n\n# Delete the storage bucket:\ngsutil rm -r gs://$DEVSHELL_PROJECT_ID\n```\n\n### Viewing audit logs\n\n- Navigation menu to navigate to Cloud overview > Activity.\n- Filters pane, click the Activity types, select all, and click OK\n- Click the Resource type > Select GCE Network > OK\n- Navigation menu to navigate to Logging > Logs Explorer.\n- Click the Log name dropdown and use the filter to locate the activity log under CLOUD AUDIT section and Apply it to the query.\n- Log fields explorer to filter to GCS Bucket entries.\n- Expand the delete entry, then drill into protoPayload > authenticationInfo field and notice you can see the email address of the user that performed this action.\n\n\n```bash\ngcloud logging read \\\n\"logName=projects/$DEVSHELL_PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access\"\n```" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_015_cloud_storage_audit_logs/ReadMe.md", "content": "# Cloud Audit Logs\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n\n**High Level Objectives**\n- Enable data access logs on Cloud Storage.\n- Generate admin and data access activity.\n- View Audit logs.\n\n**Skills**\n- gcp\n- gcp-logging\n- access-logs\n- audit-logs\n- cloud-storage\n\n\n### Enable data access logs on Cloud Storage\n\n\n- Navigation Menu > IAM & Admin > Audit Logs.\n- Scroll or use Filter to locate `Google Cloud Storage`, then check the box next to it. This should display the Info Panel with options on LOG TYPE.\n- Select Admin Read, Data Read and Data Write, and then click SAVE.\n\n\n### Generate some admin and data access activity\n\n```bash\n# Use gsutil to create a Cloud Storage bucket with the same name as your project:\ngsutil mb gs://$DEVSHELL_PROJECT_ID\n\n# Make sure the bucket successfully created:\ngsutil ls\n\n# Create a simple \"Hello World\" type of text file and upload it to your bucket:\necho \"Hello World!\" > sample.txt\ngsutil cp sample.txt gs://$DEVSHELL_PROJECT_ID\n\n# Verify the file is in the bucket:\ngsutil ls gs://$DEVSHELL_PROJECT_ID\n\n# Create a new auto mode network named mynetwork, then create a new virtual machine and place it on the new network:\ngcloud compute networks create mynetwork --subnet-mode=auto\ngcloud compute instances create default-us-vm \\\n--zone=us-west4-b --network=mynetwork\n\n# Delete the storage bucket:\ngsutil rm -r gs://$DEVSHELL_PROJECT_ID\n```\n\n### Viewing audit logs\n\n- Navigation menu to navigate to Cloud overview > Activity.\n- Filters pane, click the Activity types, select all, and click OK\n- Click the Resource type > Select GCE Network > OK\n- Navigation menu to navigate to Logging > Logs Explorer.\n- Click the Log name dropdown and use the filter to locate the activity log under CLOUD AUDIT section and Apply it to the query.\n- Log fields explorer to filter to GCS Bucket entries.\n- Expand the delete entry, then drill into protoPayload > authenticationInfo field and notice you can see the email address of the user that performed this action.\n\n\n```bash\ngcloud logging read \\\n\"logName=projects/$DEVSHELL_PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access\"\n```" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_016_analyzing_network_traffic_with_vpc_flow_logs/ReadMe.md", "content": "# Analyzing Network Traffic With VPC Flow Logs\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n**High Level Objectives**\n- Configure a custom network with VPC flow logs\n- Create an Apache web server\n- Verify that network traffic is logged\n- Export the network traffic to BigQuery to further analyze the logs\n- Add VPC flow log aggregation\n\n**Skills**\n- gcp\n- gcp-networking\n- gcp-vpc\n- gcp-vpc-flow-logs\n- gcp-bigquery\n- vpc flow logs aggregation\n- export to bigquery\n\n### Configure a custom network with VPC flow logs\n\n- In the Cloud Console, in the Navigation menu (Navigation menu icon), select VPC network > VPC networks. `vpc-net`\n\n\n| Property | Value |\n|----------|---------|\n| Name | vpc-net |\n\n\n- Subnet creation mode, click Custom\n\n| Property | Value |\n|------------------|-------------|\n| Name | vpc-subnet |\n| Region | us-central1 |\n| IP address range | 10.1.3.0/24 |\n| Flow Logs | On |\n\n\n- Create Firewall Rule\n\n| Property | Value |\n|---------------------|-----------------------------------------------------------------|\n| Name | allow-http-ssh |\n| Network | vpc-net |\n| Targets | Specified target tags |\n| Target tags | http-server |\n| Source filter | IPv4 Ranges |\n| Source IPv4 ranges | 0.0.0.0/0 |\n| Protocols and ports | Specified protocols and ports, and then check tcp, type: 80, 22 |\n\n### Create an Apache web server\n\n- In the Navigation menu, select Compute Engine > VM instances.\n\n| Property | Value |\n|--------------|---------------|\n| Name | web-server |\n| Region | us-central1 |\n| Zone | us-central1-c |\n| Series | N1 |\n| Machine type | f1-micro |\n\n- Click Networking, Disks, Security, Management, Sole-tenancy.\n- For Network tags, type http-server.\n- Specify the following and leave the remaining settings as their defaults:\n\n| Property | Value |\n|------------|--------------------------|\n| Network | vpc-net |\n| Subnetwork | vpc-subnet (10.1.3.0/24) |\n\n\n- Install Apache\n\n```bash\n# In the web-server SSH terminal, update the package index:\nsudo apt-get update\n\n# Install the apache2 package:\nsudo apt-get install apache2 -y\n\n# To create a new default web page by overwriting the default, run the following:\necho '

Hello World!

' | sudo tee /var/www/html/index.html\n```\n\n### Verify that network traffic is logged\n\n- Find your IP address\n- In the Cloud Console, go to Navigation menu > Logging > Logs Explorer.\n\n\n### Export the network traffic to BigQuery to further analyze the logs\n\n- Create an export sink\n- Generate log traffic for BigQuery\n- Note the External IP address for the web-server instance. It will be referred to as EXTERNAL_IP.\n\n```bash\n# Store the EXTERNAL_IP in an environment variable in Cloud Shell:\nexport MY_SERVER=\n\n# Access the web-server 50 times from Cloud Shell:\nfor ((i=1;i<=50;i++)); do curl $MY_SERVER; done\n```\n\n- Visualize the VPC flow logs in BigQuery\n\n- Add the following to the BigQuery Editor and replace your_table_id with TABLE_ID while retaining the accents (`) on both sides:\n\n```roomsql\n#standardSQL\nSELECT\njsonPayload.src_vpc.vpc_name,\nSUM(CAST(jsonPayload.bytes_sent AS INT64)) AS bytes,\njsonPayload.src_vpc.subnetwork_name,\njsonPayload.connection.src_ip,\njsonPayload.connection.src_port,\njsonPayload.connection.dest_ip,\njsonPayload.connection.dest_port,\njsonPayload.connection.protocol\nFROM\n`your_table_id`\nGROUP BY\njsonPayload.src_vpc.vpc_name,\njsonPayload.src_vpc.subnetwork_name,\njsonPayload.connection.src_ip,\njsonPayload.connection.src_port,\njsonPayload.connection.dest_ip,\njsonPayload.connection.dest_port,\njsonPayload.connection.protocol\nORDER BY\nbytes DESC\nLIMIT\n15\n```\n\n- Analyze the VPC flow logs in BigQuery\n- Create a new query in the BigQuery Editor with the following and replace your_table_id with TABLE_ID while retaining the accents (`) on both sides:\n\n```roomsql\n#standardSQL\nSELECT\njsonPayload.connection.src_ip,\njsonPayload.connection.dest_ip,\nSUM(CAST(jsonPayload.bytes_sent AS INT64)) AS bytes,\njsonPayload.connection.dest_port,\njsonPayload.connection.protocol\nFROM\n`your_table_id`\nWHERE jsonPayload.reporter = 'DEST'\nGROUP BY\njsonPayload.connection.src_ip,\njsonPayload.connection.dest_ip,\njsonPayload.connection.dest_port,\njsonPayload.connection.protocol\nORDER BY\nbytes DESC\nLIMIT\n15\n```\n\n\n\n### Add VPC flow log aggregation\n\n- In the Console, navigate to the Navigation menu (Navigation menu icon) and select VPC network > VPC networks.\n\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_017_application_performance_management/ReadMe.md", "content": "# Application Performance Management\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n## High Level Objectives\n\n- Download a pair of sample apps from GitHub\n- Deploy the converter application to App Engine\n- Debug the application\n- Adding log data\n- Fix the bug and deploy a new version\n- Examine an error report coming out of Cloud Run in Error Reporting\n- Examine a default and custom trace span\n\n\n### Download a pair of sample apps from GitHub\n\n- Enable APIs\n\n```bash\ngcloud services enable cloudbuild.googleapis.com\ngcloud services enable containerregistry.googleapis.com\ngcloud services enable run.googleapis.com\n\n## Clone\ncd ~/\ngit clone https://github.com/haggman/HelloLoggingNodeJS.git\n\n# Change into the HelloLoggingNodeJS folder and use the rebuildService.sh script to deploy the application into Cloud Run:\ncd ~/HelloLoggingNodeJS\nsh rebuildService.sh\n\n# New terminal session\ngit clone https://github.com/haggman/gcp-debugging\n\ncd ~/gcp-debugging\n\n# Install req and run\nsudo pip3 install -r requirements.txt\npython3 main.py\n```\n\n- Web Preview (Web preview button) in the Cloud Shell toolbar, and then select Preview on port 8080.\n\n### Deploy the converter application to App Engine\n\n- App Engine needs an application created before it can be used. This is done just once using the gcloud app create command and specifying the region where you want the app to be created. This command takes a minute or so. Please wait for it to complete before moving on:\n\n```bash\ngcloud app create --region=us-central\n```\n\n- Deploy the Flask application into App Engine. This command takes a minute or three to complete. Please wait for it before moving on:\n\n```bash\ngcloud app deploy --version=one --quiet\n```\n\n- Visit App Engine URL\n\n\n### Debug the application\n\n- Navigation menu to navigate to Debugger.\n- Authorize\n- CREATE SNAPSHOT\n\n### Adding log data\n\n- Logpoint\n\n\n### Fix the bug and deploy a new version\n\n- main.py\n- replace the if-else block on lines 24 through 29 with the following try-catch block. This is Python, so make sure you get the spacing correct:\n```python\n try:\n fahrenheit = float(input)\n celsius = int((fahrenheit - 32.0) * 5.0 / 9.0)\n except ValueError:\n fahrenheit = 'Enter a number'\n celsius = 'Invalid Input'\n```\n\n- Deploy\n\n```bash\ncd ~/gcp-debugging\ngcloud app deploy --version=two --quiet\n```\n\n### Examine an error report coming out of Cloud Run in Error Reporting\n\n\n```bash\ncd ~/HelloLoggingNodeJS\nedit index.js\n```\n\n- Hit `/uncaught`\n- Navigation menu to view Error Reporting.\n\n```bash\n# Create a new Google Cloud Source Repository git repo named hello-world:\ncd ~/HelloLoggingNodeJS\ngcloud source repos create hello-world\n```\n\n- Push a copy of the code into the project Git repository:\n\n```bash\ngit push --mirror \\\nhttps://source.developers.google.com/p/$GOOGLE_CLOUD_PROJECT/r/hello-world\n```\n\n### Examine a default and custom trace span\n\n- Navigation menu to select Trace.\n- Scroll down to the /slow route. Edit or replace the method so it resembles the following:\n\n```\n//Generates a slow request\napp.get('/slow', (req, res) => {\n const span1 = tracer.createChildSpan({name: 'slowPi'});\n let pi1=slowPi();\n span1.endSpan();\n const span2 = tracer.createChildSpan({name: 'slowPi2'});\n let pi2=slowPi2();\n span2.endSpan();\n res.send(`Took it's time. pi to 1,000 places: ${pi1}, pi to 100,000 places: ${pi2}`);\n});\n```\n\n- Rebuild and deploy\n\n```bash\nsh rebuildService.sh\n```\n\n\n\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_017_application_performance_management__python_and_nodejs/ReadMe.md", "content": "# Application Performance Management\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - DevOps Engineer, SRE Learning Path](https://www.cloudskillsboost.google/paths)\n\n**High Level Objectives**\n- Download a pair of sample apps from GitHub\n- Deploy the converter application to App Engine\n- Debug the application\n- Adding log data\n- Fix the bug and deploy a new version\n- Examine an error report coming out of Cloud Run in Error Reporting\n- Examine a default and custom trace span\n\n**Skills**\n- gcp\n- gcp-cloud-run\n- gcp-app-engine\n- debug apps\n- python\n- nodejs\n- custom traces\n- trace span\n\n\n### Download a pair of sample apps from GitHub\n\n- Enable APIs\n\n```bash\ngcloud services enable cloudbuild.googleapis.com\ngcloud services enable containerregistry.googleapis.com\ngcloud services enable run.googleapis.com\n\n## Clone\ncd ~/\ngit clone https://github.com/haggman/HelloLoggingNodeJS.git\n\n# Change into the HelloLoggingNodeJS folder and use the rebuildService.sh script to deploy the application into Cloud Run:\ncd ~/HelloLoggingNodeJS\nsh rebuildService.sh\n\n# New terminal session\ngit clone https://github.com/haggman/gcp-debugging\n\ncd ~/gcp-debugging\n\n# Install req and run\nsudo pip3 install -r requirements.txt\npython3 main.py\n```\n\n- Web Preview (Web preview button) in the Cloud Shell toolbar, and then select Preview on port 8080.\n\n### Deploy the converter application to App Engine\n\n- App Engine needs an application created before it can be used. This is done just once using the gcloud app create command and specifying the region where you want the app to be created. This command takes a minute or so. Please wait for it to complete before moving on:\n\n```bash\ngcloud app create --region=us-central\n```\n\n- Deploy the Flask application into App Engine. This command takes a minute or three to complete. Please wait for it before moving on:\n\n```bash\ngcloud app deploy --version=one --quiet\n```\n\n- Visit App Engine URL\n\n\n### Debug the application\n\n- Navigation menu to navigate to Debugger.\n- Authorize\n- CREATE SNAPSHOT\n\n### Adding log data\n\n- Logpoint\n\n\n### Fix the bug and deploy a new version\n\n- main.py\n- replace the if-else block on lines 24 through 29 with the following try-catch block. This is Python, so make sure you get the spacing correct:\n```python\n try:\n fahrenheit = float(input)\n celsius = int((fahrenheit - 32.0) * 5.0 / 9.0)\n except ValueError:\n fahrenheit = 'Enter a number'\n celsius = 'Invalid Input'\n```\n\n- Deploy\n\n```bash\ncd ~/gcp-debugging\ngcloud app deploy --version=two --quiet\n```\n\n### Examine an error report coming out of Cloud Run in Error Reporting\n\n\n```bash\ncd ~/HelloLoggingNodeJS\nedit index.js\n```\n\n- Hit `/uncaught`\n- Navigation menu to view Error Reporting.\n\n```bash\n# Create a new Google Cloud Source Repository git repo named hello-world:\ncd ~/HelloLoggingNodeJS\ngcloud source repos create hello-world\n```\n\n- Push a copy of the code into the project Git repository:\n\n```bash\ngit push --mirror \\\nhttps://source.developers.google.com/p/$GOOGLE_CLOUD_PROJECT/r/hello-world\n```\n\n### Examine a default and custom trace span\n\n- Navigation menu to select Trace.\n- Scroll down to the /slow route. Edit or replace the method so it resembles the following:\n\n```\n//Generates a slow request\napp.get('/slow', (req, res) => {\n const span1 = tracer.createChildSpan({name: 'slowPi'});\n let pi1=slowPi();\n span1.endSpan();\n const span2 = tracer.createChildSpan({name: 'slowPi2'});\n let pi2=slowPi2();\n span2.endSpan();\n res.send(`Took it's time. pi to 1,000 places: ${pi1}, pi to 100,000 places: ${pi2}`);\n});\n```\n\n- Rebuild and deploy\n\n```bash\nsh rebuildService.sh\n```\n\n\n\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_018_2inst_2buckets_2iam/ReadMe.md", "content": "# Cloud Shell, VMs, Buckets, Service Accounts\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - Getting Started with Google Kubernetes Engine Course](https://www.cloudskillsboost.google)\n\n**High Level Objectives**\n- Learn how to access the Cloud Console and Cloud Shell\n- Become familiar with the Cloud Console\n- Become familiar with Cloud Shell features, including the Cloud Shell code editor\n- Use the Cloud Console and Cloud Shell to create buckets and VMs and service accounts\n- Perform other commands in Cloud Shell\n\n**Skills**\n- gcp\n- gcp-console\n- gcp-storage\n- gcp-vm\n- gcp-iam\n- gcp-shell\n- gcp-cli\n- gcp-service-accounts\n\n### Use the Cloud Console and Cloud Shell to create buckets and VMs and service accounts\n\n- Create a bucket with the same name as your project ID. (Choose how to control access to objects and uncheck Enforce public access prevention on this bucket, now select Fine-grained)\n- Create a VM `first-vm`. Allow HTTP traffic\n- Create an IAM service account `test-service-account`\n- On the Grant this service account access to project page, specify the role as `Basic > Editor`.\n- Manage keys - Download JSON key\n\n### Explore Cloud Shell\n\n- Use Cloud Shell to set up the environment variables for this task\n\n```bash\nMY_BUCKET_NAME_1=[BUCKET_NAME]\n\nMY_BUCKET_NAME_2=[BUCKET_NAME_2]\n\nMY_REGION=us-central1\n```\n\n- Move the credentials file you created earlier into Cloud Shell\n- Create a second Cloud Storage bucket and verify it in the Cloud Console\n\n```bash\ngsutil mb gs://$MY_BUCKET_NAME_2\n```\n\n- Use the gcloud command line to create a second virtual machine.\n Select a zone from the first column of the list.\n\n```bash\ngcloud compute zones list | grep $MY_REGION\n# You replace [ZONE] with your selected zone:\nMY_ZONE=[ZONE]\n\n# Set this zone to be your default zone by executing the following command:\ngcloud config set compute/zone $MY_ZONE\n\n# Execute the following command to store a name in an environment variable you will use to create a VM. You will call your second VM second-vm:\nMY_VMNAME=second-vm\n\n# Create a VM in the default zone that you set earlier in this task using the new environment variable to assign the VM name:\ngcloud compute instances create $MY_VMNAME \\\n--machine-type \"e2-standard-2\" \\\n--image-project \"debian-cloud\" \\\n--image-family \"debian-11\" \\\n--subnet \"default\"\n\n# List the virtual machine instances in your project:\ngcloud compute instances list\n\n# Look at the External IP column. Notice that the external IP address of the first VM you created is shown as a link. The Google Cloud Console offers the link because you configured this VM's firewall to allow HTTP traffic.\n```\n\n- Use the gcloud command line to create a second service account\n- In Cloud Shell, execute the following command to create a new service account:\n\n```bash\ngcloud iam service-accounts create test-service-account2 --display-name \"test-service-account2\"\n\n# In Cloud Shell, execute the following command to grant the second service account the Project viewer role:\ngcloud projects add-iam-policy-binding $GOOGLE_CLOUD_PROJECT --member serviceAccount:test-service-account2@${GOOGLE_CLOUD_PROJECT}.iam.gserviceaccount.com --role roles/viewer\n\n```\n\n### Work with Cloud Storage in Cloud Shell\n\n```bash\n# Copy a picture of a cat from a Google-provided Cloud Storage bucket to your Cloud Shell:\ngsutil cp gs://cloud-training/ak8s/cat.jpg cat.jpg\n\n# Copy the file into the first buckets that you created earlier:\ngsutil cp cat.jpg gs://$MY_BUCKET_NAME_1\n\n# Copy the file from the first bucket into the second bucket:\ngsutil cp gs://$MY_BUCKET_NAME_1/cat.jpg gs://$MY_BUCKET_NAME_2/cat.jpg\n```\n\n- In the Cloud Console, on the Navigation menu(Navigation menu icon), click Cloud Storage > Browser, select both the buckets that you created, and verify that both contain the cat.jpg file\n\n\n- Set the access control list for a Cloud Storage object\n- Execute the following command in Cloud Shell:\n\n```bash\ngsutil acl get gs://$MY_BUCKET_NAME_1/cat.jpg > acl.txt\ncat acl.txt\n\n# To change the object to have private access, execute the following command:\ngsutil acl set private gs://$MY_BUCKET_NAME_1/cat.jpg\n\n# To verify the new ACL that's been assigned to cat.jpg, execute the following two commands:\ngsutil acl get gs://$MY_BUCKET_NAME_1/cat.jpg > acl-2.txt\ncat acl-2.txt\n```\n\n- In Cloud Shell, execute the following command to view the current configuration:\n\n```bash\ngcloud config list\n\n# In Cloud Shell, execute the following command to change the authenticated user to the first service account (which you created in an earlier task) through the credentials that you downloaded to your local machine and then uploaded into Cloud Shell (credentials.json):\ngcloud auth activate-service-account --key-file credentials.json\n\ngcloud config list\n\n# To verify the list of authorized accounts in Cloud Shell, execute the following command:\ngcloud auth list\n\n# To verify that the current account (test-service-account) cannot access the cat.jpg file in the first bucket that you created, execute the following command:\n# Because you restricted access to this file to the owner earlier in this task.\ngsutil cp gs://$MY_BUCKET_NAME_1/cat.jpg ./cat-copy.jpg\n\n# Verify that the current account (test-service-account) can access the cat.jpg file in the second bucket that you created:\ngsutil cp gs://$MY_BUCKET_NAME_2/cat.jpg ./cat-copy.jpg\n\n# To switch to the lab account, execute the following command, replacing [USERNAME] with the username provided in the Qwiklabs \ngcloud config set account [USERNAME]\n\n# To verify that you can access the cat.jpg file in the [BUCKET_NAME] bucket (the first bucket that you created), execute the following command.\ngsutil cp gs://$MY_BUCKET_NAME_1/cat.jpg ./copy2-of-cat.jpg\n\n# Make the first Cloud Storage bucket readable by everyone, including unauthenticated users:\ngsutil iam ch allUsers:objectViewer gs://$MY_BUCKET_NAME_1\n\n# Get the public URL of the object\n```\n\n### Explore the Cloud Shell code editor\n\n\n- On the Cloud console tab, click Open Terminal and in Cloud Shell, execute the following command to clone a git repository:\n\n```bash\ngit clone https://github.com/googlecodelabs/orchestrate-with-kubernetes.git\n\nmkdir test\n\n# Add the following text as the last line of the cleanup.sh file:\n```\n\n- Add the following text as the last line of the cleanup.sh file:\n```bash\necho Finished cleanup! \n```\n\n- In Cloud Shell, execute the following commands to change directory and display the contents of cleanup.sh:\n- Create new file. \n- Save the file in orchestrate-with-kubernetes folder and name the file index.html\n- Replace the string REPLACE_WITH_CAT_URL with the URL of the cat image from an earlier task\n\n```bash\nCat\n\n

Cat

\n\n\n```\n\n- first-vm, click the SSH button.\n\n```bash\nsudo apt-get remove -y --purge man-db\nsudo touch /var/lib/man-db/auto-update\nsudo apt-get update\nsudo apt-get install nginx\n```\n\n- In your Cloud Shell window, copy the HTML file you created using the Code Editor to your virtual machine:\n\n```bash\ngcloud compute scp index.html first-vm:index.nginx-debian.html --zone=us-central1-c\n```\n\n- In the SSH login window for your VM, copy the HTML file from your home directory to the document root of the nginx Web server:\n\n```bash\nsudo cp index.nginx-debian.html /var/www/html\n```\n\n- Click the link in the External IP column for your first-vm. A new browser tab opens, containing a Web page that contains the cat image.\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_019_working_with_cloud_build/ReadMe.md", "content": "# Working with Cloud Build\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - Getting Started with Google Kubernetes Engine Course](https://www.cloudskillsboost.google)\n\n**High Level Objectives**\n- Confirm that needed APIs are enabled\n- Building containers with DockerFile and Cloud Build\n- Building containers with a build configuration file and Cloud Build\n- Building and testing containers with a build configuration file and Cloud Build\n\n**Skills**\n- gcp\n- cloud-build\n- cloud-shell\n- cloud-shell-editor\n- containers\n- docker\n- dockerfile\n\n### Confirm that needed APIs are enabled\n\n- Cloud Build\n- Container Registry\n\n### Building containers with DockerFile and Cloud Build\n\n```bash\n# Create file\ntouch quickstart.sh\n```\n\n```shell\n#!/bin/sh\necho \"Hello, world! The time is $(date).\"\n```\n\n- Dockerfile\n\n```Dockerfile\nFROM alpine\nCOPY quickstart.sh /\nCMD [\"/quickstart.sh\"]\n```\n\n```bash\nchmod +x quickstart.sh\n```\n\n- In Cloud Shell, run the following command to build the Docker container image in Cloud Build:\n\n```bash\ngcloud builds submit --tag gcr.io/${GOOGLE_CLOUD_PROJECT}/quickstart-image .\n```\n\n- In the Google Cloud Console, on the Navigation menu (Navigation menu icon), click Container Registry > Images.\n\n### Building containers with a build configuration file and Cloud Build\n\n- In Cloud Shell enter the following command to clone the repository to the lab Cloud Shell:\n\n```bash\ngit clone https://github.com/GoogleCloudPlatform/training-data-analyst\n\n# Create a soft link as a shortcut to the working directory:\nln -s ~/training-data-analyst/courses/ak8s/v1.1 ~/ak8s\n\n# Change to the directory that contains the sample files for this lab:\ncd ~/ak8s/Cloud_Build/a\n\ncat cloudbuild.yaml\n\n# In Cloud Shell, execute the following command to start a Cloud Build using cloudbuild.yaml as the build configuration file:\ngcloud builds submit --config cloudbuild.yaml .\n```\n\n- Container Registry > Images and then click quickstart-image.\n- Navigation menu (Navigation menu icon), click Cloud Build > History.\n\n### Building and testing containers with a build configuration file and Cloud Build\n\n\n- In Cloud Shell, change to the directory that contains the sample files for this lab:\n\n```bash\ncd ~/ak8s/Cloud_Build/b\n\n# In Cloud Shell, execute the following command to view the contents of cloudbuild.yaml\ncat cloudbuild.yaml\n\n\n# In Cloud Shell, execute the following command to start a Cloud Build using cloudbuild.yaml as the build configuration file:\ngcloud builds submit --config cloudbuild.yaml .\n\n# Confirm that your command shell knows that the build failed:\necho $?\n\n\n```" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_020_deploying_google_kubernetes_engine/ReadMe.md", "content": "# Deploying Google Kubernetes Engine\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - Getting Started with Google Kubernetes Engine Course](https://www.cloudskillsboost.google)\n\n**High Level Objectives**\n- Use the Google Cloud Console to build and manipulate GKE clusters\n- Use the Google Cloud Console to deploy a Pod\n\n**Skills**\n- GKE\n- Kubernetes\n- Pods\n- Modify Cluster\n\n\n### Deploy GKE clusters\n\n- cluster name to standard-cluster-1\n- zone to us-central1-a.\n\n\n### Modify GKE clusters\n\n- Change the number of nodes from 3 to 4 and click RESIZE\n\n### View details about workloads in the Google Cloud Console\n\n- In the Google Cloud Console, on the Kubernetes Engine > Workloads page, click nginx-1." }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_021_creating_google_kubernetes_engine_deployments/ReadMe.md", "content": "# Creating Google Kubernetes Engine Deployments\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - Getting Started with Google Kubernetes Engine Course](https://www.cloudskillsboost.google)\n\n**High Level Objectives**\n- Create deployment manifests, deploy to cluster\n- Trigger manual scaling up and down of Pods in deployments\n- Trigger deployment rollout (rolling update to new version) and rollbacks\n- Perform a Canary deployment\n\n**Skills**\n- gcp\n- kubernetes\n- deployments\n- pods\n- scaling\n- rollouts\n- rollbacks\n- canary\n\n\n\n### Create deployment manifests and deploy to the cluster\n\n- Connect\n\n```bash\n# set the environment variable for the zone and cluster name\nexport my_zone=us-central1-a\nexport my_cluster=standard-cluster-1\n\n# Configure kubectl tab completion in Cloud Shell:\nsource <(kubectl completion bash)\n\n# configure access to your cluster for the kubectl command-line tool, using the following command:\ngcloud container clusters get-credentials $my_cluster --zone $my_zone\n\n# In Cloud Shell enter the following command to clone the repository to the lab Cloud Shell:\ngit clone https://github.com/GoogleCloudPlatform/training-data-analyst\n\n# Create a soft link as a shortcut to the working directory:\nln -s ~/training-data-analyst/courses/ak8s/v1.1 ~/ak8s\n\n# Change to the directory that contains the sample files for this lab:\ncd ~/ak8s/Deployments/\n\n```\n\n\n- Create a deployment manifest\n\n- nginx-deployment.yaml\n```yaml\napiVersion: apps/v1\nkind: Deployment\nmetadata:\n name: nginx-deployment\n labels:\n app: nginx\nspec:\n replicas: 3\n selector:\n matchLabels:\n app: nginx\n template:\n metadata:\n labels:\n app: nginx\n spec:\n containers:\n - name: nginx\n image: nginx:1.7.9\n ports:\n - containerPort: 80\n```\n\n- Apply\n\n```bash\nkubectl apply -f ./nginx-deployment.yaml\n\nkubectl get deployments\n```\n\n### Manually scale up and down the number of Pods in deployments\n\n- Navigation menu ( Navigation menu icon), click Kubernetes Engine > Workloads.\n- nginx-deployment (your deployment) to open the Deployment details page.\n- ACTIONS > Scale > Edit Replicas.\n\n```bash\nkubectl get deployments\n\n# To scale the Pod back up to three replicas, execute the following command:\nkubectl scale --replicas=3 deployment nginx-deployment\n\n\n# View\nkubectl get deployments\n\n```\n\n### Trigger a deployment rollout and a deployment rollback\n\n\n- To update the version of nginx in the deployment, execute the following command:\n\n```bash\nkubectl set image deployment.v1.apps/nginx-deployment nginx=nginx:1.9.1 --record\n\n\n# To view the rollout status, execute the following command:\nkubectl rollout status deployment.v1.apps/nginx-deployment\n\n# To verify the change, get the list of deployments:\nkubectl get deployments\n\n# View the rollout history of the deployment:\nkubectl rollout history deployment nginx-deployment\n```\n\n- Trigger a deployment rollback\n\n```bash\n# To roll back to the previous version of the nginx deployment, execute the following command:\nkubectl rollout undo deployments nginx-deployment\n\n# View the updated rollout history of the deployment:\nkubectl rollout history deployment nginx-deployment\n\n# View the details of the latest deployment revision:\nkubectl rollout history deployment/nginx-deployment --revision=3\n```\n\n\n### Define the service type in the manifest\n\n- Define service types in the manifest\n\n- service-nginx.yaml\n\n```yaml\napiVersion: v1\nkind: Service\nmetadata:\n name: nginx\nspec:\n type: LoadBalancer\n selector:\n app: nginx\n ports:\n - protocol: TCP\n port: 60000\n targetPort: 80\n```\n\n- In the Cloud Shell, to deploy your manifest, execute the following command:\n\n```bash\nkubectl apply -f ./service-nginx.yaml\n\n# To view the details of the nginx service, execute the following command:\nkubectl get service nginx\n```\n\n- When the external IP appears, open http://[EXTERNAL_IP]:60000/ in a new browser tab to see the server being served through network load balancing.\n\n\n### Perform a canary deployment\n\n- The manifest file nginx-canary.yaml that is provided for you deploys a single pod running a newer version of nginx than your main deployment. In this task, you create a canary deployment using this new deployment file:\n\n- nginx-canary.yaml\n```yaml\napiVersion: apps/v1\nkind: Deployment\nmetadata:\n name: nginx-canary\n labels:\n app: nginx\nspec:\n replicas: 1\n selector:\n matchLabels:\n app: nginx\n template:\n metadata:\n labels:\n app: nginx\n track: canary\n Version: 1.9.1\n spec:\n containers:\n - name: nginx\n image: nginx:1.9.1\n ports:\n - containerPort: 80\n```\n\n\n```bash\n# Create the canary deployment based on the configuration file:\nkubectl apply -f nginx-canary.yaml\n\n# When the deployment is complete, verify that both the nginx and the nginx-canary deployments are present:\nkubectl get deployments\n\n# Switch back to the Cloud Shell and scale down the primary deployment to 0 replicas:\nkubectl scale --replicas=0 deployment nginx-deployment\n\n# Verify that the only running replica is now the Canary deployment:\nkubectl get deployments\n```\n\n\n- Session affinity\n\n- This potential to switch between different versions may cause problems if there are significant changes in functionality in the canary release. To prevent this you can set the sessionAffinity field to ClientIP in the specification of the service if you need a client's first request to determine which Pod will be used for all subsequent connections.\n\n```yaml\napiVersion: v1\nkind: Service\nmetadata:\n name: nginx\nspec:\n type: LoadBalancer\n sessionAffinity: ClientIP\n selector:\n app: nginx\n ports:\n - protocol: TCP\n port: 60000\n targetPort: 80\n```\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_021_creating_google_kubernetes_engine_deployments/nginx-canary.yaml", "content": "apiVersion: apps/v1\nkind: Deployment\nmetadata:\n name: nginx-canary\n labels:\n app: nginx\nspec:\n replicas: 1\n selector:\n matchLabels:\n app: nginx\n template:\n metadata:\n labels:\n app: nginx\n track: canary\n Version: 1.9.1\n spec:\n containers:\n - name: nginx\n image: nginx:1.9.1\n ports:\n - containerPort: 80" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_021_creating_google_kubernetes_engine_deployments/nginx-deployment.yaml", "content": "apiVersion: apps/v1\nkind: Deployment\nmetadata:\n name: nginx-deployment\n labels:\n app: nginx\nspec:\n replicas: 3\n selector:\n matchLabels:\n app: nginx\n template:\n metadata:\n labels:\n app: nginx\n spec:\n containers:\n - name: nginx\n image: nginx:1.7.9\n ports:\n - containerPort: 80" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_021_creating_google_kubernetes_engine_deployments/nginx-svc-session-affinity.yaml", "content": "apiVersion: v1\nkind: Service\nmetadata:\n name: nginx\nspec:\n type: LoadBalancer\n sessionAffinity: ClientIP\n selector:\n app: nginx\n ports:\n - protocol: TCP\n port: 60000\n targetPort: 80" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_021_creating_google_kubernetes_engine_deployments/service-nginx.yaml", "content": "apiVersion: v1\nkind: Service\nmetadata:\n name: nginx\nspec:\n type: LoadBalancer\n selector:\n app: nginx\n ports:\n - protocol: TCP\n port: 60000\n targetPort: 80" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_022_configuring_persistent_storage_for_google_kubernetes_engine/ReadMe.md", "content": "# Configuring Persistent Storage for Google Kubernetes Engine\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - Getting Started with Google Kubernetes Engine Course](https://www.cloudskillsboost.google)\n\n\n**High Level Objectives**\n- Create manifests for PersistentVolumeClaims (PVCs) for Google Cloud persistent disks (dynamically created or existing)\n- Mount Google Cloud persistent disk PVCs as volumes in Pods\n- Use manifests to create StatefulSets\n- Mount Google Cloud persistent disk PVCs as volumes in StatefulSets\n- Verify the connection of Pods in StatefulSets to particular PVs as the Pods are stopped and restarted\n\n**Skills**\n- gcp\n- kubernetes\n- persistent storage\n- persistent volumes\n- persistent volume claims\n- statefulsets\n\n### Create PVCs\n\n```bash\n# Connect to the lab GKE cluster\nexport my_zone=us-central1-a\nexport my_cluster=standard-cluster-1\n\n# Configure tab completion for the kubectl command-line tool:\nsource <(kubectl completion bash)\n\n# Configure access to your cluster for kubectl:\ngcloud container clusters get-credentials $my_cluster --zone $my_zone\n```\n\n- In Cloud Shell, enter the following command to clone the repository to the lab Cloud Shell:\n\n```bash\ngit clone https://github.com/GoogleCloudPlatform/training-data-analyst\n\n# Create a soft link as a shortcut to the working directory:\nln -s ~/training-data-analyst/courses/ak8s/v1.1 ~/ak8s\n\n# Change to the directory that contains the sample files for this lab:\ncd ~/ak8s/Storage/\n\n# To show that you currently have no PVCs, execute the following command:\nkubectl get persistentvolumeclaim\n\n# To create the PVC, execute the following command:\nkubectl apply -f pvc-demo.yaml\n\n# To show your newly created PVC, execute the following command:\nkubectl get persistentvolumeclaim\n```\n\n\n### Mount and verify Google Cloud persistent disk PVCs in Pods\n\n- To create the Pod with the volume, execute the following command:\n\n```bash\nkubectl apply -f pod-volume-demo.yaml\n\nkubectl get pods\n\n\n# To verify the PVC is accessible within the Pod, you must gain shell access to your Pod. To start the shell session, execute the following command:\nkubectl exec -it pvc-demo-pod -- sh\n\n# To create a simple text message as a web page in the Pod enter the following commands:\necho Test webpage in a persistent volume!>/var/www/html/index.html\nchmod +x /var/www/html/index.html\n\n# Verify the text file contains your message:\ncat /var/www/html/index.html\n\nexit\n```\n\n- Test the persistence of the PV\n\n```bash\n# Delete the pvc-demo-pod:\nkubectl delete pod pvc-demo-pod\n\nkubectl get pods\n\n# To show your PVC, execute the following command:\nkubectl get persistentvolumeclaim\n\n# Redeploy the pvc-demo-pod:\nkubectl apply -f pod-volume-demo.yaml\n\nkubectl get pods\n\nkubectl exec -it pvc-demo-pod -- sh\n\n# To verify that the text file still contains your message execute the following command:\ncat /var/www/html/index.html\n```\n\n\n### Create StatefulSets with PVCs\n\n\n- Before you can use the PVC with the statefulset, you must delete the Pod that is currently using it. Execute the following command to delete the Pod:\n\n```bash\nkubectl delete pod pvc-demo-pod\n```\n\n- To create the StatefulSet with the volume, execute the following command:\n\n```bash\nkubectl apply -f statefulset-demo.yaml\n\n# Use \"kubectl describe\" to view the details of the StatefulSet:\nkubectl describe statefulset statefulset-demo\n\n# List the Pods in the cluster:\nkubectl get pods\n\n# To list the PVCs, execute the following command:\nkubectl get pvc\n\n# Use \"kubectl describe\" to view the details of the first PVC in the StatefulSet:\nkubectl describe pvc hello-web-disk-statefulset-demo-0\n```\n\n### Verify the persistence of Persistent Volume connections to Pods managed by StatefulSets\n\n- To verify that the PVC is accessible within the Pod, you must gain shell access to your Pod. To start the shell session, execute the following command:\n\n```bash\nkubectl exec -it statefulset-demo-0 -- sh\n\n# Verify that there is no index.html text file in the /var/www/html directory:\ncat /var/www/html/index.html\n\n# To create a simple text message as a web page in the Pod enter the following commands:\necho Test webpage in a persistent volume!>/var/www/html/index.html\nchmod +x /var/www/html/index.html\n\n\n# Verify the text file contains your message:\ncat /var/www/html/index.html\n\nexit\n\n\n# Delete the Pod where you updated the file on the PVC:\nkubectl delete pod statefulset-demo-0\n\nkubectl get pods\n\nkubectl exec -it statefulset-demo-0 -- sh\n\n# Verify that the text file still contains your message:\ncat /var/www/html/index.html\n```" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_022_configuring_persistent_storage_for_google_kubernetes_engine/pod-volume-demo.yaml", "content": "kind: Pod\napiVersion: v1\nmetadata:\n name: pvc-demo-pod\nspec:\n containers:\n - name: frontend\n image: nginx\n volumeMounts:\n - mountPath: \"/var/www/html\"\n name: pvc-demo-volume\n volumes:\n - name: pvc-demo-volume\n persistentVolumeClaim:\n claimName: hello-web-disk" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_022_configuring_persistent_storage_for_google_kubernetes_engine/pvc-demo.yaml", "content": "apiVersion: v1\nkind: PersistentVolumeClaim\nmetadata:\n name: hello-web-disk\nspec:\n accessModes:\n - ReadWriteOnce\n resources:\n requests:\n storage: 30Gi" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_022_configuring_persistent_storage_for_google_kubernetes_engine/statefulset-demo.yaml", "content": "kind: Service\napiVersion: v1\nmetadata:\n name: statefulset-demo-service\nspec:\n ports:\n - protocol: TCP\n port: 80\n targetPort: 9376\n type: LoadBalancer\n---\napiVersion: apps/v1\nkind: StatefulSet\nmetadata:\n name: statefulset-demo\nspec:\n selector:\n matchLabels:\n app: MyApp\n serviceName: statefulset-demo-service\n replicas: 3\n updateStrategy:\n type: RollingUpdate\n template:\n metadata:\n labels:\n app: MyApp\n spec:\n containers:\n - name: stateful-set-container\n image: nginx\n ports:\n - containerPort: 80\n name: http\n volumeMounts:\n - name: hello-web-disk\n mountPath: \"/var/www/html\"\n volumeClaimTemplates:\n - metadata:\n name: hello-web-disk\n spec:\n accessModes: [ \"ReadWriteOnce\" ]\n resources:\n requests:\n storage: 30Gi" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_023_anthos_service_mesh_walkthrough/ReadMe.md", "content": "# Anthos Service Mesh Walkthrough\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - Cloud Operations and Service Mesh with Anthos Course](https://www.cloudskillsboost.google)\n\n**High Level Objectives**\n- Navigate Google Cloud and explore Anthos clusters from the Google Cloud Console.\n- Perform east-west cross-cluster traffic routing.\n- Observe distributed services, view metrics, set up SLOs, and investigate network topology.\n- Use the Anthos Service Mesh Dashboards to verify security and encryption configuration.\n\n**Skills**\n- gcp\n- gke\n- kubernetes\n- istio\n- service mesh\n- anthos\n- SLOs\n- network topology\n- service mesh dashboard\n- cross-cluster traffic routing\n\n\nAnthos Service Mesh (ASM) on Google Kubernetes Engine. Anthos Service Mesh is a managed service based on Istio, the leading open source service mesh\n\n### Intro\n\nTwo GKE clusters called gke-central and gke-west have been provisioned in us-centra1 and us-west2. Anthos Service Mesh has been configured across these clusters to provide cross-cluster service discoverability and secure routing so that a microservice pod running on gke-central can seemlessly communicate with a pod on gke-west. Additionally, the Bank of Anthos application has been deployed across these two clusters as shown in the following diagram.\n\n![img.png](.images/arch-img.png)\n\n\n### Explore the app deployed in Anthos clusters\n\n- On the Navigation menu, click Kubernetes Engine > Clusters, and verify that two Anthos clusters are registered.\n\n- To open websites, click on the IP addresses for each of the instances of istio-ingressgateway. This will open the sign-in page for each website.\n- Deposit funds or send a payment, which will create a new transaction on the shared database.\n- Refresh the pages and confirm that both Transaction History and Current Balance are the same across clusters.\n\n> Notice that even though all services are replicated across clusters, they are both using the same database because the ledger-db is only deployed on one cluster. Anthos Service Mesh routes requests to the available pods regardless of the cluster you are ingressing from. This is called east-west routing.\n\n\n### Force cross-cluster traffic routing\n\n- To open the dashboard, click on the frontend deployment in the gke-central cluster.\n- On the Actions dropdown, select Scale > Edit replicas.\n- Enter 0 replicas, and click Scale.\n- Return to the istio-ingressgateways IP addresses that you opened before. The application should continue to work.\n- Return to your frontend deployment and scale it back to 1 replica.\n\n### Observe distributed services\n\n- To return to the home page of the Anthos Service Mesh dashboard, on the Navigation menu, click Anthos > Service Mesh.\n\n![img.png](.images/topology.png)\n\n- Click on the frontend workload node, and note the services called by that workload.\n- Click Table view. A list of distributed services in your mesh across your two clusters is displayed.\n- Click Health\n- Click Create SLO.\n- Select Latency as the metric, and click Continue.\n- Set the latency threshhold to 350 ms, and click Continue.\n- Set the Period length to Calendar day, and set the Goal to 99.5%.\n\n### Verify service mesh security\n\n- From the frontend service ASM Dashboard, open the Security (BETA) tab. The following diagram is displayed:\n\n![img.png](.images/security.png)\n\n\n- Notice that all service to service communication has a green lock. That's because all the communication is encrypted over mutual TLS. Also, notice that an unknown source has an open red lock. That means that an unathenticated agent is accessing the frontend service that is communicating over plain text. This unathenticated agent is the browser.\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_024_observing_anthos_services/ReadMe.md", "content": "# Observing Anthos Services\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - Cloud Operations and Service Mesh with Anthos Course](https://www.cloudskillsboost.google)\n\n**High Level Objectives**\n- Install Anthos Service Mesh, with tracing enabled and configured to use Cloud Trace as the backend.\n- Deploy Bookinfo, an Istio-enabled multi-service application.\n- Enable external access using an Istio Ingress Gateway.\n- Use the Bookinfo application.\n- Evaluate service performance using Cloud Trace features within Google Cloud.\n- Create and monitor service-level objectives (SLOs).\n- Leverage the Anthos Service Mesh Dashboard to understand service performance.\n\n**Skills**\n- gcp\n- gke\n- kubernetes\n- istio\n- service mesh\n- anthos\n- SLOs\n- network topology\n- microservices\n- service performance\n- Istio ingress gateway\n- cloud trace\n\nAnthos Service Mesh (ASM) on Google Kubernetes Engine. Anthos Service Mesh is a managed service based on Istio, the leading open source service mesh\n\n### Install Anthos Service Mesh with tracing enabled\n\n- Set ENV\n\n```bash\nCLUSTER_NAME=gke\nCLUSTER_ZONE=us-central1-b\nPROJECT_ID=$(gcloud config get-value project)\nPROJECT_NUMBER=$(gcloud projects describe ${PROJECT_ID} \\\n --format=\"value(projectNumber)\")\nFLEET_PROJECT_ID=${FLEET_PROJECT_ID:-$PROJECT_ID}\nIDNS=${PROJECT_ID}.svc.id.goog\nDIR_PATH=.\n```\n\n- Configure kubectl to manage your GKE cluster:\n\n```bash\ngcloud container clusters get-credentials $CLUSTER_NAME \\\n --zone $CLUSTER_ZONE --project $PROJECT_ID\n \n# Review your kubectl configuration:\nkubectl config view\n\n# Check that your cluster is running:\ngcloud container clusters list\n\n```\n\n- Install Anthos Service Mesh\n\n```bash\n# Download the Anthos Service Mesh installation script:\ncurl https://storage.googleapis.com/csm-artifacts/asm/asmcli_1.15 > asmcli\n\nchmod +x asmcli\n\n# Use asmcli to install Anthos Service Mesh:\n./asmcli install \\\n--project_id $PROJECT_ID \\\n--cluster_name $CLUSTER_NAME \\\n--cluster_location $CLUSTER_ZONE \\\n--fleet_id $FLEET_PROJECT_ID \\\n--output_dir $DIR_PATH \\\n--managed \\\n--enable_all \\\n--ca mesh_ca\n\n\n# Enable Anthos Service Mesh to send telemetry to Cloud Trace:\ncat < Trace List.\n\n### Deploy a canary release that has high latency\n\n```bash\n# In Cloud Shell, clone the repository that has the configuration files you need for this part of the lab:\ngit clone https://github.com/GoogleCloudPlatform/istio-samples.git \\\n ~/istio-samples\n \n# Create the new resources on the gke cluster:\nkubectl apply -f ~/istio-samples/istio-canary-gke/canary/destinationrule.yaml\nkubectl apply -f ~/istio-samples/istio-canary-gke/canary/productcatalog-v2.yaml\nkubectl apply -f ~/istio-samples/istio-canary-gke/canary/vs-split-traffic.yaml \n```\n\n### Define your service level objective\n\n- Navigation menu, click Anthos\n- In the Services list, click productcatalogservice -> Health\n- Click Create SLO.\n- In the Set your SLI slideout, for metric, select Latency.\n- Select Request-based as the method of evaluation.\n- Click Continue.\n- Set Latency Threshold to 1000, and click Continue.\n- Set Period type to Calendar.\n- Set Period length to Calendar day.\n- Performance goal to 99.5%.\n\n### Diagnose the problem\n\n- Click on your SLO entry in the SLO list.\n- From the Breakdown By dropdown, select Source service.\n\n- Use Cloud Trace to better understand where the delay is\n- In the Google Cloud Console, on the Navigation menu, click Trace > Trace List.\n- Click on a dot that charts at around 3000ms; it should represent one of the requests to the product catalog service.\n\n\n### Roll back the release and verify an improvement\n\n- In Cloud Shell, back out the canary release:\n\n```bash\nkubectl delete -f ~/istio-samples/istio-canary-gke/canary/destinationrule.yaml\nkubectl delete -f ~/istio-samples/istio-canary-gke/canary/productcatalog-v2.yaml\nkubectl delete -f ~/istio-samples/istio-canary-gke/canary/vs-split-traffic.yaml\n```\n\n- Click on productcatalogservice, and then in the menu pane, click Health.\n- Compare the current compliance metric with the one you saw earlier. It should be higher now, reflecting the fact that you are no longer seeing high-latency requests.\n\n### Visualize your mesh with the Anthos Service Mesh dashboard\n\n- On the Navigation menu, click Anthos > Service Mesh.\n- Click Topology. A chart representing your service mesh is displayed." }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_025_managing_traffic_with_anthos_service_mesh/ReadMe.md", "content": "# Managing Traffic Flow with Anthos Service Mesh\n\n\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - Cloud Operations and Service Mesh with Anthos Course](https://www.cloudskillsboost.google)\n\n**High Level Objectives**\n- Configure and use Istio Gateways\n- Apply default destination rules, for all available versions\n- Apply virtual services to route by default to only one version\n- Route to a specific version of a service based on user identity\n- Shift traffic gradually from one version of a microservice to another\n- Use the Anthos Service Mesh dashboard to view routing to multiple versions\n- Setup networking best practices such as retries, circuit breakers and timeouts\n\n**Skills**\n- gcp\n- gke\n- kubernetes\n- istio\n- service mesh\n- anthos\n- destination rules\n- virtual services\n- traffic management\n- retries\n- circuit breakers\n- timeouts\n\nAnthos Service Mesh’s traffic management model relies on the following two components:\n- Control plane: manages and configures the Envoy proxies to route traffic and enforce polices.\n- Data plane: encompasses all network communication between microservices performed at runtime by the Envoy proxies.\n\n![img.png](.images/img.png)\n\n\n## Review Traffic Management use cases\n\n> In Istio, when an incoming request arrives at a Kubernetes cluster, it first reaches the Gateway resource,\n> and then the VirtualService resource. The Gateway resource receives the incoming traffic and is responsible\n> for routing the traffic to the correct VirtualService based on the specified rules. The VirtualService resource\n> then applies additional routing rules to further direct the traffic to the appropriate destination service or pod.\n\n- Example: traffic splitting\n- Example: timeouts\n- Example: retries\n- Example: fault injection: inserting delays\n- Example: fault injection: inserting aborts\n- Example: conditional routing: based on request headers\n\n\n## Setup\n\n```bash\n# In Cloud Shell, set environment variables for the zone and cluster name:\nexport CLUSTER_NAME=gke\nexport CLUSTER_ZONE=us-central1-b\n\n# Configure kubectl command line access by running:\nexport GCLOUD_PROJECT=$(gcloud config get-value project)\ngcloud container clusters get-credentials $CLUSTER_NAME \\\n --zone $CLUSTER_ZONE --project $GCLOUD_PROJECT\n \n# Check that your cluster is up and running:\ngcloud container clusters list\n\n\n# Ensure the Kubernetes pods for the Anthos Service Mesh control plane are deployed:\nkubectl get pods -n istio-system\n\n\n# Ensure corresponding Kubernetes services for the Anthos Service Mesh control plane are deployed:\nkubectl get service -n istio-system\n\n# Ensure corresponding Kubernetes pods for the Anthos Service Mesh control plane are deployed, so that telemetry data is displayed in the ASM Dashboard:\nkubectl get pods -n asm-system\n\n \n```\n\n- Verify the Bookinfo deployment\n\n```bash\nkubectl get pods\n\n# Review running application services:\nkubectl get services\n\n```\n\n\n## Install Gateways to enable ingress\n\nIn a Kubernetes environment, the Kubernetes Ingress Resource is used to specify services that should be exposed outside the cluster. In Anthos Service Mesh, a better approach, which also works in Kubernetes and other environments, is to use a Gateway resource. A Gateway allows mesh features such as monitoring, mTLS, and advanced routing capabilities rules to be applied to traffic entering the cluster.\n\n![img.png](.images/img2.png)\n\n\n- Install an ingress gateway in your cluster\n\n```bash\nkubectl create namespace ingress\n\n# Label the gateway namespace with a revision label for auto-injection:\nkubectl label namespace ingress \\\n istio.io/rev=$(kubectl -n istio-system get pods -l app=istiod -o json | jq -r '.items[0].metadata.labels[\"istio.io/rev\"]') \\\n --overwrite\n```\n\n- Download and apply the gateway configuration files. \n- These include the pods and services that will first receive the incoming requests from outside the cluster:\n\n```bash\ngit clone https://github.com/GoogleCloudPlatform/anthos-service-mesh-packages\nkubectl apply -n ingress -f anthos-service-mesh-packages/samples/gateways/istio-ingressgateway\n```\n\n- After you create the deployment, verify that the new services are working:\n\n```bash\nkubectl get pod,service -n ingress\n\n# Notice the resource is a LoadBalancer. This ingress gateway uses an external TCP load balancer in GCP.\n```\n\n- Deploy the Gateway to specify the port and protocol to be used. In this case, the gateway enables HTTP traffic over port 80:\n- The Gateway resource must be located in the same namespace as the gateway deployment.\n\n```yaml\ncat < In Istio, when an incoming request arrives at a Kubernetes cluster, it first reaches the Gateway resource, \n> and then the VirtualService resource. The Gateway resource receives the incoming traffic and is responsible \n> for routing the traffic to the correct VirtualService based on the specified rules. The VirtualService resource \n> then applies additional routing rules to further direct the traffic to the appropriate destination service or pod. \n> So in the example manifest, the incoming traffic will first reach the bookinfo-gateway Gateway resource and then \n> it will be directed to the bookinfo VirtualService based on the specified matching rules. The VirtualService \n> will then route the traffic to the appropriate destination based on the defined routing rules.\n\n- Verify that the Gateway and VirtualService have been created and notice that the VirtualService is pointing to the Gateway:\n\n```bash\nkubectl get gateway,virtualservice\n\n# Save this external IP in your Cloud Shell environment:\nexport GATEWAY_URL=$(kubectl get svc -n ingress istio-ingressgateway \\\n-o=jsonpath='{.status.loadBalancer.ingress[0].ip}')\necho The gateway address is $GATEWAY_URL\n```\n\n- Generate some background traffic\n\n```bash\nsudo apt install siege\n\n# Use siege to create traffic against your services:\nsiege http://${GATEWAY_URL}/productpage\n\n```\n\n- Access the BookInfo application\n\n```bash\n# Initialize the new Cloud Shell tab:\nexport CLUSTER_NAME=gke\nexport CLUSTER_ZONE=us-central1-b\nexport GCLOUD_PROJECT=$(gcloud config get-value project)\ngcloud container clusters get-credentials $CLUSTER_NAME \\\n --zone $CLUSTER_ZONE --project $GCLOUD_PROJECT\nexport GATEWAY_URL=$(kubectl get svc istio-ingressgateway \\\n-o=jsonpath='{.status.loadBalancer.ingress[0].ip}' -n ingress)\n\n\n# Confirm that the Bookinfo application responds by sending a curl request to it from some pod, within the cluster, for example from ratings:\nkubectl exec -it \\\n$(kubectl get pod -l app=ratings -o jsonpath='{.items[0].metadata.name}') \\\n-c ratings -- curl productpage:9080/productpage \\\n| grep -o \".*\"\n\n# Check that the Bookinfo app responds to a curl request sent to it from outside the cluster, using the external IP saved earlier:\ncurl -I http://${GATEWAY_URL}/productpage\n\n# Open the Bookinfo application in your browser. Run this command in the Cloud Shell to get the full URL:\necho http://${GATEWAY_URL}/productpage\n\n\n```\n\n## Use the Anthos Service Mesh dashboard view routing to multiple versions\n\n- Navigation > Anthos > Service Mesh.\n- Click on the productpage service, then select Connected Services on the left.\n- Select the OUTBOUND tab and note the two services called by the productpage pods.\n- Click on the reviews service.\n- Note the service statistics, then select the Infrastructure link on the left-hand menu.\n- You can see that there are multiple pods, running different versions of the reviews logic, that receive traffic sent to the reviews service.\n- Click on Traffic in the left-hand menu to see another view of traffic distribution.\n- You can see that there is relatively even distribution of traffic across the three backend pods running the different versions of the application logic.\n- Click on the Anthos Service Mesh logo in the upper left corner to return to the main dashboard page.\n- Click on the TOPOLOGY link in the upper-right corner\n- Rearrange the mesh graph so that you can easily view:\n - The productpage service going to productpage deployment\n - The productpage deployment going to reviews service\n - The reviews service going to three version of reviews\n\n## Apply default destination rules, for all available versions\n\n- Review the configuration found in [Github](https://github.com/istio/istio/blob/master/samples/bookinfo/networking/destination-rule-all.yaml) . This configuration defines 4 DestinationRule resources, 1 for each servic\n- Apply the configuration with the following command in Cloud Shell:\n\nDestinationRule is an Istio resource that is used to configure traffic routing and policy rules for network traffic between Kubernetes services. It allows you to specify rules for how traffic should be routed to different versions of a service based on various criteria such as headers, URL paths, and user agents.\n\nHere are some common use cases for DestinationRules:\n\n- Traffic splitting: You can use DestinationRule to distribute traffic to different versions of a service based on the percentage of traffic you want to send to each version.\n- Fault injection: DestinationRule can be used to inject errors or faults into the traffic to a specific version of a service for testing purposes.\n- Circuit breaking: You can configure DestinationRule to apply circuit breaking rules to prevent cascading failures in your service mesh.\n- Traffic shaping: DestinationRule can be used to limit the amount of traffic that can be sent to a particular version of a service or to specific instances of a service.\n- Security: You can use DestinationRule to enforce mutual TLS authentication and other security policies for traffic between services. \n\nDestinationRule is a powerful tool for controlling how traffic flows between services in your Kubernetes cluster, and can help you improve the reliability, performance, and security of your applications.\n\n```bash\nkubectl apply -f https://raw.githubusercontent.com/istio/istio/master/samples/bookinfo/networking/destination-rule-all.yaml\n\n# Check that 4 DestinationRule resources were defined.\nkubectl get destinationrules\n\n# Review the details of the destination rules:\nkubectl get destinationrules -o yaml\n\n\n```\n\n- Wait for 1-2 minutes, then return to the Anthos Service Mesh dashboard.\n- Look in both the table and topology views and confirm that the traffic continues to be evenly distributed across the three backend versions.\n\n## Apply virtual services to route by default to only one version\n\n- Review the configuration found in [Github](https://github.com/istio/istio/blob/master/samples/bookinfo/networking/virtual-service-all-v1.yaml). This configuration defines 4 VirtualService resources, 1 for each service.\n- Apply the configuration with the following command in Cloud Shell:\n\n```bash\nkubectl apply -f https://raw.githubusercontent.com/istio/istio/master/samples/bookinfo/networking/virtual-service-all-v1.yaml\n\n# Check that 4 routes, VirtualService resources, were defined:\nkubectl get virtualservices\n\n# In Cloud Shell, get the external IP address of the ingress gateway:\necho $GATEWAY_URL\n```\n\n- Open the Bookinfo site in your browser. The URL is http://[GATEWAY_URL]/productpage, where GATEWAY_URL is the External IP address of the ingress.\n- Notice that the Book Reviews part of the page displays with no rating stars, no matter how many times you refresh. This is because you configured the mesh to route all traffic for the reviews service to the version reviews:v1 and this version of the service does not access the star ratings service.\n- Wait for 1-2 minutes, then return to the Anthos Service Mesh dashboard by selecting Navigation > Anthos > Service Mesh > reviews > Infrastructure.\n- Select SHOW TIMELINE and focus the chart on the last 5 minutes of traffic. You should see that the traffic goes from being evenly distributed to being routed to the version 1 workload 100% of the time.\n- You can also see the new traffic distribution by looking at the Traffic tab or the topology view - though these both take a couple extra minutes before the data is shown.\n\n\n## Route to a specific version of a service based on user identity\n\n- Review the configuration found in [Github](https://github.com/istio/istio/blob/master/samples/bookinfo/networking/virtual-service-reviews-test-v2.yaml). This configuration defines 1 VirtualService resource.\n- Apply the configuration with the following command in Cloud Shell:\n\n```bash\nkubectl apply -f https://raw.githubusercontent.com/istio/istio/master/samples/bookinfo/networking/virtual-service-reviews-test-v2.yaml\n\n# Confirm the rule is created:\nkubectl get virtualservice reviews\n```\n\n- Browse again to /productpage of the Bookinfo application.\n- This time, click Sign in, and use User Name of jason with no password.\n- Notice the UI shows stars from the rating service.\n\n- To better visualize the effect of the new traffic routing, you can create a new background load of authenticated requests to the service\n- Start a new siege session, generating only 20% of the traffic of the first, but with all requests being authenticated as jason:\n\n```bash\ncurl -c cookies.txt -F \"username=jason\" -L -X \\\n POST http://$GATEWAY_URL/login\ncookie_info=$(grep -Eo \"session.*\" ./cookies.txt)\ncookie_name=$(echo $cookie_info | cut -d' ' -f1)\ncookie_value=$(echo $cookie_info | cut -d' ' -f2)\nsiege -c 5 http://$GATEWAY_URL/productpage \\\n --header \"Cookie: $cookie_name=$cookie_value\"\n```\n\n- Wait for 1-2 minutes, refresh the page showing the Infrastructure telemetry, adjust the timeline to show the current time, and then check in the Anthos Dashboard and you should see that roughly 85% of requests over the last few minutes have gone to version 1 because they are unathenticated. About 15% have gone to version two because they are made as jason.\n- In Cloud Shell, cancel the siege session by typing Ctrl+c.\n- Clean up from this task by removing the application virtual services:\n\n```bash\nkubectl delete -f https://raw.githubusercontent.com/istio/istio/master/samples/bookinfo/networking/virtual-service-all-v1.yaml\n```\n\n- You can wait for 1-2 minutes, refresh the Anthos Service Mesh dashboard, adjust the timeline to show the current time, and confirm that traffic is once again evenly balanced across versions.\n\n\n## Shift traffic gradually from one version of a microservice to another\n\n\n- In Cloud Shell, route all traffic to the v1 version of each service:\n\n```bash\nkubectl apply -f https://raw.githubusercontent.com/istio/istio/master/samples/bookinfo/networking/virtual-service-all-v1.yaml \n```\n\n- Browse again to /productpage of the Bookinfo application and confirm that you do not see stars with reviews\n- Wait 1 minute, then refresh the Anthos Service Mesh dashboard, adjust the timeline to show the current time, and confirm that all traffic has been routed to the v1 backend.\n- Transfer 50% of the traffic from reviews:v1 to reviews:v3.\n\n```bash\nkubectl apply -f \\\n https://raw.githubusercontent.com/istio/istio/master/samples/bookinfo/networking/virtual-service-reviews-50-v3.yaml\n \n \n```\n\n- Browse again to /productpage of the Bookinfo application.\n\n- Notice a roughly even distribution of reviews with no stars, from v1, and reviews with red stars, from v3, that accesses the ratings service.\n- Wait 1 minute, then refresh the page, adjust the timeline to show the, current time, and confirm in the Anthos Service Mesh dashboard that traffic to the reviews service is split 50/50 between v1 and v3.\n- Transfer the remaining 50% of traffic to reviews:v3.\n- Assuming you decide that the reviews:v3 service is stable, route 100% of the traffic to reviews:v3 by applying this virtual service:\n\n```bash\nkubectl apply -f https://raw.githubusercontent.com/istio/istio/master/samples/bookinfo/networking//virtual-service-reviews-v3.yaml\n```\n\n- Test the new routing configuration using the Bookinfo UI.\n- Browse again to /productpage of the Bookinfo application.\n\n- Refresh the /productpage; you will always see book reviews with red colored star ratings for each review.\n\n- Wait 1 minute, refresh the page, then confirm in the Anthos Service Mesh dashboard that all traffic to the reviews service is sent to v3.\n\n- Clean up from this exercise, by removing the application virtual services.\n\n```bash\nkubectl delete -f https://raw.githubusercontent.com/istio/istio/master/samples/bookinfo/networking/virtual-service-all-v1.yaml\n```\n\n## Add timeouts to avoid waiting indefinitelly for service replies\n\n- In Cloud Shell, route all traffic to the v1 version of each service:\n\n```bash\nkubectl apply -f https://raw.githubusercontent.com/istio/istio/master/samples/bookinfo/networking/virtual-service-all-v1.yaml\n```\n\n- Route requests to v2 of the reviews service, i.e., a version that calls the ratings service:\n\n```bash\nkubectl apply -f - < We are auto-injecting the Istio sidecar proxy into the pods deployed in the mtls-client and mtls-service namespaces.\n> The Istio sidecar proxy is a container that runs alongside the application container in the same pod, \n> and it intercepts all inbound and outbound traffic to the pod. It is responsible for implementing the \n> mTLS encryption between services in the Istio service mesh, and enforcing Istio policies such as traffic management, \n> routing, and security.\n\n> By auto-injecting the sidecar proxy, we can ensure that all traffic between services in the mtls-client \n> and mtls-service namespaces is automatically encrypted and secured by Istio. This eliminates the need to \n> modify the application code or configuration, and makes it easy to deploy and manage services in a secure and scalable manner.\n\n> The labels added to the namespaces (istio.io/rev=${VERSION}) are used by Istio's automatic sidecar \n> injection feature to determine which pods should have the sidecar proxy injected into them. \n> The ${VERSION} variable is set based on the revision label of the istiod deployment in the istio-system namespace, \n> and it ensures that the correct version of the Istio sidecar proxy is injected into the pods.\n\n\n\n\n\n\n\n```bash\n# get the revision label\nexport DEPLOYMENT=$(kubectl get deployments -n istio-system | grep istiod)\nexport VERSION=asm-$(echo $DEPLOYMENT | cut -d'-' -f 3)-$(echo $DEPLOYMENT \\\n | cut -d'-' -f 4 | cut -d' ' -f 1)\n# enable auto-injection on the namespaces\nkubectl label namespace mtls-client istio.io/rev=${VERSION} --overwrite\nkubectl label namespace mtls-service istio.io/rev=${VERSION} --overwrite\n```\n\n- Deploy the services in the mtls-* namespaces:\n\n```bash\nkubectl apply -f \\\nhttps://raw.githubusercontent.com/istio/istio/release-1.6/samples/sleep/sleep.yaml \\\n-n mtls-client\nkubectl apply -f \\\nhttps://raw.githubusercontent.com/istio/istio/release-1.6/samples/httpbin/httpbin.yaml \\\n-n mtls-service\n```\n\n- Verify that the sleep service and the httpbin service are each deployed in both the mtls-service and legacy-service namespaces:\n\n```bash\nkubectl get services --all-namespaces\n```\n\n- Verify that a sleep pod is running in the mtls-client and legacy-client namespaces and that an httpbin pod is running in the mtls-service and legacy-service namespaces:\n\n```bash\nkubectl get pods --all-namespaces\n```\n\n- Verify that the two sleep clients can communicate with the two httpbin services\n\n```bash\nfor from in \"mtls-client\" \"legacy-client\"; do\n for to in \"mtls-service\" \"legacy-service\"; do\n kubectl exec $(kubectl get pod -l app=sleep -n ${from} -o jsonpath={.items..metadata.name}) -c sleep -n ${from} -- curl \"http://httpbin.${to}:8000/ip\" -s -o /dev/null -w \"sleep.${from} to httpbin.${to}: %{http_code}\\n\"\n done\ndone\n\n# Output\nsleep.mtls-client to httpbin.mtls-service: 200\nsleep.mtls-client to httpbin.legacy-service: 200\nsleep.legacy-client to httpbin.mtls-service: 200\nsleep.legacy-client to httpbin.legacy-service: 200\n```\n\n### Understand authentication and enable service to service authentication with mTLS\n\n- In the console, go to Navigation Menu > Anthos > Service Mesh.\n- Under Namespace dropdown select mtls-service namespace and then click on the httpbin service located below.\n- In the left side panel, go to Connected Services.\n- Use your mouse to hover over the lock symbol in the Request port column, and verify that green means mTLS and red means plain text.\n- Now check out the Security tab in the left side panel. It shows you that the httpbin service has received both plaintext and mTLS traffic.\n\n\n- Test auto mutual TLS\n- By default, Istio configures destination workloads in PERMISSIVE mode. When PERMISSIVE mode is enabled a service can accept both plaintext and mTLS traffic. mTLS is used when the request contains the X-Forwarded-Client-Cert header.\n\n- Use the Cloud Shell to send a request from the sleep service in the mtls-client namespace to the httpbin service in the mtls-service namespace:\n\n```bash\nkubectl exec $(kubectl get pod -l app=sleep -n mtls-client -o jsonpath={.items..metadata.name}) -c sleep -n mtls-client -- curl http://httpbin.mtls-service:8000/headers -s | grep X-Forwarded-Client-Cert\n# The traffic included the X-Forwarded-Client-Cert header and therefore was mutually authenticated and encrypted\n```\n\n- Now send a request from the sleep service in the mtls-client namespace to the httpbin service in the legacy-service namespace:\n\n```bash\nkubectl exec $(kubectl get pod -l app=sleep -n mtls-client -o jsonpath={.items..metadata.name}) -c sleep -n mtls-client -- curl http://httpbin.legacy-service:8000/headers -s | grep X-Forwarded-Client-Cert\n# The X-Forwarded-Client-Cert header isn't present so the traffic was sent and received in plaintext.\n```\n\n- Finally, send a request from the sleep service in the legacy-client namespace to the httpbin service in the mtls-service namespace:\n\n```bash\nkubectl exec $(kubectl get pod -l app=sleep -n legacy-client -o jsonpath={.items..metadata.name}) -c sleep -n legacy-client -- curl http://httpbin.mtls-service:8000/headers -s | grep X-Forwarded-Client-Cert\n# The X-Forwarded-Client-Cert header isn't present so the traffic was sent and received in plaintext\n```\n\n> Note: The httpbin service in the mtls-service namespace accepted mTLS traffic from the sleep service in the mtls-client namespace and plaintext from the sleep service in the legacy-client namespace.\n\n\n- Enforce STRICT mTLS mode across the service mesh\n\n- In STRICT mode, services injected with the Istio proxy will not accept plaintext traffic and will mutually authenticate with their clients.\n\n- You can enforce STRICT mTLS mode across the whole mesh or on a per-namespace basis by creating PeerAuthentication resources.\n\n![img.png](.images/mTLS-strict-mode.png)\n\n- Create a Peer Authentication resources for the entire Service Mesh:\n\n```bash\nkubectl apply -n istio-system -f - < Note: The httpbin service in the mtls-service namespace now rejects the plaintext traffic it \n> receives from the sleep client in the legacy-client namespace.\n\n- Remove the mesh wide mTLS PeerAuthentication resource by running this command in Cloud Shell:\n\n```bash\nkubectl delete pa mesh-wide-mtls -n istio-system\n```\n\n- Enforce STRICT mTLS mode on a single namespace\n\n- In Cloud Shell create a namespace for STRICT mTLS:\n\n```bash\nkubectl create ns strict-mtls-service\n\n# Enable auto-injection of the Istio sidecar proxy on the new namespace:\n# get the revision label\nexport DEPLOYMENT=$(kubectl get deployments -n istio-system | grep istiod)\nexport VERSION=asm-$(echo $DEPLOYMENT | cut -d'-' -f 3)-$(echo $DEPLOYMENT \\\n | cut -d'-' -f 4 | cut -d' ' -f 1)\n# enable auto-injection on the namespaces\nkubectl label namespace strict-mtls-service istio.io/rev=${VERSION} --overwrite\n\n# Use Cloud Shell to deploy another instance of the httpbin service in the strict-mtls-service namespace:\nkubectl apply -f \\\nhttps://raw.githubusercontent.com/istio/istio/release-1.6/samples/httpbin/httpbin.yaml \\\n-n strict-mtls-service\n\n\n# Create a PeerAuthentication resource for the strict-mtls-service namespace:\nkubectl apply -n strict-mtls-service -f - < Anthos > Service Mesh.\n\n- Under Namespace dropdown select strict-mtls-service namespace and then click on the httpbin service located below.\n\n- In the left side panel, click on Connected Services.\n\n- Use your mouse to hover over the lock symbol in the Request Port column to see that only mTLS traffic has been received.\n- Remove the strict-mtls-service peer authentication policy by running this command in Cloud Shell:\n\n```bash\nkubectl delete pa restricted-mtls -n strict-mtls-service\n```\n\n### Leverage RequestAuthentication and AuthorizationPolicy resources\n\n- This task shows you how to set up and use RequestAuthentication and AuthorizationPolicy resources. Ultimately, you will allow requests that have an approved JWT, and deny requests that don't.\n\n- A RequestAuthentication resource defines the request authentication methods that are supported by a workload. Requests with invalid authentication information will be rejected. Requests with no authentication credentials will be accepted but will not have any authenticated identity.\n\n- Create a RequestAuthentication resource for the httpbin workload in the mtls-service namespace. This policy allows the workload to accept requests with a JWT issued by testing@secure.istio.io.\n\n```bash\nkubectl apply -f - < myfile.txt\n\n# Commit the file using the following Git commands:\ngit config --global user.email \"you@example.com\"\n\ngit config --global user.name \"Your Name\"\n\ngit add myfile.txt\n\ngit commit -m \"First file using Cloud Source Repositories\" myfile.txt\n\n# Once you've committed code to the local repository, add its contents to Cloud Source Repositories using the git push command:\ngit push origin master\n```\n\n## Browse files in the Google Cloud Source Repository\n\n```bash\ngcloud source repos list\n```\n\n## View a file in the Google Cloud repository\n\n- In the Console go to Navigation menu > Source Repositories.\n\n- Click REPO_DEMO > myfile.txt to view the file's contents in the source code browser.\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_028_managing_deployments_using_kubernetes_engine/ReadMe.md", "content": "# Managing deployments using Kubernetes Engine\n\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - Quest - DevOps Essentials](https://www.cloudskillsboost.google/paths)\n\n\n**High Level Objectives**\n- Learn about deployment object\n- Create a deployment\n- Rolling Update\n- Canary deployments\n- Blue/Green deployments\n\n\n\n**Skills**\n- gcp\n- kubernetes\n- canary deployments\n- blue green deployment\n\n\n\n## Set the zone\n\n```bash\ngcloud config set compute/zone us-east5-b\n```\n\n## Get sample code for this lab\n\n```bash\ngsutil -m cp -r gs://spls/gsp053/orchestrate-with-kubernetes .\ncd orchestrate-with-kubernetes/kubernetes\n\n# Create a cluster with 3 nodes (this will take a few minutes to complete):\ngcloud container clusters create bootcamp \\\n --machine-type e2-small \\\n --num-nodes 3 \\\n --scopes \"https://www.googleapis.com/auth/projecthosting,storage-rw\"\n```\n\n\n## Learn about the deployment object\n\n```bash\nkubectl explain deployment\n\n# We can also see all of the fields using the --recursive option:\nkubectl explain deployment --recursive\n\n# We can also see the documentation for a specific field:\nkubectl explain deployment.spec.replicas\n```\n\n## Create a deployment\n\n```bash \n# change to auth:1.0.0\nkubectl create -f deployments/auth.yaml\n\nkubectl get deployments\n\n# When you create a Deployment in Kubernetes, it automatically creates a \n#ReplicaSet as well. The ReplicaSet is responsible for maintaining a \n#specified number of replicas of the Pods defined in the Deployment.\n\n# The Deployment object provides declarative updates for Pods and \n# ReplicaSets, and manages the creation and scaling of ReplicaSets \n# based on the user's desired state. When a Deployment is updated with a \n# new desired state, it creates a new ReplicaSet and gradually scales it \n# up while scaling down the old ReplicaSet, ensuring that the transition \n# between the old and new state is smooth and does not cause downtime.\nkubectl get replicasets\n\nkubectl get pods\n\nkubectl create -f services/auth.yaml\n\n# Now, do the same thing to create and expose the hello deployment:\nkubectl create -f deployments/hello.yaml\nkubectl create -f services/hello.yaml\n\n\n# And one more time to create and expose the frontend deployment:\nkubectl create secret generic tls-certs --from-file tls/\nkubectl create configmap nginx-frontend-conf --from-file=nginx/frontend.conf\nkubectl create -f deployments/frontend.yaml\nkubectl create -f services/frontend.yaml\n\n\nkubectl get secret tls-certs -o yaml\n``` \n\n- Interact with the frontend by grabbing its external IP and then curling to it:\n\n```bash\nkubectl get services frontend\n\ncurl -ks https://\n\n# OR\ncurl -ks https://`kubectl get svc frontend -o=jsonpath=\"{.status.loadBalancer.ingress[0].ip}\"`\n```\n\n- Scale a deployment\n\n```bash\nkubectl explain deployment.spec.replicas\n\nkubectl scale deployment hello --replicas=5\n\n# verify\nkubectl get pods | grep hello- | wc -l\n\n# scale down\nkubectl scale deployment hello --replicas=3\n\n# Again, verify that you have the correct number of Pods:\nkubectl get pods | grep hello- | wc -l\n```\n\n## Rolling update\n\n![img.png](.images/rolling-update.png)\n\n```bash\nkubectl edit deployment hello\n\n# change image to hello:2.0.0\n\n# See the new ReplicaSet that Kubernetes creates.:\nkubectl get replicaset\n\n# You can also see a new entry in the rollout history:\nkubectl rollout history deployment hello\n```\n\n- Pause a rolling update\n- If you detect problems with a running rollout, pause it to stop the update.\n\n```bash\nkubectl rollout pause deployment/hello\n\n# Verify the current state of the rollout:\nkubectl rollout status deployment/hello\n\n# You can also verify this on the Pods directly:\nkubectl get pods -o jsonpath --template='{range .items[*]}{.metadata.name}{\"\\t\"}{\"\\t\"}{.spec.containers[0].image}{\"\\n\"}{end}'\n```\n\n- Resume a rolling update\n\n```bash\nkubectl rollout resume deployment/hello\n\n# When the rollout is complete, you should see the following when running the status command:\nkubectl rollout status deployment/hello\n```\n\n- Rollback an update\n\n```bash\nkubectl rollout undo deployment/hello\n\n# Verify the roll back in the history:\nkubectl rollout history deployment hello\n\n# Finally, verify that all the Pods have rolled back to their previous versions:\nkubectl get pods -o jsonpath --template='{range .items[*]}{.metadata.name}{\"\\t\"}{\"\\t\"}{.spec.containers[0].image}{\"\\n\"}{end}'\n```\n\n## Canary deployments\n\n![img.png](.images/canary-deployments.png)\n\n```bash\nkubectl create -f deployments/hello-canary.yaml\n\n# On the hello service, the selector uses the app:hello selector which will match pods in both the prod \n# deployment and canary deployment. However, because the canary deployment has a fewer number of pods, \n# it will be visible to fewer users\n\n# You can verify the hello version being served by the request:\ncurl -ks https://`kubectl get svc frontend -o=jsonpath=\"{.status.loadBalancer.ingress[0].ip}\"`/version\n\n```\n\n- Canary deployments in production - session affinity\n\n- In this lab, each request sent to the Nginx service had a chance to be served by the canary \n deployment. But what if you wanted to ensure that a user didn't get served by \n the Canary deployment?\n- You can do this by creating a service with session affinity. This way the same user will \n always be served from the same version. In the example below the service is the same as before, \n but a new sessionAffinity field has been added, and set to ClientIP. All clients \n with the same IP address will have their requests sent to the same version of the hello application.\n\n\n```yaml\nkind: Service\napiVersion: v1\nmetadata:\n name: \"hello\"\nspec:\n sessionAffinity: ClientIP\n selector:\n app: \"hello\"\n ports:\n - protocol: \"TCP\"\n port: 80\n targetPort: 80\n```\n\n## Blue-green deployments\n\n![img.png](.images/blue-green-deployments.png)\n\n\n```bash\n# A major downside of blue-green deployments is that you will need to have at least 2x the \n# resources in your cluster necessary to host your application\nkubectl apply -f services/hello-blue.yaml\n\n\nkubectl create -f deployments/hello-green.yaml\n\n# Once you have a green deployment and it has started up properly, verify that the current version of 1.0.0 is still being used:\ncurl -ks https://`kubectl get svc frontend -o=jsonpath=\"{.status.loadBalancer.ingress[0].ip}\"`/version\n\n# Now, update the service to point to the new version:\nkubectl apply -f services/hello-green.yaml\n\n# When the service is updated, the \"green\" deployment will be used immediately. You can now verify that the new version is always being used:\ncurl -ks https://`kubectl get svc frontend -o=jsonpath=\"{.status.loadBalancer.ingress[0].ip}\"`/version\n\n```\n\n- Blue-Green rollback\n\n```bash\n# While the \"blue\" deployment is still running, just update the service back to the old version:\nkubectl apply -f services/hello-blue.yaml\n\n# Once you have updated the service, your rollback will have been successful. \n# Again, verify that the right version is now being used:\ncurl -ks https://`kubectl get svc frontend -o=jsonpath=\"{.status.loadBalancer.ingress[0].ip}\"`/version\n```" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_028_managing_deployments_using_kubernetes_engine/cleanup.sh", "content": "kubectl delete pods healthy-monolith monolith secure-monolith\nkubectl delete services monolith auth frontend hello\nkubectl delete deployments auth frontend hello hello-canary hello-green\nkubectl delete secrets tls-certs\nkubectl delete configmaps nginx-frontend-conf nginx-proxy-conf\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_028_managing_deployments_using_kubernetes_engine/deployments/auth.yaml", "content": "apiVersion: apps/v1\nkind: Deployment\nmetadata:\n name: auth\nspec:\n replicas: 1\n selector:\n matchLabels:\n app: auth\n template:\n metadata:\n labels:\n app: auth\n track: stable\n spec:\n containers:\n - name: auth\n image: \"kelseyhightower/auth:2.0.0\"\n ports:\n - name: http\n containerPort: 80\n - name: health\n containerPort: 81\n resources:\n limits:\n cpu: 0.2\n memory: \"10Mi\"\n livenessProbe:\n httpGet:\n path: /healthz\n port: 81\n scheme: HTTP\n initialDelaySeconds: 5\n periodSeconds: 15\n timeoutSeconds: 5\n readinessProbe:\n httpGet:\n path: /readiness\n port: 81\n scheme: HTTP\n initialDelaySeconds: 5\n timeoutSeconds: 1\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_028_managing_deployments_using_kubernetes_engine/deployments/frontend.yaml", "content": "apiVersion: apps/v1\nkind: Deployment\nmetadata:\n name: frontend\nspec:\n replicas: 1\n selector:\n matchLabels:\n app: frontend\n template:\n metadata:\n labels:\n app: frontend\n track: stable\n spec:\n containers:\n - name: nginx\n image: \"nginx:1.9.14\"\n lifecycle:\n preStop:\n exec:\n command: [\"/usr/sbin/nginx\",\"-s\",\"quit\"]\n volumeMounts:\n - name: \"nginx-frontend-conf\"\n mountPath: \"/etc/nginx/conf.d\"\n - name: \"tls-certs\"\n mountPath: \"/etc/tls\"\n volumes:\n - name: \"tls-certs\"\n secret:\n secretName: \"tls-certs\"\n - name: \"nginx-frontend-conf\"\n configMap:\n name: \"nginx-frontend-conf\"\n items:\n - key: \"frontend.conf\"\n path: \"frontend.conf\"\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_028_managing_deployments_using_kubernetes_engine/deployments/hello-canary.yaml", "content": "apiVersion: apps/v1\nkind: Deployment\nmetadata:\n name: hello-canary\nspec:\n replicas: 1\n selector:\n matchLabels:\n app: hello\n template:\n metadata:\n labels:\n app: hello\n track: canary\n version: 2.0.0\n spec:\n containers:\n - name: hello\n image: kelseyhightower/hello:2.0.0\n ports:\n - name: http\n containerPort: 80\n - name: health\n containerPort: 81\n resources:\n limits:\n cpu: 0.2\n memory: 10Mi\n livenessProbe:\n httpGet:\n path: /healthz\n port: 81\n scheme: HTTP\n initialDelaySeconds: 5\n periodSeconds: 15\n timeoutSeconds: 5\n readinessProbe:\n httpGet:\n path: /readiness\n port: 81\n scheme: HTTP\n initialDelaySeconds: 5\n timeoutSeconds: 1\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_028_managing_deployments_using_kubernetes_engine/deployments/hello-green.yaml", "content": "apiVersion: apps/v1\nkind: Deployment\nmetadata:\n name: hello-green\nspec:\n replicas: 3\n selector:\n matchLabels:\n app: hello\n template:\n metadata:\n labels:\n app: hello\n track: stable\n version: 2.0.0\n spec:\n containers:\n - name: hello\n image: kelseyhightower/hello:2.0.0\n ports:\n - name: http\n containerPort: 80\n - name: health\n containerPort: 81\n resources:\n limits:\n cpu: 0.2\n memory: 10Mi\n livenessProbe:\n httpGet:\n path: /healthz\n port: 81\n scheme: HTTP\n initialDelaySeconds: 5\n periodSeconds: 15\n timeoutSeconds: 5\n readinessProbe:\n httpGet:\n path: /readiness\n port: 81\n scheme: HTTP\n initialDelaySeconds: 5\n timeoutSeconds: 1\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_028_managing_deployments_using_kubernetes_engine/deployments/hello.yaml", "content": "apiVersion: apps/v1\nkind: Deployment\nmetadata:\n name: hello\nspec:\n replicas: 3\n selector:\n matchLabels:\n app: hello\n template:\n metadata:\n labels:\n app: hello\n track: stable\n version: 1.0.0\n spec:\n containers:\n - name: hello\n image: \"kelseyhightower/hello:1.0.0\"\n ports:\n - name: http\n containerPort: 80\n - name: health\n containerPort: 81\n resources:\n limits:\n cpu: 0.2\n memory: \"10Mi\"\n livenessProbe:\n httpGet:\n path: /healthz\n port: 81\n scheme: HTTP\n initialDelaySeconds: 5\n periodSeconds: 15\n timeoutSeconds: 5\n readinessProbe:\n httpGet:\n path: /readiness\n port: 81\n scheme: HTTP\n initialDelaySeconds: 5\n timeoutSeconds: 1\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_028_managing_deployments_using_kubernetes_engine/nginx/frontend.conf", "content": "upstream hello {\n server hello.default.svc.cluster.local;\n}\n\nupstream auth {\n server auth.default.svc.cluster.local;\n}\n\nserver {\n listen 443;\n ssl on;\n\n ssl_certificate /etc/tls/cert.pem;\n ssl_certificate_key /etc/tls/key.pem;\n\n location / {\n proxy_pass http://hello;\n }\n\n location /login {\n proxy_pass http://auth;\n }\n}\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_028_managing_deployments_using_kubernetes_engine/nginx/proxy.conf", "content": "server {\n listen 443;\n ssl on;\n\n ssl_certificate /etc/tls/cert.pem;\n ssl_certificate_key /etc/tls/key.pem;\n\n location / {\n proxy_pass http://127.0.0.1:80;\n }\n}\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_028_managing_deployments_using_kubernetes_engine/pods/healthy-monolith.yaml", "content": "apiVersion: v1\nkind: Pod\nmetadata:\n name: \"healthy-monolith\"\n labels:\n app: monolith\nspec:\n containers:\n - name: monolith\n image: kelseyhightower/monolith:1.0.0\n ports:\n - name: http\n containerPort: 80\n - name: health\n containerPort: 81\n resources:\n limits:\n cpu: 0.2\n memory: \"10Mi\"\n livenessProbe:\n httpGet:\n path: /healthz\n port: 81\n scheme: HTTP\n initialDelaySeconds: 5\n periodSeconds: 15\n timeoutSeconds: 5\n readinessProbe:\n httpGet:\n path: /readiness\n port: 81\n scheme: HTTP\n initialDelaySeconds: 5\n timeoutSeconds: 1\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_028_managing_deployments_using_kubernetes_engine/pods/monolith.yaml", "content": "apiVersion: v1\nkind: Pod\nmetadata:\n name: monolith\n labels:\n app: monolith\nspec:\n containers:\n - name: monolith\n image: kelseyhightower/monolith:1.0.0\n args:\n - \"-http=0.0.0.0:80\"\n - \"-health=0.0.0.0:81\"\n - \"-secret=secret\"\n ports:\n - name: http\n containerPort: 80\n - name: health\n containerPort: 81\n resources:\n limits:\n cpu: 0.2\n memory: \"10Mi\"\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_028_managing_deployments_using_kubernetes_engine/pods/secure-monolith.yaml", "content": "apiVersion: v1\nkind: Pod\nmetadata:\n name: \"secure-monolith\"\n labels:\n app: monolith\nspec:\n containers:\n - name: nginx\n image: \"nginx:1.9.14\"\n lifecycle:\n preStop:\n exec:\n command: [\"/usr/sbin/nginx\",\"-s\",\"quit\"]\n volumeMounts:\n - name: \"nginx-proxy-conf\"\n mountPath: \"/etc/nginx/conf.d\"\n - name: \"tls-certs\"\n mountPath: \"/etc/tls\"\n - name: monolith\n image: \"kelseyhightower/monolith:1.0.0\"\n ports:\n - name: http\n containerPort: 80\n - name: health\n containerPort: 81\n resources:\n limits:\n cpu: 0.2\n memory: \"10Mi\"\n livenessProbe:\n httpGet:\n path: /healthz\n port: 81\n scheme: HTTP\n initialDelaySeconds: 5\n periodSeconds: 15\n timeoutSeconds: 5\n readinessProbe:\n httpGet:\n path: /readiness\n port: 81\n scheme: HTTP\n initialDelaySeconds: 5\n timeoutSeconds: 1\n volumes:\n - name: \"tls-certs\"\n secret:\n secretName: \"tls-certs\"\n - name: \"nginx-proxy-conf\"\n configMap:\n name: \"nginx-proxy-conf\"\n items:\n - key: \"proxy.conf\"\n path: \"proxy.conf\"\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_028_managing_deployments_using_kubernetes_engine/services/auth.yaml", "content": "kind: Service\napiVersion: v1\nmetadata:\n name: \"auth\"\nspec:\n selector:\n app: \"auth\"\n ports:\n - protocol: \"TCP\"\n port: 80\n targetPort: 80\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_028_managing_deployments_using_kubernetes_engine/services/frontend.yaml", "content": "kind: Service\napiVersion: v1\nmetadata:\n name: \"frontend\"\nspec:\n selector:\n app: \"frontend\"\n ports:\n - protocol: \"TCP\"\n port: 443\n targetPort: 443\n type: LoadBalancer\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_028_managing_deployments_using_kubernetes_engine/services/hello-blue.yaml", "content": "kind: Service\napiVersion: v1\nmetadata:\n name: \"hello\"\nspec:\n selector:\n app: \"hello\"\n version: 1.0.0\n ports:\n - protocol: \"TCP\"\n port: 80\n targetPort: 80\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_028_managing_deployments_using_kubernetes_engine/services/hello-green.yaml", "content": "kind: Service\napiVersion: v1\nmetadata:\n name: hello\nspec:\n selector:\n app: hello\n version: 2.0.0\n ports:\n - protocol: TCP\n port: 80\n targetPort: 80\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_028_managing_deployments_using_kubernetes_engine/services/hello.yaml", "content": "kind: Service\napiVersion: v1\nmetadata:\n name: \"hello\"\nspec:\n selector:\n app: \"hello\"\n ports:\n - protocol: \"TCP\"\n port: 80\n targetPort: 80\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_028_managing_deployments_using_kubernetes_engine/services/monolith.yaml", "content": "kind: Service\napiVersion: v1\nmetadata:\n name: \"monolith\"\nspec:\n selector:\n app: \"monolith\"\n secure: \"enabled\"\n ports:\n - protocol: \"TCP\"\n port: 443\n targetPort: 443\n nodePort: 31000\n type: NodePort\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_029_trouble_shooting_workloads_on_gke_for_sre/ReadMe.md", "content": "# Troubleshooting Workloads on GKE for Site Reliability Engineers\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - Quest - DevOps Essentials](https://www.cloudskillsboost.google/paths)\n\n\n**High Level Objectives**\n- Access operational data through GKE Dashboards\n- Proactive monitoring with logs-based metrics\n- Create a SLO\n- Define an alert on the SLO\n\n\n\n**Skills**\n- gcp\n- log based metrics\n- sre\n- gke\n- monitoring\n- slo\n- alerting\n- troubleshooting\n\n\n\n\n\n## Navigating Google Kubernetes Engine (GKE) resource pages\n\n- In Cloud Console, from the Navigation menu go to Kubernetes Engine > Clusters.\n- Confirm that you see the following Kubernetes cluster available: cloud-ops-sandbox. Validate that each cluster has a green checkbox next to it to indicate it is up and running.\n- Click on the cloud-ops-sandbox link under the Name column to navigate to the cluster's Details tab.\n\n## Accessing operational data through GKE Dashboards\n\n- Navigate to Navigation menu > Kubernetes Engine > Services & Ingress. Click on the Endpoint (an IP address) for the frontend-external service.\n- Click on any product displayed on the landing page to reproduce the error reported.\n\n\n- Navigate to Cloud Monitoring from Cloud Console, from the Navigation Menu go to Monitoring > Dashboards.\n- When the Dashboards landing page opens, click GKE.\n- Click on the Add Filter button at the top of the GKE Dashboard page.\n- From the available filters, select Workloads > recommendationservice.\n\n- You will re-deploy the recommendationservice microservice to ensure that the error is no longer present.\n\n```bash\ngit clone --depth 1 --branch csb_1220 https://github.com/GoogleCloudPlatform/cloud-ops-sandbox.git\n\n\ncd cloud-ops-sandbox/sre-recipes\n\n# Connect to cluster\n./sandboxctl sre-recipes restore \"recipe3\"\n\n# Check the service back again\n```\n\n## Proactive monitoring with logs-based metrics\n\n- From Cloud Console, click on the Navigation Menu > Logging > Logs Explorer.\n- In the Query results section click on +Create metric. This will open a new tab to create a logs based metric.\n- Enter the following options on the Create logs metric page:\n\n- Metric Type: Counter\n- Log metric name: Error_Rate_SLI\n- Filter Selection: (Copy and paste the filter below)\n\n```bash\nresource.labels.cluster_name=\"cloud-ops-sandbox\" AND resource.labels.namespace_name=\"default\" AND resource.type=\"k8s_container\" AND labels.k8s-pod/app=\"recommendationservice\" AND severity>=ERROR\n```\n\n## Creating a SLO\n\n- Navigate to Navigation menu > Monitoring > Services. The resulting page will display a list of all services deployed to GKE for the application workload.\n\n- Choose a metric: Other\n\n- Request-based or windows-based: Request Based\n- the Performance Metric must be set to the following value: custom.googleapis.com/opencensus/grpc.io/client/roundtrip_latency. This will show the roundtrip latency of requests made by the client to the recommendation service.\n- Set the Performance metric to Less than -∞ to 100 ms.\n\n- Period type: Calendar\n- Period length: Calendar month\n- Performance Goal: 99%\n\n\n## Define an alert on the SLO\n\n- Navigate to Navigation menu > Monitoring > Services.\n\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_030_minimal_nodejs_app_dockerize_google_artifact_registry/ReadMe.md", "content": "# Minimal NodeJS App - Dockerize - Google Artifact Registry \n\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - Lab - Introduction to Docker](https://www.cloudskillsboost.google/paths)\n\n\n**High Level Objectives**\n- Build a minimal NodeJS app\n- Dockerize the app\n- Run locally and debug using docker\n- Push to Google Artifact Registry\n\n\n\n\n**Skills**\n- gcp\n- docker\n- nodejs\n- artifact registry\n\n\n## Build\n\n```bash\nmkdir test && cd test\n\n\ncat > Dockerfile < app.js < {\n res.statusCode = 200;\n res.setHeader('Content-Type', 'text/plain');\n res.end('Hello World\\n');\n});\nserver.listen(port, hostname, () => {\n console.log('Server running at http://%s:%s/', hostname, port);\n});\nprocess.on('SIGINT', function() {\n console.log('Caught interrupt signal and will exit');\n process.exit();\n});\nEOF\n```\n\n- Docker build\n\n```bash\ndocker build -t node-app:0.1 .\n```\n\n- Now, run the following command to look at the images you built:\n\n```bash\ndocker images\n```\n\n## Run\n\n```bash\ndocker run -p 4000:80 --name my-app node-app:0.1\n```\n\n- Open another terminal (in Cloud Shell, click the + icon), and test the server:\n\n```bash\ncurl http://localhost:4000\n```\n\n- Close the initial terminal and then run the following command to stop and remove the container:\n\n```bash\ndocker stop my-app && docker rm my-app\n```\n\n- Now run the following command to start the container in the background:\n\n```yaml\ndocker run -p 4000:80 --name my-app -d node-app:0.1\ndocker ps\n```\n\n- Notice the container is running in the output of docker ps. You can look at the logs by executing docker logs [container_id].\n\n```bash\ndocker logs [container_id]\n```\n\n- In your Cloud Shell, open the test directory you created earlier in the lab:\n\n```bash\ncd test\n```\n\n- Edit app.js with a text editor of your choice (for example nano or vim) and replace \"Hello World\" with another string:\n\n```bash\n....\nconst server = http.createServer((req, res) => {\n res.statusCode = 200;\n res.setHeader('Content-Type', 'text/plain');\n res.end('Welcome to Cloud\\n');\n});\n....\n```\n\n- Build this new image and tag it with 0.2:\n\n```bash\ndocker build -t node-app:0.2 .\n```\n\n- Run another container with the new image version. \n Notice how we map the host's port 8080 instead of 80. You can't use host port 4000 because it's already in use.\n\n```bash\ndocker run -p 8080:80 --name my-app-2 -d node-app:0.2\ndocker ps\n```\n\n- Test the containers:\n\n```bash\ncurl http://localhost:8080\n\n## And now test the first container you made:\ncurl http://localhost:4000\n```\n\n## Debug\n\n- You can look at the logs of a container using docker logs [container_id]. \n If you want to follow the log's output as the container is running, use the -f option.\n\n```bash\ndocker logs -f [container_id]\n```\n\n- You can use docker exec to do this.\n\n```bash\ndocker exec -it [container_id] bash\n\n## look at dir\nls\n```\n\n- You can examine a container's metadata in Docker by using Docker inspect:\n\n```bash\ndocker inspect [container_id]\n```\n\n- Use --format to inspect specific fields from the returned JSON. For example:\n\n```bash\ndocker inspect --format='{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' [container_id]\n```\n\n## Publish\n\n- Create the target Docker repository\n\n- From the Navigation Menu, under CI/CD navigate to Artifact Registry > Repositories.\n- Specify my-repository as the repository name.\n\n\n- Configure authentication\n\n```bash\n# To set up authentication to Docker repositories in the region us-central1, run the following command in Cloud Shell:\ngcloud auth configure-docker us-central1-docker.pkg.dev\n```\n\n- Push the container to Artifact Registry\n\n```bash\nexport PROJECT_ID=$(gcloud config get-value project)\ncd ~/test\n\n# Run the command to tag node-app:0.2.\ndocker build -t us-central1-docker.pkg.dev/$PROJECT_ID/my-repository/node-app:0.2 .\n\n\ndocker images\n\n# Push this image to Artifact Registry.\ndocker push us-central1-docker.pkg.dev/$PROJECT_ID/my-repository/node-app:0.2\n\n```\n\n- Verify the image was pushed in the Artifact Registry console.\n\n- Test the image\n\n```bash\n# Stop and remove all containers:\ndocker stop $(docker ps -q)\ndocker rm $(docker ps -aq)\n```\n\n- Run the following command to remove all of the Docker images.\n\n```bash\ndocker rmi us-central1-docker.pkg.dev/$PROJECT_ID/my-repository/node-app:0.2\ndocker rmi node:lts\ndocker rmi -f $(docker images -aq) # remove remaining images\ndocker images\n```\n\n- Pull the image and run it.\n\n```bash\ndocker pull us-central1-docker.pkg.dev/$PROJECT_ID/my-repository/node-app:0.2\ndocker run -p 4000:80 -d us-central1-docker.pkg.dev/$PROJECT_ID/my-repository/node-app:0.2\ncurl http://localhost:4000\n```\n\n\n\n\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_030_minimal_nodejs_app_dockerize_google_artifact_registry/test/Dockerfile", "content": "# Use an official Node runtime as the parent image\nFROM node:lts\n# Set the working directory in the container to /app\nWORKDIR /app\n# Copy the current directory contents into the container at /app\nADD . /app\n# Make the container's port 80 available to the outside world\nEXPOSE 80\n# Run app.js using node when the container launches\nCMD [\"node\", \"app.js\"]\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_030_minimal_nodejs_app_dockerize_google_artifact_registry/test/app.js", "content": "/*\nThis is a Node.js server that listens for HTTP requests on port 80 (the standard HTTP port)\nand responds with a \"Hello World\" message in plain text format\n*/\n\n// imports the Node.js http module, which provides functionality for creating an HTTP server.\nconst http = require('http');\n\n// defines two constants, hostname and port, which specify the address and port number that the server will listen on\nconst hostname = '0.0.0.0';\nconst port = 80;\n\n// creates an HTTP server using the http.createServer() method, which takes a callback\n// function as its argument.\n// This callback function is called whenever a client makes a request to the server.\nconst server = http.createServer((req, res) => {\n // The callback function sets the HTTP response status code to 200 (OK),\n res.statusCode = 200;\n //sets the Content-Type header to text/plain,\n res.setHeader('Content-Type', 'text/plain');\n // and sends the \"Hello World\" message as the response body.\n res.end('Hello World\\n');\n});\n\n// The server.listen() method is called to start the server listening on the\n// specified hostname and port number. It also takes a callback function that\n// is called once the server starts listening.\n// This callback function just logs a message to the console to indicate that the server is running.\nserver.listen(port, hostname, () => {\n console.log('Server running at http://%s:%s/', hostname, port);\n});\n\n// Finally, a SIGINT event listener is added to the process object.\n// This listener is triggered when the user presses Ctrl-C to stop the server.\n// When the listener is triggered, it logs a message to the console and exits the process.\nprocess.on('SIGINT', function() {\n console.log('Caught interrupt signal and will exit');\n process.exit();\n});\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_031_hello_node_kubernetes__node/Dockerfile", "content": "# Use Node.js v6.9.2 as base image\nFROM node:6.9.2\n\n# Expose port 8080 for incoming traffic\nEXPOSE 8080\n\n# Copy the server.js file from the current directory to the image\nCOPY server.js .\n\n# Set the default command to run the server.js file with Node.js\nCMD node server.js\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_031_hello_node_kubernetes__node/ReadMe.md", "content": "# Hello Node Kubernetes\n\n[https://www.cloudskillsboost.google](https://www.cloudskillsboost.google)\n\n[Select - Lab - Hello Node Kubernetes](https://www.cloudskillsboost.google/paths)\n\n\n**High Level Objectives**\n- Create a Node.js server.\n- Create a Docker container image. \n- Create a container cluster. \n- Create a Kubernetes pod. \n- Scale up your services.\n\n\n**Skills**\n- gcp\n- kubernetes\n- docker\n- nodejs\n- pods\n- deployments\n- services\n- scaling\n- load balancing\n\n\n\nhow the pieces fit together with one another\n\n![img.png](.images/moving-parts.png)\n\n\n## Create Nodejs application\n\n```bash\ntouch server.js\n\n# copy the file contents\n\n\nnode server.js # run the server\n\n# in another terminal session \ncurl localhost:8080\n```\n\n## Create Dockerfile\n\n```Dockefile\n# Use Node.js v6.9.2 as base image\nFROM node:6.9.2\n\n# Expose port 8080 for incoming traffic\nEXPOSE 8080\n\n# Copy the server.js file from the current directory to the image\nCOPY server.js .\n\n# Set the default command to run the server.js file with Node.js\nCMD node server.js\n```\n\n- Build and Run\n\n```bash\nexport PROJECT_ID=$(gcloud config get-value project -q)\n\n# Build the image with the following, replacing PROJECT_ID with your Project ID\ndocker build -t gcr.io/$PROJECT_ID/hello-node:v1 .\n\n# Run the following command replacing PROJECT_ID with your Project ID\ndocker run -d -p 8080:8080 gcr.io/$PROJECT_ID/hello-node:v1\n\n# Test\ncurl http://localhost:8080\n\n\n# Check running containers\ndocker ps\n\n# Stop the container\ndocker stop \n\n\n# Push\n\n# Run this command, replacing PROJECT_ID with your Project ID,\n\ngcloud auth configure-docker\ndocker push gcr.io/$PROJECT_ID/hello-node:v1\n```\n\n## Create your cluster\n\n```bash\n## Replace PROJECT_ID\ngcloud config set project $PROJECT_ID\n\n## Create a cluster with two n1-standard-1 nodes (this will take a few minutes to complete):\ngcloud container clusters create hello-world \\\n --num-nodes 2 \\\n --machine-type n1-standard-1 \\\n --zone us-central1-a\n \n# Check the cluster in the Cloud Console\n```\n\n## Create your pod\n\n```bash\n# Create a pod with the kubectl run command\n## Replace project ID\nkubectl create deployment hello-node \\\n --image=gcr.io/$PROJECT_ID/hello-node:v1\n \n# Check deployment\nkubectl get deployments\n\n# pods\nkubectl get pods\n\n```\n\n## Allow external traffic\n\n```bash\n# From Cloud Shell you can expose the pod to the public internet with the kubectl expose \n# command combined with the --type=\"LoadBalancer\" flag. \n# This flag is required for the creation of an externally accessible IP\nkubectl expose deployment hello-node --type=\"LoadBalancer\" --port=8080\n\n# Check services\nkubectl get services\n\n# Test application\ncurl http://:8080\n```\n\n\n## Scale up your service\n\n```bash\n# Scale up your service to four replicas\nkubectl scale deployment hello-node --replicas=4\n\n# Check deployment\nkubectl get deployment\n\n# Check pods\nkubectl get pods\n\n```\n\n\nState of our cluster\n\n![img.png](.images/state-of-cluster.png)\n\n\n## Roll out an upgrade to your service\n\n- Change the server.js file to return a different message\n\n```bash\nresponse.end(\"Hello Kubernetes World!\");\n```\n\n- Build and push the new image\n\n```bash\ndocker build -t gcr.io/$PROJECT_ID/hello-node:v2 .\n\ndocker push gcr.io/$PROJECT_ID/hello-node:v2\n```\n\n- Edit the deployment to use the new image\n\n```bash\nkubectl set image deployment/hello-node hello-node=gcr.io/$PROJECT_ID/hello-node:v2\n# OR\nkubectl edit deployment hello-node\n# change the image to gcr.io/PROJECT_ID/hello-node:v2\n```\n\n- Check the deployment\n\n```bash\nkubectl get deployments\n```\n\n\n\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_031_hello_node_kubernetes__node/server.js", "content": "/*\nThis is a basic Node.js code that creates an HTTP server and listens for\nincoming requests on port 8080. When a request is received, it responds with a HTTP\n200 status code and the message \"Hello World!\".\n*/\n\n// we are importing the Node.js http module and defining a function called handleRequest\n// which takes in two arguments, request and response. When a request is received by the server,\n// this function is called to handle the request.\nvar http = require('http');\n// Inside the handleRequest function, the response is set to return a HTTP 200\n// status code using the writeHead method of the response object, and the response\n// body is set to \"Hello World!\" using the end method of the response object.\nvar handleRequest = function(request, response) {\n response.writeHead(200);\n response.end(\"Hello World!\");\n}\n// The http.createServer method is used to create an HTTP server and\n// assign the handleRequest function as the request handler. Finally,\n// the server is started by calling the listen method of the server object\n// and specifying the port to listen on.\nvar www = http.createServer(handleRequest);\nwww.listen(8080);" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_032_setting_up_jenkins_on_kubernetes_engine/ReadMe.md", "content": "\n\n\n**High Level Objectives**\n- Prepare the environment\n- Configure Helm\n- Configure and install Jenkins\n- Connect to Jenkins\n\n\n**Skills**\n- gcp\n- kubernetes\n- docker\n- nodejs\n- pods\n- jenkins\n- helm\n- deployments\n- services\n\n\n## Prepare the environment\n\n\n```bash\n# Set the default Compute Engine zone to us-central1-c:\ngcloud config set compute/zone us-central1-c\n\n# Clone the sample code:\ngit clone https://github.com/GoogleCloudPlatform/continuous-deployment-on-kubernetes.git\n\n# Navigate to the sample code directory:\ncd continuous-deployment-on-kubernetes\n```\n\n\n- Creating a Kubernetes cluster\n\n```bash\ngcloud container clusters create jenkins-cd \\\n--num-nodes 2 \\\n--scopes \"https://www.googleapis.com/auth/projecthosting,cloud-platform\"\n```\n\n- confirm cluster is running\n\n```bash\ngcloud container clusters list\n```\n\n- Get the credentials for your cluster. Kubernetes Engine uses these credentials to access your newly provisioned cluster.\n\n```bash\ngcloud container clusters get-credentials jenkins-cd\n\n# Verify that you can access your cluster by running the following command:\nkubectl cluster-info\n```\n\n\n## Configure Helm\n\n- Add Helm's jenkins chart repository:\n\n```bash\nhelm repo add jenkins https://charts.jenkins.io\n\n# Update the repo to ensure you get the latest list of charts:\nhelm repo update\n```\n\n## Configure and install Jenkins\n\n```bash\n# Use the Helm CLI to deploy the chart with your configuration set:\nhelm upgrade --install -f jenkins/values.yaml myjenkins jenkins/jenkins\n```\n\n- Once that command completes ensure the Jenkins pod goes to the Running state and the container is in the READY state.\n\n```bash\nkubectl get pods\n```\n\n- Run the following command to setup port forwarding to the Jenkins UI from the Cloud Shell:\n\n```bash\necho http://127.0.0.1:8080\nkubectl --namespace default port-forward svc/myjenkins 8080:8080 >> /dev/null &\n```\n\n- Now, check that the Jenkins Service was created properly:\n\n```bash\nkubectl get svc\n```\n\n## Connect to Jenkins\n\n- The Jenkins chart will automatically create an admin password for you. To retrieve it, run:\n\n```bash\nkubectl exec --namespace default -it svc/myjenkins -c jenkins -- /bin/cat /run/secrets/additional/chart-admin-password && echo\n```" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_032_setting_up_jenkins_on_kubernetes_engine/values.yaml", "content": "controller:\n installPlugins:\n - kubernetes:latest\n - workflow-job:latest\n - workflow-aggregator:latest\n - credentials-binding:latest\n - git:latest\n - google-oauth-plugin:latest\n - google-source-plugin:latest\n - google-kubernetes-engine:latest\n - google-storage-plugin:latest\n resources:\n requests:\n cpu: \"50m\"\n memory: \"1024Mi\"\n limits:\n cpu: \"1\"\n memory: \"3500Mi\"\n javaOpts: \"-Xms3500m -Xmx3500m\"\n serviceType: ClusterIP\nagent:\n resources:\n requests:\n cpu: \"500m\"\n memory: \"256Mi\"\n limits:\n cpu: \"1\"\n memory: \"512Mi\"\npersistence:\n size: 100Gi\nserviceAccount:\n name: cd-jenkins\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_033_continuous_delivery_with_jenkins_in_kubernetes_engine/Jenkinsfile", "content": "pipeline {\n\n environment {\n PROJECT = \"REPLACE_WITH_YOUR_PROJECT_ID\"\n APP_NAME = \"gceme\"\n FE_SVC_NAME = \"${APP_NAME}-frontend\"\n CLUSTER = \"jenkins-cd\"\n CLUSTER_ZONE = \"us-east1-d\"\n IMAGE_TAG = \"gcr.io/${PROJECT}/${APP_NAME}:${env.BRANCH_NAME}.${env.BUILD_NUMBER}\"\n JENKINS_CRED = \"${PROJECT}\"\n }\n\n agent {\n kubernetes {\n label 'sample-app'\n defaultContainer 'jnlp'\n yaml \"\"\"\napiVersion: v1\nkind: Pod\nmetadata:\nlabels:\n component: ci\nspec:\n # Use service account that can deploy to all namespaces\n serviceAccountName: cd-jenkins\n containers:\n - name: golang\n image: golang:1.10\n command:\n - cat\n tty: true\n - name: gcloud\n image: gcr.io/cloud-builders/gcloud\n command:\n - cat\n tty: true\n - name: kubectl\n image: gcr.io/cloud-builders/kubectl\n command:\n - cat\n tty: true\n\"\"\"\n}\n }\n stages {\n stage('Test') {\n steps {\n container('golang') {\n sh \"\"\"\n ln -s `pwd` /go/src/sample-app\n cd /go/src/sample-app\n go test\n \"\"\"\n }\n }\n }\n stage('Build and push image with Container Builder') {\n steps {\n container('gcloud') {\n sh \"PYTHONUNBUFFERED=1 gcloud builds submit -t ${IMAGE_TAG} .\"\n }\n }\n }\n stage('Deploy Canary') {\n // Canary branch\n when { branch 'canary' }\n steps {\n container('kubectl') {\n // Change deployed image in canary to the one we just built\n sh(\"sed -i.bak 's#corelab/gceme:1.0.0#${IMAGE_TAG}#' ./k8s/canary/*.yaml\")\n step([$class: 'KubernetesEngineBuilder', namespace:'production', projectId: env.PROJECT, clusterName: env.CLUSTER, zone: env.CLUSTER_ZONE, manifestPattern: 'k8s/services', credentialsId: env.JENKINS_CRED, verifyDeployments: false])\n step([$class: 'KubernetesEngineBuilder', namespace:'production', projectId: env.PROJECT, clusterName: env.CLUSTER, zone: env.CLUSTER_ZONE, manifestPattern: 'k8s/canary', credentialsId: env.JENKINS_CRED, verifyDeployments: true])\n sh(\"echo http://`kubectl --namespace=production get service/${FE_SVC_NAME} -o jsonpath='{.status.loadBalancer.ingress[0].ip}'` > ${FE_SVC_NAME}\")\n }\n }\n }\n stage('Deploy Production') {\n // Production branch\n when { branch 'master' }\n steps{\n container('kubectl') {\n // Change deployed image in canary to the one we just built\n sh(\"sed -i.bak 's#corelab/gceme:1.0.0#${IMAGE_TAG}#' ./k8s/production/*.yaml\")\n step([$class: 'KubernetesEngineBuilder', namespace:'production', projectId: env.PROJECT, clusterName: env.CLUSTER, zone: env.CLUSTER_ZONE, manifestPattern: 'k8s/services', credentialsId: env.JENKINS_CRED, verifyDeployments: false])\n step([$class: 'KubernetesEngineBuilder', namespace:'production', projectId: env.PROJECT, clusterName: env.CLUSTER, zone: env.CLUSTER_ZONE, manifestPattern: 'k8s/production', credentialsId: env.JENKINS_CRED, verifyDeployments: true])\n sh(\"echo http://`kubectl --namespace=production get service/${FE_SVC_NAME} -o jsonpath='{.status.loadBalancer.ingress[0].ip}'` > ${FE_SVC_NAME}\")\n }\n }\n }\n stage('Deploy Dev') {\n // Developer Branches\n when {\n not { branch 'master' }\n not { branch 'canary' }\n }\n steps {\n container('kubectl') {\n // Create namespace if it doesn't exist\n sh(\"kubectl get ns ${env.BRANCH_NAME} || kubectl create ns ${env.BRANCH_NAME}\")\n // Don't use public load balancing for development branches\n sh(\"sed -i.bak 's#LoadBalancer#ClusterIP#' ./k8s/services/frontend.yaml\")\n sh(\"sed -i.bak 's#corelab/gceme:1.0.0#${IMAGE_TAG}#' ./k8s/dev/*.yaml\")\n step([$class: 'KubernetesEngineBuilder', namespace: \"${env.BRANCH_NAME}\", projectId: env.PROJECT, clusterName: env.CLUSTER, zone: env.CLUSTER_ZONE, manifestPattern: 'k8s/services', credentialsId: env.JENKINS_CRED, verifyDeployments: false])\n step([$class: 'KubernetesEngineBuilder', namespace: \"${env.BRANCH_NAME}\", projectId: env.PROJECT, clusterName: env.CLUSTER, zone: env.CLUSTER_ZONE, manifestPattern: 'k8s/dev', credentialsId: env.JENKINS_CRED, verifyDeployments: true])\n echo 'To access your environment run `kubectl proxy`'\n echo \"Then access your service via http://localhost:8001/api/v1/proxy/namespaces/${env.BRANCH_NAME}/services/${FE_SVC_NAME}:80/\"\n }\n }\n }\n }\n}\n" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_033_continuous_delivery_with_jenkins_in_kubernetes_engine/ReadMe.md", "content": "# Continuous Delivery with Jenkins in Kubernetes Engine\n\n**High Level Objectives**\n- \n\n\n**Skills**\n- gcp\n\n\n## Download the source code\n\n- run the following command to set your zone us-east1-c:\n\n```bash\ngcloud config set compute/zone us-east1-c\n\n# Then copy the lab's sample code:\ngsutil cp gs://spls/gsp051/continuous-deployment-on-kubernetes.zip .\n\nunzip continuous-deployment-on-kubernetes.zip\n\ncd continuous-deployment-on-kubernetes\n```\n\n## Provisioning Jenkins\n\n```bash\n# command to provision a Kubernetes cluster:\ngcloud container clusters create jenkins-cd \\\n--num-nodes 2 \\\n--machine-type n1-standard-2 \\\n--scopes \"https://www.googleapis.com/auth/source.read_write,cloud-platform\"\n\n\n# confirm that your cluster is running by executing the following command:\ngcloud container clusters list\n\n# Now, get the credentials for your cluster:\ngcloud container clusters get-credentials jenkins-cd\n\n# confirm that you can connect to it by running the following command\nkubectl cluster-info\n```\n\n\n## Setup Helm\n\n```bash\n# Add Helm's stable chart repo:\nhelm repo add jenkins https://charts.jenkins.io\n\n# Ensure the repo is up to date:\nhelm repo update\n\n```\n\n## Configure and Install Jenkins\n\nvalues file to automatically configure your Kubernetes Cloud and add the following necessary plugins:\n\n- Kubernetes:latest\n- Workflow-multibranch:latest\n- Git:latest\n- Configuration-as-code:latest\n- Google-oauth-plugin:latest\n- Google-source-plugin:latest\n- Google-storage-plugin:latest\n\n```bash\n# Use the Helm CLI to deploy the chart with your configuration settings:\nhelm install cd jenkins/jenkins -f jenkins/values.yaml --wait\n\n# Check pods\nkubectl get pods\n\n# Configure the Jenkins service account to be able to deploy to the cluster:\nkubectl create clusterrolebinding jenkins-deploy --clusterrole=cluster-admin --serviceaccount=default:cd-jenkins\n\n# Run the following command to setup port forwarding to the Jenkins UI from the Cloud Shell:\nexport POD_NAME=$(kubectl get pods --namespace default -l \"app.kubernetes.io/component=jenkins-master\" -l \"app.kubernetes.io/instance=cd\" -o jsonpath=\"{.items[0].metadata.name}\")\nkubectl port-forward $POD_NAME 8080:8080 >> /dev/null &\n\n# check that the Jenkins Service was created properly:\nkubectl get svc\n\n```\n\n## Connect to Jenkins\n\n```bash\n# Jenkins chart will automatically create an admin password for you. To retrieve it, run:\nprintf $(kubectl get secret cd-jenkins -o jsonpath=\"{.data.jenkins-admin-password}\" | base64 --decode);echo\n\n# If asked, log in with username admin and your auto-generated password.\n```\n\n## Understanding the Application\n\n\n## Deploying the Application\n\nYou will deploy the application into two different environments:\n- Production: The live site that your users access.\n- Canary: A smaller-capacity site that receives only a percentage of your user traffic. Use this environment to validate \n your software with live traffic before it's released to all of your users.\n\n\n```bash\ncd sample-app\n\n## Create the Kubernetes namespace to logically isolate the deployment:\nkubectl create ns production\n\n# Create the production and canary deployments, and the services using the kubectl apply commands:\nkubectl apply -f k8s/production -n production\n\nkubectl apply -f k8s/canary -n production\n\nkubectl apply -f k8s/services -n production\n\n# Scale up the production environment frontends by running the following command\nkubectl scale deployment gceme-frontend-production -n production --replicas 4\n\n# Now confirm that you have 5 pods running for the frontend, 4 for production traffic and 1 for canary releases \nkubectl get pods -n production -l app=gceme -l role=frontend\n\n# Also confirm that you have 2 pods for the backend, 1 for production and 1 for canary:\nkubectl get pods -n production -l app=gceme -l role=backend\n\n#Retrieve the external IP for the production services:\nkubectl get service gceme-frontend -n production\n\n# Now, store the frontend service load balancer IP in an environment variable for use later:\nexport FRONTEND_SERVICE_IP=$(kubectl get -o jsonpath=\"{.status.loadBalancer.ingress[0].ip}\" --namespace=production services gceme-frontend)\n\n# Confirm that both services are working by opening the frontend external IP address in your browser.\n\n# Check the version output of the service by running the following command (it should read 1.0.0):\ncurl http://$FRONTEND_SERVICE_IP/version\n```\n\n## Creating the Jenkins Pipeline\n\n- Creating the Jenkins Pipeline\n\n```bash\ngcloud source repos create default\n\ngit init\n\n# Initialize the sample-app directory as its own Git repository:\ngit config credential.helper gcloud.sh\n\n# Run the following command\ngit remote add origin https://source.developers.google.com/p/$DEVSHELL_PROJECT_ID/r/default\n\n# Set the username and email address for your Git commits. \n# Replace [EMAIL_ADDRESS] with your Git email address and [USERNAME] with your Git username:\ngit config --global user.email \"[EMAIL_ADDRESS]\"\n\ngit config --global user.name \"[USERNAME]\"\n\ngit add .\n\ngit commit -m \"Initial commit\"\n\ngit push origin master\n```\n\n\n- Adding your service account credentials\n\n- In the Jenkins user interface, click Manage Jenkins in the left navigation then click Manage Credentials\n , Click Global credentials (unrestricted).\n\n- Configure Jenkins Cloud for Kubernetes\n\n- Creating the Jenkins job\n\n```bash\n\n# https://source.developers.google.com/p/[PROJECT_ID]/r/default\n```\n\n\n## Creating the development environment\n\n```bash\n# Create a development branch and push it to the Git server:\ngit checkout -b new-feature\n\n\n\n```\n\n- Modifying the pipeline definition\n- Use the Jenkinsfile\n - Add your PROJECT_ID to the REPLACE_WITH_YOUR_PROJECT_ID value in the Jenkinsfile.\n - CLUSTER_ZONE to to us-east1-c\n- Change the two instances of
with
in the html.go file.\n- main.go change the version to 2.0.0\n\n\n## Kick off Deployment\n\n\n- Commit and push your changes\n\n```bash\ngit add Jenkinsfile html.go main.go\n\ngit commit -m \"Version 2.0.0\"\n\ngit push origin new-feature\n```\n\n- Once that's all taken care of, start the proxy in the background:\n\n```bash\nkubectl proxy &\n\n# If it stalls, press Ctrl + C to exit out. Verify that your application is accessible by \n# sending a request to localhost and letting kubectl proxy forward it to your service\ncurl \\\nhttp://localhost:8001/api/v1/namespaces/new-feature/services/gceme-frontend:80/proxy/version\n\n# You should see it respond with 2.0.0, which is the version that is now running.\n\n```\n\n## Deploying a canary release\n\n- Create a canary branch and push it to the Git server:\n\n```bash\ngit checkout -b canary\n\ngit push origin canary\n\n```\n\n- In Jenkins, you should see the canary pipeline has kicked off. Once complete, \n you can check the service URL to ensure that some of the traffic is being served by your new version. \n You should see about 1 in 5 requests (in no particular order) returning version 2.0.0.\n\n```bash\nexport FRONTEND_SERVICE_IP=$(kubectl get -o \\\njsonpath=\"{.status.loadBalancer.ingress[0].ip}\" --namespace=production services gceme-frontend)\n\n\nwhile true; do curl http://$FRONTEND_SERVICE_IP/version; sleep 1; done\n# Output\n1.0.0\n1.0.0\n1.0.0\n2.0.0\n1.0.0\n1.0.0\n1.0.0\n```\n\n## Deploying to production\n\n- Create a canary branch and push it to the Git server:\n\n```bash\ngit checkout master\n\ngit merge canary\n\ngit push origin master\n\n# Trigger master job\nexport FRONTEND_SERVICE_IP=$(kubectl get -o \\\njsonpath=\"{.status.loadBalancer.ingress[0].ip}\" --namespace=production services gceme-frontend)\n\n# All should be 2.0\nwhile true; do curl http://$FRONTEND_SERVICE_IP/version; sleep 1; done\n# Output\n2.0.0\n2.0.0\n2.0.0\n2.0.0\n2.0.0\n2.0.0\n\n# \nkubectl get service gceme-frontend -n production\n```" }, { "path": "home/cloud_providers/gcp/taskset_gcp_cloud_providers/task_033_continuous_delivery_with_jenkins_in_kubernetes_engine/values.yaml", "content": "controller:\n installPlugins:\n - kubernetes:latest\n - workflow-job:latest\n - workflow-aggregator:latest\n - credentials-binding:latest\n - git:latest\n - google-oauth-plugin:latest\n - google-source-plugin:latest\n - google-kubernetes-engine:latest\n - google-storage-plugin:latest\n resources:\n requests:\n cpu: \"50m\"\n memory: \"1024Mi\"\n limits:\n cpu: \"1\"\n memory: \"3500Mi\"\n javaOpts: \"-Xms3500m -Xmx3500m\"\n serviceType: ClusterIP\nagent:\n resources:\n requests:\n cpu: \"500m\"\n memory: \"256Mi\"\n limits:\n cpu: \"1\"\n memory: \"512Mi\"\npersistence:\n size: 100Gi\nserviceAccount:\n name: cd-jenkins\n" }, { "path": "home/cloud_providers/oci/ReadMe.md", "content": "# taskset_oci_cloud_providers\n\n> [Auto](https://github.com/codeaprendiz/learn_fullstack/blob/main/home/php/intermediate/taskset_intermediate_php/task_004_createGlobalMarkdownTable/generate-readme.php) generated ReadMe. Number of tasks: 3\n\n| Task | Description |\n|----------|--------------------------------------------------------------------------------------------------|\n| task_000 | [task_000_set_up_oci_cli](taskset_oci_cloud_providers/task_000_set_up_oci_cli) |\n| task_001 | [task_001_oci_cli_commands](taskset_oci_cloud_providers/task_001_oci_cli_commands) |\n| task_002 | [task_002_create_k8s_quick_create](taskset_oci_cloud_providers/task_002_create_k8s_quick_create) |\n" }, { "path": "home/cloud_providers/oci/taskset_oci_cloud_providers/task_000_set_up_oci_cli/ReadMe.md", "content": "# Set up OCI Cli\n\n[docs.oracle.com » Developer Resources » Required Keys and OCIDs](https://docs.oracle.com/en-us/iaas/Content/API/Concepts/apisigningkey.htm#two)\n[docs.oracle.com » Developer Resources » Working with CLI » Configuring the CLI](https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/cliconfigure.htm)\n\n- Login to oracle cloud\n\n- Go to your profile and download the API Keys\n\n- Download private and public key pairs\n\n- Create the OCI directory\n\n```bash\n╰─ mkdir -p ~/.oci/\n╰─ touch ~/.oci/config\n```\n\n- Move the downloaded keys to the OCI directory\n\n```bash\n╰─ ls\nconfig oci-private.pem oci-public.pem\n```\n\n\n- Set up your config file and repiar the config file permissions if needed\n\n```bash\n╰─ oci setup repair-file-permissions --file ~/.oci/oci-private.pem \n```\n\n```bash\n╰─ cat config\n[DEFAULT]\nuser=\nfingerprint=\ntenancy=\nregion=\nkey_file=~/.oci/oci-private.pem\n```\n\n- If you have created any buckets, then you can list those buckets using the following command\n\n```bash\n╰─ oci os bucket list --compartment-id | jq '.data[] | {name} '\n\n# Alternatively you can pass the config file as argument as well\n╰─ oci os bucket list --compartment-id --config-file | jq '.data[] | {name} '\n.\n```\n" }, { "path": "home/cloud_providers/oci/taskset_oci_cloud_providers/task_001_oci_cli_commands/ReadMe.md", "content": "# OCI Commands\n\n\n# oci\n\n\nCommand / Options | Use Case | Example | \n| ------------- |-------------| -------------| \n| [create](https://docs.oracle.com/en-us/iaas/tools/oci-cli/2.9.1/oci_cli_docs/cmdref/os/bucket/create.html) | Create OCI bucket | `╰─ oci os bucket create --compartment-id --name sandbox-v1-bucket`\n| [list](https://docs.oracle.com/en-us/iaas/tools/oci-cli/3.16.0/oci_cli_docs/cmdref/os/bucket/list.html)| List OCI buckets | `╰─ oci os bucket list --compartment-id `|" }, { "path": "home/cloud_providers/oci/taskset_oci_cloud_providers/task_002_create_k8s_quick_create/ReadMe.md", "content": "# To create a k8s cluster in OCI using Quick Create feature and understand the network topology required\n\nWe can later use this to create our own cluster using terraform\n\n## K8S created\n\n![](.images/k8s.png)\n\n## The VCN Created\n\n![img.png](.images/vcn.png)\n\noke-vcn-quick-sandbox-k8s-a4bf5e044\n\n- IPV4 CIDR `10.0.0.0/16`\n- Default route table `oke-public-routetable-sandbox-k8s-a4bf5e044`\n\n\n\n## Subnets\n\n![](.images/subnets.png)\n\n\noke-nodesubnet-quick-sandbox-k8s-a4bf5e044-regional\n- CIDR `10.0.10.0/24`\n- Private\n\n### Security List\n\noke-nodeseclist-quick-sandbox-k8s-a4bf5e044\n\n#### Ingress\n\n![](.images/ingress-subnet-pri.png)\n\n- 10.0.10.0/24\t--------------All Protocols----->\n> All traffic for all ports\t\n> Allow pods on one worker node to communicate with pods on other worker nodes. Anything from within the subnet can communicate with one another\n- 10.0.0.0/28\t--------------ICMP ------------->\n> Path discovery. Anything from API endpoint subnet can communicate over ICMP \n- 10.0.0.0/28 All Ports --------------All Protocols-----------> All Ports\n> TCP traffic for ports: All\n> TCP access from Kubernetes Control Plane. Anything coming from API endpoint subnet can communicate over TCP, all source ports to all destination ports\n- 0.0.0.0/0 All Ports ---------------TCP-----------------------> 22 \n> TCP traffic for ports: 22 SSH Remote Login Protocol. Inbound SSH traffic to worker nodes. Anything coming from Internet can communicate over TCP 22 for SSH access\n\n#### Egress\n\n![](.images/egress-subnet-pri.png)\n\n- All ports--------ALL protocols---------> 10.0.10.0/24\t(All ports). \n> Anything from within the subnet can communicate with one another. Allow pods on one worker node to communicate with pods on other worker nodes\n- ALL Ports--------TCP -------> 10.0.0.0/28\t- Port 6443 (API subnet)\n> All ports can communicate to port 6443 of API subnet. Access to Kubernetes API Endpoint.\n- ALL Ports--------TCP -------> 10.0.0.0/28\t- Port 12250 (API subnet)\n> All ports can communicate to port 12250 of API subnet. Kubernetes worker to control plane communication\n- -----------------ICMP--------> 10.0.0.0/28\n> Path Discovery\n- All ports ----------------TCP-------------> All BOM Services In Oracle Services Network, 443 port\n> Allow nodes to communicate with OKE to ensure correct start-up and continued functioning\n- ----------------ICMP------------> 0.0.0.0/0\n> ICMP Access from Kubernetes Control Plane\n- All ports ----------------All protocols---------------> 0.0.0.0/0, All ports\n> Worker Nodes access to Internet\n\n### RouteTable\n\noke-private-routetable-sandbox-k8s-a4bf5e044\n\n- If -------------> 0.0.0.0/0, go to NAT Gateway\n> traffic to the internet\n\n- If -------------> All BOM Services In Oracle Services Network, go to Service Gateway\n> traffic to OCI services\n\n\n\n\noke-k8sApiEndpoint-subnet-quick-sandbox-k8s-a4bf5e044-regional\n- CIDR `10.0.0.0/28`\n- Public\n\n### Security List\n\noke-k8sApiEndpoint-quick-sandbox-k8s-a4bf5e044\n\n#### Ingress\n\n![img.png](.images/ingress-api-subnet.png)\n\n- 0.0.0.0/0 All Ports ---------------TCP-----------------> 6443\n> TCP traffic for ports: 6443\n> External access to Kubernetes API endpoint\n\n- 10.0.10.0/24 All Ports ------------TCP-----------------> 6443\n> TCP traffic for ports: 6443\n> Kubernetes worker to Kubernetes API endpoint communication\n\n- 10.0.10.0/24 All Ports -----------TCP--------------------> 12250\n> TCP traffic for ports: 12250 \n> Kubernetes worker to control plane communication\n\n- 10.0.10.0/24 -----------ICMP-------------------> \n> Path Discovery\n\n#### Egress\n\n![img.png](.images/egress-api-subnet.png)\n\n- All Ports ------------------------TCP-----------------------> All BOM Services In Oracle Services Network, 443\n> TCP traffic for ports: 443 HTTPS\n> Allow Kubernetes Control Plane to communicate with OKE\n\n- All Ports ------------------------TCP-----------------------> 10.0.10.0/24, All Ports\n> TCP traffic for ports: All\n> All traffic to worker nodes\n\n- ------------------------ICMP----------------------> 10.0.10.0/24\t\n> Path discovery\n\n\n### Route Table\n\n\noke-public-routetable-sandbox-k8s-a4bf5e044\n\n- If ------------> 0.0.0.0/0, then go to Internet Gateway \n> traffic to/from internet\n\n\noke-svclbsubnet-quick-sandbox-k8s-a4bf5e044-regional\n- CIDR `10.0.20.0/24`\n- Public\n\n### Security List\n\noke-svclbseclist-quick-sandbox-k8s-a4bf5e044\n\n#### Ingress\n\n![img.png](.images/ingress-lb-sec.png)\n\n#### Egress\n\n![img.png](.images/eggress-lb-sec.png)\n\n\n### Route Table\n\n\noke-public-routetable-sandbox-k8s-a4bf5e044\n\n\n\n\n" }, { "path": "home/containers/docker/ReadMe.md", "content": "# taskset_docker_containers\n\n> [Auto](https://github.com/codeaprendiz/learn_fullstack/blob/main/home/php/intermediate/taskset_intermediate_php/task_004_createGlobalMarkdownTable/generate-readme.php) generated ReadMe. Number of tasks: 33\n\n| Task | Description |\n|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| task_000 | [task_000_commands](taskset_docker_containers/task_000_commands) |\n| task_001 | [task_001_docker_overview](taskset_docker_containers/task_001_docker_overview) |\n| task_002 | [task_002_docker_run__detached_vs_foreground](taskset_docker_containers/task_002_docker_run__detached_vs_foreground) |\n| task_003 | [task_003_getting_started](taskset_docker_containers/task_003_getting_started) |\n| task_004 | [task_004_docker_run__pid_setting_and_choosing_image_with_tag](taskset_docker_containers/task_004_docker_run__pid_setting_and_choosing_image_with_tag) |\n| task_005 | [task_005_docker_run__assign_name_and_allocate_pseudo_tty](taskset_docker_containers/task_005_docker_run__assign_name_and_allocate_pseudo_tty) |\n| task_006 | [task_006_docker_run__expose_port_and_pull_policy_and_environment_vars](taskset_docker_containers/task_006_docker_run__expose_port_and_pull_policy_and_environment_vars) |\n| task_006 | [task_006_run_commands_in_container](taskset_docker_containers/task_006_run_commands_in_container) |\n| task_007 | [task_007_docker_run__full_container_capabilities_and_set_working_dir_and_volume_mounts](taskset_docker_containers/task_007_docker_run__full_container_capabilities_and_set_working_dir_and_volume_mounts) |\n| task_008 | [task_008_docker_run__hostsfile_ulimit_mem_limit](taskset_docker_containers/task_008_docker_run__hostsfile_ulimit_mem_limit) |\n| task_008 | [task_008_docker_run__metadata_and_network_and_attach_to_stdout](taskset_docker_containers/task_008_docker_run__metadata_and_network_and_attach_to_stdout) |\n| task_009 | [task_009_docker_attach](taskset_docker_containers/task_009_docker_attach) |\n| task_010 | [task_010_docker_build](taskset_docker_containers/task_010_docker_build) |\n| task_011 | [task_011_mongo](taskset_docker_containers/task_011_mongo) |\n| task_012 | [task_012_postgres](taskset_docker_containers/task_012_postgres) |\n| task_013 | [task_013_prometheus_blackbox_exporter](taskset_docker_containers/task_013_prometheus_blackbox_exporter) |\n| task_014 | [task_014_elastic_search](taskset_docker_containers/task_014_elastic_search) |\n| task_015 | [task_015_elastic_search_bkp_restore](taskset_docker_containers/task_015_elastic_search_bkp_restore) |\n| task_016 | [task_016_elastic_search_backup_restore_sample_data](taskset_docker_containers/task_016_elastic_search_backup_restore_sample_data) |\n| task_017 | [task_017_mem_and_cpu_limit_container](taskset_docker_containers/task_017_mem_and_cpu_limit_container) |\n| task_018 | [task_018_mysql](taskset_docker_containers/task_018_mysql) |\n| task_019 | [task_019_nginx_https_domain_test](taskset_docker_containers/task_019_nginx_https_domain_test) |\n| task_020 | [task_020_docker_commit](taskset_docker_containers/task_020_docker_commit) |\n| task_021 | [task_021_kibana](taskset_docker_containers/task_021_kibana) |\n| task_022 | [task_022_sample_app](taskset_docker_containers/task_022_sample_app) |\n| task_023 | [task_023_update_sample_app](taskset_docker_containers/task_023_update_sample_app) |\n| task_024 | [task_024_sample_app_persist_db](taskset_docker_containers/task_024_sample_app_persist_db) |\n| task_025 | [task_025_sonarqube__keycloak__saml](taskset_docker_containers/task_025_sonarqube__keycloak__saml) |\n| task_026 | [task_026_mssql](taskset_docker_containers/task_026_mssql) |\n| task_027 | [task_027_docker_openvpn](taskset_docker_containers/task_027_docker_openvpn) |\n| task_028 | [task_028_docker_engine__networking__overview](taskset_docker_containers/task_028_docker_engine__networking__overview) |\n| task_029 | [task_029_docker_engine__networking__bridge_network_tutorial](taskset_docker_containers/task_029_docker_engine__networking__bridge_network_tutorial) |\n| task_030 | [task_030_docker_engine__networking__host_networking_tutorial](taskset_docker_containers/task_030_docker_engine__networking__host_networking_tutorial) |\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_000_commands/ReadMe.md", "content": "# docker commands\n\nMore details at [Offical Guide](https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands)\n\n- [docker commands](#docker-commands)\n - [image](#image)\n - [rm \\[id-of-the-image\\]](#rm-id-of-the-image)\n - [images](#images)\n - [run](#run)\n - [interactive](#interactive)\n - [tty](#tty)\n\n## image\n\n### rm [id-of-the-image]\n\nTo remove the image with specific ID\n\n```bash\n$ sudo docker images | grep ubuntu\nPassword:\nubuntu latest 4e5021d210f6 2 weeks ago 64.2MB\n \n$ sudo docker image rm 4e5021d210f6\nUntagged: ubuntu:latest\nUntagged: ubuntu@sha256:bec5a2727be7fff3d308193cfde3491f8fba1a2ba392b7546b43a051853a341d\nDeleted: sha256:4e5021d210f65ebe915670c7089120120bc0a303b90208592851708c1b8c04bd\nDeleted: sha256:1d9112746e9d86157c23e426ce87cc2d7bced0ba2ec8ddbdfbcc3093e0769472\nDeleted: sha256:efcf4a93c18b5d01aa8e10a2e3b7e2b2eef0378336456d8653e2d123d6232c1e\nDeleted: sha256:1e1aa31289fdca521c403edd6b37317bf0a349a941c7f19b6d9d311f59347502\nDeleted: sha256:c8be1b8f4d60d99c281fc2db75e0f56df42a83ad2f0b091621ce19357e19d853\n```\n\n## images\n\nTo show all the images present\n\n```bash\n$ sudo docker images \nPassword:\nREPOSITORY TAG IMAGE ID CREATED SIZE\nubuntu latest 4e5021d210f6 2 weeks ago 64.2MB\nbusybox latest 83aa35aa1c79 3 weeks ago 1.22MB\n```\n\n## run\n\n### interactive\n>--interactive , -i\t\n>\t\n>Keep STDIN open even if not attached \n\n```bash\n$ sudo docker run -i ubuntu:latest bash\npwd\n/\nexit\n\n$\n```\n\n### tty\n\n>--tty , -t\t\n>\t\n>Allocate a pseudo-TTY\n\nYou have to externally kill the container in this case\n\n```bash\n$ sudo docker run -t ubuntu:latest bash\nroot@b01ba82675f5:/# pwd\nls\nexit\n^C^C\nroot@b01ba82675f5:/# exit\n```\n\nWhen you combine -i and -t, you get a proper terminal like experience\n\n```bash\n$ sudo docker run -i -t ubuntu:latest bash\nUnable to find image 'ubuntu:latest' locally\nlatest: Pulling from library/ubuntu\n5bed26d33875: Pull complete\nf11b29a9c730: Pull complete\n930bda195c84: Pull complete\n78bf9a5ad49e: Pull complete\nDigest: sha256:bec5a2727be7fff3d308193cfde3491f8fba1a2ba392b7546b43a051853a341d\nStatus: Downloaded newer image for ubuntu:latest\nroot@e421090e426a:/#\n```\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_001_docker_overview/ReadMe.md", "content": "# Docker overview\n\n\n[docs.docker.com/get-started/overview](https://docs.docker.com/get-started/overview)\n\nVersion Stack\n\n| Stack | Version |\n|--------|----------|\n| Docker | 20.10.14 |\n\n\n## Usecase to solve actual problem\n\n### docker run\n\nThe following command runs an `ubuntu` container, attaches interactively to your local command-line session, and runs `/bin/bash`.\n\n\n\n```bash\n# Version\n❯ docker -v \nDocker version 20.10.14, build a224086\n\n# run : Run a command in a new container\n# -i : interactively\n# -t : attached to your terminal\n# ubuntu : is the image we will be downloading\n# /bin/bash : the command that will run inside the container started with ubuntu image\n❯ docker run -i -t ubuntu /bin/bash\n\nroot@f3d2356faadc:/# ls\nbin boot dev etc home lib media mnt opt proc root run sbin srv sys tmp usr var\n\n# exit\n\n\n❯ docker ps # To show all running containers \nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n\n❯ docker ps -a # To show all containers including stopped ones\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n864a03e87269 ubuntu \"sh\" 23 seconds ago Exited (0) 17 seconds ago unruffled_margulis\n\n❯ docker rm unruffled_margulis # Remove the container \nunruffled_margulis\n\n❯ docker ps -a \nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n\n❯ \n```\n\nDocker starts the container and executes /bin/bash. Because the container is running interactively and attached to your terminal (due to the -i and -t flags), you can provide input using your keyboard while the output is logged to your terminal.\n\nThat's all for today!" }, { "path": "home/containers/docker/taskset_docker_containers/task_002_docker_run__detached_vs_foreground/ReadMe.md", "content": "## Detached vs Foreground\n\n- [docs.docker.com/engine/reference/run](https://docs.docker.com/engine/reference/run)\n\n- [docs.docker.com/engine/reference/commandline/run](https://docs.docker.com/engine/reference/commandline/run)\n\nVersion Stack\n\n| Stack | Version |\n|--------|----------|\n| Docker | 20.10.14 |\n\nBy design, containers started in detached mode exit when the root process used to run the container exits\n\n\n\n### Detached Mode\n\n```bash\n# Note: No --rm option\n❯ docker run -d -p 80:80 nginx service nginx start \n3fdd6761951aeba2a8936a54a7fea982b1b7073a0d2892cab9a4c095d080900b\n\n# Note the container exited after starting\n❯ docker ps -a \nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n3fdd6761951a nginx \"/docker-entrypoint.…\" 4 seconds ago Exited (0) 4 seconds ago wonderful_fermi\n\n# Note: We added --rm option\n❯ docker run --rm -d -p 80:80 nginx service nginx start\ne836a7703057577b1aa58ac5cf9ca4e9bb85767069651f9fd8ac1972c4d041c0\n\n# The container also exited after being stopped\n❯ docker ps -a \nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n❯ \n\n# You can start an ubuntu container as well in detached mode\n❯ docker run -d ubuntu /bin/bash\n63e90449bddb96856fb2cebcb33c5b8f12859ac59bea39645d5c9877215a8cac\n\n❯ docker ps -a \nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n63e90449bddb ubuntu \"/bin/bash\" 2 seconds ago Exited (0) 1 second ago distracted_pasteur\n\n❯ docker run -d ubuntu sleep 100\na979bd34e5c4d34e8dcc30c464ed3b432fe77938ae3df3ea3983da24d0c649c4\n\n❯ docker ps -a \nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\na979bd34e5c4 ubuntu \"sleep 100\" 3 seconds ago Up 3 seconds sweet_wozniak\n63e90449bddb ubuntu \"/bin/bash\" 30 seconds ago Exited (0) 29 seconds ago distracted_pasteur\n```\n\n\n### Foreground Mode\n\nIn foreground mode (the default when -d is not specified), docker run can start the process in the container and attach the console to the process’s standard input, output, and standard error\n\nFor interactive processes (like a shell), you must use -i -t together in order to allocate a tty for the container process\n\n```bash\n❯ docker run -it ubuntu /bin/bash \nroot@6036032b640a:/# ls\nbin dev home media opt root sbin sys usr\nboot etc lib mnt proc run srv tmp var\nroot@6036032b640a:/# exit\nexit\n\n❯ \n```" }, { "path": "home/containers/docker/taskset_docker_containers/task_003_getting_started/ReadMe.md", "content": "[Getting Started](https://docs.docker.com/get-started/)\n\n- Run\n\n```bash\n$ docker run -d -p 80:80 docker/getting-started\nUnable to find image 'docker/getting-started:latest' locally\nlatest: Pulling from docker/getting-started\ndf9b9388f04a: Pull complete \n5867cba5fcbd: Pull complete \n4b639e65cb3b: Pull complete \n061ed9e2b976: Pull complete \nbc19f3e8eeb1: Pull complete \n4071be97c256: Pull complete \n79b586f1a54b: Pull complete \n0c9732f525d6: Pull complete \nDigest: sha256:b558be874169471bd4e65bd6eac8c303b271a7ee8553ba47481b73b2bf597aae\nStatus: Downloaded newer image for docker/getting-started:latest\n4fb7848e41a1f4135e029b438f3e0fe424dbe5d458618b625128c8f72013b1ff\n\n$ docker ps \nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n4fb7848e41a1 docker/getting-started \"/docker-entrypoint.…\" 2 minutes ago Up 2 minutes 0.0.0.0:80->80/tcp quirky_rosalind\n\n```" }, { "path": "home/containers/docker/taskset_docker_containers/task_004_docker_run__pid_setting_and_choosing_image_with_tag/ReadMe.md", "content": "## PID Setting and choosing image with Specific Tag\n\nVersion Stack\n\n| Stack | Version |\n|--------|----------|\n| Docker | 20.10.14 |\n\n\n### ImageTag\n\n[imagetag](https://docs.docker.com/engine/reference/run/#imagetag)\n\n- Run image with specific tag say ubuntu:14.04\n```bash\n❯ docker run --rm -it -d ubuntu:14.04 sh\n32bd86340d4773b17d5a9ba5c2f8f448ab4d29186801a6d989ad53a2a0a48af3\n\n❯ docker ps -a \nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n32bd86340d47 ubuntu:14.04 \"sh\" 5 seconds ago Up 4 seconds practical_ishizaka\n```\n\n### PID\n\n[pid-settings---pid](https://docs.docker.com/engine/reference/run/#pid-settings---pid)\n\nLet's create two containers a1 and a2, and we want container a2 to be able to see the processes running in container a1\n\n```bash\n# Terminal session 1\n❯ docker run --rm --name=a1 -it ubuntu /bin/bash\nroot@fefc7f52750f:/# sleep 10000\n\n\n\n# Terminal session 2\n❯ docker ps -a \nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\nfefc7f52750f ubuntu \"/bin/bash\" 33 seconds ago Up 32 seconds a1\n\n\n# Note that a2 cannot see the processes running inside of a1 yet.\n❯ docker run --rm --name=a2 -it ubuntu /bin/bash\nroot@9630d2dd813f:/# ps -ef \nUID PID PPID C STIME TTY TIME CMD\nroot 1 0 0 10:34 pts/0 00:00:00 /bin/bash\nroot 9 1 0 10:34 pts/0 00:00:00 ps -ef\nroot@9630d2dd813f:/# #let's exit\nroot@9630d2dd813f:/# exit\nexit\n\n❯ docker ps -a \nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\nfefc7f52750f ubuntu \"/bin/bash\" About a minute ago Up About a minute a1\n\n\n# Now let's start the second container a2 using pid=container:a1\n# Note that now it's able to see the process sleep running in a1\n❯ docker run --rm --name=a2 --pid=container:a1 -it ubuntu /bin/bash\nroot@0bfaed14e83d:/# ps -ef\nUID PID PPID C STIME TTY TIME CMD\nroot 1 0 0 10:33 pts/0 00:00:00 /bin/bash\nroot 10 1 0 10:33 pts/0 00:00:00 sleep 10000\nroot 11 0 0 10:35 pts/0 00:00:00 /bin/bash\nroot 20 11 0 10:35 pts/0 00:00:00 ps -ef\n\n```\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_005_docker_run__assign_name_and_allocate_pseudo_tty/ReadMe.md", "content": "## Assign name and allocate pseudo tty\n\n[assign-name-and-allocate-pseudo-tty---name--it](https://docs.docker.com/engine/reference/commandline/run/#assign-name-and-allocate-pseudo-tty---name--it)\n\nVersion Stack\n\n| Stack | Version |\n|--------|----------|\n| Docker | 20.10.14 |\n\n\n- Let's begin\n\n\n```bash\n# allocate pseudo tty : -it\n# --name for container name\n❯ docker run --name test -it debian\n\nroot@d6c0fe130dba:/# exit 13\n\n# Note the exit code is passed to the caller of docker run.\n❯ echo $? \n13\n❯ docker ps -a \nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n4a94928d6520 debian \"bash\" About a minute ago Exited (13) 54 seconds ago test\n```\n\n## Capture container ID\n\n[capture-container-id---cidfile](https://docs.docker.com/engine/reference/commandline/run/#capture-container-id---cidfile)\n\n- This will create a container and print `test` to the console. The `cidfile` flag makes Docker attempt to create a new file and write the container ID to it.\n\n```bash\n❯ docker run --cidfile /tmp/docker_test.cid ubuntu echo \"test\"\ntest\n\n❯ docker ps -a \nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\nc2683f80d7bf ubuntu \"echo test\" 5 seconds ago Exited (0) 4 seconds ago youthful_hypatia\n\n# Note the container ID got captured in the file\n❯ cat /tmp/docker_test.cid \nc2683f80d7bf613f4004911904a908377a43fb1ab556988f3aa9992647cd184a\n\n\n```\n\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_006_docker_run__expose_port_and_pull_policy_and_environment_vars/ReadMe.md", "content": "## Expose Port, Pull Policy And Environment Variables\n\n\nVersion Stack\n\n| Stack | Version |\n|--------|----------|\n| Docker | 20.10.14 |\n\n\n### Expose Port\n\n[publish-or-expose-port--p---expose](https://docs.docker.com/engine/reference/commandline/run/#publish-or-expose-port--p---expose)\n\n```bash\n❯ docker run --rm -d -p 8081:80 nginx nginx -g 'daemon off;' \nf73315b8a038d94192802c894c72fa3957ca4db019f312e829c3a612fbf17d63\n\n❯ curl localhost:8081 -I\nHTTP/1.1 200 OK\nServer: nginx/1.23.2\nDate: Mon, 14 Nov 2022 14:59:15 GMT\nContent-Type: text/html\nContent-Length: 615\nLast-Modified: Wed, 19 Oct 2022 07:56:21 GMT\nConnection: keep-alive\nETag: \"634fada5-267\"\nAccept-Ranges: bytes\n```\n\nYou can visit the same in browser\n\n![nginx.png](.images/nginx.png)\n\n## Pull Policy\n\n[set-the-pull-policy---pull](https://docs.docker.com/engine/reference/commandline/run/#-set-the-pull-policy---pull)\n\n```bash\n❯ docker pull ubuntu \n❯ docker images | grep ubuntu \nubuntu latest 3c2df5585507 2 weeks ago 69.2MB\n\n❯ docker rmi ubuntu \n\n\n❯ docker run --pull=never ubuntu \ndocker: Error response from daemon: No such image: ubuntu:latest.\n\n# As there is no image with this tag locally\n❯ docker images | grep ubuntu | wc -l\n 0\n```\n\n\n## Environment \n\n[set-environment-variables--e---env---env-file](https://docs.docker.com/engine/reference/commandline/run/#set-environment-variables--e---env---env-file)\n\n```bash\n# Let's create a file\n❯ echo \"VAR3=value\" > .env \n❯ cat .env \nVAR3=value\n\n❯ docker run --rm -it -e MYVAR1=bar --env MYVAR2=foo --env-file ./.env ubuntu bash\nroot@9cb685c53176:/# env | grep VAR\nMYVAR2=foo\nMYVAR1=bar\nVAR3=value\nroot@9cb685c53176:/# exit\nexit\n\n❯ docker run --rm -it -e MYVAR1=bar --env MYVAR2=foo --env-file ./.env ubuntu env | grep VAR\nVAR3=value\nMYVAR1=bar\nMYVAR2=foo\n\n```" }, { "path": "home/containers/docker/taskset_docker_containers/task_006_run_commands_in_container/ReadMe.md", "content": "# To execute command inside image containers\n\n> docker run -it [image-name:tag] [command-to-execute]\n\n```bash\n$ docker run -it ubuntu:latest bash\nUnable to find image 'ubuntu:latest' locally\nlatest: Pulling from library/ubuntu\n5bed26d33875: Pull complete\nf11b29a9c730: Pull complete\n930bda195c84: Pull complete\n78bf9a5ad49e: Pull complete\nDigest: sha256:bec5a2727be7fff3d308193cfde3491f8fba1a2ba392b7546b43a051853a341d\nStatus: Downloaded newer image for ubuntu:latest\nroot@e421090e426a:/#\n```" }, { "path": "home/containers/docker/taskset_docker_containers/task_007_docker_run__full_container_capabilities_and_set_working_dir_and_volume_mounts/ReadMe.md", "content": "## Full container capabilities, Set working directory And Mount Volumes\n\nVersion Stack\n\n| Stack | Version |\n|--------|----------|\n| Docker | 20.10.14 |\n\n### Full container capabilities\n\n[full-container-capabilities---privileged](https://docs.docker.com/engine/reference/commandline/run/#full-container-capabilities---privileged)\n\n```bash\n❯ docker run -t -i --rm ubuntu bash\nroot@ae4994d93a27:/# mount -t tmpfs none /mnt\nmount: /mnt: permission denied.\nroot@ae4994d93a27:/# exit\nexit\n\n\n❯ docker run -t -i --privileged ubuntu bash\nroot@6ad992ced205:/# mount -t tmpfs none /mnt\nroot@6ad992ced205:/# df -h | egrep \"Filesystem|tmpfs\"\nFilesystem Size Used Avail Use% Mounted on\ntmpfs 64M 0 64M 0% /dev\n```\n\n\n### Set working directory\n\n[set-working-directory--w](https://docs.docker.com/engine/reference/commandline/run/#set-working-directory--w)\n\n```bash\n❯ docker run -w /path/to/dir/ -i -t ubuntu pwd \n/path/to/dir\n```\n\n\n### Mount Volumes\n\n[mount-volume](https://docs.docker.com/engine/reference/commandline/run/#mount-volume--v---read-only)\n\n```bash\n## Terminal session 1\n❯ ls\nReadMe.md\n\n# Note that the container also see the file ReadMe.md as we have mounted the same using pwd\n❯ docker run -v `pwd`:`pwd` -w `pwd` -i -t ubuntu ls\nReadMe.md\n\n## Terminal session 2\n# Let's create another directory and see\n❯ mkdir -p /tmp/test\n❯ cd /tmp/test\n❯ touch test.txt\n\n\n# Terminal session 1\n❯ docker run --rm -v /tmp/test:/foo -w /foo -i -t ubuntu bash\n# Let's see if the container can see the file\nroot@0e19af311731:/foo# ls\ntest.txt\nroot@0e19af311731:/foo# exit\nexit\n\n## The same can also be achieved using mount flag\n❯ docker run -t -i -w /foo --mount type=bind,src=/tmp/test,dst=/foo busybox sh\n/foo # ls\ntest.txt\n/foo # touch newfile.txt\n/foo # exit\n❯ ls /tmp/test \nnewfile.txt test.txt\n```" }, { "path": "home/containers/docker/taskset_docker_containers/task_008_docker_run__hostsfile_ulimit_mem_limit/ReadMe.md", "content": "# Hosts file, ulimit, memory limit\n\n## Hosts file\n\n[add-entries-to-container-hosts-file---add-host](https://docs.docker.com/engine/reference/commandline/run/#add-entries-to-container-hosts-file---add-host)\n\n```bash\n## get IP from ping google.com \n❯ docker run --add-host=myhost:142.250.181.78 --rm -it alpine\n/ # ping myhost\nPING myhost (142.250.181.78): 56 data bytes\n64 bytes from 142.250.181.78: seq=0 ttl=37 time=19.929 ms\n```\n\n## ulimit\n\n[set-ulimits-in-container---ulimit](https://docs.docker.com/engine/reference/commandline/run/#set-ulimits-in-container---ulimit)\n\n```bash\n❯ docker run --rm debian sh -c \"ulimit -n\" \n1048576\n\n❯ docker run --ulimit nofile=1024:1024 --rm debian sh -c \"ulimit -n\"\n1024\n```\n\n## Memory limit\n\n[specify-hard-limits-on-memory-available-to-containers--m---memory](https://docs.docker.com/engine/reference/commandline/run/#specify-hard-limits-on-memory-available-to-containers--m---memory)\n\n```bash\n## Terminal session 1\n❯ docker run --rm -it ubuntu \n\n## Terminal session 2\n❯ docker stats\n\n## Terminal session 1\n❯ docker run --rm -it --memory=\"2g\" ubuntu\n\n## Terminal session 2\n❯ docker stats\n```" }, { "path": "home/containers/docker/taskset_docker_containers/task_008_docker_run__metadata_and_network_and_attach_to_stdout/ReadMe.md", "content": "## Metadata, Network and Attach to stdout/stdin/stderr\n\n### Set metadata on container\n\n[set-metadata-on-container--l---label---label-file](https://docs.docker.com/engine/reference/commandline/run/#set-metadata-on-container--l---label---label-file)\n\n```bash\n# Terminal session 1\n❯ docker run --rm -l my-label --label com.example.foo=bar -it ubuntu bash\nroot@877169a9c393:/# \n\n# Terminal session 2\n❯ docker ps -a \nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n877169a9c393 ubuntu \"bash\" 27 seconds ago Up 27 seconds lucid_heyrovsky\n\n❯ docker inspect lucid_heyrovsky | egrep \"my-label|com\" \n \"com.example.foo\": \"bar\",\n \"my-label\": \"\"\n \n# Terminal session 1\nroot@877169a9c393:/# exit\nexit\n❯ \n```\n\n### Connect to network\n\nLet's create a nework. Connect two containers `a1` and `a2` to the same network.\nThen we should be able to ping `a2` from `a1`\n\n[connect-a-container-to-a-network---network](https://docs.docker.com/engine/reference/commandline/run/#connect-a-container-to-a-network---network)\n\n```bash\n# Terminal session 1\n# Create a network\n❯ docker network create mynet\n\n❯ docker network ls\nNETWORK ID NAME DRIVER SCOPE\nd94bd0d8c825 bridge bridge local\n4173677fe745 host host local\n92def2900117 mynet bridge local\n2328a0a37fde none null local\n\n❯ docker run --rm --name=a1 -it --network=mynet busybox \n\n\n# Terminal session 2\n❯ docker run --rm --name=a2 -it --network=mynet busybox\n\n## Note they are able to ping each other with just container names\n/ # ping a1\nPING a1 (172.18.0.2): 56 data bytes\n64 bytes from 172.18.0.2: seq=0 ttl=64 time=0.296 ms\n64 bytes from 172.18.0.2: seq=1 ttl=64 time=0.371 ms\n.\n/ # exit\n❯ \n```\n\n## Attach to stdout\n\n[attach-to-stdinstdoutstderr--a](https://docs.docker.com/engine/reference/commandline/run/#attach-to-stdinstdoutstderr--a)\n\nLet's do an example of attaching to container's stdout\n\n\n```bash\n# The following attaches stdout to your container.\n# So the output generated by the container will be displayed on your terminal\n❯ docker run -a stdout --rm --name ubuntu ubuntu ls var \nbackups\ncache\nlib\nlocal\nlock\nlog\nmail\nopt\nrun\nspool\ntmp\n```" }, { "path": "home/containers/docker/taskset_docker_containers/task_009_docker_attach/ReadMe.md", "content": "# docker attach\n\n[https://docs.docker.com/engine/reference/commandline/attach/](https://docs.docker.com/engine/reference/commandline/attach/)\n\nOnce you are attached to a container using docker attach\n- To stop a container, use CTRL-c. This key sequence sends SIGKILL to the container.\n- If the container was run with -i and -t, you can detach from a container and leave it running using the CTRL-p CTRL-q key sequence.\n## Attach to and detach from a running container\n\n```bash\n❯ docker run -d --name topdemo ubuntu:22.04 /usr/bin/top -b\n\n❯ docker attach topdemo\n\n# pressing CTRL-c terminates the container\n\n❯ docker ps -a\n```\n\n- Repeating the example above, but this time with the -i and -t options set;\n\n```bash\n❯ docker run -dit --name topdemo2 ubuntu:22.04 /usr/bin/top -b\n\n❯ docker attach topdemo2\n# pressing the CTRL-p CTRL-q the attach command is detached from the container\n# and the container is still running\n\n❯ docker ps -a \n```\n\n\n## Get the exit code of the container’s command\n\n- You can see the exit code returned by the bash process is returned by the docker attach command to its caller too\n\n```bash\n❯ docker run --name test -dit alpine\n❯ docker attach test\n/ # exit 13\n❯ echo $?\n13\n❯ docker ps -a --filter name=test\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n7828441ca97a alpine \"/bin/sh\" 48 seconds ago Exited (13) 31 seconds ago test\n\n```\n\n- In the given example, a Docker container is started with the alpine image in detached mode using the docker run command. Then, the docker attach command is used to attach to the running container.\n- Inside the container, the exit 13 command is executed, which will cause the bash process to exit with a status code of 13. The docker attach command will then return the same exit code to its caller, which in this case is the shell where the command was executed.\n- This means that the exit code returned by the docker attach command will be the same as the exit code returned by the bash process running inside the container. In other words, if the container's main process exits with a non-zero status code, the docker attach command will also return a non-zero status code to indicate that the command failed. This behavior allows you to check the exit status of a command running inside a container, which can be useful for scripting or automation purposes.\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_010_docker_build/Dockerfile", "content": "FROM nginx:latest\nCOPY index.html /usr/share/nginx/html/\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_010_docker_build/ReadMe.md", "content": "# docker build\n\n[docs.docker.com/engine/reference/commandline/build](https://docs.docker.com/engine/reference/commandline/build/)\n\n**High Level Objectives**\n- run nginx docker on port 8080\n- create a custom dockerfile with some changes\n- build an image with specific tag\n- run container that uses new image\n- understand the differences\n\n**Skills**\n- docker\n- docker build\n- tag\n- docker images\n\n**Version Stack**\n\n| Stack | Version |\n|--------|----------|\n| docker | 20.10.14 |\n\n## run nginx container\n\n```bash\n❯ docker run -it --rm -d -p 8080:80 --name nginx nginx\na6d8a4f9987c77a27c4f7864b82d86a1a1c0a899bf79bd3b70ef893ae74cf92d\n\n❯ docker ps -a \nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\na6d8a4f9987c nginx \"/docker-entrypoint.…\" 4 seconds ago Up 4 seconds 0.0.0.0:8080->80/tcp nginx\n\n❯ curl localhost:8080 \n\n\n\nWelcome to nginx!\n\n\n\n

Welcome to nginx!

\n

If you see this page, the nginx web server is successfully installed and\nworking. Further configuration is required.

\n\n

For online documentation and support please refer to\nnginx.org.
\nCommercial support is available at\nnginx.com.

\n\n

Thank you for using nginx.

\n\n\n\n\n❯ docker exec -it nginx bash\nroot@41e0b0f9b11b:/# ls /usr/share/nginx/html/\n50x.html index.html\nroot@41e0b0f9b11b:/# cat /usr/share/nginx/html/index.html \n\n\n\nWelcome to nginx!\n\n\n\n

Welcome to nginx!

\n

If you see this page, the nginx web server is successfully installed and\nworking. Further configuration is required.

\n\n

For online documentation and support please refer to\nnginx.org.
\nCommercial support is available at\nnginx.com.

\n\n

Thank you for using nginx.

\n\n\n```\n\n## Create Dockerfile and index.html\n\n## Build\n\n```bash\n❯ docker build -f Dockerfile .\n\n\n```\n\n## Check images\n\n\n```bash\n❯ docker images | head -n 2 \nREPOSITORY TAG IMAGE ID CREATED SIZE\n 9a69d38ae721 32 seconds ago 135MB\n\n\n```\n\n## Tag \n\n```bash\n❯ docker build -t my-docker-image -f Dockerfile .\n\n❯ docker images | head -n 2 \nREPOSITORY TAG IMAGE ID CREATED SIZE\nmy-docker-image latest 9a69d38ae721 About a minute ago 135MB\n```\n\n## Run image with new container\n\n```bash\n❯ docker ps -a | grep -v \"IMAGE\" | awk '{ print $NF}' | xargs docker stop\nnginx\n\n❯ docker run -it --rm -d -p 8080:80 --name nginx my-docker-image:latest \n1535f427e222e04b71d91c7b4ccb740ec2d1fb4624828bb4f145e303fc1815c3\n\n\n❯ curl localhost:8080\n\n\n Hello, Docker!\n\n\n

Hello, Docker!

\n

Welcome to my Docker container!

\n\n\n\n\n\n❯ docker exec -it nginx bash \nroot@7e144aa1d8ec:/# cat /usr/share/nginx/html/index.html \n\n\n Hello, Docker!\n\n\n

Hello, Docker!

\n

Welcome to my Docker container!

\n\n\nroot@7e144aa1d8ec:/# \n\n```" }, { "path": "home/containers/docker/taskset_docker_containers/task_010_docker_build/index.html", "content": "\n\n Hello, Docker!\n\n\n

Hello, Docker!

\n

Welcome to my Docker container!

\n\n\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_011_mongo/ReadMe.md", "content": "\n[Referenced link](https://www.code4it.dev/blog/run-mongodb-on-docker)\n\n```bash\n$ docker run -d --name mongo-on-docker -p 27888:27017 -e MONGO_INITDB_ROOT_USERNAME=mongoadmin -e MONGO_INITDB_ROOT_PASSWORD=secret mongo\n0f4060b2b64f35642a4988c5dde5eb9461f87de36ac297b10142a2701269ba8f\n```\n\n- While connecting using the client, the following details are required\n```bash\nServer: localhost\nPort: 27888\nUsername: mongoadmin\nPassword: secret\n``` \n\n- You can use the following to connect to the shell\n\n```bash\n$ mongo --username mongoadmin --password secret --port 27888 --host 127.0.0.1\nMongoDB shell version v4.4.3\nconnecting to: mongodb://127.0.0.1:27888/?compressors=disabled&gssapiServiceName=mongodb\nImplicit session: session { \"id\" : UUID(\"7e4758b6-a551-4f20-bece-584fb042996d\") }\nMongoDB server version: 4.4.4\n---\nThe server generated these startup warnings when booting: \n 2021-05-30T07:21:09.404+00:00: Using the XFS filesystem is strongly recommended with the WiredTiger storage engine. See http://dochub.mongodb.org/core/prodnotes-filesystem\n---\n---\n Enable MongoDB's free cloud-based monitoring service, which will then receive and display\n metrics about your deployment (disk utilization, CPU, operation statistics, etc).\n\n The monitoring data will be available on a MongoDB website with a unique URL accessible to you\n and anyone you share the URL with. MongoDB may use this information to make product\n improvements and to suggest MongoDB products and deployment options to you.\n\n To enable free monitoring, run the following command: db.enableFreeMonitoring()\n To permanently disable this reminder, run the following command: db.disableFreeMonitoring()\n---\n>\n```\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_012_postgres/ReadMe.md", "content": "\n- Run the following command\n\n```bash\n$ docker run -d \\\n--name my_postgres \\\n-v /tmp/data:/var/lib/postgresql/data \\\n-p 54320:5432 \\\n-e POSTGRES_PASSWORD=my_password postgres\n7d93d3b28d3447f5bd4ed149a7084a7d46872b6efc7d2fc4720d25381dae9169\n```\n\n- Check the status of the container\n\n```bash\n$ docker ps -a | egrep -v \"k8s\"\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n7d93d3b28d34 postgres \"docker-entrypoint.s…\" 12 seconds ago Up 11 seconds 0.0.0.0:54320->5432/tcp, :::54320->5432/tcp my_postgres\n```\n\n\n- Try connecting to the database\n\n```bash\n$ psql -h 127.0.0.1 -p 54320 --username=postgres\nPassword for user postgres: \npsql (13.2, server 13.3 (Debian 13.3-1.pgdg100+1))\nType \"help\" for help.\n\npostgres=# \npostgres=# \\du\n List of roles\n Role name | Attributes | Member of \n-----------+------------------------------------------------------------+-----------\n postgres | Superuser, Create role, Create DB, Replication, Bypass RLS | {}\n\n\n```" }, { "path": "home/containers/docker/taskset_docker_containers/task_013_prometheus_blackbox_exporter/ReadMe.md", "content": "## Black box exporter POC\n\n[Docs](https://prometheus.io/docs/guides/multi-target-exporter/)\n\n- Starting the blackbox exporter\n```bash\n$ docker run -p 9115:9115 prom/blackbox-exporter\nlevel=info ts=2020-07-27T17:37:24.916Z caller=main.go:212 msg=\"Starting blackbox_exporter\" version=\"(version=0.17.0, branch=HEAD, revision=1bc768014cf6815f7e9d694e0292e77dd10f3235)\"\nlevel=info ts=2020-07-27T17:37:24.916Z caller=main.go:213 msg=\"Build context\" (gogo1.14.4,userroot@626fb3899f41,date20200619-11:54:41)=(MISSING)\nlevel=info ts=2020-07-27T17:37:24.918Z caller=main.go:225 msg=\"Loaded config file\"\nlevel=info ts=2020-07-27T17:37:24.919Z caller=main.go:369 msg=\"Listening on address\" address=:9115\n\n```\n\n- Quering the exporter itself\n```bash\n$ curl 'localhost:9115/metrics'\n# HELP blackbox_exporter_build_info A metric with a constant '1' value labeled by version, revision, branch, and goversion from which blackbox_exporter was built.\n.\npromhttp_metric_handler_requests_total{code=\"503\"} 0\n```\n\n- to query prometheus.io in the terminal with curl:\n\n```bash\n$ docker \\\n> run -p 9115:9115 \\\n> --mount type=bind,source=\"$(pwd)\"/blackbox.yml,target=/blackbox.yml,readonly \\\n> prom/blackbox-exporter \\\n> --config.file=\"/blackbox.yml\"\nlevel=info ts=2020-07-27T18:06:49.187Z caller=main.go:212 msg=\"Starting blackbox_exporter\" version=\"(version=0.17.0, branch=HEAD, revision=1bc768014cf6815f7e9d694e0292e77dd10f3235)\"\nlevel=info ts=2020-07-27T18:06:49.187Z caller=main.go:213 msg=\"Build context\" (gogo1.14.4,userroot@626fb3899f41,date20200619-11:54:41)=(MISSING)\nlevel=info ts=2020-07-27T18:06:49.190Z caller=main.go:225 msg=\"Loaded config file\"\nlevel=info ts=2020-07-27T18:06:49.190Z caller=main.go:369 msg=\"Listening on address\" address=:9115\n```\n\nWith this command, you told docker to:\n\n- run a container with the port 9115 outside the container mapped to the port 9115 inside of the container.\n- mount from your current directory ($(pwd) stands for print working directory) the file blackbox.yml into /blackbox.yml in readonly mode.\n- use the image prom/blackbox-exporter from Docker hub.\n- run the blackbox-exporter with the flag --config.file telling it to use /blackbox.yml as config file.\n\nNow you can try our new IPv4-using module http_2xx in a terminal:\n```bash\n$ curl 'localhost:9115/probe?target=prometheus.io&module=http_2xx'\n# HELP probe_dns_lookup_time_seconds Returns the time taken for probe dns lookup in seconds\n.\nprobe_success 1\n# HELP probe_tls_version_info Contains the TLS version used\n# TYPE probe_tls_version_info gauge\nprobe_tls_version_info{version=\"TLS 1.3\"} 1\n```\n\nRun Prometheus on MacOS\n```bash\n$ docker \\\n> run -p 9090:9090 \\\n> --mount type=bind,source=\"$(pwd)\"/prometheus.yml,target=/prometheus.yml,readonly \\\n> prom/prometheus \\\n> --config.file=\"/prometheus.yml\"\nlevel=info ts=2020-07-27T18:23:09.768Z caller=main.go:302 msg=\"No time or size retention was set so using the default time retention\" duration=15d\n.\nlevel=info ts=2020-07-27T18:23:09.791Z caller=main.go:646 msg=\"Server is ready to receive web requests.\"\n```\n\nIf everything works fine, you can check the targets at [localhost:9090/targets](localhost:9090/targets)\n\n\n![img](./.images/localhost-targets-prometheus.png)\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_013_prometheus_blackbox_exporter/blackbox.yml", "content": "modules:\n http_2xx:\n prober: http\n http:\n preferred_ip_protocol: \"ip4\"\n http_post_2xx:\n prober: http\n http:\n method: POST\n tcp_connect:\n prober: tcp\n pop3s_banner:\n prober: tcp\n tcp:\n query_response:\n - expect: \"^+OK\"\n tls: true\n tls_config:\n insecure_skip_verify: false\n ssh_banner:\n prober: tcp\n tcp:\n query_response:\n - expect: \"^SSH-2.0-\"\n irc_banner:\n prober: tcp\n tcp:\n query_response:\n - send: \"NICK prober\"\n - send: \"USER prober prober prober :prober\"\n - expect: \"PING :([^ ]+)\"\n send: \"PONG ${1}\"\n - expect: \"^:[^ ]+ 001\"\n icmp:\n prober: icmp\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_013_prometheus_blackbox_exporter/prometheus.yml", "content": "global:\n scrape_interval: 5s\n\nscrape_configs:\n - job_name: blackbox # To get metrics about the exporter itself\n metrics_path: /metrics\n static_configs:\n - targets:\n - host.docker.internal:9115 # For Windows and macOS replace with - host.docker.internal:9115\n\n - job_name: blackbox-http # To get metrics about the exporter’s targets\n metrics_path: /probe\n params:\n module: [http_2xx]\n static_configs:\n - targets:\n - http://prometheus.io # Target to probe with http\n - https://prometheus.io # Target to probe with https\n - http://example.com:8080 # Target to probe with http on port 8080\n relabel_configs:\n - source_labels: [__address__]\n target_label: __param_target\n - source_labels: [__param_target]\n target_label: instance\n - target_label: __address__\n replacement: host.docker.internal:9115 # The blackbox exporter’s real hostname:port. For Windows and macOS replace with - host.docker.internal:9115" }, { "path": "home/containers/docker/taskset_docker_containers/task_014_elastic_search/ReadMe.md", "content": "To start docker-elastic-search on single node\n\n[Docs](https://www.elastic.co/guide/en/elasticsearch/reference/current/docker.html)\n\n- Start docker-elastic-search\n\n```bash\n$ $ docker run -p 9200:9200 -p 9300:9300 -e \"discovery.type=single-node\" docker.elastic.co/elasticsearch/elasticsearch:7.8.1\n\n```\n\n- Check the health\n\n```bash\n$ curl -X GET \"localhost:9200/_cat/nodes?v&pretty\"\nip heap.percent ram.percent cpu load_1m load_5m load_15m node.role master name\n172.17.0.3 49 96 6 0.56 0.38 0.40 dilmrt * 7fc9a4e5361c\n```\n\n\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_015_elastic_search_bkp_restore/Dockerfile", "content": "FROM docker.elastic.co/elasticsearch/elasticsearch:7.7.0\n\n#this is to tell that we are passing these arguments at runtime\nARG ENV_VAR_AWS_ACCESS_KEY_ID\nARG ENV_VAR_AWS_SECRET_ACCESS_KEY\n\nENV AWS_ACCESS_KEY_ID ${ENV_VAR_AWS_ACCESS_KEY_ID}\nENV AWS_SECRET_ACCESS_KEY ${ENV_VAR_AWS_SECRET_ACCESS_KEY}\nENV xpack.security.enabled 'false'\nENV xpack.monitoring.enabled 'false'\nENV xpack.graph.enabled 'false'\nENV xpack.watcher.enabled 'false'\nENV discovery.type 'single-node'\nENV bootstrap.memory_lock 'true'\nENV indices.memory.index_buffer_size '30%'\n\nRUN /usr/share/elasticsearch/bin/elasticsearch-plugin install --batch repository-s3\nRUN /usr/share/elasticsearch/bin/elasticsearch-keystore create\nRUN echo $AWS_ACCESS_KEY_ID | /usr/share/elasticsearch/bin/elasticsearch-keystore add --stdin s3.client.default.access_key\nRUN echo $AWS_SECRET_ACCESS_KEY | /usr/share/elasticsearch/bin/elasticsearch-keystore add --stdin s3.client.default.secret_key" }, { "path": "home/containers/docker/taskset_docker_containers/task_015_elastic_search_bkp_restore/ReadMe.md", "content": "\n- Docs Referred\n - [elasticsearch-backup-snapshot-and-restore-on-aws-s3](https://medium.com/@federicopanini/elasticsearch-backup-snapshot-and-restore-on-aws-s3-f1fc32fbca7f)\n - [opendistro](https://opendistro.github.io/for-elasticsearch-docs/docs/elasticsearch/snapshot-restore/#amazon-s3)\n\n\n### Build image and deploy\n\n\n- Build new image\n```bash\ndocker build \\\n--build-arg ENV_VAR_AWS_ACCESS_KEY_ID= \\\n--build-arg ENV_VAR_AWS_SECRET_ACCESS_KEY= \\\n--tag=codeaprendiz/elasticsearch .\n```\n\n- Check the images present\n```bash\n$ docker images | grep \"codeaprendiz/elasticsearch\"\ncodeaprendiz/elasticsearch latest f06a06d5fd8a 36 seconds ago 796MB\n```\n\n- Running the image\n```bash\ndocker run -p 9200:9200 -p 9600:9600 codeaprendiz/elasticsearch\n```\n\n### Register\n- Register your repo at S3\n\n```bash\n$ curl -X PUT -H \"Content-Type: application/json\" -d @register.json \"http://localhost:9200/_snapshot/my-s3-repository\"\n{\"acknowledged\":true}\n```\n\n\n### Taking Snapshots\n\n- Taking a snapshot\n```bash\n$ curl -X PUT -H \"Content-Type: application/json\" -d @snapshotsetting.json \"http://localhost:9200/_snapshot/my-s3-repository/firstsnap?wait_for_completion=true\"\n{\"snapshot\":{\"snapshot\":\"firstsnap\",\"uuid\":\"VpRaTS-eRr6TLqIOi9Zw2w\",\"version_id\":7060299,\"version\":\"7.6.2\",\"indices\":[],\"include_global_state\":false,\"state\":\"SUCCESS\",\"start_time\":\"2020-05-16T14:13:06.219Z\",\"start_time_in_millis\":1589638386219,\"end_time\":\"2020-05-16T14:13:06.624Z\",\"end_time_in_millis\":1589638386624,\"duration_in_millis\":405,\"failures\":[],\"shards\":{\"total\":0,\"failed\":0,\"successful\":0}}}\n```\n\n- Corresponding docker logs\n\n```bash\n$ docker logs -f friendly_fermi\n{\"type\": \"server\", \"timestamp\": \"2020-05-16T14:13:06,646Z\", \"level\": \"INFO\", \"component\": \"o.e.s.SnapshotsService\", \"cluster.name\": \"docker-cluster\", \"node.name\": \"676c35dac6af\", \"message\": \"snapshot [my-s3-repository:firstsnap/VpRaTS-eRr6TLqIOi9Zw2w] started\", \"cluster.uuid\": \"Crq-wvoIQmuzm920sZr8MA\", \"node.id\": \"Q_xnc6qyRxy-BbvRLQNwlg\" }\n{\"type\": \"server\", \"timestamp\": \"2020-05-16T14:13:08,852Z\", \"level\": \"INFO\", \"component\": \"o.e.s.SnapshotsService\", \"cluster.name\": \"docker-cluster\", \"node.name\": \"676c35dac6af\", \"message\": \"snapshot [my-s3-repository:firstsnap/VpRaTS-eRr6TLqIOi9Zw2w] completed with state [SUCCESS]\", \"cluster.uuid\": \"Crq-wvoIQmuzm920sZr8MA\", \"node.id\": \"Q_xnc6qyRxy-BbvRLQNwlg\" }\n```\n\n\n- Request your snapshot \n```bash\n$ curl -X GET \"http://localhost:9200/_snapshot/my-s3-repository/firstsnap\"\n{\"snapshots\":[{\"snapshot\":\"firstsnap\",\"uuid\":\"VpRaTS-eRr6TLqIOi9Zw2w\",\"version_id\":7060299,\"version\":\"7.6.2\",\"indices\":[],\"include_global_state\":false,\"state\":\"SUCCESS\",\"start_time\":\"2020-05-16T14:13:06.219Z\",\"start_time_in_millis\":1589638386219,\"end_time\":\"2020-05-16T14:13:06.624Z\",\"end_time_in_millis\":1589638386624,\"duration_in_millis\":405,\"failures\":[],\"shards\":{\"total\":0,\"failed\":0,\"successful\":0}}]}\n```\n\n\n- To check the status of snapshot\n```bash\n$ curl -X GET \"http://localhost:9200/_snapshot/_status\" \n{\"snapshots\":[]}\n```\n\n- To check all the snapshots\n```bash\n$ curl -X GET \"http://localhost:9200/_snapshot/_all\"\n{\"my-s3-repository\":{\"type\":\"s3\",\"settings\":{\"bucket\":\"elk-backup-codeaprendiz\"}}}\n```\n\n- To see all the snapshots in a repository\n```bash\n$ curl -X GET \"http://localhost:9200/_snapshot/my-s3-repository/_all\"\n{\"snapshots\":[{\"snapshot\":\"firstsnap\",\"uuid\":\"VwFvTv3nSKOD5K8J3EBE2A\",\"version_id\":7060299,\"version\":\"7.6.2\",\"indices\":[],\"include_global_state\":false,\"state\":\"SUCCESS\",\"start_time\":\"2020-05-14T14:45:46.358Z\",\"start_time_in_millis\":1589467546358,\"end_time\":\"2020-05-14T14:45:46.561Z\",\"end_time_in_millis\":1589467546561,\"duration_in_millis\":203,\"failures\":[],\"shards\":{\"total\":0,\"failed\":0,\"successful\":0}}]}\n```\n\n\n### Restore your snapshot\n\n- To restore a snapshot\n```bash\n$ curl -X POST -H \"Content-Type: application/json\" -d @restoresnapshot.json \"http://localhost:9200/_snapshot/my-s3-repository/firstsnap/_restore\"\n{\"snapshot\":{\"snapshot\":\"firstsnap\",\"indices\":[],\"shards\":{\"total\":0,\"failed\":0,\"successful\":0}}}\n```\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_015_elastic_search_bkp_restore/register.json", "content": "{\n \"type\": \"s3\",\n \"settings\": {\n \"bucket\": \"elk-backup-codeaprendiz\"\n }\n}\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_015_elastic_search_bkp_restore/restoresnapshot.json", "content": "{\n \"indices\": \"kibana*,my-index*\",\n \"ignore_unavailable\": true,\n \"include_global_state\": false,\n \"include_aliases\": false,\n \"partial\": false,\n \"rename_pattern\": \"kibana(.+)\",\n \"rename_replacement\": \"restored-kibana$1\",\n \"index_settings\": {\n \"index.blocks.read_only\": false\n },\n \"ignore_index_settings\": [\n \"index.refresh_interval\"\n ]\n}\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_015_elastic_search_bkp_restore/snapshotsetting.json", "content": "{\n \"indices\": \"kibana*,my-index*,-my-index-2016\",\n \"ignore_unavailable\": true,\n \"include_global_state\": false,\n \"partial\": false\n}\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_016_elastic_search_backup_restore_sample_data/Dockerfile", "content": "FROM docker.elastic.co/elasticsearch/elasticsearch:7.7.0\n\n#this is to tell that we are passing these arguments at runtime\nARG ENV_VAR_AWS_ACCESS_KEY_ID\nARG ENV_VAR_AWS_SECRET_ACCESS_KEY\n\nENV AWS_ACCESS_KEY_ID ${ENV_VAR_AWS_ACCESS_KEY_ID}\nENV AWS_SECRET_ACCESS_KEY ${ENV_VAR_AWS_SECRET_ACCESS_KEY}\nENV xpack.security.enabled 'false'\nENV xpack.monitoring.enabled 'false'\nENV xpack.graph.enabled 'false'\nENV xpack.watcher.enabled 'false'\nENV discovery.type 'single-node'\nENV bootstrap.memory_lock 'true'\nENV indices.memory.index_buffer_size '30%'\n\nRUN /usr/share/elasticsearch/bin/elasticsearch-plugin install --batch repository-s3\nRUN /usr/share/elasticsearch/bin/elasticsearch-keystore create\nRUN echo $AWS_ACCESS_KEY_ID | /usr/share/elasticsearch/bin/elasticsearch-keystore add --stdin s3.client.default.access_key\nRUN echo $AWS_SECRET_ACCESS_KEY | /usr/share/elasticsearch/bin/elasticsearch-keystore add --stdin s3.client.default.secret_key\n\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_016_elastic_search_backup_restore_sample_data/ReadMe.md", "content": "\n- Docs Referred\n - [elasticsearch-backup-snapshot-and-restore-on-aws-s3](https://medium.com/@federicopanini/elasticsearch-backup-snapshot-and-restore-on-aws-s3-f1fc32fbca7f)\n - [opendistro](https://opendistro.github.io/for-elasticsearch-docs/docs/elasticsearch/snapshot-restore/#amazon-s3)\n - [elasticsearch](https://www.elastic.co/guide/en/kibana/7.7/tutorial-build-dashboard.html#load-dataset)\n\n### Build image and deploy\n\n- Build new image\n```bash\ndocker build \\\n--build-arg ENV_VAR_AWS_ACCESS_KEY_ID= \\\n--build-arg ENV_VAR_AWS_SECRET_ACCESS_KEY= \\\n--tag=codeaprendiz/elasticsearch .\n```\n\n- Running the image\n```bash\ndocker run -p 9200:9200 -p 9600:9600 codeaprendiz/elasticsearch\n```\n\n### Register\n- Register your repo at S3\n\n```bash\n$ curl -X PUT -H \"Content-Type: application/json\" -d @register.json \"http://localhost:9200/_snapshot/my-s3-repository\"\n{\"acknowledged\":true}\n```\n\n\n### Download data\n```bash\ncurl -O https://download.elastic.co/demos/kibana/gettingstarted/8.x/shakespeare.json\ncurl -O https://download.elastic.co/demos/kibana/gettingstarted/8.x/accounts.zip\ncurl -O https://download.elastic.co/demos/kibana/gettingstarted/8.x/logs.jsonl.gz\n```\n\n\n### Set Up Mapping\n\n\n- Set up mapping shakespeare\n```bash\ncurl -X PUT \"localhost:9200/shakespeare?pretty\" -H 'Content-Type: application/json' -d'\n{\n \"mappings\": {\n \"properties\": {\n \"speaker\": {\"type\": \"keyword\"},\n \"play_name\": {\"type\": \"keyword\"},\n \"line_id\": {\"type\": \"integer\"},\n \"speech_number\": {\"type\": \"integer\"}\n }\n }\n}\n'\n\n```\n\n\n\n\n- set up mapping logs index1\n```\ncurl -X PUT \"localhost:9200/logstash-2015.05.18?pretty\" -H 'Content-Type: application/json' -d'\n{\n \"mappings\": {\n \"properties\": {\n \"geo\": {\n \"properties\": {\n \"coordinates\": {\n \"type\": \"geo_point\"\n }\n }\n }\n }\n }\n}\n'\n\n```\n\n- set up mapping logs index2\n\n```bash\ncurl -X PUT \"localhost:9200/logstash-2015.05.19?pretty\" -H 'Content-Type: application/json' -d'\n{\n \"mappings\": {\n \"properties\": {\n \"geo\": {\n \"properties\": {\n \"coordinates\": {\n \"type\": \"geo_point\"\n }\n }\n }\n }\n }\n}\n'\n\n```\n\n- set up mapping logs index3\n\n```bash\ncurl -X PUT \"localhost:9200/logstash-2015.05.20?pretty\" -H 'Content-Type: application/json' -d'\n{\n \"mappings\": {\n \"properties\": {\n \"geo\": {\n \"properties\": {\n \"coordinates\": {\n \"type\": \"geo_point\"\n }\n }\n }\n }\n }\n}\n'\n```\n\n\n### Load the dataset\n\n- accounts.json\n```bash\n$ ls accounts.json\naccounts.json\n\ncurl -u elastic -H 'Content-Type: application/x-ndjson' -XPOST 'http://localhost:9200/bank/_bulk?pretty' --data-binary @accounts.json\nEnter host password for user 'elastic': changeit\n```\n\n\n- shakespeare.json\n\n```bash\n$ ls shakespeare.json\nshakespeare.json\n\n$ curl -u elastic -H 'Content-Type: application/x-ndjson' -XPOST 'http://localhost:9200/shakespeare/_bulk?pretty' --data-binary @shakespeare.json\nEnter host password for user 'elastic': changeit\n```\n\n\n\n- logs.jsonl\n\n```bash\n$ ls logs.jsonl\nlogs.jsonl\n\n$ curl -u elastic -H 'Content-Type: application/x-ndjson' -XPOST 'http://localhost:9200/_bulk?pretty' --data-binary @logs.jsonl\n\nEnter host password for user 'elastic': changeit\n```\n\n\n- Verify successful loading \n\n```bash\n$ curl -X GET \"localhost:9200/_cat/indices?v&pretty\"\nhealth status index uuid pri rep docs.count docs.deleted store.size pri.store.size\nyellow open bank D3IZamRJTSaMiQalyytz9Q 1 1 1000 0 381.8kb 381.8kb\nyellow open shakespeare eRGAw6pgRnyScN5kIH6ZzQ 1 1 0 0 5.9mb 5.9mb\nyellow open logstash-2015.05.20 qjAB6tF1Q2azhnE6e_NoxQ 1 1 0 0 5.7mb 5.7mb\nyellow open logstash-2015.05.18 sg3cCzaVQyunHmwDpWK7gQ 1 1 0 0 5.5mb 5.5mb\nyellow open logstash-2015.05.19 BOvYmnU6QB-Wp0ITC0wN1g 1 1 0 0 5.6mb 5.6mb\n\n```\n\n- Check after 15 minutes (CHECK THE STATE HERE. LATER WE WILL RESTORE THE DATA FROM S3 and COMPARE ITS STATE)\n\n```bash\n$ curl -X GET \"localhost:9200/_cat/indices?v&pretty\"\nhealth status index uuid pri rep docs.count docs.deleted store.size pri.store.size\nyellow open bank D3IZamRJTSaMiQalyytz9Q 1 1 1000 0 381.9kb 381.9kb\nyellow open shakespeare eRGAw6pgRnyScN5kIH6ZzQ 1 1 111396 0 18.2mb 18.2mb\nyellow open logstash-2015.05.20 qjAB6tF1Q2azhnE6e_NoxQ 1 1 4750 0 14mb 14mb\nyellow open logstash-2015.05.18 sg3cCzaVQyunHmwDpWK7gQ 1 1 4631 0 13.7mb 13.7mb\nyellow open logstash-2015.05.19 BOvYmnU6QB-Wp0ITC0wN1g 1 1 4624 0 13.8mb 13.8mb\n```\n\n### Index Mapping before restore\n\n```bash\n$ curl -X GET \"http://localhost:9200/bank/_mapping\"\n{\"bank\":{\"mappings\":{\"properties\":{\"account_number\":{\"type\":\"long\"},\"address\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}},\"age\":{\"type\":\"long\"},\"balance\":{\"type\":\"long\"},\"city\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}},\"email\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}},\"employer\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}},\"firstname\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}},\"gender\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}},\"lastname\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}},\"state\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}}}}}}\n```\n\n```bash\n$ curl -X GET \"http://localhost:9200/shakespeare/_mapping\"\n{\"shakespeare\":{\"mappings\":{\"properties\":{\"line_id\":{\"type\":\"integer\"},\"line_number\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}},\"play_name\":{\"type\":\"keyword\"},\"speaker\":{\"type\":\"keyword\"},\"speech_number\":{\"type\":\"integer\"},\"text_entry\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}},\"type\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}}}}}}\n```\n\n\n### Taking Snapshots\n\n- Taking a snapshot (this may take some time. be patient!)\n```bash\ncurl -X PUT -H \"Content-Type: application/json\" -d @snapshotsetting.json \"http://localhost:9200/_snapshot/my-s3-repository/finalsnap?wait_for_completion=true\"\n{\"snapshot\":{\"snapshot\":\"finalsnap\",\"uuid\":\"rWvtq0cBQIqFoUDc8pYFNA\",\"version_id\":7070099,\"version\":\"7.7.0\",\"indices\":[\"logstash-2015.05.20\",\"logstash-2015.05.19\",\"shakespeare\",\"logstash-2015.05.18\",\"bank\"],\"include_global_state\":false,\"state\":\"SUCCESS\",\"start_time\":\"2020-05-17T20:16:14.563Z\",\"start_time_in_millis\":1589746574563,\"end_time\":\"2020-05-17T20:17:38.094Z\",\"end_time_in_millis\":1589746658094,\"duration_in_millis\":83531,\"failures\":[],\"shards\":{\"total\":5,\"failed\":0,\"successful\":5}}}\n```\n\n\n- To check the status of snapshot\n```bash\n$ curl -X GET \"http://localhost:9200/_snapshot/_status\"\n{\"snapshots\":[{\"snapshot\":\"finalsnap\",\"repository\":\"my-s3-repository\",\"uuid\":\"rWvtq0cBQIqFoUDc8pYFNA\",\"state\":\"STARTED\",\"include_global_state\":false,\"shards_stats\":{\"initializing\":0,\"started\":5,\"finalizing\":0,\"done\":0,\"failed\":0,\"total\":5},\"stats\":{\"incremental\":{\"file_count\":20,\"size_in_bytes\":63273242},\"processed\":{\"file_count\":4,\"size_in_bytes\":1704},\"total\":{\"file_count\":20,\"size_in_bytes\":63273242},\"start_time_in_millis\":1589746574563,\"time_in_millis\":41848},\"indices\":{\"bank\":{\"shards_stats\":{\"initializing\":0,\"started\":1,\"finalizing\":0,\"done\":0,\"failed\":0,\"total\":1},\"stats\":{\"incremental\":{\"file_count\":4,\"size_in_bytes\":391085},\"processed\":{\"file_count\":0,\"size_in_bytes\":0},\"total\":{\"file_count\":4,\"size_in_bytes\":391085},\"start_time_in_millis\":1589746576366,\"time_in_millis\":0},\"shards\":{\"0\":{\"stage\":\"STARTED\",\"stats\":{\"incremental\":{\"file_count\":4,\"size_in_bytes\":391085},\"processed\":{\"file_count\":0,\"size_in_bytes\":0},\"total\":{\"file_count\":4,\"size_in_bytes\":391085},\"start_time_in_millis\":1589746576366,\"time_in_millis\":0},\"node\":\"vp977yjVTHW5915UCPRBYA\"}}},\"shakespeare\":{\"shards_stats\":{\"initializing\":0,\"started\":1,\"finalizing\":0,\"done\":0,\"failed\":0,\"total\":1},\"stats\":{\"incremental\":{\"file_count\":4,\"size_in_bytes\":19179417},\"processed\":{\"file_count\":1,\"size_in_bytes\":426},\"total\":{\"file_count\":4,\"size_in_bytes\":19179417},\"start_time_in_millis\":1589746576366,\"time_in_millis\":0},\"shards\":{\"0\":{\"stage\":\"STARTED\",\"stats\":{\"incremental\":{\"file_count\":4,\"size_in_bytes\":19179417},\"processed\":{\"file_count\":1,\"size_in_bytes\":426},\"total\":{\"file_count\":4,\"size_in_bytes\":19179417},\"start_time_in_millis\":1589746576366,\"time_in_millis\":0},\"node\":\"vp977yjVTHW5915UCPRBYA\"}}},\"logstash-2015.05.20\":{\"shards_stats\":{\"initializing\":0,\"started\":1,\"finalizing\":0,\"done\":0,\"failed\":0,\"total\":1},\"stats\":{\"incremental\":{\"file_count\":4,\"size_in_bytes\":14772605},\"processed\":{\"file_count\":1,\"size_in_bytes\":426},\"total\":{\"file_count\":4,\"size_in_bytes\":14772605},\"start_time_in_millis\":1589746576366,\"time_in_millis\":0},\"shards\":{\"0\":{\"stage\":\"STARTED\",\"stats\":{\"incremental\":{\"file_count\":4,\"size_in_bytes\":14772605},\"processed\":{\"file_count\":1,\"size_in_bytes\":426},\"total\":{\"file_count\":4,\"size_in_bytes\":14772605},\"start_time_in_millis\":1589746576366,\"time_in_millis\":0},\"node\":\"vp977yjVTHW5915UCPRBYA\"}}},\"logstash-2015.05.18\":{\"shards_stats\":{\"initializing\":0,\"started\":1,\"finalizing\":0,\"done\":0,\"failed\":0,\"total\":1},\"stats\":{\"incremental\":{\"file_count\":4,\"size_in_bytes\":14394696},\"processed\":{\"file_count\":1,\"size_in_bytes\":426},\"total\":{\"file_count\":4,\"size_in_bytes\":14394696},\"start_time_in_millis\":1589746576366,\"time_in_millis\":0},\"shards\":{\"0\":{\"stage\":\"STARTED\",\"stats\":{\"incremental\":{\"file_count\":4,\"size_in_bytes\":14394696},\"processed\":{\"file_count\":1,\"size_in_bytes\":426},\"total\":{\"file_count\":4,\"size_in_bytes\":14394696},\"start_time_in_millis\":1589746576366,\"time_in_millis\":0},\"node\":\"vp977yjVTHW5915UCPRBYA\"}}},\"logstash-2015.05.19\":{\"shards_stats\":{\"initializing\":0,\"started\":1,\"finalizing\":0,\"done\":0,\"failed\":0,\"total\":1},\"stats\":{\"incremental\":{\"file_count\":4,\"size_in_bytes\":14535439},\"processed\":{\"file_count\":1,\"size_in_bytes\":426},\"total\":{\"file_count\":4,\"size_in_bytes\":14535439},\"start_time_in_millis\":1589746576366,\"time_in_millis\":0},\"shards\":{\"0\":{\"stage\":\"STARTED\",\"stats\":{\"incremental\":{\"file_count\":4,\"size_in_bytes\":14535439},\"processed\":{\"file_count\":1,\"size_in_bytes\":426},\"total\":{\"file_count\":4,\"size_in_bytes\":14535439},\"start_time_in_millis\":1589746576366,\"time_in_millis\":0},\"node\":\"vp977yjVTHW5915UCPRBYA\"}}}}}]}\n\n$ curl -X GET \"http://localhost:9200/_snapshot/_status\"\n{\"snapshots\":[]}\n```\n\n\n\n- Request your snapshot \n```bash\n$ curl -X GET \"http://localhost:9200/_snapshot/my-s3-repository/finalsnap\"\ncurl -X GET \"http://localhost:9200/_snapshot/my-s3-repository/finalsnap\"\n{\"snapshots\":[{\"snapshot\":\"finalsnap\",\"uuid\":\"rWvtq0cBQIqFoUDc8pYFNA\",\"version_id\":7070099,\"version\":\"7.7.0\",\"indices\":[\"logstash-2015.05.20\",\"logstash-2015.05.19\",\"shakespeare\",\"logstash-2015.05.18\",\"bank\"],\"include_global_state\":false,\"state\":\"SUCCESS\",\"start_time\":\"2020-05-17T20:16:14.563Z\",\"start_time_in_millis\":1589746574563,\"end_time\":\"2020-05-17T20:17:38.094Z\",\"end_time_in_millis\":1589746658094,\"duration_in_millis\":83531,\"failures\":[],\"shards\":{\"total\":5,\"failed\":0,\"successful\":5}}]}\n```\n\n- To check all the snapshots\n```bash\n$ curl -X GET \"http://localhost:9200/_snapshot/_all\" \n{\"my-s3-repository\":{\"type\":\"s3\",\"settings\":{\"bucket\":\"elk-backup-codeaprendiz\"}}} \n```\n\n- To see all the snapshots in a repository\n```bash\n$ curl -X GET \"http://localhost:9200/_snapshot/my-s3-repository/_all\"\n{\"snapshots\":[{\"snapshot\":\"firstsnap\",\"uuid\":\"VpRaTS-eRr6TLqIOi9Zw2w\",\"version_id\":7060299,\"version\":\"7.6.2\",\"indices\":[],\"include_global_state\":false,\"state\":\"SUCCESS\",\"start_time\":\"2020-05-16T14:13:06.219Z\",\"start_time_in_millis\":1589638386219,\"end_time\":\"2020-05-16T14:13:06.624Z\",\"end_time_in_millis\":1589638386624,\"duration_in_millis\":405,\"failures\":[],\"shards\":{\"total\":0,\"failed\":0,\"successful\":0}},{\"snapshot\":\"finalsnap\",\"uuid\":\"rWvtq0cBQIqFoUDc8pYFNA\",\"version_id\":7070099,\"version\":\"7.7.0\",\"indices\":[\"logstash-2015.05.20\",\"logstash-2015.05.19\",\"shakespeare\",\"logstash-2015.05.18\",\"bank\"],\"include_global_state\":false,\"state\":\"SUCCESS\",\"start_time\":\"2020-05-17T20:16:14.563Z\",\"start_time_in_millis\":1589746574563,\"end_time\":\"2020-05-17T20:17:38.094Z\",\"end_time_in_millis\":1589746658094,\"duration_in_millis\":83531,\"failures\":[],\"shards\":{\"total\":5,\"failed\":0,\"successful\":5}}]}\n```\n\n\n### Restore your snapshot after creating a new docker container\n\n- Kill the previous(ctr+D) docker container and start a new container. You will need to register you S3 bucket again. See the command given at the begining.\n\n- After the new container is started and registered. The state before\n```bash\n$ curl -X GET \"localhost:9200/_cat/indices?v&pretty\"\nhealth status index uuid pri rep docs.count docs.deleted store.size pri.store.size\n```\n\n- To restore a snapshot\n```bash\n$ curl -X POST -H \"Content-Type: application/json\" -d @restoresnapshot.json \"http://localhost:9200/_snapshot/my-s3-repository/finalsnap/_restore\"\n{\"accepted\":true}\n```\n\n- Now check the state after (COMPARE WITH PREVIOUS STATE)\n```bash\n$ curl -X GET \"localhost:9200/_cat/indices?v&pretty\"\nhealth status index uuid pri rep docs.count docs.deleted store.size pri.store.size\nyellow open bank smFJpJJ-S9KiGyw8Ysc5Vw 1 1 1000 0 381.9kb 381.9kb\nyellow open shakespeare cs8TZUIPStyjL5_92lcPqw 1 1 111396 0 18.2mb 18.2mb\nyellow open logstash-2015.05.20 lOdp-I-wRt-DTK3GxDHbuw 1 1 4750 0 14mb 14mb\nyellow open logstash-2015.05.18 i8P-GUM_S_CYMwBh-nO4pQ 1 1 4631 0 13.7mb 13.7mb\nyellow open logstash-2015.05.19 XStCeqfgRSSxbNEo9Gdy9w 1 1 4624 0 13.8mb 13.8mb\n\n```\n\n### Index Mapping after restore\n\n```bash\n$ curl -X GET \"http://localhost:9200/bank/_mapping\"\n{\"bank\":{\"mappings\":{\"properties\":{\"account_number\":{\"type\":\"long\"},\"address\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}},\"age\":{\"type\":\"long\"},\"balance\":{\"type\":\"long\"},\"city\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}},\"email\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}},\"employer\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}},\"firstname\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}},\"gender\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}},\"lastname\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}},\"state\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}}}}}}\n```\n\n```bash\n$ curl -X GET \"http://localhost:9200/shakespeare/_mapping\"\n{\"shakespeare\":{\"mappings\":{\"properties\":{\"line_id\":{\"type\":\"integer\"},\"line_number\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}},\"play_name\":{\"type\":\"keyword\"},\"speaker\":{\"type\":\"keyword\"},\"speech_number\":{\"type\":\"integer\"},\"text_entry\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}},\"type\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\",\"ignore_above\":256}}}}}}}\n```\n\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_016_elastic_search_backup_restore_sample_data/createdata.json", "content": "{\n \"mappings\":{\n \"employees\":{\n \"properties\":{\n \"FirstName\":{\n \"type\":\"text\"\n },\n \"LastName\":{\n \"type\":\"text\"\n },\n \"Designation\":{\n \"type\":\"text\"\n },\n \"Salary\":{\n \"type\":\"integer\"\n },\n \"DateOfJoining\":{\n \"type\":\"date\",\n \"format\":\"yyyy-MM-dd\"\n },\n \"Address\":{\n \"type\":\"text\"\n },\n \"Gender\":{\n \"type\":\"text\"\n },\n \"Age\":{\n \"type\":\"integer\"\n },\n \"MaritalStatus\":{\n \"type\":\"text\"\n },\n \"Interests\":{\n \"type\":\"text\"\n }\n }\n }\n }\n}\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_016_elastic_search_backup_restore_sample_data/register.json", "content": "{\n \"type\": \"s3\",\n \"settings\": {\n \"bucket\": \"elk-backup-codeaprendiz\"\n }\n}\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_016_elastic_search_backup_restore_sample_data/restoresnapshot.json", "content": "{\n \"indices\": \"bank*,shakespeare*,logstash*\",\n \"ignore_unavailable\": true,\n \"include_global_state\": false,\n \"include_aliases\": false,\n \"partial\": false,\n \"rename_pattern\": \"kibana(.+)\",\n \"rename_replacement\": \"restored-kibana$1\",\n \"index_settings\": {\n \"index.blocks.read_only\": false\n },\n \"ignore_index_settings\": [\n \"index.refresh_interval\"\n ]\n}\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_016_elastic_search_backup_restore_sample_data/snapshotsetting.json", "content": "{\n \"indices\": \"bank*,shakespeare*,logstash*\",\n \"ignore_unavailable\": true,\n \"include_global_state\": false,\n \"partial\": false\n}\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_017_mem_and_cpu_limit_container/ReadMe.md", "content": "\n### To set the upper limit on memory to 512 megabytes used by nginx container\n```bash\n$ docker run -m 512m nginx\n\n$ docker ps | egrep -v \"k8s\" \nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n6959c8b602ba nginx \"/docker-entrypoint.…\" About a minute ago Up About a minute 80/tcp intelligent_bartik\n\n$ docker stats intelligent_bartik\nCONTAINER ID NAME CPU % MEM USAGE / LIMIT MEM % NET I/O BLOCK I/O PIDS\n6959c8b602ba intelligent_bartik 0.00% 4.316MiB / 512MiB 0.84% 1.17kB / 0B 7.42MB / 8.19kB 2\n```\n\n### To set the upper limit on the number of CPUs used by nginx container\n\nBy default, access to the computing power of the host machine is unlimited. We can set the CPUs limit using the cpus parameter. For example, let's constrain our container to use at most two CPUs:\n\n\n```bash\n$ docker run --cpus=2 nginx\n```" }, { "path": "home/containers/docker/taskset_docker_containers/task_018_mysql/ReadMe.md", "content": "\n[Link](https://medium.com/@crmcmullen/how-to-run-mysql-in-a-docker-container-on-macos-with-persistent-local-data-58b89aec496a)\n\n- To stop the mysql process on mac OS\n```bash\n$ sudo launchctl unload -w /Library/LaunchDaemons/com.oracle.oss.mysql.mysqld.plist\n/Library/LaunchDaemons/com.oracle.oss.mysql.mysqld.plist: Operation now in progress\n```\n\n\n- Create persistent directory\n```bash\n$ mkdir /Users/[your_username]/Develop\n$ mkdir /Users/[your_username]/Develop/mysql_data\n$ mkdir /Users/[your_username]/Develop/mysql_data/8.0\n```\n\n- Create docker network\n```bash\n$ docker network create dev-network\n```\n\n- Starting the docker container on local\n```bash\n$ docker run --restart always --name mysql8.0 --net dev-network -v /Users/ankitsinghrathi/Develop/mysql_data/8.0:/var/lib/mysql -p 3306:3306 -d -e MYSQL_ROOT_PASSWORD=password mysql:8.0\n```\n\n- Connecting to mysql\n\n```bash\n$ mysql -h127.0.0.1 -uroot -ppassword \nmysql: [Warning] Using a password on the command line interface can be insecure.\nWelcome to the MySQL monitor. Commands end with ; or \\g.\nYour MySQL connection id is 10\nServer version: 8.0.23 MySQL Community Server - GPL\n\nCopyright (c) 2000, 2021, Oracle and/or its affiliates.\n\nOracle is a registered trademark of Oracle Corporation and/or its\naffiliates. Other names may be trademarks of their respective\nowners.\n\nType 'help;' or '\\h' for help. Type '\\c' to clear the current input statement.\n\nmysql> \n```\n\n- Connecting to mysql using python\n```bash\n$ pip3 install mysql-connector-python\n```\n\n```python\nimport mysql.connector\nmydb = mysql.connector.connect(\n host=\"localhost\",\n user=\"root\",\n password=\"password\"\n)\nmycursor = mydb.cursor()\nmycursor.execute(\"CREATE DATABASE mydatabase\")\nmycursor.execute(\"show databases\")\nfor x in mycursor:\n print(x)\n...\n('information_schema',)\n('mydatabase',)\n('mysql',)\n('performance_schema',)\n('sys',)\n```\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_019_nginx_https_domain_test/ReadMe.md", "content": "\n\nTo test the certificates are working\n\n- nslookup to domain\n```bash\n$ nslookup server.domain.com\nServer: 127.0.0.53\nAddress: 127.0.0.53#53\n\nNon-authoritative answer:\nName: server.domain.com\nAddress: 23.12.43.56\n```\n\n- Login to the server 23.12.43.56. Assuming the certificates and key are valid for `*.domain.com`\n\n```bash\n$ ls -ltrh\ntotal 20K\n-rwxrwxrwx 1 server server 3.2K Aug 20 16:10 star_domain.com.key\n-rwxrwxrwx 1 server server 8.5K Aug 20 16:10 star_domain_com.chained.crt\n-rwxrwxrwx 1 server server 335 Aug 20 16:45 nginx.conf\n```\n\n- Contents of nginx.conf\n```bash\n$ cat nginx.conf \nserver {\n listen 443 ssl;\n server_name prod.domain.com;\n ssl_certificate /etc/nginx/certs/star_domain_com.chained.crt;\n ssl_certificate_key /etc/nginx/certs/star_domain.com.key;\n location / {\n allow all;\n root /usr/share/nginx/html;\n }\n\n root /usr/share/nginx/html;\n index index.html;\n}\n```\n\n\n- Start the docker container\n```bash\n$ docker run --rm -p 80:80 -p 443:443 \\\n--name nginx_service \\\n-v $PWD/star_domain.com.key:/etc/nginx/certs/star_domain.com.key \\\n-v $PWD/star_domain_com.chained.crt:/etc/nginx/certs/star_domain_com.chained.crt \\\n-v $PWD/nginx.conf:/etc/nginx/conf.d/default.conf \\\n nginx:latest\n```\n\n- Visit `https://server.domain.com/` on browser and validate if its being loaded\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_020_docker_commit/ReadMe.md", "content": "# docker commit\n\nIt can be useful to commit a container’s file changes or settings into a new image. \nThis allows you to debug a container by running an interactive shell, or to export a working dataset to another server\n\n[docs.docker.com/engine/reference/commandline/commit](https://docs.docker.com/engine/reference/commandline/commit)\n\n**High Level Objectives**\n- start ubuntu container with bash. Make some changes\n- commit the container state to image\n- start new container with our new image, validate our changes\n- add env using --change and repeat validation process\n\n**Skills**\n- docker\n- docker commit\n- commit\n- docker images\n- docker inspect\n- docker commit --change\n\n\n**Version Stack**\n\n| Stack | Version |\n|--------|----------|\n| docker | 20.10.14 |\n\n\n# run ubuntu container\n\n```bash\n# Terminal session t1\n❯ docker run -it --rm --name ubuntu ubuntu bash\nroot@4d74a15a73eb:/# cd /home\nroot@4d74a15a73eb:/home# ls\nroot@4d74a15a73eb:/home# echo \"I am new file\" > file.txt\nroot@4d74a15a73eb:/home# ls\nfile.txt\nroot@4d74a15a73eb:/home#\n\n\n## New Terminal session t2\n❯ docker ps -a\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n4d74a15a73eb ubuntu \"bash\" 45 seconds ago Up 44 seconds ubuntu\n\n❯ docker commit 4d74a15a73eb my-ubuntu:v1 \nsha256:9fec4fd33de4966790bb4b2920abeefc4d33513c8c2bbb3641d6609caab2086f\n\n❯ docker images | head -n 2 \nREPOSITORY TAG IMAGE ID CREATED SIZE\nmy-ubuntu v1 9fec4fd33de4 12 seconds ago 69.2MB\n\n\n# terminal session t1\nroot@4d74a15a73eb:/home#\nroot@4d74a15a73eb:/home# exit\nexit\n\n❯ docker ps -a \nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n\n❯ docker run -it --rm --name ubuntu my-ubuntu:v1 bash\nroot@8d61e1d9a312:/# cd /home\nroot@8d61e1d9a312:/home# ls\nfile.txt\n\n\n\n\n# terminal session t2\n❯ docker ps -a \nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n8d61e1d9a312 my-ubuntu:v1 \"bash\" 6 minutes ago Up 6 minutes ubuntu\n\n❯ docker inspect -f \"{{ .Config.Env }}\" 8d61e1d9a312\n[PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin]\n\n❯ docker commit --change \"ENV DEBUG=true\" 8d61e1d9a312 my-ubuntu:v2\nsha256:e7eb352de7b38ae12046552925d2ff9ef61d1dc14894a709dd28c499dda50243\n\n❯ docker images | head -n 2 \nREPOSITORY TAG IMAGE ID CREATED SIZE\nmy-ubuntu v2 e7eb352de7b3 About a minute ago 214MB\n\n\n\n\n# Terminal session t1\nroot@4d74a15a73eb:/home#\nroot@8d61e1d9a312:/home# exit\nexit\n\n❯ docker ps -a \nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n\n❯ docker run -it --rm --name ubuntu my-ubuntu:v2 bash\nroot@072729702c8b:/# env | grep DEBUG\nDEBUG=true\n\n\n# Terminal session t2\n❯ docker ps -a \nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n072729702c8b my-ubuntu:v2 \"bash\" 2 minutes ago Up 2 minutes ubuntu\n\n❯ docker inspect -f \"{{ .Config.Env }}\" 072729702c8b \n[PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin DEBUG=true]\n```" }, { "path": "home/containers/docker/taskset_docker_containers/task_021_kibana/ReadMe.md", "content": "To Start Kibana on local and connect it to local docker-elastic-search on local\n\n- For starting elastic search refer to the [task-005-elastic-search](../task-005-elastic-search)\n\n- Check if elastic-search is running on local\n```bash\n$ docker ps | egrep elastic \n7fc9a4e5361c docker.elastic.co/elasticsearch/elasticsearch:7.8.1 \"/tini -- /usr/local…\" 7 minutes ago Up 7 minutes 0.0.0.0:9200->9200/tcp, 0.0.0.0:9300->9300/tcp docker run --link dreamy_borg:elasticsearch -p 5601:5601 docker.elastic.co/kibana/kibana:7.8.1\n```\n\n\n- Start the docker-kibanan on local\n```bash\n$ docker run --link dreamy_borg:elasticsearch -p 5601:5601 docker.elastic.co/kibana/kibana:7.8.1\n```\n\n\n- Kibana will not come up if its unable to connect to elastic search. You will see the following in logs\n```bash\n{\"type\":\"log\",\"@timestamp\":\"2020-07-30T09:37:59Z\",\"tags\":[\"warning\",\"elasticsearch\",\"admin\"],\"pid\":7,\"message\":\"Unable to revive connection: http://elasticsearch:9200/\"}\n``` \n\n- Once the Kibana is up you can visit the dashboard at [http://0.0.0.0:5601/app/kibana](http://0.0.0.0:5601/app/kibana)\n You can verify the elastic search connection by checking Index Pattern settings page.\n \n\n![img](./.images/kibana-dashboard.png)" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/ReadMe.md", "content": "- [Sample APP](https://docs.docker.com/get-started/02_our_app/)\n\n\n- Build \n\n```bash\n$ docker build -t getting-started .\n```\n\n- Start the app container\n\n```bash\n$ docker run -dp 3000:3000 getting-started\nec25cae23f5fa1d421c7a750b70d1ba914286eee2e46f464db8fbb8d1f7314ba\n```\n\n- Then visit the app on localhost:3000\n\n![](.images/2022-07-24-11-00-29.png)" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/Dockerfile", "content": "# syntax=docker/dockerfile:1\nFROM node:12-alpine\nRUN apk add --no-cache python2 g++ make\nWORKDIR /app\nCOPY . .\nRUN yarn install --production\nCMD [\"node\", \"src/index.js\"]\nEXPOSE 3000" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/package.json", "content": "{\n \"name\": \"101-app\",\n \"version\": \"1.0.0\",\n \"main\": \"index.js\",\n \"license\": \"MIT\",\n \"scripts\": {\n \"prettify\": \"prettier -l --write \\\"**/*.js\\\"\",\n \"test\": \"jest\",\n \"dev\": \"nodemon src/index.js\"\n },\n \"dependencies\": {\n \"express\": \"^4.17.1\",\n \"mysql\": \"^2.17.1\",\n \"sqlite3\": \"^5.0.0\",\n \"uuid\": \"^3.3.3\",\n \"wait-port\": \"^0.2.2\"\n },\n \"resolutions\": {\n \"ansi-regex\": \"5.0.1\"\n },\n \"prettier\": {\n \"trailingComma\": \"all\",\n \"tabWidth\": 4,\n \"useTabs\": false,\n \"semi\": true,\n \"singleQuote\": true\n },\n \"devDependencies\": {\n \"jest\": \"^27.2.5\",\n \"nodemon\": \"^2.0.13\",\n \"prettier\": \"^1.18.2\"\n }\n}\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/spec/persistence/sqlite.spec.js", "content": "const db = require('../../src/persistence/sqlite');\nconst fs = require('fs');\nconst location = process.env.SQLITE_DB_LOCATION || '/etc/todos/todo.db';\n\nconst ITEM = {\n id: '7aef3d7c-d301-4846-8358-2a91ec9d6be3',\n name: 'Test',\n completed: false,\n};\n\nbeforeEach(() => {\n if (fs.existsSync(location)) {\n fs.unlinkSync(location);\n }\n});\n\ntest('it initializes correctly', async () => {\n await db.init();\n});\n\ntest('it can store and retrieve items', async () => {\n await db.init();\n\n await db.storeItem(ITEM);\n\n const items = await db.getItems();\n expect(items.length).toBe(1);\n expect(items[0]).toEqual(ITEM);\n});\n\ntest('it can update an existing item', async () => {\n await db.init();\n\n const initialItems = await db.getItems();\n expect(initialItems.length).toBe(0);\n\n await db.storeItem(ITEM);\n\n await db.updateItem(\n ITEM.id,\n Object.assign({}, ITEM, { completed: !ITEM.completed }),\n );\n\n const items = await db.getItems();\n expect(items.length).toBe(1);\n expect(items[0].completed).toBe(!ITEM.completed);\n});\n\ntest('it can remove an existing item', async () => {\n await db.init();\n await db.storeItem(ITEM);\n\n await db.removeItem(ITEM.id);\n\n const items = await db.getItems();\n expect(items.length).toBe(0);\n});\n\ntest('it can get a single item', async () => {\n await db.init();\n await db.storeItem(ITEM);\n\n const item = await db.getItem(ITEM.id);\n expect(item).toEqual(ITEM);\n});\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/spec/routes/addItem.spec.js", "content": "const db = require('../../src/persistence');\nconst addItem = require('../../src/routes/addItem');\nconst ITEM = { id: 12345 };\nconst uuid = require('uuid/v4');\n\njest.mock('uuid/v4', () => jest.fn());\n\njest.mock('../../src/persistence', () => ({\n removeItem: jest.fn(),\n storeItem: jest.fn(),\n getItem: jest.fn(),\n}));\n\ntest('it stores item correctly', async () => {\n const id = 'something-not-a-uuid';\n const name = 'A sample item';\n const req = { body: { name } };\n const res = { send: jest.fn() };\n\n uuid.mockReturnValue(id);\n\n await addItem(req, res);\n\n const expectedItem = { id, name, completed: false };\n\n expect(db.storeItem.mock.calls.length).toBe(1);\n expect(db.storeItem.mock.calls[0][0]).toEqual(expectedItem);\n expect(res.send.mock.calls[0].length).toBe(1);\n expect(res.send.mock.calls[0][0]).toEqual(expectedItem);\n});\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/spec/routes/deleteItem.spec.js", "content": "const db = require('../../src/persistence');\nconst deleteItem = require('../../src/routes/deleteItem');\nconst ITEM = { id: 12345 };\n\njest.mock('../../src/persistence', () => ({\n removeItem: jest.fn(),\n getItem: jest.fn(),\n}));\n\ntest('it removes item correctly', async () => {\n const req = { params: { id: 12345 } };\n const res = { sendStatus: jest.fn() };\n\n await deleteItem(req, res);\n\n expect(db.removeItem.mock.calls.length).toBe(1);\n expect(db.removeItem.mock.calls[0][0]).toBe(req.params.id);\n expect(res.sendStatus.mock.calls[0].length).toBe(1);\n expect(res.sendStatus.mock.calls[0][0]).toBe(200);\n});\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/spec/routes/getItems.spec.js", "content": "const db = require('../../src/persistence');\nconst getItems = require('../../src/routes/getItems');\nconst ITEMS = [{ id: 12345 }];\n\njest.mock('../../src/persistence', () => ({\n getItems: jest.fn(),\n}));\n\ntest('it gets items correctly', async () => {\n const req = {};\n const res = { send: jest.fn() };\n db.getItems.mockReturnValue(Promise.resolve(ITEMS));\n\n await getItems(req, res);\n\n expect(db.getItems.mock.calls.length).toBe(1);\n expect(res.send.mock.calls[0].length).toBe(1);\n expect(res.send.mock.calls[0][0]).toEqual(ITEMS);\n});\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/spec/routes/updateItem.spec.js", "content": "const db = require('../../src/persistence');\nconst updateItem = require('../../src/routes/updateItem');\nconst ITEM = { id: 12345 };\n\njest.mock('../../src/persistence', () => ({\n getItem: jest.fn(),\n updateItem: jest.fn(),\n}));\n\ntest('it updates items correctly', async () => {\n const req = {\n params: { id: 1234 },\n body: { name: 'New title', completed: false },\n };\n const res = { send: jest.fn() };\n\n db.getItem.mockReturnValue(Promise.resolve(ITEM));\n\n await updateItem(req, res);\n\n expect(db.updateItem.mock.calls.length).toBe(1);\n expect(db.updateItem.mock.calls[0][0]).toBe(req.params.id);\n expect(db.updateItem.mock.calls[0][1]).toEqual({\n name: 'New title',\n completed: false,\n });\n\n expect(db.getItem.mock.calls.length).toBe(1);\n expect(db.getItem.mock.calls[0][0]).toBe(req.params.id);\n\n expect(res.send.mock.calls[0].length).toBe(1);\n expect(res.send.mock.calls[0][0]).toEqual(ITEM);\n});\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/src/index.js", "content": "const express = require('express');\nconst app = express();\nconst db = require('./persistence');\nconst getItems = require('./routes/getItems');\nconst addItem = require('./routes/addItem');\nconst updateItem = require('./routes/updateItem');\nconst deleteItem = require('./routes/deleteItem');\n\napp.use(express.json());\napp.use(express.static(__dirname + '/static'));\n\napp.get('/items', getItems);\napp.post('/items', addItem);\napp.put('/items/:id', updateItem);\napp.delete('/items/:id', deleteItem);\n\ndb.init().then(() => {\n app.listen(3000, () => console.log('Listening on port 3000'));\n}).catch((err) => {\n console.error(err);\n process.exit(1);\n});\n\nconst gracefulShutdown = () => {\n db.teardown()\n .catch(() => {})\n .then(() => process.exit());\n};\n\nprocess.on('SIGINT', gracefulShutdown);\nprocess.on('SIGTERM', gracefulShutdown);\nprocess.on('SIGUSR2', gracefulShutdown); // Sent by nodemon\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/src/persistence/index.js", "content": "if (process.env.MYSQL_HOST) module.exports = require('./mysql');\nelse module.exports = require('./sqlite');\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/src/persistence/mysql.js", "content": "const waitPort = require('wait-port');\nconst fs = require('fs');\nconst mysql = require('mysql');\n\nconst {\n MYSQL_HOST: HOST,\n MYSQL_HOST_FILE: HOST_FILE,\n MYSQL_USER: USER,\n MYSQL_USER_FILE: USER_FILE,\n MYSQL_PASSWORD: PASSWORD,\n MYSQL_PASSWORD_FILE: PASSWORD_FILE,\n MYSQL_DB: DB,\n MYSQL_DB_FILE: DB_FILE,\n} = process.env;\n\nlet pool;\n\nasync function init() {\n const host = HOST_FILE ? fs.readFileSync(HOST_FILE) : HOST;\n const user = USER_FILE ? fs.readFileSync(USER_FILE) : USER;\n const password = PASSWORD_FILE ? fs.readFileSync(PASSWORD_FILE) : PASSWORD;\n const database = DB_FILE ? fs.readFileSync(DB_FILE) : DB;\n\n await waitPort({ host, port : 3306});\n\n pool = mysql.createPool({\n connectionLimit: 5,\n host,\n user,\n password,\n database,\n charset: 'utf8mb4',\n });\n\n return new Promise((acc, rej) => {\n pool.query(\n 'CREATE TABLE IF NOT EXISTS todo_items (id varchar(36), name varchar(255), completed boolean) DEFAULT CHARSET utf8mb4',\n err => {\n if (err) return rej(err);\n\n console.log(`Connected to mysql db at host ${HOST}`);\n acc();\n },\n );\n });\n}\n\nasync function teardown() {\n return new Promise((acc, rej) => {\n pool.end(err => {\n if (err) rej(err);\n else acc();\n });\n });\n}\n\nasync function getItems() {\n return new Promise((acc, rej) => {\n pool.query('SELECT * FROM todo_items', (err, rows) => {\n if (err) return rej(err);\n acc(\n rows.map(item =>\n Object.assign({}, item, {\n completed: item.completed === 1,\n }),\n ),\n );\n });\n });\n}\n\nasync function getItem(id) {\n return new Promise((acc, rej) => {\n pool.query('SELECT * FROM todo_items WHERE id=?', [id], (err, rows) => {\n if (err) return rej(err);\n acc(\n rows.map(item =>\n Object.assign({}, item, {\n completed: item.completed === 1,\n }),\n )[0],\n );\n });\n });\n}\n\nasync function storeItem(item) {\n return new Promise((acc, rej) => {\n pool.query(\n 'INSERT INTO todo_items (id, name, completed) VALUES (?, ?, ?)',\n [item.id, item.name, item.completed ? 1 : 0],\n err => {\n if (err) return rej(err);\n acc();\n },\n );\n });\n}\n\nasync function updateItem(id, item) {\n return new Promise((acc, rej) => {\n pool.query(\n 'UPDATE todo_items SET name=?, completed=? WHERE id=?',\n [item.name, item.completed ? 1 : 0, id],\n err => {\n if (err) return rej(err);\n acc();\n },\n );\n });\n}\n\nasync function removeItem(id) {\n return new Promise((acc, rej) => {\n pool.query('DELETE FROM todo_items WHERE id = ?', [id], err => {\n if (err) return rej(err);\n acc();\n });\n });\n}\n\nmodule.exports = {\n init,\n teardown,\n getItems,\n getItem,\n storeItem,\n updateItem,\n removeItem,\n};\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/src/persistence/sqlite.js", "content": "const sqlite3 = require('sqlite3').verbose();\nconst fs = require('fs');\nconst location = process.env.SQLITE_DB_LOCATION || '/etc/todos/todo.db';\n\nlet db, dbAll, dbRun;\n\nfunction init() {\n const dirName = require('path').dirname(location);\n if (!fs.existsSync(dirName)) {\n fs.mkdirSync(dirName, { recursive: true });\n }\n\n return new Promise((acc, rej) => {\n db = new sqlite3.Database(location, err => {\n if (err) return rej(err);\n\n if (process.env.NODE_ENV !== 'test')\n console.log(`Using sqlite database at ${location}`);\n\n db.run(\n 'CREATE TABLE IF NOT EXISTS todo_items (id varchar(36), name varchar(255), completed boolean)',\n (err, result) => {\n if (err) return rej(err);\n acc();\n },\n );\n });\n });\n}\n\nasync function teardown() {\n return new Promise((acc, rej) => {\n db.close(err => {\n if (err) rej(err);\n else acc();\n });\n });\n}\n\nasync function getItems() {\n return new Promise((acc, rej) => {\n db.all('SELECT * FROM todo_items', (err, rows) => {\n if (err) return rej(err);\n acc(\n rows.map(item =>\n Object.assign({}, item, {\n completed: item.completed === 1,\n }),\n ),\n );\n });\n });\n}\n\nasync function getItem(id) {\n return new Promise((acc, rej) => {\n db.all('SELECT * FROM todo_items WHERE id=?', [id], (err, rows) => {\n if (err) return rej(err);\n acc(\n rows.map(item =>\n Object.assign({}, item, {\n completed: item.completed === 1,\n }),\n )[0],\n );\n });\n });\n}\n\nasync function storeItem(item) {\n return new Promise((acc, rej) => {\n db.run(\n 'INSERT INTO todo_items (id, name, completed) VALUES (?, ?, ?)',\n [item.id, item.name, item.completed ? 1 : 0],\n err => {\n if (err) return rej(err);\n acc();\n },\n );\n });\n}\n\nasync function updateItem(id, item) {\n return new Promise((acc, rej) => {\n db.run(\n 'UPDATE todo_items SET name=?, completed=? WHERE id = ?',\n [item.name, item.completed ? 1 : 0, id],\n err => {\n if (err) return rej(err);\n acc();\n },\n );\n });\n} \n\nasync function removeItem(id) {\n return new Promise((acc, rej) => {\n db.run('DELETE FROM todo_items WHERE id = ?', [id], err => {\n if (err) return rej(err);\n acc();\n });\n });\n}\n\nmodule.exports = {\n init,\n teardown,\n getItems,\n getItem,\n storeItem,\n updateItem,\n removeItem,\n};\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/src/routes/addItem.js", "content": "const db = require('../persistence');\nconst uuid = require('uuid/v4');\n\nmodule.exports = async (req, res) => {\n const item = {\n id: uuid(),\n name: req.body.name,\n completed: false,\n };\n\n await db.storeItem(item);\n res.send(item);\n};\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/src/routes/deleteItem.js", "content": "const db = require('../persistence');\n\nmodule.exports = async (req, res) => {\n await db.removeItem(req.params.id);\n res.sendStatus(200);\n};\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/src/routes/getItems.js", "content": "const db = require('../persistence');\n\nmodule.exports = async (req, res) => {\n const items = await db.getItems();\n res.send(items);\n};\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/src/routes/updateItem.js", "content": "const db = require('../persistence');\n\nmodule.exports = async (req, res) => {\n await db.updateItem(req.params.id, {\n name: req.body.name,\n completed: req.body.completed,\n });\n const item = await db.getItem(req.params.id);\n res.send(item);\n};\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/src/static/css/font-awesome/fa-brands-400.svg#fontawesome", "content": "\n\n\n\n\nCreated by FontForge 20190801 at Thu Aug 22 14:41:09 2019\n By Robert Madole\nCopyright (c) Font Awesome\n\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/src/static/css/font-awesome/fa-regular-400.svg#fontawesome", "content": "\n\n\n\n\nCreated by FontForge 20190801 at Thu Aug 22 14:41:09 2019\n By Robert Madole\nCopyright (c) Font Awesome\n\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/src/static/css/font-awesome/fa-solid-900.svg#fontawesome", "content": "\n\n\n\n\nCreated by FontForge 20190801 at Thu Aug 22 14:41:09 2019\n By Robert Madole\nCopyright (c) Font Awesome\n\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/src/static/css/styles.css", "content": "body {\n background-color: #f4f4f4;\n margin-top: 50px;\n font-family: 'Lato';\n}\n\n.item {\n background-color: white;\n padding: 15px;\n margin-bottom: 15px;\n border: transparent;\n border-radius: 5px;\n box-shadow: 0 0 1em #ccc;\n transition: all .2s ease-in-out;\n}\n\n.item:hover {\n box-shadow: 0 0 1em #aaa;\n}\n\n.item.completed {\n text-decoration: line-through;\n}\n\n.toggles {\n color: black;\n}\n\n.name {\n padding-top: 3px;\n}\n\n.remove {\n padding-left: 0;\n}\n\nbutton:focus {\n border: 1px solid #333;\n}" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/src/static/index.html", "content": "\n\n\n\n \n \n \n \n \n \n Todo App\n\n\n
\n \n \n \n \n \n\n\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/src/static/js/app.js", "content": "function App() {\n const { Container, Row, Col } = ReactBootstrap;\n return (\n \n \n \n \n \n \n \n );\n}\n\nfunction TodoListCard() {\n const [items, setItems] = React.useState(null);\n\n React.useEffect(() => {\n fetch('/items')\n .then(r => r.json())\n .then(setItems);\n }, []);\n\n const onNewItem = React.useCallback(\n newItem => {\n setItems([...items, newItem]);\n },\n [items],\n );\n\n const onItemUpdate = React.useCallback(\n item => {\n const index = items.findIndex(i => i.id === item.id);\n setItems([\n ...items.slice(0, index),\n item,\n ...items.slice(index + 1),\n ]);\n },\n [items],\n );\n\n const onItemRemoval = React.useCallback(\n item => {\n const index = items.findIndex(i => i.id === item.id);\n setItems([...items.slice(0, index), ...items.slice(index + 1)]);\n },\n [items],\n );\n\n if (items === null) return 'Loading...';\n\n return (\n \n \n {items.length === 0 && (\n

No items yet! Add one above!

\n )}\n {items.map(item => (\n \n ))}\n \n );\n}\n\nfunction AddItemForm({ onNewItem }) {\n const { Form, InputGroup, Button } = ReactBootstrap;\n\n const [newItem, setNewItem] = React.useState('');\n const [submitting, setSubmitting] = React.useState(false);\n\n const submitNewItem = e => {\n e.preventDefault();\n setSubmitting(true);\n fetch('/items', {\n method: 'POST',\n body: JSON.stringify({ name: newItem }),\n headers: { 'Content-Type': 'application/json' },\n })\n .then(r => r.json())\n .then(item => {\n onNewItem(item);\n setSubmitting(false);\n setNewItem('');\n });\n };\n\n return (\n
\n \n setNewItem(e.target.value)}\n type=\"text\"\n placeholder=\"New Item\"\n aria-describedby=\"basic-addon1\"\n />\n \n \n {submitting ? 'Adding...' : 'Add Item'}\n \n \n \n
\n );\n}\n\nfunction ItemDisplay({ item, onItemUpdate, onItemRemoval }) {\n const { Container, Row, Col, Button } = ReactBootstrap;\n\n const toggleCompletion = () => {\n fetch(`/items/${item.id}`, {\n method: 'PUT',\n body: JSON.stringify({\n name: item.name,\n completed: !item.completed,\n }),\n headers: { 'Content-Type': 'application/json' },\n })\n .then(r => r.json())\n .then(onItemUpdate);\n };\n\n const removeItem = () => {\n fetch(`/items/${item.id}`, { method: 'DELETE' }).then(() =>\n onItemRemoval(item),\n );\n };\n\n return (\n \n \n \n \n \n \n \n \n {item.name}\n \n \n \n \n \n \n \n \n );\n}\n\nReactDOM.render(, document.getElementById('root'));\n" }, { "path": "home/containers/docker/taskset_docker_containers/task_022_sample_app/app/src/static/js/react-bootstrap.js", "content": "(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory(require(\"react\"), require(\"react-dom\"));\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine([\"react\", \"react-dom\"], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"ReactBootstrap\"] = factory(require(\"react\"), require(\"react-dom\"));\n\telse\n\t\troot[\"ReactBootstrap\"] = factory(root[\"React\"], root[\"ReactDOM\"]);\n})(window, function(__WEBPACK_EXTERNAL_MODULE__1__, __WEBPACK_EXTERNAL_MODULE__6__) {\nreturn /******/ (function(modules) { // webpackBootstrap\n/******/ \t// The module cache\n/******/ \tvar installedModules = {};\n/******/\n/******/ \t// The require function\n/******/ \tfunction __webpack_require__(moduleId) {\n/******/\n/******/ \t\t// Check if module is in cache\n/******/ \t\tif(installedModules[moduleId]) {\n/******/ \t\t\treturn installedModules[moduleId].exports;\n/******/ \t\t}\n/******/ \t\t// Create a new module (and put it into the cache)\n/******/ \t\tvar module = installedModules[moduleId] = {\n/******/ \t\t\ti: moduleId,\n/******/ \t\t\tl: false,\n/******/ \t\t\texports: {}\n/******/ \t\t};\n/******/\n/******/ \t\t// Execute the module function\n/******/ \t\tmodules[moduleId].call(module.exports, module, module.exports, __webpack_require__);\n/******/\n/******/ \t\t// Flag the module as loaded\n/******/ \t\tmodule.l = true;\n/******/\n/******/ \t\t// Return the exports of the module\n/******/ \t\treturn module.exports;\n/******/ \t}\n/******/\n/******/\n/******/ \t// expose the modules object (__webpack_modules__)\n/******/ \t__webpack_require__.m = modules;\n/******/\n/******/ \t// expose the module cache\n/******/ \t__webpack_require__.c = installedModules;\n/******/\n/******/ \t// define getter function for harmony exports\n/******/ \t__webpack_require__.d = function(exports, name, getter) {\n/******/ \t\tif(!__webpack_require__.o(exports, name)) {\n/******/ \t\t\tObject.defineProperty(exports, name, { enumerable: true, get: getter });\n/******/ \t\t}\n/******/ \t};\n/******/\n/******/ \t// define __esModule on exports\n/******/ \t__webpack_require__.r = function(exports) {\n/******/ \t\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n/******/ \t\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n/******/ \t\t}\n/******/ \t\tObject.defineProperty(exports, '__esModule', { value: true });\n/******/ \t};\n/******/\n/******/ \t// create a fake namespace object\n/******/ \t// mode & 1: value is a module id, require it\n/******/ \t// mode & 2: merge all properties of value into the ns\n/******/ \t// mode & 4: return value when already ns object\n/******/ \t// mode & 8|1: behave like require\n/******/ \t__webpack_require__.t = function(value, mode) {\n/******/ \t\tif(mode & 1) value = __webpack_require__(value);\n/******/ \t\tif(mode & 8) return value;\n/******/ \t\tif((mode & 4) && typeof value === 'object' && value && value.__esModule) return value;\n/******/ \t\tvar ns = Object.create(null);\n/******/ \t\t__webpack_require__.r(ns);\n/******/ \t\tObject.defineProperty(ns, 'default', { enumerable: true, value: value });\n/******/ \t\tif(mode & 2 && typeof value != 'string') for(var key in value) __webpack_require__.d(ns, key, function(key) { return value[key]; }.bind(null, key));\n/******/ \t\treturn ns;\n/******/ \t};\n/******/\n/******/ \t// getDefaultExport function for compatibility with non-harmony modules\n/******/ \t__webpack_require__.n = function(module) {\n/******/ \t\tvar getter = module && module.__esModule ?\n/******/ \t\t\tfunction getDefault() { return module['default']; } :\n/******/ \t\t\tfunction getModuleExports() { return module; };\n/******/ \t\t__webpack_require__.d(getter, 'a', getter);\n/******/ \t\treturn getter;\n/******/ \t};\n/******/\n/******/ \t// Object.prototype.hasOwnProperty.call\n/******/ \t__webpack_require__.o = function(object, property) { return Object.prototype.hasOwnProperty.call(object, property); };\n/******/\n/******/ \t// __webpack_public_path__\n/******/ \t__webpack_require__.p = \"\";\n/******/\n/******/\n/******/ \t// Load entry module and return exports\n/******/ \treturn __webpack_require__(__webpack_require__.s = 86);\n/******/ })\n/************************************************************************/\n/******/ ([\n/* 0 */\n/***/ (function(module, exports, __webpack_require__) {\n\n/**\n * Copyright (c) 2013-present, Facebook, Inc.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n */\nif (false) { var throwOnDirectAccess, ReactIs; } else {\n // By explicitly using `prop-types` you are opting into new production behavior.\n // http://fb.me/prop-types-in-prod\n module.exports = __webpack_require__(58)();\n}\n\n/***/ }),\n/* 1 */\n/***/ (function(module, exports) {\n\nmodule.exports = __WEBPACK_EXTERNAL_MODULE__1__;\n\n/***/ }),\n/* 2 */\n/***/ (function(module, exports, __webpack_require__) {\n\nvar __WEBPACK_AMD_DEFINE_ARRAY__, __WEBPACK_AMD_DEFINE_RESULT__;/*!\n Copyright (c) 2017 Jed Watson.\n Licensed under the MIT License (MIT), see\n http://jedwatson.github.io/classnames\n*/\n\n/* global define */\n(function () {\n 'use strict';\n\n var hasOwn = {}.hasOwnProperty;\n\n function classNames() {\n var classes = [];\n\n for (var i = 0; i < arguments.length; i++) {\n var arg = arguments[i];\n if (!arg) continue;\n var argType = typeof arg;\n\n if (argType === 'string' || argType === 'number') {\n classes.push(arg);\n } else if (Array.isArray(arg) && arg.length) {\n var inner = classNames.apply(null, arg);\n\n if (inner) {\n classes.push(inner);\n }\n } else if (argType === 'object') {\n for (var key in arg) {\n if (hasOwn.call(arg, key) && arg[key]) {\n classes.push(key);\n }\n }\n }\n }\n\n return classes.join(' ');\n }\n\n if ( true && module.exports) {\n classNames.default = classNames;\n module.exports = classNames;\n } else if (true) {\n // register as 'classnames', consistent with npm package name\n !(__WEBPACK_AMD_DEFINE_ARRAY__ = [], __WEBPACK_AMD_DEFINE_RESULT__ = (function () {\n return classNames;\n }).apply(exports, __WEBPACK_AMD_DEFINE_ARRAY__),\n\t\t\t\t__WEBPACK_AMD_DEFINE_RESULT__ !== undefined && (module.exports = __WEBPACK_AMD_DEFINE_RESULT__));\n } else {}\n})();\n\n/***/ }),\n/* 3 */\n/***/ (function(module, exports) {\n\nfunction _assertThisInitialized(self) {\n if (self === void 0) {\n throw new ReferenceError(\"this hasn't been initialised - super() hasn't been called\");\n }\n\n return self;\n}\n\nmodule.exports = _assertThisInitialized;\n\n/***/ }),\n/* 4 */\n/***/ (function(module, exports) {\n\nfunction _defineProperty(obj, key, value) {\n if (key in obj) {\n Object.defineProperty(obj, key, {\n value: value,\n enumerable: true,\n configurable: true,\n writable: true\n });\n } else {\n obj[key] = value;\n }\n\n return obj;\n}\n\nmodule.exports = _defineProperty;\n\n/***/ }),\n/* 5 */\n/***/ (function(module, exports) {\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n \"default\": obj\n };\n}\n\nmodule.exports = _interopRequireDefault;\n\n/***/ }),\n/* 6 */\n/***/ (function(module, exports) {\n\nmodule.exports = __WEBPACK_EXTERNAL_MODULE__6__;\n\n/***/ }),\n/* 7 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = uncontrollable;\n\nvar _react = _interopRequireDefault(__webpack_require__(1));\n\nvar _invariant = _interopRequireDefault(__webpack_require__(24));\n\nvar Utils = _interopRequireWildcard(__webpack_require__(39));\n\nfunction _interopRequireWildcard(obj) {\n if (obj && obj.__esModule) {\n return obj;\n } else {\n var newObj = {};\n\n if (obj != null) {\n for (var key in obj) {\n if (Object.prototype.hasOwnProperty.call(obj, key)) {\n var desc = Object.defineProperty && Object.getOwnPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : {};\n\n if (desc.get || desc.set) {\n Object.defineProperty(newObj, key, desc);\n } else {\n newObj[key] = obj[key];\n }\n }\n }\n }\n\n newObj.default = obj;\n return newObj;\n }\n}\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction _extends() {\n _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n return _extends.apply(this, arguments);\n}\n\nfunction _objectWithoutPropertiesLoose(source, excluded) {\n if (source == null) return {};\n var target = {};\n var sourceKeys = Object.keys(source);\n var key, i;\n\n for (i = 0; i < sourceKeys.length; i++) {\n key = sourceKeys[i];\n if (excluded.indexOf(key) >= 0) continue;\n target[key] = source[key];\n }\n\n return target;\n}\n\nfunction _inheritsLoose(subClass, superClass) {\n subClass.prototype = Object.create(superClass.prototype);\n subClass.prototype.constructor = subClass;\n subClass.__proto__ = superClass;\n}\n\nfunction uncontrollable(Component, controlledValues, methods) {\n if (methods === void 0) {\n methods = [];\n }\n\n var displayName = Component.displayName || Component.name || 'Component';\n var canAcceptRef = Utils.canAcceptRef(Component);\n var controlledProps = Object.keys(controlledValues);\n var PROPS_TO_OMIT = controlledProps.map(Utils.defaultKey);\n !(canAcceptRef || !methods.length) ? false ? undefined : invariant(false) : void 0;\n\n var UncontrolledComponent =\n /*#__PURE__*/\n function (_React$Component) {\n _inheritsLoose(UncontrolledComponent, _React$Component);\n\n function UncontrolledComponent() {\n var _this;\n\n for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {\n args[_key] = arguments[_key];\n }\n\n _this = _React$Component.call.apply(_React$Component, [this].concat(args)) || this;\n _this.handlers = Object.create(null);\n controlledProps.forEach(function (propName) {\n var handlerName = controlledValues[propName];\n\n var handleChange = function handleChange(value) {\n if (_this.props[handlerName]) {\n var _this$props;\n\n _this._notifying = true;\n\n for (var _len2 = arguments.length, args = new Array(_len2 > 1 ? _len2 - 1 : 0), _key2 = 1; _key2 < _len2; _key2++) {\n args[_key2 - 1] = arguments[_key2];\n }\n\n (_this$props = _this.props)[handlerName].apply(_this$props, [value].concat(args));\n\n _this._notifying = false;\n }\n\n _this._values[propName] = value;\n if (!_this.unmounted) _this.forceUpdate();\n };\n\n _this.handlers[handlerName] = handleChange;\n });\n if (methods.length) _this.attachRef = function (ref) {\n _this.inner = ref;\n };\n return _this;\n }\n\n var _proto = UncontrolledComponent.prototype;\n\n _proto.shouldComponentUpdate = function shouldComponentUpdate() {\n //let the forceUpdate trigger the update\n return !this._notifying;\n };\n\n _proto.componentWillMount = function componentWillMount() {\n var _this2 = this;\n\n var props = this.props;\n this._values = Object.create(null);\n controlledProps.forEach(function (key) {\n _this2._values[key] = props[Utils.defaultKey(key)];\n });\n };\n\n _proto.componentWillReceiveProps = function componentWillReceiveProps(nextProps) {\n var _this3 = this;\n\n var props = this.props;\n controlledProps.forEach(function (key) {\n /**\n * If a prop switches from controlled to Uncontrolled\n * reset its value to the defaultValue\n */\n if (!Utils.isProp(nextProps, key) && Utils.isProp(props, key)) {\n _this3._values[key] = nextProps[Utils.defaultKey(key)];\n }\n });\n };\n\n _proto.componentWillUnmount = function componentWillUnmount() {\n this.unmounted = true;\n };\n\n _proto.render = function render() {\n var _this4 = this;\n\n var _this$props2 = this.props,\n innerRef = _this$props2.innerRef,\n props = _objectWithoutPropertiesLoose(_this$props2, [\"innerRef\"]);\n\n PROPS_TO_OMIT.forEach(function (prop) {\n delete props[prop];\n });\n var newProps = {};\n controlledProps.forEach(function (propName) {\n var propValue = _this4.props[propName];\n newProps[propName] = propValue !== undefined ? propValue : _this4._values[propName];\n });\n return _react.default.createElement(Component, _extends({}, props, newProps, this.handlers, {\n ref: innerRef || this.attachRef\n }));\n };\n\n return UncontrolledComponent;\n }(_react.default.Component);\n\n UncontrolledComponent.displayName = \"Uncontrolled(\" + displayName + \")\";\n UncontrolledComponent.propTypes = _extends({\n innerRef: function innerRef() {}\n }, Utils.uncontrolledPropTypes(controlledValues, displayName));\n methods.forEach(function (method) {\n UncontrolledComponent.prototype[method] = function $proxiedMethod() {\n var _this$inner;\n\n return (_this$inner = this.inner)[method].apply(_this$inner, arguments);\n };\n });\n var WrappedComponent = UncontrolledComponent;\n\n if (_react.default.forwardRef) {\n WrappedComponent = _react.default.forwardRef(function (props, ref) {\n return _react.default.createElement(UncontrolledComponent, _extends({}, props, {\n innerRef: ref\n }));\n });\n WrappedComponent.propTypes = UncontrolledComponent.propTypes;\n }\n\n WrappedComponent.ControlledComponent = Component;\n /**\n * useful when wrapping a Component and you want to control\n * everything\n */\n\n WrappedComponent.deferControlTo = function (newComponent, additions, nextMethods) {\n if (additions === void 0) {\n additions = {};\n }\n\n return uncontrollable(newComponent, _extends({}, controlledValues, additions), nextMethods);\n };\n\n return WrappedComponent;\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 8 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = useEventCallback;\n\nvar _react = __webpack_require__(1);\n\nvar _useCommittedRef = _interopRequireDefault(__webpack_require__(71));\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction useEventCallback(fn) {\n var ref = (0, _useCommittedRef.default)(fn);\n return (0, _react.useCallback)(function () {\n return ref.current.apply(void 0, arguments);\n }, [ref]);\n}\n\n/***/ }),\n/* 9 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = qsa; // Zepto.js\n// (c) 2010-2015 Thomas Fuchs\n// Zepto.js may be freely distributed under the MIT license.\n\nvar simpleSelectorRE = /^[\\w-]*$/;\nvar toArray = Function.prototype.bind.call(Function.prototype.call, [].slice);\n\nfunction qsa(element, selector) {\n var maybeID = selector[0] === '#',\n maybeClass = selector[0] === '.',\n nameOnly = maybeID || maybeClass ? selector.slice(1) : selector,\n isSimple = simpleSelectorRE.test(nameOnly),\n found;\n\n if (isSimple) {\n if (maybeID) {\n element = element.getElementById ? element : document;\n return (found = element.getElementById(nameOnly)) ? [found] : [];\n }\n\n if (element.getElementsByClassName && maybeClass) return toArray(element.getElementsByClassName(nameOnly));\n return toArray(element.getElementsByTagName(selector));\n }\n\n return toArray(element.querySelectorAll(selector));\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 10 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = void 0;\n\nvar _default = !!(typeof window !== 'undefined' && window.document && window.document.createElement);\n\nexports.default = _default;\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 11 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nvar _interopRequireDefault = __webpack_require__(5);\n\nexports.__esModule = true;\nexports.default = style;\n\nvar _camelizeStyle = _interopRequireDefault(__webpack_require__(40));\n\nvar _hyphenateStyle = _interopRequireDefault(__webpack_require__(60));\n\nvar _getComputedStyle2 = _interopRequireDefault(__webpack_require__(62));\n\nvar _removeStyle = _interopRequireDefault(__webpack_require__(63));\n\nvar _properties = __webpack_require__(26);\n\nvar _isTransform = _interopRequireDefault(__webpack_require__(64));\n\nfunction style(node, property, value) {\n var css = '';\n var transforms = '';\n var props = property;\n\n if (typeof property === 'string') {\n if (value === undefined) {\n return node.style[(0, _camelizeStyle.default)(property)] || (0, _getComputedStyle2.default)(node).getPropertyValue((0, _hyphenateStyle.default)(property));\n } else {\n (props = {})[property] = value;\n }\n }\n\n Object.keys(props).forEach(function (key) {\n var value = props[key];\n\n if (!value && value !== 0) {\n (0, _removeStyle.default)(node, (0, _hyphenateStyle.default)(key));\n } else if ((0, _isTransform.default)(key)) {\n transforms += key + \"(\" + value + \") \";\n } else {\n css += (0, _hyphenateStyle.default)(key) + \": \" + value + \";\";\n }\n });\n\n if (transforms) {\n css += _properties.transform + \": \" + transforms + \";\";\n }\n\n node.style.cssText += ';' + css;\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 12 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = exports.EXITING = exports.ENTERED = exports.ENTERING = exports.EXITED = exports.UNMOUNTED = void 0;\n\nvar PropTypes = _interopRequireWildcard(__webpack_require__(0));\n\nvar _react = _interopRequireDefault(__webpack_require__(1));\n\nvar _reactDom = _interopRequireDefault(__webpack_require__(6));\n\nvar _reactLifecyclesCompat = __webpack_require__(65);\n\nvar _PropTypes = __webpack_require__(66);\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction _interopRequireWildcard(obj) {\n if (obj && obj.__esModule) {\n return obj;\n } else {\n var newObj = {};\n\n if (obj != null) {\n for (var key in obj) {\n if (Object.prototype.hasOwnProperty.call(obj, key)) {\n var desc = Object.defineProperty && Object.getOwnPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : {};\n\n if (desc.get || desc.set) {\n Object.defineProperty(newObj, key, desc);\n } else {\n newObj[key] = obj[key];\n }\n }\n }\n }\n\n newObj.default = obj;\n return newObj;\n }\n}\n\nfunction _objectWithoutPropertiesLoose(source, excluded) {\n if (source == null) return {};\n var target = {};\n var sourceKeys = Object.keys(source);\n var key, i;\n\n for (i = 0; i < sourceKeys.length; i++) {\n key = sourceKeys[i];\n if (excluded.indexOf(key) >= 0) continue;\n target[key] = source[key];\n }\n\n return target;\n}\n\nfunction _inheritsLoose(subClass, superClass) {\n subClass.prototype = Object.create(superClass.prototype);\n subClass.prototype.constructor = subClass;\n subClass.__proto__ = superClass;\n}\n\nvar UNMOUNTED = 'unmounted';\nexports.UNMOUNTED = UNMOUNTED;\nvar EXITED = 'exited';\nexports.EXITED = EXITED;\nvar ENTERING = 'entering';\nexports.ENTERING = ENTERING;\nvar ENTERED = 'entered';\nexports.ENTERED = ENTERED;\nvar EXITING = 'exiting';\n/**\n * The Transition component lets you describe a transition from one component\n * state to another _over time_ with a simple declarative API. Most commonly\n * it's used to animate the mounting and unmounting of a component, but can also\n * be used to describe in-place transition states as well.\n *\n * ---\n *\n * **Note**: `Transition` is a platform-agnostic base component. If you're using\n * transitions in CSS, you'll probably want to use\n * [`CSSTransition`](https://reactcommunity.org/react-transition-group/css-transition)\n * instead. It inherits all the features of `Transition`, but contains\n * additional features necessary to play nice with CSS transitions (hence the\n * name of the component).\n *\n * ---\n *\n * By default the `Transition` component does not alter the behavior of the\n * component it renders, it only tracks \"enter\" and \"exit\" states for the\n * components. It's up to you to give meaning and effect to those states. For\n * example we can add styles to a component when it enters or exits:\n *\n * ```jsx\n * import { Transition } from 'react-transition-group';\n *\n * const duration = 300;\n *\n * const defaultStyle = {\n * transition: `opacity ${duration}ms ease-in-out`,\n * opacity: 0,\n * }\n *\n * const transitionStyles = {\n * entering: { opacity: 0 },\n * entered: { opacity: 1 },\n * };\n *\n * const Fade = ({ in: inProp }) => (\n * \n * {state => (\n *
\n * I'm a fade Transition!\n *
\n * )}\n * \n * );\n * ```\n *\n * There are 4 main states a Transition can be in:\n * - `'entering'`\n * - `'entered'`\n * - `'exiting'`\n * - `'exited'`\n *\n * Transition state is toggled via the `in` prop. When `true` the component\n * begins the \"Enter\" stage. During this stage, the component will shift from\n * its current transition state, to `'entering'` for the duration of the\n * transition and then to the `'entered'` stage once it's complete. Let's take\n * the following example (we'll use the\n * [useState](https://reactjs.org/docs/hooks-reference.html#usestate) hook):\n *\n * ```jsx\n * function App() {\n * const [inProp, setInProp] = useState(false);\n * return (\n *
\n * \n * {state => (\n * // ...\n * )}\n * \n * \n *
\n * );\n * }\n * ```\n *\n * When the button is clicked the component will shift to the `'entering'` state\n * and stay there for 500ms (the value of `timeout`) before it finally switches\n * to `'entered'`.\n *\n * When `in` is `false` the same thing happens except the state moves from\n * `'exiting'` to `'exited'`.\n */\n\nexports.EXITING = EXITING;\n\nvar Transition =\n/*#__PURE__*/\nfunction (_React$Component) {\n _inheritsLoose(Transition, _React$Component);\n\n function Transition(props, context) {\n var _this;\n\n _this = _React$Component.call(this, props, context) || this;\n var parentGroup = context.transitionGroup; // In the context of a TransitionGroup all enters are really appears\n\n var appear = parentGroup && !parentGroup.isMounting ? props.enter : props.appear;\n var initialStatus;\n _this.appearStatus = null;\n\n if (props.in) {\n if (appear) {\n initialStatus = EXITED;\n _this.appearStatus = ENTERING;\n } else {\n initialStatus = ENTERED;\n }\n } else {\n if (props.unmountOnExit || props.mountOnEnter) {\n initialStatus = UNMOUNTED;\n } else {\n initialStatus = EXITED;\n }\n }\n\n _this.state = {\n status: initialStatus\n };\n _this.nextCallback = null;\n return _this;\n }\n\n var _proto = Transition.prototype;\n\n _proto.getChildContext = function getChildContext() {\n return {\n transitionGroup: null // allows for nested Transitions\n\n };\n };\n\n Transition.getDerivedStateFromProps = function getDerivedStateFromProps(_ref, prevState) {\n var nextIn = _ref.in;\n\n if (nextIn && prevState.status === UNMOUNTED) {\n return {\n status: EXITED\n };\n }\n\n return null;\n }; // getSnapshotBeforeUpdate(prevProps) {\n // let nextStatus = null\n // if (prevProps !== this.props) {\n // const { status } = this.state\n // if (this.props.in) {\n // if (status !== ENTERING && status !== ENTERED) {\n // nextStatus = ENTERING\n // }\n // } else {\n // if (status === ENTERING || status === ENTERED) {\n // nextStatus = EXITING\n // }\n // }\n // }\n // return { nextStatus }\n // }\n\n\n _proto.componentDidMount = function componentDidMount() {\n this.updateStatus(true, this.appearStatus);\n };\n\n _proto.componentDidUpdate = function componentDidUpdate(prevProps) {\n var nextStatus = null;\n\n if (prevProps !== this.props) {\n var status = this.state.status;\n\n if (this.props.in) {\n if (status !== ENTERING && status !== ENTERED) {\n nextStatus = ENTERING;\n }\n } else {\n if (status === ENTERING || status === ENTERED) {\n nextStatus = EXITING;\n }\n }\n }\n\n this.updateStatus(false, nextStatus);\n };\n\n _proto.componentWillUnmount = function componentWillUnmount() {\n this.cancelNextCallback();\n };\n\n _proto.getTimeouts = function getTimeouts() {\n var timeout = this.props.timeout;\n var exit, enter, appear;\n exit = enter = appear = timeout;\n\n if (timeout != null && typeof timeout !== 'number') {\n exit = timeout.exit;\n enter = timeout.enter; // TODO: remove fallback for next major\n\n appear = timeout.appear !== undefined ? timeout.appear : enter;\n }\n\n return {\n exit: exit,\n enter: enter,\n appear: appear\n };\n };\n\n _proto.updateStatus = function updateStatus(mounting, nextStatus) {\n if (mounting === void 0) {\n mounting = false;\n }\n\n if (nextStatus !== null) {\n // nextStatus will always be ENTERING or EXITING.\n this.cancelNextCallback();\n\n var node = _reactDom.default.findDOMNode(this);\n\n if (nextStatus === ENTERING) {\n this.performEnter(node, mounting);\n } else {\n this.performExit(node);\n }\n } else if (this.props.unmountOnExit && this.state.status === EXITED) {\n this.setState({\n status: UNMOUNTED\n });\n }\n };\n\n _proto.performEnter = function performEnter(node, mounting) {\n var _this2 = this;\n\n var enter = this.props.enter;\n var appearing = this.context.transitionGroup ? this.context.transitionGroup.isMounting : mounting;\n var timeouts = this.getTimeouts();\n var enterTimeout = appearing ? timeouts.appear : timeouts.enter; // no enter animation skip right to ENTERED\n // if we are mounting and running this it means appear _must_ be set\n\n if (!mounting && !enter) {\n this.safeSetState({\n status: ENTERED\n }, function () {\n _this2.props.onEntered(node);\n });\n return;\n }\n\n this.props.onEnter(node, appearing);\n this.safeSetState({\n status: ENTERING\n }, function () {\n _this2.props.onEntering(node, appearing);\n\n _this2.onTransitionEnd(node, enterTimeout, function () {\n _this2.safeSetState({\n status: ENTERED\n }, function () {\n _this2.props.onEntered(node, appearing);\n });\n });\n });\n };\n\n _proto.performExit = function performExit(node) {\n var _this3 = this;\n\n var exit = this.props.exit;\n var timeouts = this.getTimeouts(); // no exit animation skip right to EXITED\n\n if (!exit) {\n this.safeSetState({\n status: EXITED\n }, function () {\n _this3.props.onExited(node);\n });\n return;\n }\n\n this.props.onExit(node);\n this.safeSetState({\n status: EXITING\n }, function () {\n _this3.props.onExiting(node);\n\n _this3.onTransitionEnd(node, timeouts.exit, function () {\n _this3.safeSetState({\n status: EXITED\n }, function () {\n _this3.props.onExited(node);\n });\n });\n });\n };\n\n _proto.cancelNextCallback = function cancelNextCallback() {\n if (this.nextCallback !== null) {\n this.nextCallback.cancel();\n this.nextCallback = null;\n }\n };\n\n _proto.safeSetState = function safeSetState(nextState, callback) {\n // This shouldn't be necessary, but there are weird race conditions with\n // setState callbacks and unmounting in testing, so always make sure that\n // we can cancel any pending setState callbacks after we unmount.\n callback = this.setNextCallback(callback);\n this.setState(nextState, callback);\n };\n\n _proto.setNextCallback = function setNextCallback(callback) {\n var _this4 = this;\n\n var active = true;\n\n this.nextCallback = function (event) {\n if (active) {\n active = false;\n _this4.nextCallback = null;\n callback(event);\n }\n };\n\n this.nextCallback.cancel = function () {\n active = false;\n };\n\n return this.nextCallback;\n };\n\n _proto.onTransitionEnd = function onTransitionEnd(node, timeout, handler) {\n this.setNextCallback(handler);\n var doesNotHaveTimeoutOrListener = timeout == null && !this.props.addEndListener;\n\n if (!node || doesNotHaveTimeoutOrListener) {\n setTimeout(this.nextCallback, 0);\n return;\n }\n\n if (this.props.addEndListener) {\n this.props.addEndListener(node, this.nextCallback);\n }\n\n if (timeout != null) {\n setTimeout(this.nextCallback, timeout);\n }\n };\n\n _proto.render = function render() {\n var status = this.state.status;\n\n if (status === UNMOUNTED) {\n return null;\n }\n\n var _this$props = this.props,\n children = _this$props.children,\n childProps = _objectWithoutPropertiesLoose(_this$props, [\"children\"]); // filter props for Transtition\n\n\n delete childProps.in;\n delete childProps.mountOnEnter;\n delete childProps.unmountOnExit;\n delete childProps.appear;\n delete childProps.enter;\n delete childProps.exit;\n delete childProps.timeout;\n delete childProps.addEndListener;\n delete childProps.onEnter;\n delete childProps.onEntering;\n delete childProps.onEntered;\n delete childProps.onExit;\n delete childProps.onExiting;\n delete childProps.onExited;\n\n if (typeof children === 'function') {\n return children(status, childProps);\n }\n\n var child = _react.default.Children.only(children);\n\n return _react.default.cloneElement(child, childProps);\n };\n\n return Transition;\n}(_react.default.Component);\n\nTransition.contextTypes = {\n transitionGroup: PropTypes.object\n};\nTransition.childContextTypes = {\n transitionGroup: function transitionGroup() {}\n};\nTransition.propTypes = false ? undefined : {};\n\nfunction noop() {}\n\nTransition.defaultProps = {\n in: false,\n mountOnEnter: false,\n unmountOnExit: false,\n appear: false,\n enter: true,\n exit: true,\n onEnter: noop,\n onEntering: noop,\n onEntered: noop,\n onExit: noop,\n onExiting: noop,\n onExited: noop\n};\nTransition.UNMOUNTED = 0;\nTransition.EXITED = 1;\nTransition.ENTERING = 2;\nTransition.ENTERED = 3;\nTransition.EXITING = 4;\n\nvar _default = (0, _reactLifecyclesCompat.polyfill)(Transition);\n\nexports.default = _default;\n\n/***/ }),\n/* 13 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nObject.defineProperty(exports, \"__esModule\", {\n value: true\n});\nexports.default = isRequiredForA11y;\n\nfunction isRequiredForA11y(validator) {\n return function validate(props, propName, componentName, location, propFullName) {\n var componentNameSafe = componentName || '<>';\n var propFullNameSafe = propFullName || propName;\n\n if (props[propName] == null) {\n return new Error('The ' + location + ' `' + propFullNameSafe + '` is required to make ' + ('`' + componentNameSafe + '` accessible for users of assistive ') + 'technologies such as screen readers.');\n }\n\n for (var _len = arguments.length, args = Array(_len > 5 ? _len - 5 : 0), _key = 5; _key < _len; _key++) {\n args[_key - 5] = arguments[_key];\n }\n\n return validator.apply(undefined, [props, propName, componentName, location, propFullName].concat(args));\n };\n}\n\nmodule.exports = exports['default'];\n\n/***/ }),\n/* 14 */\n/***/ (function(module, exports) {\n\nfunction _extends() {\n module.exports = _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n return _extends.apply(this, arguments);\n}\n\nmodule.exports = _extends;\n\n/***/ }),\n/* 15 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = useUncontrolled;\n\nvar _react = __webpack_require__(1);\n\nvar Utils = _interopRequireWildcard(__webpack_require__(39));\n\nfunction _interopRequireWildcard(obj) {\n if (obj && obj.__esModule) {\n return obj;\n } else {\n var newObj = {};\n\n if (obj != null) {\n for (var key in obj) {\n if (Object.prototype.hasOwnProperty.call(obj, key)) {\n var desc = Object.defineProperty && Object.getOwnPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : {};\n\n if (desc.get || desc.set) {\n Object.defineProperty(newObj, key, desc);\n } else {\n newObj[key] = obj[key];\n }\n }\n }\n }\n\n newObj.default = obj;\n return newObj;\n }\n}\n\nfunction _extends() {\n _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n return _extends.apply(this, arguments);\n}\n\nfunction _objectWithoutPropertiesLoose(source, excluded) {\n if (source == null) return {};\n var target = {};\n var sourceKeys = Object.keys(source);\n var key, i;\n\n for (i = 0; i < sourceKeys.length; i++) {\n key = sourceKeys[i];\n if (excluded.indexOf(key) >= 0) continue;\n target[key] = source[key];\n }\n\n return target;\n}\n\nfunction _toPropertyKey(arg) {\n var key = _toPrimitive(arg, \"string\");\n\n return typeof key === \"symbol\" ? key : String(key);\n}\n\nfunction _toPrimitive(input, hint) {\n if (typeof input !== \"object\" || input === null) return input;\n var prim = input[Symbol.toPrimitive];\n\n if (prim !== undefined) {\n var res = prim.call(input, hint || \"default\");\n if (typeof res !== \"object\") return res;\n throw new TypeError(\"@@toPrimitive must return a primitive value.\");\n }\n\n return (hint === \"string\" ? String : Number)(input);\n}\n\nfunction useUncontrolled(props, config) {\n return Object.keys(config).reduce(function (result, fieldName) {\n var _extends2;\n\n var defaultValue = result[Utils.defaultKey(fieldName)],\n propsValue = result[fieldName],\n rest = _objectWithoutPropertiesLoose(result, [Utils.defaultKey(fieldName), fieldName].map(_toPropertyKey));\n\n var handlerName = config[fieldName];\n var prevProps = (0, _react.useRef)({});\n\n var _useState = (0, _react.useState)(defaultValue),\n stateValue = _useState[0],\n setState = _useState[1];\n\n var isProp = Utils.isProp(props, fieldName);\n var wasProp = Utils.isProp(prevProps.current, fieldName);\n prevProps.current = props;\n /**\n * If a prop switches from controlled to Uncontrolled\n * reset its value to the defaultValue\n */\n\n if (!isProp && wasProp) {\n setState(defaultValue);\n }\n\n var propsHandler = props[handlerName];\n var handler = (0, _react.useCallback)(function (value) {\n for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {\n args[_key - 1] = arguments[_key];\n }\n\n if (propsHandler) propsHandler.apply(void 0, [value].concat(args));\n setState(value);\n }, [setState, propsHandler]);\n return _extends({}, rest, (_extends2 = {}, _extends2[fieldName] = isProp ? propsValue : stateValue, _extends2[handlerName] = handler, _extends2));\n }, props);\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 16 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = ownerDocument;\n\nfunction ownerDocument(node) {\n return node && node.ownerDocument || document;\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 17 */\n/***/ (function(module, exports) {\n\nfunction _inheritsLoose(subClass, superClass) {\n subClass.prototype = Object.create(superClass.prototype);\n subClass.prototype.constructor = subClass;\n subClass.__proto__ = superClass;\n}\n\nmodule.exports = _inheritsLoose;\n\n/***/ }),\n/* 18 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nvar _interopRequireDefault = __webpack_require__(5);\n\nexports.__esModule = true;\nexports.default = scrollbarSize;\n\nvar _inDOM = _interopRequireDefault(__webpack_require__(10));\n\nvar size;\n\nfunction scrollbarSize(recalc) {\n if (!size && size !== 0 || recalc) {\n if (_inDOM.default) {\n var scrollDiv = document.createElement('div');\n scrollDiv.style.position = 'absolute';\n scrollDiv.style.top = '-9999px';\n scrollDiv.style.width = '50px';\n scrollDiv.style.height = '50px';\n scrollDiv.style.overflow = 'scroll';\n document.body.appendChild(scrollDiv);\n size = scrollDiv.offsetWidth - scrollDiv.clientWidth;\n document.body.removeChild(scrollDiv);\n }\n }\n\n return size;\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 19 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nObject.defineProperty(exports, \"__esModule\", {\n value: true\n});\nexports.isRequiredForA11y = exports.elementType = exports.deprecated = exports.componentOrElement = exports.all = undefined;\n\nvar _all = __webpack_require__(34);\n\nvar _all2 = _interopRequireDefault(_all);\n\nvar _componentOrElement = __webpack_require__(20);\n\nvar _componentOrElement2 = _interopRequireDefault(_componentOrElement);\n\nvar _deprecated = __webpack_require__(67);\n\nvar _deprecated2 = _interopRequireDefault(_deprecated);\n\nvar _elementType = __webpack_require__(28);\n\nvar _elementType2 = _interopRequireDefault(_elementType);\n\nvar _isRequiredForA11y = __webpack_require__(13);\n\nvar _isRequiredForA11y2 = _interopRequireDefault(_isRequiredForA11y);\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nexports.all = _all2.default;\nexports.componentOrElement = _componentOrElement2.default;\nexports.deprecated = _deprecated2.default;\nexports.elementType = _elementType2.default;\nexports.isRequiredForA11y = _isRequiredForA11y2.default;\n\n/***/ }),\n/* 20 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nObject.defineProperty(exports, \"__esModule\", {\n value: true\n});\n\nvar _typeof = typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\" ? function (obj) {\n return typeof obj;\n} : function (obj) {\n return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj;\n};\n\nvar _react = __webpack_require__(1);\n\nvar _react2 = _interopRequireDefault(_react);\n\nvar _createChainableTypeChecker = __webpack_require__(27);\n\nvar _createChainableTypeChecker2 = _interopRequireDefault(_createChainableTypeChecker);\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction validate(props, propName, componentName, location, propFullName) {\n var propValue = props[propName];\n var propType = typeof propValue === 'undefined' ? 'undefined' : _typeof(propValue);\n\n if (_react2.default.isValidElement(propValue)) {\n return new Error('Invalid ' + location + ' `' + propFullName + '` of type ReactElement ' + ('supplied to `' + componentName + '`, expected a ReactComponent or a ') + 'DOMElement. You can usually obtain a ReactComponent or DOMElement ' + 'from a ReactElement by attaching a ref to it.');\n }\n\n if ((propType !== 'object' || typeof propValue.render !== 'function') && propValue.nodeType !== 1) {\n return new Error('Invalid ' + location + ' `' + propFullName + '` of value `' + propValue + '` ' + ('supplied to `' + componentName + '`, expected a ReactComponent or a ') + 'DOMElement.');\n }\n\n return null;\n}\n\nexports.default = (0, _createChainableTypeChecker2.default)(validate);\nmodule.exports = exports['default'];\n\n/***/ }),\n/* 21 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n/**\n * Copyright (c) 2014-present, Facebook, Inc.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\n/**\n * Similar to invariant but only logs a warning if the condition is not met.\n * This can be used to log issues in development environments in critical\n * paths. Removing the logging code for production environments will keep the\n * same logic and follow the same code paths.\n */\n\nvar __DEV__ = \"production\" !== 'production';\n\nvar warning = function () {};\n\nif (__DEV__) {\n var printWarning = function printWarning(format, args) {\n var len = arguments.length;\n args = new Array(len > 1 ? len - 1 : 0);\n\n for (var key = 1; key < len; key++) {\n args[key - 1] = arguments[key];\n }\n\n var argIndex = 0;\n var message = 'Warning: ' + format.replace(/%s/g, function () {\n return args[argIndex++];\n });\n\n if (typeof console !== 'undefined') {\n console.error(message);\n }\n\n try {\n // --- Welcome to debugging React ---\n // This error was thrown as a convenience so that you can use this stack\n // to find the callsite that caused this warning to fire.\n throw new Error(message);\n } catch (x) {}\n };\n\n warning = function (condition, format, args) {\n var len = arguments.length;\n args = new Array(len > 2 ? len - 2 : 0);\n\n for (var key = 2; key < len; key++) {\n args[key - 2] = arguments[key];\n }\n\n if (format === undefined) {\n throw new Error('`warning(condition, format, ...args)` requires a warning ' + 'message argument');\n }\n\n if (!condition) {\n printWarning.apply(null, [format].concat(args));\n }\n };\n}\n\nmodule.exports = warning;\n\n/***/ }),\n/* 22 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nvar _interopRequireDefault = __webpack_require__(5);\n\nexports.__esModule = true;\nexports.default = void 0;\n\nvar _inDOM = _interopRequireDefault(__webpack_require__(10));\n\nvar _default = function () {\n // HTML DOM and SVG DOM may have different support levels,\n // so we need to check on context instead of a document root element.\n return _inDOM.default ? function (context, node) {\n if (context.contains) {\n return context.contains(node);\n } else if (context.compareDocumentPosition) {\n return context === node || !!(context.compareDocumentPosition(node) & 16);\n } else {\n return fallback(context, node);\n }\n } : fallback;\n}();\n\nexports.default = _default;\n\nfunction fallback(context, node) {\n if (node) do {\n if (node === context) return true;\n } while (node = node.parentNode);\n return false;\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 23 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nvar _interopRequireDefault = __webpack_require__(5);\n\nexports.__esModule = true;\nexports.default = void 0;\n\nvar _properties = _interopRequireDefault(__webpack_require__(26));\n\nvar _style = _interopRequireDefault(__webpack_require__(11));\n\nfunction onEnd(node, handler, duration) {\n var fakeEvent = {\n target: node,\n currentTarget: node\n },\n backup;\n if (!_properties.default.end) duration = 0;else if (duration == null) duration = parseDuration(node) || 0;\n\n if (_properties.default.end) {\n node.addEventListener(_properties.default.end, done, false);\n backup = setTimeout(function () {\n return done(fakeEvent);\n }, (duration || 100) * 1.5);\n } else setTimeout(done.bind(null, fakeEvent), 0);\n\n function done(event) {\n if (event.target !== event.currentTarget) return;\n clearTimeout(backup);\n event.target.removeEventListener(_properties.default.end, done);\n handler.call(this);\n }\n}\n\nonEnd._parseDuration = parseDuration;\nvar _default = onEnd;\nexports.default = _default;\n\nfunction parseDuration(node) {\n var str = (0, _style.default)(node, _properties.default.duration),\n mult = str.indexOf('ms') === -1 ? 1000 : 1;\n return parseFloat(str) * mult;\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 24 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n/**\n * Copyright (c) 2013-present, Facebook, Inc.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\n/**\n * Use invariant() to assert state which your program assumes to be true.\n *\n * Provide sprintf-style format (only %s is supported) and arguments\n * to provide information about what broke and what you were\n * expecting.\n *\n * The invariant message will be stripped in production, but the invariant\n * will remain to ensure logic does not differ in production.\n */\n\nvar invariant = function (condition, format, a, b, c, d, e, f) {\n if (false) {}\n\n if (!condition) {\n var error;\n\n if (format === undefined) {\n error = new Error('Minified exception occurred; use the non-minified dev environment ' + 'for the full error message and additional helpful warnings.');\n } else {\n var args = [a, b, c, d, e, f];\n var argIndex = 0;\n error = new Error(format.replace(/%s/g, function () {\n return args[argIndex++];\n }));\n error.name = 'Invariant Violation';\n }\n\n error.framesToPop = 1; // we don't care about invariant's own frame\n\n throw error;\n }\n};\n\nmodule.exports = invariant;\n\n/***/ }),\n/* 25 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nvar _interopRequireDefault = __webpack_require__(5);\n\nexports.__esModule = true;\nexports.default = void 0;\n\nvar _on = _interopRequireDefault(__webpack_require__(43));\n\nexports.on = _on.default;\n\nvar _off = _interopRequireDefault(__webpack_require__(44));\n\nexports.off = _off.default;\n\nvar _filter = _interopRequireDefault(__webpack_require__(78));\n\nexports.filter = _filter.default;\n\nvar _listen = _interopRequireDefault(__webpack_require__(30));\n\nexports.listen = _listen.default;\nvar _default = {\n on: _on.default,\n off: _off.default,\n filter: _filter.default,\n listen: _listen.default\n};\nexports.default = _default;\n\n/***/ }),\n/* 26 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nvar _interopRequireDefault = __webpack_require__(5);\n\nexports.__esModule = true;\nexports.default = exports.animationEnd = exports.animationDelay = exports.animationTiming = exports.animationDuration = exports.animationName = exports.transitionEnd = exports.transitionDuration = exports.transitionDelay = exports.transitionTiming = exports.transitionProperty = exports.transform = void 0;\n\nvar _inDOM = _interopRequireDefault(__webpack_require__(10));\n\nvar transform = 'transform';\nexports.transform = transform;\nvar prefix, transitionEnd, animationEnd;\nexports.animationEnd = animationEnd;\nexports.transitionEnd = transitionEnd;\nvar transitionProperty, transitionDuration, transitionTiming, transitionDelay;\nexports.transitionDelay = transitionDelay;\nexports.transitionTiming = transitionTiming;\nexports.transitionDuration = transitionDuration;\nexports.transitionProperty = transitionProperty;\nvar animationName, animationDuration, animationTiming, animationDelay;\nexports.animationDelay = animationDelay;\nexports.animationTiming = animationTiming;\nexports.animationDuration = animationDuration;\nexports.animationName = animationName;\n\nif (_inDOM.default) {\n var _getTransitionPropert = getTransitionProperties();\n\n prefix = _getTransitionPropert.prefix;\n exports.transitionEnd = transitionEnd = _getTransitionPropert.transitionEnd;\n exports.animationEnd = animationEnd = _getTransitionPropert.animationEnd;\n exports.transform = transform = prefix + \"-\" + transform;\n exports.transitionProperty = transitionProperty = prefix + \"-transition-property\";\n exports.transitionDuration = transitionDuration = prefix + \"-transition-duration\";\n exports.transitionDelay = transitionDelay = prefix + \"-transition-delay\";\n exports.transitionTiming = transitionTiming = prefix + \"-transition-timing-function\";\n exports.animationName = animationName = prefix + \"-animation-name\";\n exports.animationDuration = animationDuration = prefix + \"-animation-duration\";\n exports.animationTiming = animationTiming = prefix + \"-animation-delay\";\n exports.animationDelay = animationDelay = prefix + \"-animation-timing-function\";\n}\n\nvar _default = {\n transform: transform,\n end: transitionEnd,\n property: transitionProperty,\n timing: transitionTiming,\n delay: transitionDelay,\n duration: transitionDuration\n};\nexports.default = _default;\n\nfunction getTransitionProperties() {\n var style = document.createElement('div').style;\n var vendorMap = {\n O: function O(e) {\n return \"o\" + e.toLowerCase();\n },\n Moz: function Moz(e) {\n return e.toLowerCase();\n },\n Webkit: function Webkit(e) {\n return \"webkit\" + e;\n },\n ms: function ms(e) {\n return \"MS\" + e;\n }\n };\n var vendors = Object.keys(vendorMap);\n var transitionEnd, animationEnd;\n var prefix = '';\n\n for (var i = 0; i < vendors.length; i++) {\n var vendor = vendors[i];\n\n if (vendor + \"TransitionProperty\" in style) {\n prefix = \"-\" + vendor.toLowerCase();\n transitionEnd = vendorMap[vendor]('TransitionEnd');\n animationEnd = vendorMap[vendor]('AnimationEnd');\n break;\n }\n }\n\n if (!transitionEnd && 'transitionProperty' in style) transitionEnd = 'transitionend';\n if (!animationEnd && 'animationName' in style) animationEnd = 'animationend';\n style = null;\n return {\n animationEnd: animationEnd,\n transitionEnd: transitionEnd,\n prefix: prefix\n };\n}\n\n/***/ }),\n/* 27 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nObject.defineProperty(exports, \"__esModule\", {\n value: true\n});\nexports.default = createChainableTypeChecker;\n/**\n * Copyright 2013-present, Facebook, Inc.\n * All rights reserved.\n *\n * This source code is licensed under the BSD-style license found in the\n * LICENSE file in the root directory of this source tree. An additional grant\n * of patent rights can be found in the PATENTS file in the same directory.\n */\n// Mostly taken from ReactPropTypes.\n\nfunction createChainableTypeChecker(validate) {\n function checkType(isRequired, props, propName, componentName, location, propFullName) {\n var componentNameSafe = componentName || '<>';\n var propFullNameSafe = propFullName || propName;\n\n if (props[propName] == null) {\n if (isRequired) {\n return new Error('Required ' + location + ' `' + propFullNameSafe + '` was not specified ' + ('in `' + componentNameSafe + '`.'));\n }\n\n return null;\n }\n\n for (var _len = arguments.length, args = Array(_len > 6 ? _len - 6 : 0), _key = 6; _key < _len; _key++) {\n args[_key - 6] = arguments[_key];\n }\n\n return validate.apply(undefined, [props, propName, componentNameSafe, location, propFullNameSafe].concat(args));\n }\n\n var chainedCheckType = checkType.bind(null, false);\n chainedCheckType.isRequired = checkType.bind(null, true);\n return chainedCheckType;\n}\n\nmodule.exports = exports['default'];\n\n/***/ }),\n/* 28 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nObject.defineProperty(exports, \"__esModule\", {\n value: true\n});\n\nvar _react = __webpack_require__(1);\n\nvar _react2 = _interopRequireDefault(_react);\n\nvar _reactIs = __webpack_require__(69);\n\nvar _createChainableTypeChecker = __webpack_require__(27);\n\nvar _createChainableTypeChecker2 = _interopRequireDefault(_createChainableTypeChecker);\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction elementType(props, propName, componentName, location, propFullName) {\n var propValue = props[propName];\n\n if (_react2.default.isValidElement(propValue)) {\n return new Error('Invalid ' + location + ' `' + propFullName + '` of type ReactElement ' + ('supplied to `' + componentName + '`,expected an element type (a string ') + ', component class, or function component).');\n }\n\n if (!(0, _reactIs.isValidElementType)(propValue)) {\n return new Error('Invalid ' + location + ' `' + propFullName + '` of value `' + propValue + '` ' + ('supplied to `' + componentName + '`, expected an element type (a string ') + ', component class, or function component).');\n }\n\n return null;\n}\n\nexports.default = (0, _createChainableTypeChecker2.default)(elementType);\nmodule.exports = exports['default'];\n\n/***/ }),\n/* 29 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = void 0;\n\nvar _react = _interopRequireDefault(__webpack_require__(1));\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nvar DropdownContext = _react.default.createContext({\n menuRef: function menuRef() {},\n toggleRef: function toggleRef() {},\n onToggle: function onToggle() {},\n toggleNode: undefined,\n alignEnd: null,\n show: null,\n drop: null\n});\n\nvar _default = DropdownContext;\nexports.default = _default;\nmodule.exports = exports.default;\n\n/***/ }),\n/* 30 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nvar _interopRequireDefault = __webpack_require__(5);\n\nexports.__esModule = true;\nexports.default = void 0;\n\nvar _inDOM = _interopRequireDefault(__webpack_require__(10));\n\nvar _on = _interopRequireDefault(__webpack_require__(43));\n\nvar _off = _interopRequireDefault(__webpack_require__(44));\n\nvar listen = function listen() {};\n\nif (_inDOM.default) {\n listen = function listen(node, eventName, handler, capture) {\n (0, _on.default)(node, eventName, handler, capture);\n return function () {\n (0, _off.default)(node, eventName, handler, capture);\n };\n };\n}\n\nvar _default = listen;\nexports.default = _default;\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 31 */\n/***/ (function(module, __webpack_exports__, __webpack_require__) {\n\n\"use strict\";\n__webpack_require__.r(__webpack_exports__);\n\n// EXTERNAL MODULE: ./node_modules/@babel/runtime/helpers/objectWithoutPropertiesLoose.js\nvar objectWithoutPropertiesLoose = __webpack_require__(53);\nvar objectWithoutPropertiesLoose_default = /*#__PURE__*/__webpack_require__.n(objectWithoutPropertiesLoose);\n\n// EXTERNAL MODULE: ./node_modules/@babel/runtime/helpers/extends.js\nvar helpers_extends = __webpack_require__(14);\nvar extends_default = /*#__PURE__*/__webpack_require__.n(helpers_extends);\n\n// EXTERNAL MODULE: ./node_modules/@babel/runtime/helpers/inheritsLoose.js\nvar inheritsLoose = __webpack_require__(17);\nvar inheritsLoose_default = /*#__PURE__*/__webpack_require__.n(inheritsLoose);\n\n// EXTERNAL MODULE: ./node_modules/@babel/runtime/helpers/assertThisInitialized.js\nvar assertThisInitialized = __webpack_require__(3);\nvar assertThisInitialized_default = /*#__PURE__*/__webpack_require__.n(assertThisInitialized);\n\n// EXTERNAL MODULE: ./node_modules/@babel/runtime/helpers/defineProperty.js\nvar defineProperty = __webpack_require__(4);\nvar defineProperty_default = /*#__PURE__*/__webpack_require__.n(defineProperty);\n\n// EXTERNAL MODULE: external {\"root\":\"React\",\"commonjs2\":\"react\",\"commonjs\":\"react\",\"amd\":\"react\"}\nvar external_root_React_commonjs2_react_commonjs_react_amd_react_ = __webpack_require__(1);\n\n// EXTERNAL MODULE: ./node_modules/popper.js/dist/esm/popper.js\nvar popper = __webpack_require__(38);\n\n// EXTERNAL MODULE: ./node_modules/react-popper/node_modules/create-react-context/lib/index.js\nvar lib = __webpack_require__(54);\nvar lib_default = /*#__PURE__*/__webpack_require__.n(lib);\n\n// CONCATENATED MODULE: ./node_modules/react-popper/lib/esm/Manager.js\n\n\n\n\n\n\nvar ManagerContext = lib_default()({\n setReferenceNode: undefined,\n referenceNode: undefined\n});\n\nvar Manager_Manager =\n/*#__PURE__*/\nfunction (_React$Component) {\n inheritsLoose_default()(Manager, _React$Component);\n\n function Manager() {\n var _this;\n\n _this = _React$Component.call(this) || this;\n\n defineProperty_default()(assertThisInitialized_default()(assertThisInitialized_default()(_this)), \"setReferenceNode\", function (referenceNode) {\n if (!referenceNode || _this.state.context.referenceNode === referenceNode) {\n return;\n }\n\n _this.setState(function (_ref) {\n var context = _ref.context;\n return {\n context: extends_default()({}, context, {\n referenceNode: referenceNode\n })\n };\n });\n });\n\n _this.state = {\n context: {\n setReferenceNode: _this.setReferenceNode,\n referenceNode: undefined\n }\n };\n return _this;\n }\n\n var _proto = Manager.prototype;\n\n _proto.render = function render() {\n return external_root_React_commonjs2_react_commonjs_react_amd_react_[\"createElement\"](ManagerContext.Provider, {\n value: this.state.context\n }, this.props.children);\n };\n\n return Manager;\n}(external_root_React_commonjs2_react_commonjs_react_amd_react_[\"Component\"]);\n\n\n// CONCATENATED MODULE: ./node_modules/react-popper/lib/esm/utils.js\n/**\n * Takes an argument and if it's an array, returns the first item in the array,\n * otherwise returns the argument. Used for Preact compatibility.\n */\nvar unwrapArray = function unwrapArray(arg) {\n return Array.isArray(arg) ? arg[0] : arg;\n};\n/**\n * Takes a maybe-undefined function and arbitrary args and invokes the function\n * only if it is defined.\n */\n\nvar safeInvoke = function safeInvoke(fn) {\n if (typeof fn === \"function\") {\n for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {\n args[_key - 1] = arguments[_key];\n }\n\n return fn.apply(void 0, args);\n }\n};\n// CONCATENATED MODULE: ./node_modules/react-popper/lib/esm/Popper.js\n\n\n\n\n\n\n\n\n\nvar initialStyle = {\n position: 'absolute',\n top: 0,\n left: 0,\n opacity: 0,\n pointerEvents: 'none'\n};\nvar initialArrowStyle = {};\nvar Popper_InnerPopper =\n/*#__PURE__*/\nfunction (_React$Component) {\n inheritsLoose_default()(InnerPopper, _React$Component);\n\n function InnerPopper() {\n var _this;\n\n for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {\n args[_key] = arguments[_key];\n }\n\n _this = _React$Component.call.apply(_React$Component, [this].concat(args)) || this;\n\n defineProperty_default()(assertThisInitialized_default()(assertThisInitialized_default()(_this)), \"state\", {\n data: undefined,\n placement: undefined\n });\n\n defineProperty_default()(assertThisInitialized_default()(assertThisInitialized_default()(_this)), \"popperInstance\", void 0);\n\n defineProperty_default()(assertThisInitialized_default()(assertThisInitialized_default()(_this)), \"popperNode\", null);\n\n defineProperty_default()(assertThisInitialized_default()(assertThisInitialized_default()(_this)), \"arrowNode\", null);\n\n defineProperty_default()(assertThisInitialized_default()(assertThisInitialized_default()(_this)), \"setPopperNode\", function (popperNode) {\n if (!popperNode || _this.popperNode === popperNode) return;\n safeInvoke(_this.props.innerRef, popperNode);\n _this.popperNode = popperNode;\n\n _this.updatePopperInstance();\n });\n\n defineProperty_default()(assertThisInitialized_default()(assertThisInitialized_default()(_this)), \"setArrowNode\", function (arrowNode) {\n _this.arrowNode = arrowNode;\n });\n\n defineProperty_default()(assertThisInitialized_default()(assertThisInitialized_default()(_this)), \"updateStateModifier\", {\n enabled: true,\n order: 900,\n fn: function fn(data) {\n var placement = data.placement;\n\n _this.setState({\n data: data,\n placement: placement\n });\n\n return data;\n }\n });\n\n defineProperty_default()(assertThisInitialized_default()(assertThisInitialized_default()(_this)), \"getOptions\", function () {\n return {\n placement: _this.props.placement,\n eventsEnabled: _this.props.eventsEnabled,\n positionFixed: _this.props.positionFixed,\n modifiers: extends_default()({}, _this.props.modifiers, {\n arrow: extends_default()({}, _this.props.modifiers && _this.props.modifiers.arrow, {\n enabled: !!_this.arrowNode,\n element: _this.arrowNode\n }),\n applyStyle: {\n enabled: false\n },\n updateStateModifier: _this.updateStateModifier\n })\n };\n });\n\n defineProperty_default()(assertThisInitialized_default()(assertThisInitialized_default()(_this)), \"getPopperStyle\", function () {\n return !_this.popperNode || !_this.state.data ? initialStyle : extends_default()({\n position: _this.state.data.offsets.popper.position\n }, _this.state.data.styles);\n });\n\n defineProperty_default()(assertThisInitialized_default()(assertThisInitialized_default()(_this)), \"getPopperPlacement\", function () {\n return !_this.state.data ? undefined : _this.state.placement;\n });\n\n defineProperty_default()(assertThisInitialized_default()(assertThisInitialized_default()(_this)), \"getArrowStyle\", function () {\n return !_this.arrowNode || !_this.state.data ? initialArrowStyle : _this.state.data.arrowStyles;\n });\n\n defineProperty_default()(assertThisInitialized_default()(assertThisInitialized_default()(_this)), \"getOutOfBoundariesState\", function () {\n return _this.state.data ? _this.state.data.hide : undefined;\n });\n\n defineProperty_default()(assertThisInitialized_default()(assertThisInitialized_default()(_this)), \"destroyPopperInstance\", function () {\n if (!_this.popperInstance) return;\n\n _this.popperInstance.destroy();\n\n _this.popperInstance = null;\n });\n\n defineProperty_default()(assertThisInitialized_default()(assertThisInitialized_default()(_this)), \"updatePopperInstance\", function () {\n _this.destroyPopperInstance();\n\n var _assertThisInitialize = assertThisInitialized_default()(assertThisInitialized_default()(_this)),\n popperNode = _assertThisInitialize.popperNode;\n\n var referenceElement = _this.props.referenceElement;\n if (!referenceElement || !popperNode) return;\n _this.popperInstance = new popper[\"a\" /* default */](referenceElement, popperNode, _this.getOptions());\n });\n\n defineProperty_default()(assertThisInitialized_default()(assertThisInitialized_default()(_this)), \"scheduleUpdate\", function () {\n if (_this.popperInstance) {\n _this.popperInstance.scheduleUpdate();\n }\n });\n\n return _this;\n }\n\n var _proto = InnerPopper.prototype;\n\n _proto.componentDidUpdate = function componentDidUpdate(prevProps, prevState) {\n // If the Popper.js options have changed, update the instance (destroy + create)\n if (this.props.placement !== prevProps.placement || this.props.referenceElement !== prevProps.referenceElement || this.props.positionFixed !== prevProps.positionFixed) {\n this.updatePopperInstance();\n } else if (this.props.eventsEnabled !== prevProps.eventsEnabled && this.popperInstance) {\n this.props.eventsEnabled ? this.popperInstance.enableEventListeners() : this.popperInstance.disableEventListeners();\n } // A placement difference in state means popper determined a new placement\n // apart from the props value. By the time the popper element is rendered with\n // the new position Popper has already measured it, if the place change triggers\n // a size change it will result in a misaligned popper. So we schedule an update to be sure.\n\n\n if (prevState.placement !== this.state.placement) {\n this.scheduleUpdate();\n }\n };\n\n _proto.componentWillUnmount = function componentWillUnmount() {\n safeInvoke(this.props.innerRef, null);\n this.destroyPopperInstance();\n };\n\n _proto.render = function render() {\n return unwrapArray(this.props.children)({\n ref: this.setPopperNode,\n style: this.getPopperStyle(),\n placement: this.getPopperPlacement(),\n outOfBoundaries: this.getOutOfBoundariesState(),\n scheduleUpdate: this.scheduleUpdate,\n arrowProps: {\n ref: this.setArrowNode,\n style: this.getArrowStyle()\n }\n });\n };\n\n return InnerPopper;\n}(external_root_React_commonjs2_react_commonjs_react_amd_react_[\"Component\"]);\n\ndefineProperty_default()(Popper_InnerPopper, \"defaultProps\", {\n placement: 'bottom',\n eventsEnabled: true,\n referenceElement: undefined,\n positionFixed: false\n});\n\nvar placements = popper[\"a\" /* default */].placements;\n\nfunction Popper(_ref) {\n var referenceElement = _ref.referenceElement,\n props = objectWithoutPropertiesLoose_default()(_ref, [\"referenceElement\"]);\n\n return external_root_React_commonjs2_react_commonjs_react_amd_react_[\"createElement\"](ManagerContext.Consumer, null, function (_ref2) {\n var referenceNode = _ref2.referenceNode;\n return external_root_React_commonjs2_react_commonjs_react_amd_react_[\"createElement\"](Popper_InnerPopper, extends_default()({\n referenceElement: referenceElement !== undefined ? referenceElement : referenceNode\n }, props));\n });\n}\n// EXTERNAL MODULE: ./node_modules/warning/warning.js\nvar warning = __webpack_require__(21);\nvar warning_default = /*#__PURE__*/__webpack_require__.n(warning);\n\n// CONCATENATED MODULE: ./node_modules/react-popper/lib/esm/Reference.js\n\n\n\n\n\n\n\n\n\nvar Reference_InnerReference =\n/*#__PURE__*/\nfunction (_React$Component) {\n inheritsLoose_default()(InnerReference, _React$Component);\n\n function InnerReference() {\n var _this;\n\n for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {\n args[_key] = arguments[_key];\n }\n\n _this = _React$Component.call.apply(_React$Component, [this].concat(args)) || this;\n\n defineProperty_default()(assertThisInitialized_default()(assertThisInitialized_default()(_this)), \"refHandler\", function (node) {\n safeInvoke(_this.props.innerRef, node);\n safeInvoke(_this.props.setReferenceNode, node);\n });\n\n return _this;\n }\n\n var _proto = InnerReference.prototype;\n\n _proto.render = function render() {\n warning_default()(Boolean(this.props.setReferenceNode), '`Reference` should not be used outside of a `Manager` component.');\n return unwrapArray(this.props.children)({\n ref: this.refHandler\n });\n };\n\n return InnerReference;\n}(external_root_React_commonjs2_react_commonjs_react_amd_react_[\"Component\"]);\n\nfunction Reference(props) {\n return external_root_React_commonjs2_react_commonjs_react_amd_react_[\"createElement\"](ManagerContext.Consumer, null, function (_ref) {\n var setReferenceNode = _ref.setReferenceNode;\n return external_root_React_commonjs2_react_commonjs_react_amd_react_[\"createElement\"](Reference_InnerReference, extends_default()({\n setReferenceNode: setReferenceNode\n }, props));\n });\n}\n// CONCATENATED MODULE: ./node_modules/react-popper/lib/esm/index.js\n/* concated harmony reexport Popper */__webpack_require__.d(__webpack_exports__, \"Popper\", function() { return Popper; });\n/* concated harmony reexport placements */__webpack_require__.d(__webpack_exports__, \"placements\", function() { return placements; });\n/* concated harmony reexport Manager */__webpack_require__.d(__webpack_exports__, \"Manager\", function() { return Manager_Manager; });\n/* concated harmony reexport Reference */__webpack_require__.d(__webpack_exports__, \"Reference\", function() { return Reference; });\n// Public components\n\n\n\n // Public types\n\n/***/ }),\n/* 32 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = forwardRef;\n\nvar _react = _interopRequireDefault(__webpack_require__(1));\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction forwardRef(renderFn, _temp) {\n var _ref = _temp === void 0 ? {} : _temp,\n propTypes = _ref.propTypes,\n defaultProps = _ref.defaultProps,\n _ref$allowFallback = _ref.allowFallback,\n allowFallback = _ref$allowFallback === void 0 ? false : _ref$allowFallback,\n _ref$displayName = _ref.displayName,\n displayName = _ref$displayName === void 0 ? renderFn.name || renderFn.displayName : _ref$displayName;\n\n var render = function render(props, ref) {\n return renderFn(props, ref);\n };\n\n return Object.assign(_react.default.forwardRef || !allowFallback ? _react.default.forwardRef(render) : function (props) {\n return render(props, null);\n }, {\n displayName: displayName,\n propTypes: propTypes,\n defaultProps: defaultProps\n });\n}\n\n/***/ }),\n/* 33 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = camelize;\nvar rHyphen = /-(.)/g;\n\nfunction camelize(string) {\n return string.replace(rHyphen, function (_, chr) {\n return chr.toUpperCase();\n });\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 34 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nObject.defineProperty(exports, \"__esModule\", {\n value: true\n});\nexports.default = all;\n\nvar _createChainableTypeChecker = __webpack_require__(27);\n\nvar _createChainableTypeChecker2 = _interopRequireDefault(_createChainableTypeChecker);\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction all() {\n for (var _len = arguments.length, validators = Array(_len), _key = 0; _key < _len; _key++) {\n validators[_key] = arguments[_key];\n }\n\n function allPropTypes() {\n for (var _len2 = arguments.length, args = Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {\n args[_key2] = arguments[_key2];\n }\n\n var error = null;\n validators.forEach(function (validator) {\n if (error != null) {\n return;\n }\n\n var result = validator.apply(undefined, args);\n\n if (result != null) {\n error = result;\n }\n });\n return error;\n }\n\n return (0, _createChainableTypeChecker2.default)(allPropTypes);\n}\n\nmodule.exports = exports['default'];\n\n/***/ }),\n/* 35 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = void 0;\n\nvar _propTypes = _interopRequireDefault(__webpack_require__(0));\n\nvar _react = _interopRequireDefault(__webpack_require__(1));\n\nvar _reactPopper = __webpack_require__(31);\n\nvar _DropdownContext = _interopRequireDefault(__webpack_require__(29));\n\nvar _RootCloseWrapper = _interopRequireDefault(__webpack_require__(42));\n\nvar _mapContextToProps = _interopRequireDefault(__webpack_require__(77));\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction _objectWithoutPropertiesLoose(source, excluded) {\n if (source == null) return {};\n var target = {};\n var sourceKeys = Object.keys(source);\n var key, i;\n\n for (i = 0; i < sourceKeys.length; i++) {\n key = sourceKeys[i];\n if (excluded.indexOf(key) >= 0) continue;\n target[key] = source[key];\n }\n\n return target;\n}\n\nfunction _extends() {\n _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n return _extends.apply(this, arguments);\n}\n\nfunction _inheritsLoose(subClass, superClass) {\n subClass.prototype = Object.create(superClass.prototype);\n subClass.prototype.constructor = subClass;\n subClass.__proto__ = superClass;\n}\n\nvar DropdownMenu =\n/*#__PURE__*/\nfunction (_React$Component) {\n _inheritsLoose(DropdownMenu, _React$Component);\n\n function DropdownMenu() {\n var _this;\n\n for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {\n args[_key] = arguments[_key];\n }\n\n _this = _React$Component.call.apply(_React$Component, [this].concat(args)) || this;\n _this.state = {\n toggleId: null\n };\n _this.popperIsInitialized = false;\n\n _this.handleClose = function (e) {\n if (!_this.props.onToggle) return;\n\n _this.props.onToggle(false, e);\n };\n\n return _this;\n }\n\n var _proto = DropdownMenu.prototype;\n\n _proto.getSnapshotBeforeUpdate = function getSnapshotBeforeUpdate(prevProps) {\n // If, to the best we can tell, this update won't reinitialize popper,\n // manually schedule an update\n var shouldUpdatePopper = !prevProps.show && this.props.show && this.popperIsInitialized && // a new reference node will already trigger this internally\n prevProps.toggleNode === this.props.toggleNode;\n\n if (this.props.show && this.props.usePopper && !this.popperIsInitialized) {\n this.popperIsInitialized = true;\n }\n\n return !!shouldUpdatePopper;\n };\n\n _proto.componentDidUpdate = function componentDidUpdate(_, __, shouldUpdatePopper) {\n if (shouldUpdatePopper && this.scheduleUpdate) {\n this.scheduleUpdate();\n }\n };\n\n _proto.render = function render() {\n var _this2 = this;\n\n var _this$props = this.props,\n show = _this$props.show,\n flip = _this$props.flip,\n menuRef = _this$props.menuRef,\n alignEnd = _this$props.alignEnd,\n drop = _this$props.drop,\n usePopper = _this$props.usePopper,\n toggleNode = _this$props.toggleNode,\n rootCloseEvent = _this$props.rootCloseEvent,\n _this$props$popperCon = _this$props.popperConfig,\n popperConfig = _this$props$popperCon === void 0 ? {} : _this$props$popperCon;\n var placement = alignEnd ? 'bottom-end' : 'bottom-start';\n if (drop === 'up') placement = alignEnd ? 'top-end' : 'top-start';\n if (drop === 'right') placement = alignEnd ? 'right-end' : 'right-start';\n if (drop === 'left') placement = alignEnd ? 'left-end' : 'left-start';\n var menu = null;\n var menuProps = {\n ref: menuRef,\n 'aria-labelledby': toggleNode && toggleNode.id\n };\n var childArgs = {\n show: show,\n alignEnd: alignEnd,\n close: this.handleClose\n };\n\n if (!usePopper) {\n menu = this.props.children(_extends({}, childArgs, {\n props: menuProps\n }));\n } else if (this.popperIsInitialized || show) {\n // Add it this way, so it doesn't override someones usage\n // with react-poppers \n if (toggleNode) popperConfig.referenceElement = toggleNode;\n menu = _react.default.createElement(_reactPopper.Popper, _extends({}, popperConfig, {\n innerRef: menuRef,\n placement: placement,\n eventsEnabled: !!show,\n modifiers: _extends({\n flip: {\n enabled: !!flip\n }\n }, popperConfig.modifiers)\n }), function (_ref) {\n var ref = _ref.ref,\n style = _ref.style,\n popper = _objectWithoutPropertiesLoose(_ref, [\"ref\", \"style\"]);\n\n _this2.scheduleUpdate = popper.scheduleUpdate;\n return _this2.props.children(_extends({}, popper, childArgs, {\n props: _extends({}, menuProps, {\n ref: ref,\n style: style\n })\n }));\n });\n }\n\n return menu && _react.default.createElement(_RootCloseWrapper.default, {\n disabled: !show,\n event: rootCloseEvent,\n onRootClose: this.handleClose\n }, menu);\n };\n\n return DropdownMenu;\n}(_react.default.Component);\n\nDropdownMenu.displayName = 'ReactOverlaysDropdownMenu';\nDropdownMenu.propTypes = {\n /**\n * A render prop that returns a Menu element. The `props`\n * argument should spread through to **a component that can accept a ref**.\n *\n * @type {Function ({\n * show: boolean,\n * alignEnd: boolean,\n * close: (?SyntheticEvent) => void,\n * placement: Placement,\n * outOfBoundaries: ?boolean,\n * scheduleUpdate: () => void,\n * props: {\n * ref: (?HTMLElement) => void,\n * style: { [string]: string | number },\n * aria-labelledby: ?string\n * },\n * arrowProps: {\n * ref: (?HTMLElement) => void,\n * style: { [string]: string | number },\n * },\n * }) => React.Element}\n */\n children: _propTypes.default.func.isRequired,\n\n /**\n * Controls the visible state of the menu, generally this is\n * provided by the parent `Dropdown` component,\n * but may also be specified as a prop directly.\n */\n show: _propTypes.default.bool,\n\n /**\n * Aligns the dropdown menu to the 'end' of it's placement position.\n * Generally this is provided by the parent `Dropdown` component,\n * but may also be specified as a prop directly.\n */\n alignEnd: _propTypes.default.bool,\n\n /**\n * Enables the Popper.js `flip` modifier, allowing the Dropdown to\n * automatically adjust it's placement in case of overlap with the viewport or toggle.\n * Refer to the [flip docs](https://popper.js.org/popper-documentation.html#modifiers..flip.enabled) for more info\n */\n flip: _propTypes.default.bool,\n usePopper: _propTypes.default.oneOf([true, false]),\n\n /**\n * A set of popper options and props passed directly to react-popper's Popper component.\n */\n popperConfig: _propTypes.default.object,\n\n /**\n * Override the default event used by RootCloseWrapper.\n */\n rootCloseEvent: _propTypes.default.string,\n\n /** @private */\n onToggle: _propTypes.default.func,\n\n /** @private */\n menuRef: _propTypes.default.func,\n\n /** @private */\n drop: _propTypes.default.string,\n\n /** @private */\n toggleNode: _propTypes.default.any\n};\nDropdownMenu.defaultProps = {\n usePopper: true\n};\nvar DecoratedDropdownMenu = (0, _mapContextToProps.default)(_DropdownContext.default, function (_ref2, props) {\n var show = _ref2.show,\n alignEnd = _ref2.alignEnd,\n toggle = _ref2.toggle,\n drop = _ref2.drop,\n menuRef = _ref2.menuRef,\n toggleNode = _ref2.toggleNode;\n return {\n drop: drop,\n menuRef: menuRef,\n toggleNode: toggleNode,\n onToggle: toggle,\n show: show == null ? props.show : show,\n alignEnd: alignEnd == null ? props.alignEnd : alignEnd\n };\n}, DropdownMenu);\nvar _default = DecoratedDropdownMenu;\nexports.default = _default;\nmodule.exports = exports.default;\n\n/***/ }),\n/* 36 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = void 0;\n\nvar _propTypes = _interopRequireDefault(__webpack_require__(0));\n\nvar _react = _interopRequireDefault(__webpack_require__(1));\n\nvar _DropdownContext = _interopRequireDefault(__webpack_require__(29));\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nvar propTypes = {\n /**\n * A render prop that returns a Toggle element. The `props`\n * argument should spread through to **a component that can accept a ref**. Use\n * the `onToggle` argument to toggle the menu open or closed\n *\n * @type {Function ({\n * show: boolean,\n * toggle: (show: boolean) => void,\n * props: {\n * ref: (?HTMLElement) => void,\n * aria-haspopup: true\n * aria-expanded: boolean\n * },\n * }) => React.Element}\n */\n children: _propTypes.default.func.isRequired\n};\n\nfunction DropdownToggle(_ref) {\n var children = _ref.children;\n return _react.default.createElement(_DropdownContext.default.Consumer, null, function (_ref2) {\n var show = _ref2.show,\n toggle = _ref2.toggle,\n toggleRef = _ref2.toggleRef;\n return children({\n show: show,\n toggle: toggle,\n props: {\n ref: toggleRef,\n 'aria-haspopup': true,\n 'aria-expanded': !!show\n }\n });\n });\n}\n\nDropdownToggle.displayName = 'ReactOverlaysDropdownToggle';\nDropdownToggle.propTypes = propTypes;\nvar _default = DropdownToggle;\nexports.default = _default;\nmodule.exports = exports.default;\n\n/***/ }),\n/* 37 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = void 0;\n\nvar _class = _interopRequireDefault(__webpack_require__(80));\n\nvar _style = _interopRequireDefault(__webpack_require__(11));\n\nvar _scrollbarSize = _interopRequireDefault(__webpack_require__(18));\n\nvar _isOverflowing = _interopRequireDefault(__webpack_require__(83));\n\nvar _manageAriaHidden = __webpack_require__(85);\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction findIndexOf(arr, cb) {\n var idx = -1;\n arr.some(function (d, i) {\n if (cb(d, i)) {\n idx = i;\n return true;\n }\n });\n return idx;\n}\n/**\n * Proper state managment for containers and the modals in those containers.\n *\n * @internal Used by the Modal to ensure proper styling of containers.\n */\n\n\nvar ModalManager =\n/*#__PURE__*/\nfunction () {\n function ModalManager(_temp) {\n var _ref = _temp === void 0 ? {} : _temp,\n _ref$hideSiblingNodes = _ref.hideSiblingNodes,\n hideSiblingNodes = _ref$hideSiblingNodes === void 0 ? true : _ref$hideSiblingNodes,\n _ref$handleContainerO = _ref.handleContainerOverflow,\n handleContainerOverflow = _ref$handleContainerO === void 0 ? true : _ref$handleContainerO;\n\n this.hideSiblingNodes = hideSiblingNodes;\n this.handleContainerOverflow = handleContainerOverflow;\n this.modals = [];\n this.containers = [];\n this.data = [];\n this.scrollbarSize = (0, _scrollbarSize.default)();\n }\n\n var _proto = ModalManager.prototype;\n\n _proto.isContainerOverflowing = function isContainerOverflowing(modal) {\n var data = this.data[this.containerIndexFromModal(modal)];\n return data && data.overflowing;\n };\n\n _proto.containerIndexFromModal = function containerIndexFromModal(modal) {\n return findIndexOf(this.data, function (d) {\n return d.modals.indexOf(modal) !== -1;\n });\n };\n\n _proto.setContainerStyle = function setContainerStyle(containerState, container) {\n var style = {\n overflow: 'hidden' // we are only interested in the actual `style` here\n // becasue we will override it\n\n };\n containerState.style = {\n overflow: container.style.overflow,\n paddingRight: container.style.paddingRight\n };\n\n if (containerState.overflowing) {\n // use computed style, here to get the real padding\n // to add our scrollbar width\n style.paddingRight = parseInt((0, _style.default)(container, 'paddingRight') || 0, 10) + this.scrollbarSize + \"px\";\n }\n\n (0, _style.default)(container, style);\n };\n\n _proto.removeContainerStyle = function removeContainerStyle(containerState, container) {\n var style = containerState.style;\n Object.keys(style).forEach(function (key) {\n container.style[key] = style[key];\n });\n };\n\n _proto.add = function add(modal, container, className) {\n var modalIdx = this.modals.indexOf(modal);\n var containerIdx = this.containers.indexOf(container);\n\n if (modalIdx !== -1) {\n return modalIdx;\n }\n\n modalIdx = this.modals.length;\n this.modals.push(modal);\n\n if (this.hideSiblingNodes) {\n (0, _manageAriaHidden.hideSiblings)(container, modal);\n }\n\n if (containerIdx !== -1) {\n this.data[containerIdx].modals.push(modal);\n return modalIdx;\n }\n\n var data = {\n modals: [modal],\n //right now only the first modal of a container will have its classes applied\n classes: className ? className.split(/\\s+/) : [],\n overflowing: (0, _isOverflowing.default)(container)\n };\n\n if (this.handleContainerOverflow) {\n this.setContainerStyle(data, container);\n }\n\n data.classes.forEach(_class.default.addClass.bind(null, container));\n this.containers.push(container);\n this.data.push(data);\n return modalIdx;\n };\n\n _proto.remove = function remove(modal) {\n var modalIdx = this.modals.indexOf(modal);\n\n if (modalIdx === -1) {\n return;\n }\n\n var containerIdx = this.containerIndexFromModal(modal);\n var data = this.data[containerIdx];\n var container = this.containers[containerIdx];\n data.modals.splice(data.modals.indexOf(modal), 1);\n this.modals.splice(modalIdx, 1); // if that was the last modal in a container,\n // clean up the container\n\n if (data.modals.length === 0) {\n data.classes.forEach(_class.default.removeClass.bind(null, container));\n\n if (this.handleContainerOverflow) {\n this.removeContainerStyle(data, container);\n }\n\n if (this.hideSiblingNodes) {\n (0, _manageAriaHidden.showSiblings)(container, modal);\n }\n\n this.containers.splice(containerIdx, 1);\n this.data.splice(containerIdx, 1);\n } else if (this.hideSiblingNodes) {\n //otherwise make sure the next top modal is visible to a SR\n var _data$modals = data.modals[data.modals.length - 1],\n backdrop = _data$modals.backdrop,\n dialog = _data$modals.dialog;\n (0, _manageAriaHidden.ariaHidden)(false, dialog);\n (0, _manageAriaHidden.ariaHidden)(false, backdrop);\n }\n };\n\n _proto.isTopModal = function isTopModal(modal) {\n return !!this.modals.length && this.modals[this.modals.length - 1] === modal;\n };\n\n return ModalManager;\n}();\n\nvar _default = ModalManager;\nexports.default = _default;\nmodule.exports = exports.default;\n\n/***/ }),\n/* 38 */\n/***/ (function(module, __webpack_exports__, __webpack_require__) {\n\n\"use strict\";\n/* WEBPACK VAR INJECTION */(function(global) {/**!\n * @fileOverview Kickass library to create and place poppers near their reference elements.\n * @version 1.15.0\n * @license\n * Copyright (c) 2016 Federico Zivolo and contributors\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\nvar isBrowser = typeof window !== 'undefined' && typeof document !== 'undefined';\nvar longerTimeoutBrowsers = ['Edge', 'Trident', 'Firefox'];\nvar timeoutDuration = 0;\n\nfor (var i = 0; i < longerTimeoutBrowsers.length; i += 1) {\n if (isBrowser && navigator.userAgent.indexOf(longerTimeoutBrowsers[i]) >= 0) {\n timeoutDuration = 1;\n break;\n }\n}\n\nfunction microtaskDebounce(fn) {\n var called = false;\n return function () {\n if (called) {\n return;\n }\n\n called = true;\n window.Promise.resolve().then(function () {\n called = false;\n fn();\n });\n };\n}\n\nfunction taskDebounce(fn) {\n var scheduled = false;\n return function () {\n if (!scheduled) {\n scheduled = true;\n setTimeout(function () {\n scheduled = false;\n fn();\n }, timeoutDuration);\n }\n };\n}\n\nvar supportsMicroTasks = isBrowser && window.Promise;\n/**\n* Create a debounced version of a method, that's asynchronously deferred\n* but called in the minimum time possible.\n*\n* @method\n* @memberof Popper.Utils\n* @argument {Function} fn\n* @returns {Function}\n*/\n\nvar debounce = supportsMicroTasks ? microtaskDebounce : taskDebounce;\n/**\n * Check if the given variable is a function\n * @method\n * @memberof Popper.Utils\n * @argument {Any} functionToCheck - variable to check\n * @returns {Boolean} answer to: is a function?\n */\n\nfunction isFunction(functionToCheck) {\n var getType = {};\n return functionToCheck && getType.toString.call(functionToCheck) === '[object Function]';\n}\n/**\n * Get CSS computed property of the given element\n * @method\n * @memberof Popper.Utils\n * @argument {Eement} element\n * @argument {String} property\n */\n\n\nfunction getStyleComputedProperty(element, property) {\n if (element.nodeType !== 1) {\n return [];\n } // NOTE: 1 DOM access here\n\n\n var window = element.ownerDocument.defaultView;\n var css = window.getComputedStyle(element, null);\n return property ? css[property] : css;\n}\n/**\n * Returns the parentNode or the host of the element\n * @method\n * @memberof Popper.Utils\n * @argument {Element} element\n * @returns {Element} parent\n */\n\n\nfunction getParentNode(element) {\n if (element.nodeName === 'HTML') {\n return element;\n }\n\n return element.parentNode || element.host;\n}\n/**\n * Returns the scrolling parent of the given element\n * @method\n * @memberof Popper.Utils\n * @argument {Element} element\n * @returns {Element} scroll parent\n */\n\n\nfunction getScrollParent(element) {\n // Return body, `getScroll` will take care to get the correct `scrollTop` from it\n if (!element) {\n return document.body;\n }\n\n switch (element.nodeName) {\n case 'HTML':\n case 'BODY':\n return element.ownerDocument.body;\n\n case '#document':\n return element.body;\n } // Firefox want us to check `-x` and `-y` variations as well\n\n\n var _getStyleComputedProp = getStyleComputedProperty(element),\n overflow = _getStyleComputedProp.overflow,\n overflowX = _getStyleComputedProp.overflowX,\n overflowY = _getStyleComputedProp.overflowY;\n\n if (/(auto|scroll|overlay)/.test(overflow + overflowY + overflowX)) {\n return element;\n }\n\n return getScrollParent(getParentNode(element));\n}\n\nvar isIE11 = isBrowser && !!(window.MSInputMethodContext && document.documentMode);\nvar isIE10 = isBrowser && /MSIE 10/.test(navigator.userAgent);\n/**\n * Determines if the browser is Internet Explorer\n * @method\n * @memberof Popper.Utils\n * @param {Number} version to check\n * @returns {Boolean} isIE\n */\n\nfunction isIE(version) {\n if (version === 11) {\n return isIE11;\n }\n\n if (version === 10) {\n return isIE10;\n }\n\n return isIE11 || isIE10;\n}\n/**\n * Returns the offset parent of the given element\n * @method\n * @memberof Popper.Utils\n * @argument {Element} element\n * @returns {Element} offset parent\n */\n\n\nfunction getOffsetParent(element) {\n if (!element) {\n return document.documentElement;\n }\n\n var noOffsetParent = isIE(10) ? document.body : null; // NOTE: 1 DOM access here\n\n var offsetParent = element.offsetParent || null; // Skip hidden elements which don't have an offsetParent\n\n while (offsetParent === noOffsetParent && element.nextElementSibling) {\n offsetParent = (element = element.nextElementSibling).offsetParent;\n }\n\n var nodeName = offsetParent && offsetParent.nodeName;\n\n if (!nodeName || nodeName === 'BODY' || nodeName === 'HTML') {\n return element ? element.ownerDocument.documentElement : document.documentElement;\n } // .offsetParent will return the closest TH, TD or TABLE in case\n // no offsetParent is present, I hate this job...\n\n\n if (['TH', 'TD', 'TABLE'].indexOf(offsetParent.nodeName) !== -1 && getStyleComputedProperty(offsetParent, 'position') === 'static') {\n return getOffsetParent(offsetParent);\n }\n\n return offsetParent;\n}\n\nfunction isOffsetContainer(element) {\n var nodeName = element.nodeName;\n\n if (nodeName === 'BODY') {\n return false;\n }\n\n return nodeName === 'HTML' || getOffsetParent(element.firstElementChild) === element;\n}\n/**\n * Finds the root node (document, shadowDOM root) of the given element\n * @method\n * @memberof Popper.Utils\n * @argument {Element} node\n * @returns {Element} root node\n */\n\n\nfunction getRoot(node) {\n if (node.parentNode !== null) {\n return getRoot(node.parentNode);\n }\n\n return node;\n}\n/**\n * Finds the offset parent common to the two provided nodes\n * @method\n * @memberof Popper.Utils\n * @argument {Element} element1\n * @argument {Element} element2\n * @returns {Element} common offset parent\n */\n\n\nfunction findCommonOffsetParent(element1, element2) {\n // This check is needed to avoid errors in case one of the elements isn't defined for any reason\n if (!element1 || !element1.nodeType || !element2 || !element2.nodeType) {\n return document.documentElement;\n } // Here we make sure to give as \"start\" the element that comes first in the DOM\n\n\n var order = element1.compareDocumentPosition(element2) & Node.DOCUMENT_POSITION_FOLLOWING;\n var start = order ? element1 : element2;\n var end = order ? element2 : element1; // Get common ancestor container\n\n var range = document.createRange();\n range.setStart(start, 0);\n range.setEnd(end, 0);\n var commonAncestorContainer = range.commonAncestorContainer; // Both nodes are inside #document\n\n if (element1 !== commonAncestorContainer && element2 !== commonAncestorContainer || start.contains(end)) {\n if (isOffsetContainer(commonAncestorContainer)) {\n return commonAncestorContainer;\n }\n\n return getOffsetParent(commonAncestorContainer);\n } // one of the nodes is inside shadowDOM, find which one\n\n\n var element1root = getRoot(element1);\n\n if (element1root.host) {\n return findCommonOffsetParent(element1root.host, element2);\n } else {\n return findCommonOffsetParent(element1, getRoot(element2).host);\n }\n}\n/**\n * Gets the scroll value of the given element in the given side (top and left)\n * @method\n * @memberof Popper.Utils\n * @argument {Element} element\n * @argument {String} side `top` or `left`\n * @returns {number} amount of scrolled pixels\n */\n\n\nfunction getScroll(element) {\n var side = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'top';\n var upperSide = side === 'top' ? 'scrollTop' : 'scrollLeft';\n var nodeName = element.nodeName;\n\n if (nodeName === 'BODY' || nodeName === 'HTML') {\n var html = element.ownerDocument.documentElement;\n var scrollingElement = element.ownerDocument.scrollingElement || html;\n return scrollingElement[upperSide];\n }\n\n return element[upperSide];\n}\n/*\n * Sum or subtract the element scroll values (left and top) from a given rect object\n * @method\n * @memberof Popper.Utils\n * @param {Object} rect - Rect object you want to change\n * @param {HTMLElement} element - The element from the function reads the scroll values\n * @param {Boolean} subtract - set to true if you want to subtract the scroll values\n * @return {Object} rect - The modifier rect object\n */\n\n\nfunction includeScroll(rect, element) {\n var subtract = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;\n var scrollTop = getScroll(element, 'top');\n var scrollLeft = getScroll(element, 'left');\n var modifier = subtract ? -1 : 1;\n rect.top += scrollTop * modifier;\n rect.bottom += scrollTop * modifier;\n rect.left += scrollLeft * modifier;\n rect.right += scrollLeft * modifier;\n return rect;\n}\n/*\n * Helper to detect borders of a given element\n * @method\n * @memberof Popper.Utils\n * @param {CSSStyleDeclaration} styles\n * Result of `getStyleComputedProperty` on the given element\n * @param {String} axis - `x` or `y`\n * @return {number} borders - The borders size of the given axis\n */\n\n\nfunction getBordersSize(styles, axis) {\n var sideA = axis === 'x' ? 'Left' : 'Top';\n var sideB = sideA === 'Left' ? 'Right' : 'Bottom';\n return parseFloat(styles['border' + sideA + 'Width'], 10) + parseFloat(styles['border' + sideB + 'Width'], 10);\n}\n\nfunction getSize(axis, body, html, computedStyle) {\n return Math.max(body['offset' + axis], body['scroll' + axis], html['client' + axis], html['offset' + axis], html['scroll' + axis], isIE(10) ? parseInt(html['offset' + axis]) + parseInt(computedStyle['margin' + (axis === 'Height' ? 'Top' : 'Left')]) + parseInt(computedStyle['margin' + (axis === 'Height' ? 'Bottom' : 'Right')]) : 0);\n}\n\nfunction getWindowSizes(document) {\n var body = document.body;\n var html = document.documentElement;\n var computedStyle = isIE(10) && getComputedStyle(html);\n return {\n height: getSize('Height', body, html, computedStyle),\n width: getSize('Width', body, html, computedStyle)\n };\n}\n\nvar classCallCheck = function (instance, Constructor) {\n if (!(instance instanceof Constructor)) {\n throw new TypeError(\"Cannot call a class as a function\");\n }\n};\n\nvar createClass = function () {\n function defineProperties(target, props) {\n for (var i = 0; i < props.length; i++) {\n var descriptor = props[i];\n descriptor.enumerable = descriptor.enumerable || false;\n descriptor.configurable = true;\n if (\"value\" in descriptor) descriptor.writable = true;\n Object.defineProperty(target, descriptor.key, descriptor);\n }\n }\n\n return function (Constructor, protoProps, staticProps) {\n if (protoProps) defineProperties(Constructor.prototype, protoProps);\n if (staticProps) defineProperties(Constructor, staticProps);\n return Constructor;\n };\n}();\n\nvar defineProperty = function (obj, key, value) {\n if (key in obj) {\n Object.defineProperty(obj, key, {\n value: value,\n enumerable: true,\n configurable: true,\n writable: true\n });\n } else {\n obj[key] = value;\n }\n\n return obj;\n};\n\nvar _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n};\n/**\n * Given element offsets, generate an output similar to getBoundingClientRect\n * @method\n * @memberof Popper.Utils\n * @argument {Object} offsets\n * @returns {Object} ClientRect like output\n */\n\n\nfunction getClientRect(offsets) {\n return _extends({}, offsets, {\n right: offsets.left + offsets.width,\n bottom: offsets.top + offsets.height\n });\n}\n/**\n * Get bounding client rect of given element\n * @method\n * @memberof Popper.Utils\n * @param {HTMLElement} element\n * @return {Object} client rect\n */\n\n\nfunction getBoundingClientRect(element) {\n var rect = {}; // IE10 10 FIX: Please, don't ask, the element isn't\n // considered in DOM in some circumstances...\n // This isn't reproducible in IE10 compatibility mode of IE11\n\n try {\n if (isIE(10)) {\n rect = element.getBoundingClientRect();\n var scrollTop = getScroll(element, 'top');\n var scrollLeft = getScroll(element, 'left');\n rect.top += scrollTop;\n rect.left += scrollLeft;\n rect.bottom += scrollTop;\n rect.right += scrollLeft;\n } else {\n rect = element.getBoundingClientRect();\n }\n } catch (e) {}\n\n var result = {\n left: rect.left,\n top: rect.top,\n width: rect.right - rect.left,\n height: rect.bottom - rect.top\n }; // subtract scrollbar size from sizes\n\n var sizes = element.nodeName === 'HTML' ? getWindowSizes(element.ownerDocument) : {};\n var width = sizes.width || element.clientWidth || result.right - result.left;\n var height = sizes.height || element.clientHeight || result.bottom - result.top;\n var horizScrollbar = element.offsetWidth - width;\n var vertScrollbar = element.offsetHeight - height; // if an hypothetical scrollbar is detected, we must be sure it's not a `border`\n // we make this check conditional for performance reasons\n\n if (horizScrollbar || vertScrollbar) {\n var styles = getStyleComputedProperty(element);\n horizScrollbar -= getBordersSize(styles, 'x');\n vertScrollbar -= getBordersSize(styles, 'y');\n result.width -= horizScrollbar;\n result.height -= vertScrollbar;\n }\n\n return getClientRect(result);\n}\n\nfunction getOffsetRectRelativeToArbitraryNode(children, parent) {\n var fixedPosition = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;\n var isIE10 = isIE(10);\n var isHTML = parent.nodeName === 'HTML';\n var childrenRect = getBoundingClientRect(children);\n var parentRect = getBoundingClientRect(parent);\n var scrollParent = getScrollParent(children);\n var styles = getStyleComputedProperty(parent);\n var borderTopWidth = parseFloat(styles.borderTopWidth, 10);\n var borderLeftWidth = parseFloat(styles.borderLeftWidth, 10); // In cases where the parent is fixed, we must ignore negative scroll in offset calc\n\n if (fixedPosition && isHTML) {\n parentRect.top = Math.max(parentRect.top, 0);\n parentRect.left = Math.max(parentRect.left, 0);\n }\n\n var offsets = getClientRect({\n top: childrenRect.top - parentRect.top - borderTopWidth,\n left: childrenRect.left - parentRect.left - borderLeftWidth,\n width: childrenRect.width,\n height: childrenRect.height\n });\n offsets.marginTop = 0;\n offsets.marginLeft = 0; // Subtract margins of documentElement in case it's being used as parent\n // we do this only on HTML because it's the only element that behaves\n // differently when margins are applied to it. The margins are included in\n // the box of the documentElement, in the other cases not.\n\n if (!isIE10 && isHTML) {\n var marginTop = parseFloat(styles.marginTop, 10);\n var marginLeft = parseFloat(styles.marginLeft, 10);\n offsets.top -= borderTopWidth - marginTop;\n offsets.bottom -= borderTopWidth - marginTop;\n offsets.left -= borderLeftWidth - marginLeft;\n offsets.right -= borderLeftWidth - marginLeft; // Attach marginTop and marginLeft because in some circumstances we may need them\n\n offsets.marginTop = marginTop;\n offsets.marginLeft = marginLeft;\n }\n\n if (isIE10 && !fixedPosition ? parent.contains(scrollParent) : parent === scrollParent && scrollParent.nodeName !== 'BODY') {\n offsets = includeScroll(offsets, parent);\n }\n\n return offsets;\n}\n\nfunction getViewportOffsetRectRelativeToArtbitraryNode(element) {\n var excludeScroll = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;\n var html = element.ownerDocument.documentElement;\n var relativeOffset = getOffsetRectRelativeToArbitraryNode(element, html);\n var width = Math.max(html.clientWidth, window.innerWidth || 0);\n var height = Math.max(html.clientHeight, window.innerHeight || 0);\n var scrollTop = !excludeScroll ? getScroll(html) : 0;\n var scrollLeft = !excludeScroll ? getScroll(html, 'left') : 0;\n var offset = {\n top: scrollTop - relativeOffset.top + relativeOffset.marginTop,\n left: scrollLeft - relativeOffset.left + relativeOffset.marginLeft,\n width: width,\n height: height\n };\n return getClientRect(offset);\n}\n/**\n * Check if the given element is fixed or is inside a fixed parent\n * @method\n * @memberof Popper.Utils\n * @argument {Element} element\n * @argument {Element} customContainer\n * @returns {Boolean} answer to \"isFixed?\"\n */\n\n\nfunction isFixed(element) {\n var nodeName = element.nodeName;\n\n if (nodeName === 'BODY' || nodeName === 'HTML') {\n return false;\n }\n\n if (getStyleComputedProperty(element, 'position') === 'fixed') {\n return true;\n }\n\n var parentNode = getParentNode(element);\n\n if (!parentNode) {\n return false;\n }\n\n return isFixed(parentNode);\n}\n/**\n * Finds the first parent of an element that has a transformed property defined\n * @method\n * @memberof Popper.Utils\n * @argument {Element} element\n * @returns {Element} first transformed parent or documentElement\n */\n\n\nfunction getFixedPositionOffsetParent(element) {\n // This check is needed to avoid errors in case one of the elements isn't defined for any reason\n if (!element || !element.parentElement || isIE()) {\n return document.documentElement;\n }\n\n var el = element.parentElement;\n\n while (el && getStyleComputedProperty(el, 'transform') === 'none') {\n el = el.parentElement;\n }\n\n return el || document.documentElement;\n}\n/**\n * Computed the boundaries limits and return them\n * @method\n * @memberof Popper.Utils\n * @param {HTMLElement} popper\n * @param {HTMLElement} reference\n * @param {number} padding\n * @param {HTMLElement} boundariesElement - Element used to define the boundaries\n * @param {Boolean} fixedPosition - Is in fixed position mode\n * @returns {Object} Coordinates of the boundaries\n */\n\n\nfunction getBoundaries(popper, reference, padding, boundariesElement) {\n var fixedPosition = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : false; // NOTE: 1 DOM access here\n\n var boundaries = {\n top: 0,\n left: 0\n };\n var offsetParent = fixedPosition ? getFixedPositionOffsetParent(popper) : findCommonOffsetParent(popper, reference); // Handle viewport case\n\n if (boundariesElement === 'viewport') {\n boundaries = getViewportOffsetRectRelativeToArtbitraryNode(offsetParent, fixedPosition);\n } else {\n // Handle other cases based on DOM element used as boundaries\n var boundariesNode = void 0;\n\n if (boundariesElement === 'scrollParent') {\n boundariesNode = getScrollParent(getParentNode(reference));\n\n if (boundariesNode.nodeName === 'BODY') {\n boundariesNode = popper.ownerDocument.documentElement;\n }\n } else if (boundariesElement === 'window') {\n boundariesNode = popper.ownerDocument.documentElement;\n } else {\n boundariesNode = boundariesElement;\n }\n\n var offsets = getOffsetRectRelativeToArbitraryNode(boundariesNode, offsetParent, fixedPosition); // In case of HTML, we need a different computation\n\n if (boundariesNode.nodeName === 'HTML' && !isFixed(offsetParent)) {\n var _getWindowSizes = getWindowSizes(popper.ownerDocument),\n height = _getWindowSizes.height,\n width = _getWindowSizes.width;\n\n boundaries.top += offsets.top - offsets.marginTop;\n boundaries.bottom = height + offsets.top;\n boundaries.left += offsets.left - offsets.marginLeft;\n boundaries.right = width + offsets.left;\n } else {\n // for all the other DOM elements, this one is good\n boundaries = offsets;\n }\n } // Add paddings\n\n\n padding = padding || 0;\n var isPaddingNumber = typeof padding === 'number';\n boundaries.left += isPaddingNumber ? padding : padding.left || 0;\n boundaries.top += isPaddingNumber ? padding : padding.top || 0;\n boundaries.right -= isPaddingNumber ? padding : padding.right || 0;\n boundaries.bottom -= isPaddingNumber ? padding : padding.bottom || 0;\n return boundaries;\n}\n\nfunction getArea(_ref) {\n var width = _ref.width,\n height = _ref.height;\n return width * height;\n}\n/**\n * Utility used to transform the `auto` placement to the placement with more\n * available space.\n * @method\n * @memberof Popper.Utils\n * @argument {Object} data - The data object generated by update method\n * @argument {Object} options - Modifiers configuration and options\n * @returns {Object} The data object, properly modified\n */\n\n\nfunction computeAutoPlacement(placement, refRect, popper, reference, boundariesElement) {\n var padding = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : 0;\n\n if (placement.indexOf('auto') === -1) {\n return placement;\n }\n\n var boundaries = getBoundaries(popper, reference, padding, boundariesElement);\n var rects = {\n top: {\n width: boundaries.width,\n height: refRect.top - boundaries.top\n },\n right: {\n width: boundaries.right - refRect.right,\n height: boundaries.height\n },\n bottom: {\n width: boundaries.width,\n height: boundaries.bottom - refRect.bottom\n },\n left: {\n width: refRect.left - boundaries.left,\n height: boundaries.height\n }\n };\n var sortedAreas = Object.keys(rects).map(function (key) {\n return _extends({\n key: key\n }, rects[key], {\n area: getArea(rects[key])\n });\n }).sort(function (a, b) {\n return b.area - a.area;\n });\n var filteredAreas = sortedAreas.filter(function (_ref2) {\n var width = _ref2.width,\n height = _ref2.height;\n return width >= popper.clientWidth && height >= popper.clientHeight;\n });\n var computedPlacement = filteredAreas.length > 0 ? filteredAreas[0].key : sortedAreas[0].key;\n var variation = placement.split('-')[1];\n return computedPlacement + (variation ? '-' + variation : '');\n}\n/**\n * Get offsets to the reference element\n * @method\n * @memberof Popper.Utils\n * @param {Object} state\n * @param {Element} popper - the popper element\n * @param {Element} reference - the reference element (the popper will be relative to this)\n * @param {Element} fixedPosition - is in fixed position mode\n * @returns {Object} An object containing the offsets which will be applied to the popper\n */\n\n\nfunction getReferenceOffsets(state, popper, reference) {\n var fixedPosition = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : null;\n var commonOffsetParent = fixedPosition ? getFixedPositionOffsetParent(popper) : findCommonOffsetParent(popper, reference);\n return getOffsetRectRelativeToArbitraryNode(reference, commonOffsetParent, fixedPosition);\n}\n/**\n * Get the outer sizes of the given element (offset size + margins)\n * @method\n * @memberof Popper.Utils\n * @argument {Element} element\n * @returns {Object} object containing width and height properties\n */\n\n\nfunction getOuterSizes(element) {\n var window = element.ownerDocument.defaultView;\n var styles = window.getComputedStyle(element);\n var x = parseFloat(styles.marginTop || 0) + parseFloat(styles.marginBottom || 0);\n var y = parseFloat(styles.marginLeft || 0) + parseFloat(styles.marginRight || 0);\n var result = {\n width: element.offsetWidth + y,\n height: element.offsetHeight + x\n };\n return result;\n}\n/**\n * Get the opposite placement of the given one\n * @method\n * @memberof Popper.Utils\n * @argument {String} placement\n * @returns {String} flipped placement\n */\n\n\nfunction getOppositePlacement(placement) {\n var hash = {\n left: 'right',\n right: 'left',\n bottom: 'top',\n top: 'bottom'\n };\n return placement.replace(/left|right|bottom|top/g, function (matched) {\n return hash[matched];\n });\n}\n/**\n * Get offsets to the popper\n * @method\n * @memberof Popper.Utils\n * @param {Object} position - CSS position the Popper will get applied\n * @param {HTMLElement} popper - the popper element\n * @param {Object} referenceOffsets - the reference offsets (the popper will be relative to this)\n * @param {String} placement - one of the valid placement options\n * @returns {Object} popperOffsets - An object containing the offsets which will be applied to the popper\n */\n\n\nfunction getPopperOffsets(popper, referenceOffsets, placement) {\n placement = placement.split('-')[0]; // Get popper node sizes\n\n var popperRect = getOuterSizes(popper); // Add position, width and height to our offsets object\n\n var popperOffsets = {\n width: popperRect.width,\n height: popperRect.height\n }; // depending by the popper placement we have to compute its offsets slightly differently\n\n var isHoriz = ['right', 'left'].indexOf(placement) !== -1;\n var mainSide = isHoriz ? 'top' : 'left';\n var secondarySide = isHoriz ? 'left' : 'top';\n var measurement = isHoriz ? 'height' : 'width';\n var secondaryMeasurement = !isHoriz ? 'height' : 'width';\n popperOffsets[mainSide] = referenceOffsets[mainSide] + referenceOffsets[measurement] / 2 - popperRect[measurement] / 2;\n\n if (placement === secondarySide) {\n popperOffsets[secondarySide] = referenceOffsets[secondarySide] - popperRect[secondaryMeasurement];\n } else {\n popperOffsets[secondarySide] = referenceOffsets[getOppositePlacement(secondarySide)];\n }\n\n return popperOffsets;\n}\n/**\n * Mimics the `find` method of Array\n * @method\n * @memberof Popper.Utils\n * @argument {Array} arr\n * @argument prop\n * @argument value\n * @returns index or -1\n */\n\n\nfunction find(arr, check) {\n // use native find if supported\n if (Array.prototype.find) {\n return arr.find(check);\n } // use `filter` to obtain the same behavior of `find`\n\n\n return arr.filter(check)[0];\n}\n/**\n * Return the index of the matching object\n * @method\n * @memberof Popper.Utils\n * @argument {Array} arr\n * @argument prop\n * @argument value\n * @returns index or -1\n */\n\n\nfunction findIndex(arr, prop, value) {\n // use native findIndex if supported\n if (Array.prototype.findIndex) {\n return arr.findIndex(function (cur) {\n return cur[prop] === value;\n });\n } // use `find` + `indexOf` if `findIndex` isn't supported\n\n\n var match = find(arr, function (obj) {\n return obj[prop] === value;\n });\n return arr.indexOf(match);\n}\n/**\n * Loop trough the list of modifiers and run them in order,\n * each of them will then edit the data object.\n * @method\n * @memberof Popper.Utils\n * @param {dataObject} data\n * @param {Array} modifiers\n * @param {String} ends - Optional modifier name used as stopper\n * @returns {dataObject}\n */\n\n\nfunction runModifiers(modifiers, data, ends) {\n var modifiersToRun = ends === undefined ? modifiers : modifiers.slice(0, findIndex(modifiers, 'name', ends));\n modifiersToRun.forEach(function (modifier) {\n if (modifier['function']) {\n // eslint-disable-line dot-notation\n console.warn('`modifier.function` is deprecated, use `modifier.fn`!');\n }\n\n var fn = modifier['function'] || modifier.fn; // eslint-disable-line dot-notation\n\n if (modifier.enabled && isFunction(fn)) {\n // Add properties to offsets to make them a complete clientRect object\n // we do this before each modifier to make sure the previous one doesn't\n // mess with these values\n data.offsets.popper = getClientRect(data.offsets.popper);\n data.offsets.reference = getClientRect(data.offsets.reference);\n data = fn(data, modifier);\n }\n });\n return data;\n}\n/**\n * Updates the position of the popper, computing the new offsets and applying\n * the new style.
\n * Prefer `scheduleUpdate` over `update` because of performance reasons.\n * @method\n * @memberof Popper\n */\n\n\nfunction update() {\n // if popper is destroyed, don't perform any further update\n if (this.state.isDestroyed) {\n return;\n }\n\n var data = {\n instance: this,\n styles: {},\n arrowStyles: {},\n attributes: {},\n flipped: false,\n offsets: {}\n }; // compute reference element offsets\n\n data.offsets.reference = getReferenceOffsets(this.state, this.popper, this.reference, this.options.positionFixed); // compute auto placement, store placement inside the data object,\n // modifiers will be able to edit `placement` if needed\n // and refer to originalPlacement to know the original value\n\n data.placement = computeAutoPlacement(this.options.placement, data.offsets.reference, this.popper, this.reference, this.options.modifiers.flip.boundariesElement, this.options.modifiers.flip.padding); // store the computed placement inside `originalPlacement`\n\n data.originalPlacement = data.placement;\n data.positionFixed = this.options.positionFixed; // compute the popper offsets\n\n data.offsets.popper = getPopperOffsets(this.popper, data.offsets.reference, data.placement);\n data.offsets.popper.position = this.options.positionFixed ? 'fixed' : 'absolute'; // run the modifiers\n\n data = runModifiers(this.modifiers, data); // the first `update` will call `onCreate` callback\n // the other ones will call `onUpdate` callback\n\n if (!this.state.isCreated) {\n this.state.isCreated = true;\n this.options.onCreate(data);\n } else {\n this.options.onUpdate(data);\n }\n}\n/**\n * Helper used to know if the given modifier is enabled.\n * @method\n * @memberof Popper.Utils\n * @returns {Boolean}\n */\n\n\nfunction isModifierEnabled(modifiers, modifierName) {\n return modifiers.some(function (_ref) {\n var name = _ref.name,\n enabled = _ref.enabled;\n return enabled && name === modifierName;\n });\n}\n/**\n * Get the prefixed supported property name\n * @method\n * @memberof Popper.Utils\n * @argument {String} property (camelCase)\n * @returns {String} prefixed property (camelCase or PascalCase, depending on the vendor prefix)\n */\n\n\nfunction getSupportedPropertyName(property) {\n var prefixes = [false, 'ms', 'Webkit', 'Moz', 'O'];\n var upperProp = property.charAt(0).toUpperCase() + property.slice(1);\n\n for (var i = 0; i < prefixes.length; i++) {\n var prefix = prefixes[i];\n var toCheck = prefix ? '' + prefix + upperProp : property;\n\n if (typeof document.body.style[toCheck] !== 'undefined') {\n return toCheck;\n }\n }\n\n return null;\n}\n/**\n * Destroys the popper.\n * @method\n * @memberof Popper\n */\n\n\nfunction destroy() {\n this.state.isDestroyed = true; // touch DOM only if `applyStyle` modifier is enabled\n\n if (isModifierEnabled(this.modifiers, 'applyStyle')) {\n this.popper.removeAttribute('x-placement');\n this.popper.style.position = '';\n this.popper.style.top = '';\n this.popper.style.left = '';\n this.popper.style.right = '';\n this.popper.style.bottom = '';\n this.popper.style.willChange = '';\n this.popper.style[getSupportedPropertyName('transform')] = '';\n }\n\n this.disableEventListeners(); // remove the popper if user explicity asked for the deletion on destroy\n // do not use `remove` because IE11 doesn't support it\n\n if (this.options.removeOnDestroy) {\n this.popper.parentNode.removeChild(this.popper);\n }\n\n return this;\n}\n/**\n * Get the window associated with the element\n * @argument {Element} element\n * @returns {Window}\n */\n\n\nfunction getWindow(element) {\n var ownerDocument = element.ownerDocument;\n return ownerDocument ? ownerDocument.defaultView : window;\n}\n\nfunction attachToScrollParents(scrollParent, event, callback, scrollParents) {\n var isBody = scrollParent.nodeName === 'BODY';\n var target = isBody ? scrollParent.ownerDocument.defaultView : scrollParent;\n target.addEventListener(event, callback, {\n passive: true\n });\n\n if (!isBody) {\n attachToScrollParents(getScrollParent(target.parentNode), event, callback, scrollParents);\n }\n\n scrollParents.push(target);\n}\n/**\n * Setup needed event listeners used to update the popper position\n * @method\n * @memberof Popper.Utils\n * @private\n */\n\n\nfunction setupEventListeners(reference, options, state, updateBound) {\n // Resize event listener on window\n state.updateBound = updateBound;\n getWindow(reference).addEventListener('resize', state.updateBound, {\n passive: true\n }); // Scroll event listener on scroll parents\n\n var scrollElement = getScrollParent(reference);\n attachToScrollParents(scrollElement, 'scroll', state.updateBound, state.scrollParents);\n state.scrollElement = scrollElement;\n state.eventsEnabled = true;\n return state;\n}\n/**\n * It will add resize/scroll events and start recalculating\n * position of the popper element when they are triggered.\n * @method\n * @memberof Popper\n */\n\n\nfunction enableEventListeners() {\n if (!this.state.eventsEnabled) {\n this.state = setupEventListeners(this.reference, this.options, this.state, this.scheduleUpdate);\n }\n}\n/**\n * Remove event listeners used to update the popper position\n * @method\n * @memberof Popper.Utils\n * @private\n */\n\n\nfunction removeEventListeners(reference, state) {\n // Remove resize event listener on window\n getWindow(reference).removeEventListener('resize', state.updateBound); // Remove scroll event listener on scroll parents\n\n state.scrollParents.forEach(function (target) {\n target.removeEventListener('scroll', state.updateBound);\n }); // Reset state\n\n state.updateBound = null;\n state.scrollParents = [];\n state.scrollElement = null;\n state.eventsEnabled = false;\n return state;\n}\n/**\n * It will remove resize/scroll events and won't recalculate popper position\n * when they are triggered. It also won't trigger `onUpdate` callback anymore,\n * unless you call `update` method manually.\n * @method\n * @memberof Popper\n */\n\n\nfunction disableEventListeners() {\n if (this.state.eventsEnabled) {\n cancelAnimationFrame(this.scheduleUpdate);\n this.state = removeEventListeners(this.reference, this.state);\n }\n}\n/**\n * Tells if a given input is a number\n * @method\n * @memberof Popper.Utils\n * @param {*} input to check\n * @return {Boolean}\n */\n\n\nfunction isNumeric(n) {\n return n !== '' && !isNaN(parseFloat(n)) && isFinite(n);\n}\n/**\n * Set the style to the given popper\n * @method\n * @memberof Popper.Utils\n * @argument {Element} element - Element to apply the style to\n * @argument {Object} styles\n * Object with a list of properties and values which will be applied to the element\n */\n\n\nfunction setStyles(element, styles) {\n Object.keys(styles).forEach(function (prop) {\n var unit = ''; // add unit if the value is numeric and is one of the following\n\n if (['width', 'height', 'top', 'right', 'bottom', 'left'].indexOf(prop) !== -1 && isNumeric(styles[prop])) {\n unit = 'px';\n }\n\n element.style[prop] = styles[prop] + unit;\n });\n}\n/**\n * Set the attributes to the given popper\n * @method\n * @memberof Popper.Utils\n * @argument {Element} element - Element to apply the attributes to\n * @argument {Object} styles\n * Object with a list of properties and values which will be applied to the element\n */\n\n\nfunction setAttributes(element, attributes) {\n Object.keys(attributes).forEach(function (prop) {\n var value = attributes[prop];\n\n if (value !== false) {\n element.setAttribute(prop, attributes[prop]);\n } else {\n element.removeAttribute(prop);\n }\n });\n}\n/**\n * @function\n * @memberof Modifiers\n * @argument {Object} data - The data object generated by `update` method\n * @argument {Object} data.styles - List of style properties - values to apply to popper element\n * @argument {Object} data.attributes - List of attribute properties - values to apply to popper element\n * @argument {Object} options - Modifiers configuration and options\n * @returns {Object} The same data object\n */\n\n\nfunction applyStyle(data) {\n // any property present in `data.styles` will be applied to the popper,\n // in this way we can make the 3rd party modifiers add custom styles to it\n // Be aware, modifiers could override the properties defined in the previous\n // lines of this modifier!\n setStyles(data.instance.popper, data.styles); // any property present in `data.attributes` will be applied to the popper,\n // they will be set as HTML attributes of the element\n\n setAttributes(data.instance.popper, data.attributes); // if arrowElement is defined and arrowStyles has some properties\n\n if (data.arrowElement && Object.keys(data.arrowStyles).length) {\n setStyles(data.arrowElement, data.arrowStyles);\n }\n\n return data;\n}\n/**\n * Set the x-placement attribute before everything else because it could be used\n * to add margins to the popper margins needs to be calculated to get the\n * correct popper offsets.\n * @method\n * @memberof Popper.modifiers\n * @param {HTMLElement} reference - The reference element used to position the popper\n * @param {HTMLElement} popper - The HTML element used as popper\n * @param {Object} options - Popper.js options\n */\n\n\nfunction applyStyleOnLoad(reference, popper, options, modifierOptions, state) {\n // compute reference element offsets\n var referenceOffsets = getReferenceOffsets(state, popper, reference, options.positionFixed); // compute auto placement, store placement inside the data object,\n // modifiers will be able to edit `placement` if needed\n // and refer to originalPlacement to know the original value\n\n var placement = computeAutoPlacement(options.placement, referenceOffsets, popper, reference, options.modifiers.flip.boundariesElement, options.modifiers.flip.padding);\n popper.setAttribute('x-placement', placement); // Apply `position` to popper before anything else because\n // without the position applied we can't guarantee correct computations\n\n setStyles(popper, {\n position: options.positionFixed ? 'fixed' : 'absolute'\n });\n return options;\n}\n/**\n * @function\n * @memberof Popper.Utils\n * @argument {Object} data - The data object generated by `update` method\n * @argument {Boolean} shouldRound - If the offsets should be rounded at all\n * @returns {Object} The popper's position offsets rounded\n *\n * The tale of pixel-perfect positioning. It's still not 100% perfect, but as\n * good as it can be within reason.\n * Discussion here: https://github.com/FezVrasta/popper.js/pull/715\n *\n * Low DPI screens cause a popper to be blurry if not using full pixels (Safari\n * as well on High DPI screens).\n *\n * Firefox prefers no rounding for positioning and does not have blurriness on\n * high DPI screens.\n *\n * Only horizontal placement and left/right values need to be considered.\n */\n\n\nfunction getRoundedOffsets(data, shouldRound) {\n var _data$offsets = data.offsets,\n popper = _data$offsets.popper,\n reference = _data$offsets.reference;\n var round = Math.round,\n floor = Math.floor;\n\n var noRound = function noRound(v) {\n return v;\n };\n\n var referenceWidth = round(reference.width);\n var popperWidth = round(popper.width);\n var isVertical = ['left', 'right'].indexOf(data.placement) !== -1;\n var isVariation = data.placement.indexOf('-') !== -1;\n var sameWidthParity = referenceWidth % 2 === popperWidth % 2;\n var bothOddWidth = referenceWidth % 2 === 1 && popperWidth % 2 === 1;\n var horizontalToInteger = !shouldRound ? noRound : isVertical || isVariation || sameWidthParity ? round : floor;\n var verticalToInteger = !shouldRound ? noRound : round;\n return {\n left: horizontalToInteger(bothOddWidth && !isVariation && shouldRound ? popper.left - 1 : popper.left),\n top: verticalToInteger(popper.top),\n bottom: verticalToInteger(popper.bottom),\n right: horizontalToInteger(popper.right)\n };\n}\n\nvar isFirefox = isBrowser && /Firefox/i.test(navigator.userAgent);\n/**\n * @function\n * @memberof Modifiers\n * @argument {Object} data - The data object generated by `update` method\n * @argument {Object} options - Modifiers configuration and options\n * @returns {Object} The data object, properly modified\n */\n\nfunction computeStyle(data, options) {\n var x = options.x,\n y = options.y;\n var popper = data.offsets.popper; // Remove this legacy support in Popper.js v2\n\n var legacyGpuAccelerationOption = find(data.instance.modifiers, function (modifier) {\n return modifier.name === 'applyStyle';\n }).gpuAcceleration;\n\n if (legacyGpuAccelerationOption !== undefined) {\n console.warn('WARNING: `gpuAcceleration` option moved to `computeStyle` modifier and will not be supported in future versions of Popper.js!');\n }\n\n var gpuAcceleration = legacyGpuAccelerationOption !== undefined ? legacyGpuAccelerationOption : options.gpuAcceleration;\n var offsetParent = getOffsetParent(data.instance.popper);\n var offsetParentRect = getBoundingClientRect(offsetParent); // Styles\n\n var styles = {\n position: popper.position\n };\n var offsets = getRoundedOffsets(data, window.devicePixelRatio < 2 || !isFirefox);\n var sideA = x === 'bottom' ? 'top' : 'bottom';\n var sideB = y === 'right' ? 'left' : 'right'; // if gpuAcceleration is set to `true` and transform is supported,\n // we use `translate3d` to apply the position to the popper we\n // automatically use the supported prefixed version if needed\n\n var prefixedProperty = getSupportedPropertyName('transform'); // now, let's make a step back and look at this code closely (wtf?)\n // If the content of the popper grows once it's been positioned, it\n // may happen that the popper gets misplaced because of the new content\n // overflowing its reference element\n // To avoid this problem, we provide two options (x and y), which allow\n // the consumer to define the offset origin.\n // If we position a popper on top of a reference element, we can set\n // `x` to `top` to make the popper grow towards its top instead of\n // its bottom.\n\n var left = void 0,\n top = void 0;\n\n if (sideA === 'bottom') {\n // when offsetParent is the positioning is relative to the bottom of the screen (excluding the scrollbar)\n // and not the bottom of the html element\n if (offsetParent.nodeName === 'HTML') {\n top = -offsetParent.clientHeight + offsets.bottom;\n } else {\n top = -offsetParentRect.height + offsets.bottom;\n }\n } else {\n top = offsets.top;\n }\n\n if (sideB === 'right') {\n if (offsetParent.nodeName === 'HTML') {\n left = -offsetParent.clientWidth + offsets.right;\n } else {\n left = -offsetParentRect.width + offsets.right;\n }\n } else {\n left = offsets.left;\n }\n\n if (gpuAcceleration && prefixedProperty) {\n styles[prefixedProperty] = 'translate3d(' + left + 'px, ' + top + 'px, 0)';\n styles[sideA] = 0;\n styles[sideB] = 0;\n styles.willChange = 'transform';\n } else {\n // othwerise, we use the standard `top`, `left`, `bottom` and `right` properties\n var invertTop = sideA === 'bottom' ? -1 : 1;\n var invertLeft = sideB === 'right' ? -1 : 1;\n styles[sideA] = top * invertTop;\n styles[sideB] = left * invertLeft;\n styles.willChange = sideA + ', ' + sideB;\n } // Attributes\n\n\n var attributes = {\n 'x-placement': data.placement\n }; // Update `data` attributes, styles and arrowStyles\n\n data.attributes = _extends({}, attributes, data.attributes);\n data.styles = _extends({}, styles, data.styles);\n data.arrowStyles = _extends({}, data.offsets.arrow, data.arrowStyles);\n return data;\n}\n/**\n * Helper used to know if the given modifier depends from another one.
\n * It checks if the needed modifier is listed and enabled.\n * @method\n * @memberof Popper.Utils\n * @param {Array} modifiers - list of modifiers\n * @param {String} requestingName - name of requesting modifier\n * @param {String} requestedName - name of requested modifier\n * @returns {Boolean}\n */\n\n\nfunction isModifierRequired(modifiers, requestingName, requestedName) {\n var requesting = find(modifiers, function (_ref) {\n var name = _ref.name;\n return name === requestingName;\n });\n var isRequired = !!requesting && modifiers.some(function (modifier) {\n return modifier.name === requestedName && modifier.enabled && modifier.order < requesting.order;\n });\n\n if (!isRequired) {\n var _requesting = '`' + requestingName + '`';\n\n var requested = '`' + requestedName + '`';\n console.warn(requested + ' modifier is required by ' + _requesting + ' modifier in order to work, be sure to include it before ' + _requesting + '!');\n }\n\n return isRequired;\n}\n/**\n * @function\n * @memberof Modifiers\n * @argument {Object} data - The data object generated by update method\n * @argument {Object} options - Modifiers configuration and options\n * @returns {Object} The data object, properly modified\n */\n\n\nfunction arrow(data, options) {\n var _data$offsets$arrow; // arrow depends on keepTogether in order to work\n\n\n if (!isModifierRequired(data.instance.modifiers, 'arrow', 'keepTogether')) {\n return data;\n }\n\n var arrowElement = options.element; // if arrowElement is a string, suppose it's a CSS selector\n\n if (typeof arrowElement === 'string') {\n arrowElement = data.instance.popper.querySelector(arrowElement); // if arrowElement is not found, don't run the modifier\n\n if (!arrowElement) {\n return data;\n }\n } else {\n // if the arrowElement isn't a query selector we must check that the\n // provided DOM node is child of its popper node\n if (!data.instance.popper.contains(arrowElement)) {\n console.warn('WARNING: `arrow.element` must be child of its popper element!');\n return data;\n }\n }\n\n var placement = data.placement.split('-')[0];\n var _data$offsets = data.offsets,\n popper = _data$offsets.popper,\n reference = _data$offsets.reference;\n var isVertical = ['left', 'right'].indexOf(placement) !== -1;\n var len = isVertical ? 'height' : 'width';\n var sideCapitalized = isVertical ? 'Top' : 'Left';\n var side = sideCapitalized.toLowerCase();\n var altSide = isVertical ? 'left' : 'top';\n var opSide = isVertical ? 'bottom' : 'right';\n var arrowElementSize = getOuterSizes(arrowElement)[len]; //\n // extends keepTogether behavior making sure the popper and its\n // reference have enough pixels in conjunction\n //\n // top/left side\n\n if (reference[opSide] - arrowElementSize < popper[side]) {\n data.offsets.popper[side] -= popper[side] - (reference[opSide] - arrowElementSize);\n } // bottom/right side\n\n\n if (reference[side] + arrowElementSize > popper[opSide]) {\n data.offsets.popper[side] += reference[side] + arrowElementSize - popper[opSide];\n }\n\n data.offsets.popper = getClientRect(data.offsets.popper); // compute center of the popper\n\n var center = reference[side] + reference[len] / 2 - arrowElementSize / 2; // Compute the sideValue using the updated popper offsets\n // take popper margin in account because we don't have this info available\n\n var css = getStyleComputedProperty(data.instance.popper);\n var popperMarginSide = parseFloat(css['margin' + sideCapitalized], 10);\n var popperBorderSide = parseFloat(css['border' + sideCapitalized + 'Width'], 10);\n var sideValue = center - data.offsets.popper[side] - popperMarginSide - popperBorderSide; // prevent arrowElement from being placed not contiguously to its popper\n\n sideValue = Math.max(Math.min(popper[len] - arrowElementSize, sideValue), 0);\n data.arrowElement = arrowElement;\n data.offsets.arrow = (_data$offsets$arrow = {}, defineProperty(_data$offsets$arrow, side, Math.round(sideValue)), defineProperty(_data$offsets$arrow, altSide, ''), _data$offsets$arrow);\n return data;\n}\n/**\n * Get the opposite placement variation of the given one\n * @method\n * @memberof Popper.Utils\n * @argument {String} placement variation\n * @returns {String} flipped placement variation\n */\n\n\nfunction getOppositeVariation(variation) {\n if (variation === 'end') {\n return 'start';\n } else if (variation === 'start') {\n return 'end';\n }\n\n return variation;\n}\n/**\n * List of accepted placements to use as values of the `placement` option.
\n * Valid placements are:\n * - `auto`\n * - `top`\n * - `right`\n * - `bottom`\n * - `left`\n *\n * Each placement can have a variation from this list:\n * - `-start`\n * - `-end`\n *\n * Variations are interpreted easily if you think of them as the left to right\n * written languages. Horizontally (`top` and `bottom`), `start` is left and `end`\n * is right.
\n * Vertically (`left` and `right`), `start` is top and `end` is bottom.\n *\n * Some valid examples are:\n * - `top-end` (on top of reference, right aligned)\n * - `right-start` (on right of reference, top aligned)\n * - `bottom` (on bottom, centered)\n * - `auto-end` (on the side with more space available, alignment depends by placement)\n *\n * @static\n * @type {Array}\n * @enum {String}\n * @readonly\n * @method placements\n * @memberof Popper\n */\n\n\nvar placements = ['auto-start', 'auto', 'auto-end', 'top-start', 'top', 'top-end', 'right-start', 'right', 'right-end', 'bottom-end', 'bottom', 'bottom-start', 'left-end', 'left', 'left-start']; // Get rid of `auto` `auto-start` and `auto-end`\n\nvar validPlacements = placements.slice(3);\n/**\n * Given an initial placement, returns all the subsequent placements\n * clockwise (or counter-clockwise).\n *\n * @method\n * @memberof Popper.Utils\n * @argument {String} placement - A valid placement (it accepts variations)\n * @argument {Boolean} counter - Set to true to walk the placements counterclockwise\n * @returns {Array} placements including their variations\n */\n\nfunction clockwise(placement) {\n var counter = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;\n var index = validPlacements.indexOf(placement);\n var arr = validPlacements.slice(index + 1).concat(validPlacements.slice(0, index));\n return counter ? arr.reverse() : arr;\n}\n\nvar BEHAVIORS = {\n FLIP: 'flip',\n CLOCKWISE: 'clockwise',\n COUNTERCLOCKWISE: 'counterclockwise'\n};\n/**\n * @function\n * @memberof Modifiers\n * @argument {Object} data - The data object generated by update method\n * @argument {Object} options - Modifiers configuration and options\n * @returns {Object} The data object, properly modified\n */\n\nfunction flip(data, options) {\n // if `inner` modifier is enabled, we can't use the `flip` modifier\n if (isModifierEnabled(data.instance.modifiers, 'inner')) {\n return data;\n }\n\n if (data.flipped && data.placement === data.originalPlacement) {\n // seems like flip is trying to loop, probably there's not enough space on any of the flippable sides\n return data;\n }\n\n var boundaries = getBoundaries(data.instance.popper, data.instance.reference, options.padding, options.boundariesElement, data.positionFixed);\n var placement = data.placement.split('-')[0];\n var placementOpposite = getOppositePlacement(placement);\n var variation = data.placement.split('-')[1] || '';\n var flipOrder = [];\n\n switch (options.behavior) {\n case BEHAVIORS.FLIP:\n flipOrder = [placement, placementOpposite];\n break;\n\n case BEHAVIORS.CLOCKWISE:\n flipOrder = clockwise(placement);\n break;\n\n case BEHAVIORS.COUNTERCLOCKWISE:\n flipOrder = clockwise(placement, true);\n break;\n\n default:\n flipOrder = options.behavior;\n }\n\n flipOrder.forEach(function (step, index) {\n if (placement !== step || flipOrder.length === index + 1) {\n return data;\n }\n\n placement = data.placement.split('-')[0];\n placementOpposite = getOppositePlacement(placement);\n var popperOffsets = data.offsets.popper;\n var refOffsets = data.offsets.reference; // using floor because the reference offsets may contain decimals we are not going to consider here\n\n var floor = Math.floor;\n var overlapsRef = placement === 'left' && floor(popperOffsets.right) > floor(refOffsets.left) || placement === 'right' && floor(popperOffsets.left) < floor(refOffsets.right) || placement === 'top' && floor(popperOffsets.bottom) > floor(refOffsets.top) || placement === 'bottom' && floor(popperOffsets.top) < floor(refOffsets.bottom);\n var overflowsLeft = floor(popperOffsets.left) < floor(boundaries.left);\n var overflowsRight = floor(popperOffsets.right) > floor(boundaries.right);\n var overflowsTop = floor(popperOffsets.top) < floor(boundaries.top);\n var overflowsBottom = floor(popperOffsets.bottom) > floor(boundaries.bottom);\n var overflowsBoundaries = placement === 'left' && overflowsLeft || placement === 'right' && overflowsRight || placement === 'top' && overflowsTop || placement === 'bottom' && overflowsBottom; // flip the variation if required\n\n var isVertical = ['top', 'bottom'].indexOf(placement) !== -1; // flips variation if reference element overflows boundaries\n\n var flippedVariationByRef = !!options.flipVariations && (isVertical && variation === 'start' && overflowsLeft || isVertical && variation === 'end' && overflowsRight || !isVertical && variation === 'start' && overflowsTop || !isVertical && variation === 'end' && overflowsBottom); // flips variation if popper content overflows boundaries\n\n var flippedVariationByContent = !!options.flipVariationsByContent && (isVertical && variation === 'start' && overflowsRight || isVertical && variation === 'end' && overflowsLeft || !isVertical && variation === 'start' && overflowsBottom || !isVertical && variation === 'end' && overflowsTop);\n var flippedVariation = flippedVariationByRef || flippedVariationByContent;\n\n if (overlapsRef || overflowsBoundaries || flippedVariation) {\n // this boolean to detect any flip loop\n data.flipped = true;\n\n if (overlapsRef || overflowsBoundaries) {\n placement = flipOrder[index + 1];\n }\n\n if (flippedVariation) {\n variation = getOppositeVariation(variation);\n }\n\n data.placement = placement + (variation ? '-' + variation : ''); // this object contains `position`, we want to preserve it along with\n // any additional property we may add in the future\n\n data.offsets.popper = _extends({}, data.offsets.popper, getPopperOffsets(data.instance.popper, data.offsets.reference, data.placement));\n data = runModifiers(data.instance.modifiers, data, 'flip');\n }\n });\n return data;\n}\n/**\n * @function\n * @memberof Modifiers\n * @argument {Object} data - The data object generated by update method\n * @argument {Object} options - Modifiers configuration and options\n * @returns {Object} The data object, properly modified\n */\n\n\nfunction keepTogether(data) {\n var _data$offsets = data.offsets,\n popper = _data$offsets.popper,\n reference = _data$offsets.reference;\n var placement = data.placement.split('-')[0];\n var floor = Math.floor;\n var isVertical = ['top', 'bottom'].indexOf(placement) !== -1;\n var side = isVertical ? 'right' : 'bottom';\n var opSide = isVertical ? 'left' : 'top';\n var measurement = isVertical ? 'width' : 'height';\n\n if (popper[side] < floor(reference[opSide])) {\n data.offsets.popper[opSide] = floor(reference[opSide]) - popper[measurement];\n }\n\n if (popper[opSide] > floor(reference[side])) {\n data.offsets.popper[opSide] = floor(reference[side]);\n }\n\n return data;\n}\n/**\n * Converts a string containing value + unit into a px value number\n * @function\n * @memberof {modifiers~offset}\n * @private\n * @argument {String} str - Value + unit string\n * @argument {String} measurement - `height` or `width`\n * @argument {Object} popperOffsets\n * @argument {Object} referenceOffsets\n * @returns {Number|String}\n * Value in pixels, or original string if no values were extracted\n */\n\n\nfunction toValue(str, measurement, popperOffsets, referenceOffsets) {\n // separate value from unit\n var split = str.match(/((?:\\-|\\+)?\\d*\\.?\\d*)(.*)/);\n var value = +split[1];\n var unit = split[2]; // If it's not a number it's an operator, I guess\n\n if (!value) {\n return str;\n }\n\n if (unit.indexOf('%') === 0) {\n var element = void 0;\n\n switch (unit) {\n case '%p':\n element = popperOffsets;\n break;\n\n case '%':\n case '%r':\n default:\n element = referenceOffsets;\n }\n\n var rect = getClientRect(element);\n return rect[measurement] / 100 * value;\n } else if (unit === 'vh' || unit === 'vw') {\n // if is a vh or vw, we calculate the size based on the viewport\n var size = void 0;\n\n if (unit === 'vh') {\n size = Math.max(document.documentElement.clientHeight, window.innerHeight || 0);\n } else {\n size = Math.max(document.documentElement.clientWidth, window.innerWidth || 0);\n }\n\n return size / 100 * value;\n } else {\n // if is an explicit pixel unit, we get rid of the unit and keep the value\n // if is an implicit unit, it's px, and we return just the value\n return value;\n }\n}\n/**\n * Parse an `offset` string to extrapolate `x` and `y` numeric offsets.\n * @function\n * @memberof {modifiers~offset}\n * @private\n * @argument {String} offset\n * @argument {Object} popperOffsets\n * @argument {Object} referenceOffsets\n * @argument {String} basePlacement\n * @returns {Array} a two cells array with x and y offsets in numbers\n */\n\n\nfunction parseOffset(offset, popperOffsets, referenceOffsets, basePlacement) {\n var offsets = [0, 0]; // Use height if placement is left or right and index is 0 otherwise use width\n // in this way the first offset will use an axis and the second one\n // will use the other one\n\n var useHeight = ['right', 'left'].indexOf(basePlacement) !== -1; // Split the offset string to obtain a list of values and operands\n // The regex addresses values with the plus or minus sign in front (+10, -20, etc)\n\n var fragments = offset.split(/(\\+|\\-)/).map(function (frag) {\n return frag.trim();\n }); // Detect if the offset string contains a pair of values or a single one\n // they could be separated by comma or space\n\n var divider = fragments.indexOf(find(fragments, function (frag) {\n return frag.search(/,|\\s/) !== -1;\n }));\n\n if (fragments[divider] && fragments[divider].indexOf(',') === -1) {\n console.warn('Offsets separated by white space(s) are deprecated, use a comma (,) instead.');\n } // If divider is found, we divide the list of values and operands to divide\n // them by ofset X and Y.\n\n\n var splitRegex = /\\s*,\\s*|\\s+/;\n var ops = divider !== -1 ? [fragments.slice(0, divider).concat([fragments[divider].split(splitRegex)[0]]), [fragments[divider].split(splitRegex)[1]].concat(fragments.slice(divider + 1))] : [fragments]; // Convert the values with units to absolute pixels to allow our computations\n\n ops = ops.map(function (op, index) {\n // Most of the units rely on the orientation of the popper\n var measurement = (index === 1 ? !useHeight : useHeight) ? 'height' : 'width';\n var mergeWithPrevious = false;\n return op // This aggregates any `+` or `-` sign that aren't considered operators\n // e.g.: 10 + +5 => [10, +, +5]\n .reduce(function (a, b) {\n if (a[a.length - 1] === '' && ['+', '-'].indexOf(b) !== -1) {\n a[a.length - 1] = b;\n mergeWithPrevious = true;\n return a;\n } else if (mergeWithPrevious) {\n a[a.length - 1] += b;\n mergeWithPrevious = false;\n return a;\n } else {\n return a.concat(b);\n }\n }, []) // Here we convert the string values into number values (in px)\n .map(function (str) {\n return toValue(str, measurement, popperOffsets, referenceOffsets);\n });\n }); // Loop trough the offsets arrays and execute the operations\n\n ops.forEach(function (op, index) {\n op.forEach(function (frag, index2) {\n if (isNumeric(frag)) {\n offsets[index] += frag * (op[index2 - 1] === '-' ? -1 : 1);\n }\n });\n });\n return offsets;\n}\n/**\n * @function\n * @memberof Modifiers\n * @argument {Object} data - The data object generated by update method\n * @argument {Object} options - Modifiers configuration and options\n * @argument {Number|String} options.offset=0\n * The offset value as described in the modifier description\n * @returns {Object} The data object, properly modified\n */\n\n\nfunction offset(data, _ref) {\n var offset = _ref.offset;\n var placement = data.placement,\n _data$offsets = data.offsets,\n popper = _data$offsets.popper,\n reference = _data$offsets.reference;\n var basePlacement = placement.split('-')[0];\n var offsets = void 0;\n\n if (isNumeric(+offset)) {\n offsets = [+offset, 0];\n } else {\n offsets = parseOffset(offset, popper, reference, basePlacement);\n }\n\n if (basePlacement === 'left') {\n popper.top += offsets[0];\n popper.left -= offsets[1];\n } else if (basePlacement === 'right') {\n popper.top += offsets[0];\n popper.left += offsets[1];\n } else if (basePlacement === 'top') {\n popper.left += offsets[0];\n popper.top -= offsets[1];\n } else if (basePlacement === 'bottom') {\n popper.left += offsets[0];\n popper.top += offsets[1];\n }\n\n data.popper = popper;\n return data;\n}\n/**\n * @function\n * @memberof Modifiers\n * @argument {Object} data - The data object generated by `update` method\n * @argument {Object} options - Modifiers configuration and options\n * @returns {Object} The data object, properly modified\n */\n\n\nfunction preventOverflow(data, options) {\n var boundariesElement = options.boundariesElement || getOffsetParent(data.instance.popper); // If offsetParent is the reference element, we really want to\n // go one step up and use the next offsetParent as reference to\n // avoid to make this modifier completely useless and look like broken\n\n if (data.instance.reference === boundariesElement) {\n boundariesElement = getOffsetParent(boundariesElement);\n } // NOTE: DOM access here\n // resets the popper's position so that the document size can be calculated excluding\n // the size of the popper element itself\n\n\n var transformProp = getSupportedPropertyName('transform');\n var popperStyles = data.instance.popper.style; // assignment to help minification\n\n var top = popperStyles.top,\n left = popperStyles.left,\n transform = popperStyles[transformProp];\n popperStyles.top = '';\n popperStyles.left = '';\n popperStyles[transformProp] = '';\n var boundaries = getBoundaries(data.instance.popper, data.instance.reference, options.padding, boundariesElement, data.positionFixed); // NOTE: DOM access here\n // restores the original style properties after the offsets have been computed\n\n popperStyles.top = top;\n popperStyles.left = left;\n popperStyles[transformProp] = transform;\n options.boundaries = boundaries;\n var order = options.priority;\n var popper = data.offsets.popper;\n var check = {\n primary: function primary(placement) {\n var value = popper[placement];\n\n if (popper[placement] < boundaries[placement] && !options.escapeWithReference) {\n value = Math.max(popper[placement], boundaries[placement]);\n }\n\n return defineProperty({}, placement, value);\n },\n secondary: function secondary(placement) {\n var mainSide = placement === 'right' ? 'left' : 'top';\n var value = popper[mainSide];\n\n if (popper[placement] > boundaries[placement] && !options.escapeWithReference) {\n value = Math.min(popper[mainSide], boundaries[placement] - (placement === 'right' ? popper.width : popper.height));\n }\n\n return defineProperty({}, mainSide, value);\n }\n };\n order.forEach(function (placement) {\n var side = ['left', 'top'].indexOf(placement) !== -1 ? 'primary' : 'secondary';\n popper = _extends({}, popper, check[side](placement));\n });\n data.offsets.popper = popper;\n return data;\n}\n/**\n * @function\n * @memberof Modifiers\n * @argument {Object} data - The data object generated by `update` method\n * @argument {Object} options - Modifiers configuration and options\n * @returns {Object} The data object, properly modified\n */\n\n\nfunction shift(data) {\n var placement = data.placement;\n var basePlacement = placement.split('-')[0];\n var shiftvariation = placement.split('-')[1]; // if shift shiftvariation is specified, run the modifier\n\n if (shiftvariation) {\n var _data$offsets = data.offsets,\n reference = _data$offsets.reference,\n popper = _data$offsets.popper;\n var isVertical = ['bottom', 'top'].indexOf(basePlacement) !== -1;\n var side = isVertical ? 'left' : 'top';\n var measurement = isVertical ? 'width' : 'height';\n var shiftOffsets = {\n start: defineProperty({}, side, reference[side]),\n end: defineProperty({}, side, reference[side] + reference[measurement] - popper[measurement])\n };\n data.offsets.popper = _extends({}, popper, shiftOffsets[shiftvariation]);\n }\n\n return data;\n}\n/**\n * @function\n * @memberof Modifiers\n * @argument {Object} data - The data object generated by update method\n * @argument {Object} options - Modifiers configuration and options\n * @returns {Object} The data object, properly modified\n */\n\n\nfunction hide(data) {\n if (!isModifierRequired(data.instance.modifiers, 'hide', 'preventOverflow')) {\n return data;\n }\n\n var refRect = data.offsets.reference;\n var bound = find(data.instance.modifiers, function (modifier) {\n return modifier.name === 'preventOverflow';\n }).boundaries;\n\n if (refRect.bottom < bound.top || refRect.left > bound.right || refRect.top > bound.bottom || refRect.right < bound.left) {\n // Avoid unnecessary DOM access if visibility hasn't changed\n if (data.hide === true) {\n return data;\n }\n\n data.hide = true;\n data.attributes['x-out-of-boundaries'] = '';\n } else {\n // Avoid unnecessary DOM access if visibility hasn't changed\n if (data.hide === false) {\n return data;\n }\n\n data.hide = false;\n data.attributes['x-out-of-boundaries'] = false;\n }\n\n return data;\n}\n/**\n * @function\n * @memberof Modifiers\n * @argument {Object} data - The data object generated by `update` method\n * @argument {Object} options - Modifiers configuration and options\n * @returns {Object} The data object, properly modified\n */\n\n\nfunction inner(data) {\n var placement = data.placement;\n var basePlacement = placement.split('-')[0];\n var _data$offsets = data.offsets,\n popper = _data$offsets.popper,\n reference = _data$offsets.reference;\n var isHoriz = ['left', 'right'].indexOf(basePlacement) !== -1;\n var subtractLength = ['top', 'left'].indexOf(basePlacement) === -1;\n popper[isHoriz ? 'left' : 'top'] = reference[basePlacement] - (subtractLength ? popper[isHoriz ? 'width' : 'height'] : 0);\n data.placement = getOppositePlacement(placement);\n data.offsets.popper = getClientRect(popper);\n return data;\n}\n/**\n * Modifier function, each modifier can have a function of this type assigned\n * to its `fn` property.
\n * These functions will be called on each update, this means that you must\n * make sure they are performant enough to avoid performance bottlenecks.\n *\n * @function ModifierFn\n * @argument {dataObject} data - The data object generated by `update` method\n * @argument {Object} options - Modifiers configuration and options\n * @returns {dataObject} The data object, properly modified\n */\n\n/**\n * Modifiers are plugins used to alter the behavior of your poppers.
\n * Popper.js uses a set of 9 modifiers to provide all the basic functionalities\n * needed by the library.\n *\n * Usually you don't want to override the `order`, `fn` and `onLoad` props.\n * All the other properties are configurations that could be tweaked.\n * @namespace modifiers\n */\n\n\nvar modifiers = {\n /**\n * Modifier used to shift the popper on the start or end of its reference\n * element.
\n * It will read the variation of the `placement` property.
\n * It can be one either `-end` or `-start`.\n * @memberof modifiers\n * @inner\n */\n shift: {\n /** @prop {number} order=100 - Index used to define the order of execution */\n order: 100,\n\n /** @prop {Boolean} enabled=true - Whether the modifier is enabled or not */\n enabled: true,\n\n /** @prop {ModifierFn} */\n fn: shift\n },\n\n /**\n * The `offset` modifier can shift your popper on both its axis.\n *\n * It accepts the following units:\n * - `px` or unit-less, interpreted as pixels\n * - `%` or `%r`, percentage relative to the length of the reference element\n * - `%p`, percentage relative to the length of the popper element\n * - `vw`, CSS viewport width unit\n * - `vh`, CSS viewport height unit\n *\n * For length is intended the main axis relative to the placement of the popper.
\n * This means that if the placement is `top` or `bottom`, the length will be the\n * `width`. In case of `left` or `right`, it will be the `height`.\n *\n * You can provide a single value (as `Number` or `String`), or a pair of values\n * as `String` divided by a comma or one (or more) white spaces.
\n * The latter is a deprecated method because it leads to confusion and will be\n * removed in v2.
\n * Additionally, it accepts additions and subtractions between different units.\n * Note that multiplications and divisions aren't supported.\n *\n * Valid examples are:\n * ```\n * 10\n * '10%'\n * '10, 10'\n * '10%, 10'\n * '10 + 10%'\n * '10 - 5vh + 3%'\n * '-10px + 5vh, 5px - 6%'\n * ```\n * > **NB**: If you desire to apply offsets to your poppers in a way that may make them overlap\n * > with their reference element, unfortunately, you will have to disable the `flip` modifier.\n * > You can read more on this at this [issue](https://github.com/FezVrasta/popper.js/issues/373).\n *\n * @memberof modifiers\n * @inner\n */\n offset: {\n /** @prop {number} order=200 - Index used to define the order of execution */\n order: 200,\n\n /** @prop {Boolean} enabled=true - Whether the modifier is enabled or not */\n enabled: true,\n\n /** @prop {ModifierFn} */\n fn: offset,\n\n /** @prop {Number|String} offset=0\n * The offset value as described in the modifier description\n */\n offset: 0\n },\n\n /**\n * Modifier used to prevent the popper from being positioned outside the boundary.\n *\n * A scenario exists where the reference itself is not within the boundaries.
\n * We can say it has \"escaped the boundaries\" — or just \"escaped\".
\n * In this case we need to decide whether the popper should either:\n *\n * - detach from the reference and remain \"trapped\" in the boundaries, or\n * - if it should ignore the boundary and \"escape with its reference\"\n *\n * When `escapeWithReference` is set to`true` and reference is completely\n * outside its boundaries, the popper will overflow (or completely leave)\n * the boundaries in order to remain attached to the edge of the reference.\n *\n * @memberof modifiers\n * @inner\n */\n preventOverflow: {\n /** @prop {number} order=300 - Index used to define the order of execution */\n order: 300,\n\n /** @prop {Boolean} enabled=true - Whether the modifier is enabled or not */\n enabled: true,\n\n /** @prop {ModifierFn} */\n fn: preventOverflow,\n\n /**\n * @prop {Array} [priority=['left','right','top','bottom']]\n * Popper will try to prevent overflow following these priorities by default,\n * then, it could overflow on the left and on top of the `boundariesElement`\n */\n priority: ['left', 'right', 'top', 'bottom'],\n\n /**\n * @prop {number} padding=5\n * Amount of pixel used to define a minimum distance between the boundaries\n * and the popper. This makes sure the popper always has a little padding\n * between the edges of its container\n */\n padding: 5,\n\n /**\n * @prop {String|HTMLElement} boundariesElement='scrollParent'\n * Boundaries used by the modifier. Can be `scrollParent`, `window`,\n * `viewport` or any DOM element.\n */\n boundariesElement: 'scrollParent'\n },\n\n /**\n * Modifier used to make sure the reference and its popper stay near each other\n * without leaving any gap between the two. Especially useful when the arrow is\n * enabled and you want to ensure that it points to its reference element.\n * It cares only about the first axis. You can still have poppers with margin\n * between the popper and its reference element.\n * @memberof modifiers\n * @inner\n */\n keepTogether: {\n /** @prop {number} order=400 - Index used to define the order of execution */\n order: 400,\n\n /** @prop {Boolean} enabled=true - Whether the modifier is enabled or not */\n enabled: true,\n\n /** @prop {ModifierFn} */\n fn: keepTogether\n },\n\n /**\n * This modifier is used to move the `arrowElement` of the popper to make\n * sure it is positioned between the reference element and its popper element.\n * It will read the outer size of the `arrowElement` node to detect how many\n * pixels of conjunction are needed.\n *\n * It has no effect if no `arrowElement` is provided.\n * @memberof modifiers\n * @inner\n */\n arrow: {\n /** @prop {number} order=500 - Index used to define the order of execution */\n order: 500,\n\n /** @prop {Boolean} enabled=true - Whether the modifier is enabled or not */\n enabled: true,\n\n /** @prop {ModifierFn} */\n fn: arrow,\n\n /** @prop {String|HTMLElement} element='[x-arrow]' - Selector or node used as arrow */\n element: '[x-arrow]'\n },\n\n /**\n * Modifier used to flip the popper's placement when it starts to overlap its\n * reference element.\n *\n * Requires the `preventOverflow` modifier before it in order to work.\n *\n * **NOTE:** this modifier will interrupt the current update cycle and will\n * restart it if it detects the need to flip the placement.\n * @memberof modifiers\n * @inner\n */\n flip: {\n /** @prop {number} order=600 - Index used to define the order of execution */\n order: 600,\n\n /** @prop {Boolean} enabled=true - Whether the modifier is enabled or not */\n enabled: true,\n\n /** @prop {ModifierFn} */\n fn: flip,\n\n /**\n * @prop {String|Array} behavior='flip'\n * The behavior used to change the popper's placement. It can be one of\n * `flip`, `clockwise`, `counterclockwise` or an array with a list of valid\n * placements (with optional variations)\n */\n behavior: 'flip',\n\n /**\n * @prop {number} padding=5\n * The popper will flip if it hits the edges of the `boundariesElement`\n */\n padding: 5,\n\n /**\n * @prop {String|HTMLElement} boundariesElement='viewport'\n * The element which will define the boundaries of the popper position.\n * The popper will never be placed outside of the defined boundaries\n * (except if `keepTogether` is enabled)\n */\n boundariesElement: 'viewport',\n\n /**\n * @prop {Boolean} flipVariations=false\n * The popper will switch placement variation between `-start` and `-end` when\n * the reference element overlaps its boundaries.\n *\n * The original placement should have a set variation.\n */\n flipVariations: false,\n\n /**\n * @prop {Boolean} flipVariationsByContent=false\n * The popper will switch placement variation between `-start` and `-end` when\n * the popper element overlaps its reference boundaries.\n *\n * The original placement should have a set variation.\n */\n flipVariationsByContent: false\n },\n\n /**\n * Modifier used to make the popper flow toward the inner of the reference element.\n * By default, when this modifier is disabled, the popper will be placed outside\n * the reference element.\n * @memberof modifiers\n * @inner\n */\n inner: {\n /** @prop {number} order=700 - Index used to define the order of execution */\n order: 700,\n\n /** @prop {Boolean} enabled=false - Whether the modifier is enabled or not */\n enabled: false,\n\n /** @prop {ModifierFn} */\n fn: inner\n },\n\n /**\n * Modifier used to hide the popper when its reference element is outside of the\n * popper boundaries. It will set a `x-out-of-boundaries` attribute which can\n * be used to hide with a CSS selector the popper when its reference is\n * out of boundaries.\n *\n * Requires the `preventOverflow` modifier before it in order to work.\n * @memberof modifiers\n * @inner\n */\n hide: {\n /** @prop {number} order=800 - Index used to define the order of execution */\n order: 800,\n\n /** @prop {Boolean} enabled=true - Whether the modifier is enabled or not */\n enabled: true,\n\n /** @prop {ModifierFn} */\n fn: hide\n },\n\n /**\n * Computes the style that will be applied to the popper element to gets\n * properly positioned.\n *\n * Note that this modifier will not touch the DOM, it just prepares the styles\n * so that `applyStyle` modifier can apply it. This separation is useful\n * in case you need to replace `applyStyle` with a custom implementation.\n *\n * This modifier has `850` as `order` value to maintain backward compatibility\n * with previous versions of Popper.js. Expect the modifiers ordering method\n * to change in future major versions of the library.\n *\n * @memberof modifiers\n * @inner\n */\n computeStyle: {\n /** @prop {number} order=850 - Index used to define the order of execution */\n order: 850,\n\n /** @prop {Boolean} enabled=true - Whether the modifier is enabled or not */\n enabled: true,\n\n /** @prop {ModifierFn} */\n fn: computeStyle,\n\n /**\n * @prop {Boolean} gpuAcceleration=true\n * If true, it uses the CSS 3D transformation to position the popper.\n * Otherwise, it will use the `top` and `left` properties\n */\n gpuAcceleration: true,\n\n /**\n * @prop {string} [x='bottom']\n * Where to anchor the X axis (`bottom` or `top`). AKA X offset origin.\n * Change this if your popper should grow in a direction different from `bottom`\n */\n x: 'bottom',\n\n /**\n * @prop {string} [x='left']\n * Where to anchor the Y axis (`left` or `right`). AKA Y offset origin.\n * Change this if your popper should grow in a direction different from `right`\n */\n y: 'right'\n },\n\n /**\n * Applies the computed styles to the popper element.\n *\n * All the DOM manipulations are limited to this modifier. This is useful in case\n * you want to integrate Popper.js inside a framework or view library and you\n * want to delegate all the DOM manipulations to it.\n *\n * Note that if you disable this modifier, you must make sure the popper element\n * has its position set to `absolute` before Popper.js can do its work!\n *\n * Just disable this modifier and define your own to achieve the desired effect.\n *\n * @memberof modifiers\n * @inner\n */\n applyStyle: {\n /** @prop {number} order=900 - Index used to define the order of execution */\n order: 900,\n\n /** @prop {Boolean} enabled=true - Whether the modifier is enabled or not */\n enabled: true,\n\n /** @prop {ModifierFn} */\n fn: applyStyle,\n\n /** @prop {Function} */\n onLoad: applyStyleOnLoad,\n\n /**\n * @deprecated since version 1.10.0, the property moved to `computeStyle` modifier\n * @prop {Boolean} gpuAcceleration=true\n * If true, it uses the CSS 3D transformation to position the popper.\n * Otherwise, it will use the `top` and `left` properties\n */\n gpuAcceleration: undefined\n }\n};\n/**\n * The `dataObject` is an object containing all the information used by Popper.js.\n * This object is passed to modifiers and to the `onCreate` and `onUpdate` callbacks.\n * @name dataObject\n * @property {Object} data.instance The Popper.js instance\n * @property {String} data.placement Placement applied to popper\n * @property {String} data.originalPlacement Placement originally defined on init\n * @property {Boolean} data.flipped True if popper has been flipped by flip modifier\n * @property {Boolean} data.hide True if the reference element is out of boundaries, useful to know when to hide the popper\n * @property {HTMLElement} data.arrowElement Node used as arrow by arrow modifier\n * @property {Object} data.styles Any CSS property defined here will be applied to the popper. It expects the JavaScript nomenclature (eg. `marginBottom`)\n * @property {Object} data.arrowStyles Any CSS property defined here will be applied to the popper arrow. It expects the JavaScript nomenclature (eg. `marginBottom`)\n * @property {Object} data.boundaries Offsets of the popper boundaries\n * @property {Object} data.offsets The measurements of popper, reference and arrow elements\n * @property {Object} data.offsets.popper `top`, `left`, `width`, `height` values\n * @property {Object} data.offsets.reference `top`, `left`, `width`, `height` values\n * @property {Object} data.offsets.arrow] `top` and `left` offsets, only one of them will be different from 0\n */\n\n/**\n * Default options provided to Popper.js constructor.
\n * These can be overridden using the `options` argument of Popper.js.
\n * To override an option, simply pass an object with the same\n * structure of the `options` object, as the 3rd argument. For example:\n * ```\n * new Popper(ref, pop, {\n * modifiers: {\n * preventOverflow: { enabled: false }\n * }\n * })\n * ```\n * @type {Object}\n * @static\n * @memberof Popper\n */\n\nvar Defaults = {\n /**\n * Popper's placement.\n * @prop {Popper.placements} placement='bottom'\n */\n placement: 'bottom',\n\n /**\n * Set this to true if you want popper to position it self in 'fixed' mode\n * @prop {Boolean} positionFixed=false\n */\n positionFixed: false,\n\n /**\n * Whether events (resize, scroll) are initially enabled.\n * @prop {Boolean} eventsEnabled=true\n */\n eventsEnabled: true,\n\n /**\n * Set to true if you want to automatically remove the popper when\n * you call the `destroy` method.\n * @prop {Boolean} removeOnDestroy=false\n */\n removeOnDestroy: false,\n\n /**\n * Callback called when the popper is created.
\n * By default, it is set to no-op.
\n * Access Popper.js instance with `data.instance`.\n * @prop {onCreate}\n */\n onCreate: function onCreate() {},\n\n /**\n * Callback called when the popper is updated. This callback is not called\n * on the initialization/creation of the popper, but only on subsequent\n * updates.
\n * By default, it is set to no-op.
\n * Access Popper.js instance with `data.instance`.\n * @prop {onUpdate}\n */\n onUpdate: function onUpdate() {},\n\n /**\n * List of modifiers used to modify the offsets before they are applied to the popper.\n * They provide most of the functionalities of Popper.js.\n * @prop {modifiers}\n */\n modifiers: modifiers\n};\n/**\n * @callback onCreate\n * @param {dataObject} data\n */\n\n/**\n * @callback onUpdate\n * @param {dataObject} data\n */\n// Utils\n// Methods\n\nvar Popper = function () {\n /**\n * Creates a new Popper.js instance.\n * @class Popper\n * @param {Element|referenceObject} reference - The reference element used to position the popper\n * @param {Element} popper - The HTML / XML element used as the popper\n * @param {Object} options - Your custom options to override the ones defined in [Defaults](#defaults)\n * @return {Object} instance - The generated Popper.js instance\n */\n function Popper(reference, popper) {\n var _this = this;\n\n var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};\n classCallCheck(this, Popper);\n\n this.scheduleUpdate = function () {\n return requestAnimationFrame(_this.update);\n }; // make update() debounced, so that it only runs at most once-per-tick\n\n\n this.update = debounce(this.update.bind(this)); // with {} we create a new object with the options inside it\n\n this.options = _extends({}, Popper.Defaults, options); // init state\n\n this.state = {\n isDestroyed: false,\n isCreated: false,\n scrollParents: []\n }; // get reference and popper elements (allow jQuery wrappers)\n\n this.reference = reference && reference.jquery ? reference[0] : reference;\n this.popper = popper && popper.jquery ? popper[0] : popper; // Deep merge modifiers options\n\n this.options.modifiers = {};\n Object.keys(_extends({}, Popper.Defaults.modifiers, options.modifiers)).forEach(function (name) {\n _this.options.modifiers[name] = _extends({}, Popper.Defaults.modifiers[name] || {}, options.modifiers ? options.modifiers[name] : {});\n }); // Refactoring modifiers' list (Object => Array)\n\n this.modifiers = Object.keys(this.options.modifiers).map(function (name) {\n return _extends({\n name: name\n }, _this.options.modifiers[name]);\n }) // sort the modifiers by order\n .sort(function (a, b) {\n return a.order - b.order;\n }); // modifiers have the ability to execute arbitrary code when Popper.js get inited\n // such code is executed in the same order of its modifier\n // they could add new properties to their options configuration\n // BE AWARE: don't add options to `options.modifiers.name` but to `modifierOptions`!\n\n this.modifiers.forEach(function (modifierOptions) {\n if (modifierOptions.enabled && isFunction(modifierOptions.onLoad)) {\n modifierOptions.onLoad(_this.reference, _this.popper, _this.options, modifierOptions, _this.state);\n }\n }); // fire the first update to position the popper in the right place\n\n this.update();\n var eventsEnabled = this.options.eventsEnabled;\n\n if (eventsEnabled) {\n // setup event listeners, they will take care of update the position in specific situations\n this.enableEventListeners();\n }\n\n this.state.eventsEnabled = eventsEnabled;\n } // We can't use class properties because they don't get listed in the\n // class prototype and break stuff like Sinon stubs\n\n\n createClass(Popper, [{\n key: 'update',\n value: function update$$1() {\n return update.call(this);\n }\n }, {\n key: 'destroy',\n value: function destroy$$1() {\n return destroy.call(this);\n }\n }, {\n key: 'enableEventListeners',\n value: function enableEventListeners$$1() {\n return enableEventListeners.call(this);\n }\n }, {\n key: 'disableEventListeners',\n value: function disableEventListeners$$1() {\n return disableEventListeners.call(this);\n }\n /**\n * Schedules an update. It will run on the next UI update available.\n * @method scheduleUpdate\n * @memberof Popper\n */\n\n /**\n * Collection of utilities useful when writing custom modifiers.\n * Starting from version 1.7, this method is available only if you\n * include `popper-utils.js` before `popper.js`.\n *\n * **DEPRECATION**: This way to access PopperUtils is deprecated\n * and will be removed in v2! Use the PopperUtils module directly instead.\n * Due to the high instability of the methods contained in Utils, we can't\n * guarantee them to follow semver. Use them at your own risk!\n * @static\n * @private\n * @type {Object}\n * @deprecated since version 1.8\n * @member Utils\n * @memberof Popper\n */\n\n }]);\n return Popper;\n}();\n/**\n * The `referenceObject` is an object that provides an interface compatible with Popper.js\n * and lets you use it as replacement of a real DOM node.
\n * You can use this method to position a popper relatively to a set of coordinates\n * in case you don't have a DOM node to use as reference.\n *\n * ```\n * new Popper(referenceObject, popperNode);\n * ```\n *\n * NB: This feature isn't supported in Internet Explorer 10.\n * @name referenceObject\n * @property {Function} data.getBoundingClientRect\n * A function that returns a set of coordinates compatible with the native `getBoundingClientRect` method.\n * @property {number} data.clientWidth\n * An ES6 getter that will return the width of the virtual reference element.\n * @property {number} data.clientHeight\n * An ES6 getter that will return the height of the virtual reference element.\n */\n\n\nPopper.Utils = (typeof window !== 'undefined' ? window : global).PopperUtils;\nPopper.placements = placements;\nPopper.Defaults = Defaults;\n/* harmony default export */ __webpack_exports__[\"a\"] = (Popper);\n/* WEBPACK VAR INJECTION */}.call(this, __webpack_require__(41)))\n\n/***/ }),\n/* 39 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.uncontrolledPropTypes = uncontrolledPropTypes;\nexports.isProp = isProp;\nexports.defaultKey = defaultKey;\nexports.canAcceptRef = canAcceptRef;\n\nvar _invariant = _interopRequireDefault(__webpack_require__(24));\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nvar noop = function noop() {};\n\nfunction readOnlyPropType(handler, name) {\n return function (props, propName) {\n if (props[propName] !== undefined) {\n if (!props[handler]) {\n return new Error(\"You have provided a `\" + propName + \"` prop to `\" + name + \"` \" + (\"without an `\" + handler + \"` handler prop. This will render a read-only field. \") + (\"If the field should be mutable use `\" + defaultKey(propName) + \"`. \") + (\"Otherwise, set `\" + handler + \"`.\"));\n }\n }\n };\n}\n\nfunction uncontrolledPropTypes(controlledValues, displayName) {\n var propTypes = {};\n Object.keys(controlledValues).forEach(function (prop) {\n // add default propTypes for folks that use runtime checks\n propTypes[defaultKey(prop)] = noop;\n\n if (false) { var handler; }\n });\n return propTypes;\n}\n\nfunction isProp(props, prop) {\n return props[prop] !== undefined;\n}\n\nfunction defaultKey(key) {\n return 'default' + key.charAt(0).toUpperCase() + key.substr(1);\n}\n/**\n * Copyright (c) 2013-present, Facebook, Inc.\n * All rights reserved.\n *\n * This source code is licensed under the BSD-style license found in the\n * LICENSE file in the root directory of this source tree. An additional grant\n * of patent rights can be found in the PATENTS file in the same directory.\n */\n\n\nfunction canAcceptRef(component) {\n return !!component && (typeof component !== 'function' || component.prototype && component.prototype.isReactComponent);\n}\n\n/***/ }),\n/* 40 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nvar _interopRequireDefault = __webpack_require__(5);\n\nexports.__esModule = true;\nexports.default = camelizeStyleName;\n\nvar _camelize = _interopRequireDefault(__webpack_require__(33));\n/**\n * Copyright 2014-2015, Facebook, Inc.\n * All rights reserved.\n * https://github.com/facebook/react/blob/2aeb8a2a6beb00617a4217f7f8284924fa2ad819/src/vendor/core/camelizeStyleName.js\n */\n\n\nvar msPattern = /^-ms-/;\n\nfunction camelizeStyleName(string) {\n return (0, _camelize.default)(string.replace(msPattern, 'ms-'));\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 41 */\n/***/ (function(module, exports) {\n\nvar g; // This works in non-strict mode\n\ng = function () {\n return this;\n}();\n\ntry {\n // This works if eval is allowed (see CSP)\n g = g || new Function(\"return this\")();\n} catch (e) {\n // This works if the window reference is available\n if (typeof window === \"object\") g = window;\n} // g can still be undefined, but nothing to do about it...\n// We return undefined, instead of nothing here, so it's\n// easier to handle this case. if(!global) { ...}\n\n\nmodule.exports = g;\n\n/***/ }),\n/* 42 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = void 0;\n\nvar _contains = _interopRequireDefault(__webpack_require__(22));\n\nvar _listen = _interopRequireDefault(__webpack_require__(30));\n\nvar _propTypes = _interopRequireDefault(__webpack_require__(0));\n\nvar _react = _interopRequireDefault(__webpack_require__(1));\n\nvar _reactDom = _interopRequireDefault(__webpack_require__(6));\n\nvar _ownerDocument = _interopRequireDefault(__webpack_require__(45));\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction _inheritsLoose(subClass, superClass) {\n subClass.prototype = Object.create(superClass.prototype);\n subClass.prototype.constructor = subClass;\n subClass.__proto__ = superClass;\n}\n\nfunction _assertThisInitialized(self) {\n if (self === void 0) {\n throw new ReferenceError(\"this hasn't been initialised - super() hasn't been called\");\n }\n\n return self;\n}\n\nvar escapeKeyCode = 27;\n\nvar noop = function noop() {};\n\nfunction isLeftClickEvent(event) {\n return event.button === 0;\n}\n\nfunction isModifiedEvent(event) {\n return !!(event.metaKey || event.altKey || event.ctrlKey || event.shiftKey);\n}\n/**\n * The `` component registers your callback on the document\n * when rendered. Powers the `` component. This is used achieve modal\n * style behavior where your callback is triggered when the user tries to\n * interact with the rest of the document or hits the `esc` key.\n */\n\n\nvar RootCloseWrapper =\n/*#__PURE__*/\nfunction (_React$Component) {\n _inheritsLoose(RootCloseWrapper, _React$Component);\n\n function RootCloseWrapper(props, context) {\n var _this;\n\n _this = _React$Component.call(this, props, context) || this;\n\n _this.addEventListeners = function () {\n var event = _this.props.event;\n var doc = (0, _ownerDocument.default)(_assertThisInitialized(_assertThisInitialized(_this))); // Use capture for this listener so it fires before React's listener, to\n // avoid false positives in the contains() check below if the target DOM\n // element is removed in the React mouse callback.\n\n _this.removeMouseCaptureListener = (0, _listen.default)(doc, event, _this.handleMouseCapture, true);\n _this.removeMouseListener = (0, _listen.default)(doc, event, _this.handleMouse);\n _this.removeKeyupListener = (0, _listen.default)(doc, 'keyup', _this.handleKeyUp);\n\n if ('ontouchstart' in doc.documentElement) {\n _this.mobileSafariHackListeners = [].slice.call(document.body.children).map(function (el) {\n return (0, _listen.default)(el, 'mousemove', noop);\n });\n }\n };\n\n _this.removeEventListeners = function () {\n if (_this.removeMouseCaptureListener) _this.removeMouseCaptureListener();\n if (_this.removeMouseListener) _this.removeMouseListener();\n if (_this.removeKeyupListener) _this.removeKeyupListener();\n if (_this.mobileSafariHackListeners) _this.mobileSafariHackListeners.forEach(function (remove) {\n return remove();\n });\n };\n\n _this.handleMouseCapture = function (e) {\n _this.preventMouseRootClose = isModifiedEvent(e) || !isLeftClickEvent(e) || (0, _contains.default)(_reactDom.default.findDOMNode(_assertThisInitialized(_assertThisInitialized(_this))), e.target);\n };\n\n _this.handleMouse = function (e) {\n if (!_this.preventMouseRootClose && _this.props.onRootClose) {\n _this.props.onRootClose(e);\n }\n };\n\n _this.handleKeyUp = function (e) {\n if (e.keyCode === escapeKeyCode && _this.props.onRootClose) {\n _this.props.onRootClose(e);\n }\n };\n\n _this.preventMouseRootClose = false;\n return _this;\n }\n\n var _proto = RootCloseWrapper.prototype;\n\n _proto.componentDidMount = function componentDidMount() {\n if (!this.props.disabled) {\n this.addEventListeners();\n }\n };\n\n _proto.componentDidUpdate = function componentDidUpdate(prevProps) {\n if (!this.props.disabled && prevProps.disabled) {\n this.addEventListeners();\n } else if (this.props.disabled && !prevProps.disabled) {\n this.removeEventListeners();\n }\n };\n\n _proto.componentWillUnmount = function componentWillUnmount() {\n if (!this.props.disabled) {\n this.removeEventListeners();\n }\n };\n\n _proto.render = function render() {\n return this.props.children;\n };\n\n return RootCloseWrapper;\n}(_react.default.Component);\n\nRootCloseWrapper.displayName = 'RootCloseWrapper';\nRootCloseWrapper.propTypes = {\n /**\n * Callback fired after click or mousedown. Also triggers when user hits `esc`.\n */\n onRootClose: _propTypes.default.func,\n\n /**\n * Children to render.\n */\n children: _propTypes.default.element,\n\n /**\n * Disable the the RootCloseWrapper, preventing it from triggering `onRootClose`.\n */\n disabled: _propTypes.default.bool,\n\n /**\n * Choose which document mouse event to bind to.\n */\n event: _propTypes.default.oneOf(['click', 'mousedown'])\n};\nRootCloseWrapper.defaultProps = {\n event: 'click'\n};\nvar _default = RootCloseWrapper;\nexports.default = _default;\nmodule.exports = exports.default;\n\n/***/ }),\n/* 43 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nvar _interopRequireDefault = __webpack_require__(5);\n\nexports.__esModule = true;\nexports.default = void 0;\n\nvar _inDOM = _interopRequireDefault(__webpack_require__(10));\n\nvar on = function on() {};\n\nif (_inDOM.default) {\n on = function () {\n if (document.addEventListener) return function (node, eventName, handler, capture) {\n return node.addEventListener(eventName, handler, capture || false);\n };else if (document.attachEvent) return function (node, eventName, handler) {\n return node.attachEvent('on' + eventName, function (e) {\n e = e || window.event;\n e.target = e.target || e.srcElement;\n e.currentTarget = node;\n handler.call(node, e);\n });\n };\n }();\n}\n\nvar _default = on;\nexports.default = _default;\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 44 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nvar _interopRequireDefault = __webpack_require__(5);\n\nexports.__esModule = true;\nexports.default = void 0;\n\nvar _inDOM = _interopRequireDefault(__webpack_require__(10));\n\nvar off = function off() {};\n\nif (_inDOM.default) {\n off = function () {\n if (document.addEventListener) return function (node, eventName, handler, capture) {\n return node.removeEventListener(eventName, handler, capture || false);\n };else if (document.attachEvent) return function (node, eventName, handler) {\n return node.detachEvent('on' + eventName, handler);\n };\n }();\n}\n\nvar _default = off;\nexports.default = _default;\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 45 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = _default;\n\nvar _reactDom = _interopRequireDefault(__webpack_require__(6));\n\nvar _ownerDocument = _interopRequireDefault(__webpack_require__(16));\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction _default(componentOrElement) {\n return (0, _ownerDocument.default)(_reactDom.default.findDOMNode(componentOrElement));\n}\n\nmodule.exports = exports.default;\n\n/***/ }),\n/* 46 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = forwardRef;\n\nvar _react = _interopRequireDefault(__webpack_require__(1));\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction forwardRef(renderFn, _ref) {\n var displayName = _ref.displayName,\n propTypes = _ref.propTypes,\n defaultProps = _ref.defaultProps,\n _ref$allowFallback = _ref.allowFallback,\n allowFallback = _ref$allowFallback === void 0 ? false : _ref$allowFallback;\n\n var render = function render(props, ref) {\n return renderFn(props, ref);\n };\n\n Object.assign(render, {\n displayName: displayName\n });\n if (_react.default.forwardRef || !allowFallback) return Object.assign(_react.default.forwardRef(render), {\n propTypes: propTypes,\n defaultProps: defaultProps\n });\n return Object.assign(function (props) {\n return render(props, null);\n }, {\n displayName: displayName,\n propTypes: propTypes,\n defaultProps: defaultProps\n });\n}\n\n/***/ }),\n/* 47 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = hasClass;\n\nfunction hasClass(element, className) {\n if (element.classList) return !!className && element.classList.contains(className);else return (\" \" + (element.className.baseVal || element.className) + \" \").indexOf(\" \" + className + \" \") !== -1;\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 48 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = void 0;\n\nvar _propTypes = _interopRequireDefault(__webpack_require__(0));\n\nvar _componentOrElement = _interopRequireDefault(__webpack_require__(20));\n\nvar _react = _interopRequireDefault(__webpack_require__(1));\n\nvar _reactDom = _interopRequireDefault(__webpack_require__(6));\n\nvar _WaitForContainer = _interopRequireDefault(__webpack_require__(49));\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction _inheritsLoose(subClass, superClass) {\n subClass.prototype = Object.create(superClass.prototype);\n subClass.prototype.constructor = subClass;\n subClass.__proto__ = superClass;\n}\n/**\n * The `` component renders its children into a new \"subtree\" outside of current component hierarchy.\n * You can think of it as a declarative `appendChild()`, or jQuery's `$.fn.appendTo()`.\n * The children of `` component will be appended to the `container` specified.\n */\n\n\nvar Portal =\n/*#__PURE__*/\nfunction (_React$Component) {\n _inheritsLoose(Portal, _React$Component);\n\n function Portal() {\n return _React$Component.apply(this, arguments) || this;\n }\n\n var _proto = Portal.prototype;\n\n _proto.render = function render() {\n var _this = this;\n\n return this.props.children ? _react.default.createElement(_WaitForContainer.default, {\n container: this.props.container,\n onContainerResolved: this.props.onRendered\n }, function (container) {\n return _reactDom.default.createPortal(_this.props.children, container);\n }) : null;\n };\n\n return Portal;\n}(_react.default.Component);\n\nPortal.displayName = 'Portal';\nPortal.propTypes = {\n /**\n * A Node, Component instance, or function that returns either. The `container` will have the Portal children\n * appended to it.\n */\n container: _propTypes.default.oneOfType([_componentOrElement.default, _propTypes.default.func]),\n onRendered: _propTypes.default.func\n};\nvar _default = Portal;\nexports.default = _default;\nmodule.exports = exports.default;\n\n/***/ }),\n/* 49 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = void 0;\n\nvar _propTypes = _interopRequireDefault(__webpack_require__(0));\n\nvar _componentOrElement = _interopRequireDefault(__webpack_require__(20));\n\nvar _inDOM = _interopRequireDefault(__webpack_require__(10));\n\nvar _ownerDocument = _interopRequireDefault(__webpack_require__(16));\n\nvar _react = _interopRequireDefault(__webpack_require__(1));\n\nvar _reactDom = _interopRequireDefault(__webpack_require__(6));\n\nvar _getContainer = _interopRequireDefault(__webpack_require__(50));\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction _assertThisInitialized(self) {\n if (self === void 0) {\n throw new ReferenceError(\"this hasn't been initialised - super() hasn't been called\");\n }\n\n return self;\n}\n\nfunction _inheritsLoose(subClass, superClass) {\n subClass.prototype = Object.create(superClass.prototype);\n subClass.prototype.constructor = subClass;\n subClass.__proto__ = superClass;\n}\n\nvar propTypes = {\n /**\n * A Node, Component instance, or function that returns either. The `container` will have the Portal children\n * appended to it.\n */\n container: _propTypes.default.oneOfType([_componentOrElement.default, _propTypes.default.func]),\n onContainerResolved: _propTypes.default.func\n};\n\nvar WaitForContainer =\n/*#__PURE__*/\nfunction (_React$Component) {\n _inheritsLoose(WaitForContainer, _React$Component);\n\n function WaitForContainer() {\n var _this;\n\n for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {\n args[_key] = arguments[_key];\n }\n\n _this = _React$Component.call.apply(_React$Component, [this].concat(args)) || this;\n if (!_inDOM.default) return _assertThisInitialized(_this);\n var container = _this.props.container;\n if (typeof container === 'function') container = container();\n\n if (container && !_reactDom.default.findDOMNode(container)) {\n // The container is a React component that has not yet been rendered.\n // Don't set the container node yet.\n return _assertThisInitialized(_this);\n }\n\n _this.setContainer(container);\n\n return _this;\n }\n\n var _proto = WaitForContainer.prototype;\n\n _proto.UNSAFE_componentWillReceiveProps = function UNSAFE_componentWillReceiveProps(nextProps) {\n if (nextProps.container !== this.props.container) {\n this.setContainer(nextProps.container);\n }\n };\n\n _proto.componentDidMount = function componentDidMount() {\n if (!this._container) {\n this.setContainer(this.props.container);\n this.forceUpdate(this.props.onContainerResolved);\n } else if (this.props.onContainerResolved) {\n this.props.onContainerResolved();\n }\n };\n\n _proto.componentWillUnmount = function componentWillUnmount() {\n this._container = null;\n };\n\n _proto.setContainer = function setContainer(container) {\n this._container = (0, _getContainer.default)(container, (0, _ownerDocument.default)().body);\n };\n\n _proto.render = function render() {\n return this._container ? this.props.children(this._container) : null;\n };\n\n return WaitForContainer;\n}(_react.default.Component);\n\nWaitForContainer.propTypes = propTypes;\nvar _default = WaitForContainer;\nexports.default = _default;\nmodule.exports = exports.default;\n\n/***/ }),\n/* 50 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = getContainer;\n\nvar _reactDom = _interopRequireDefault(__webpack_require__(6));\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction getContainer(container, defaultContainer) {\n if (container == null) return defaultContainer;\n container = typeof container === 'function' ? container() : container;\n return _reactDom.default.findDOMNode(container) || null;\n}\n\nmodule.exports = exports.default;\n\n/***/ }),\n/* 51 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nvar _interopRequireDefault = __webpack_require__(5);\n\nexports.__esModule = true;\nexports.default = void 0;\n\nvar _end = _interopRequireDefault(__webpack_require__(23));\n\nexports.end = _end.default;\n\nvar _properties = _interopRequireDefault(__webpack_require__(26));\n\nexports.properties = _properties.default;\nvar _default = {\n end: _end.default,\n properties: _properties.default\n};\nexports.default = _default;\n\n/***/ }),\n/* 52 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = void 0;\n\nvar _matches = _interopRequireDefault(__webpack_require__(72));\n\nvar _querySelectorAll = _interopRequireDefault(__webpack_require__(9));\n\nvar _react = _interopRequireDefault(__webpack_require__(1));\n\nvar _reactDom = _interopRequireDefault(__webpack_require__(6));\n\nvar _propTypes = _interopRequireDefault(__webpack_require__(0));\n\nvar _uncontrollable = _interopRequireDefault(__webpack_require__(7));\n\nvar Popper = _interopRequireWildcard(__webpack_require__(31));\n\nvar _DropdownContext = _interopRequireDefault(__webpack_require__(29));\n\nvar _DropdownMenu = _interopRequireDefault(__webpack_require__(35));\n\nvar _DropdownToggle = _interopRequireDefault(__webpack_require__(36));\n\nfunction _interopRequireWildcard(obj) {\n if (obj && obj.__esModule) {\n return obj;\n } else {\n var newObj = {};\n\n if (obj != null) {\n for (var key in obj) {\n if (Object.prototype.hasOwnProperty.call(obj, key)) {\n var desc = Object.defineProperty && Object.getOwnPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : {};\n\n if (desc.get || desc.set) {\n Object.defineProperty(newObj, key, desc);\n } else {\n newObj[key] = obj[key];\n }\n }\n }\n }\n\n newObj.default = obj;\n return newObj;\n }\n}\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction _objectWithoutPropertiesLoose(source, excluded) {\n if (source == null) return {};\n var target = {};\n var sourceKeys = Object.keys(source);\n var key, i;\n\n for (i = 0; i < sourceKeys.length; i++) {\n key = sourceKeys[i];\n if (excluded.indexOf(key) >= 0) continue;\n target[key] = source[key];\n }\n\n return target;\n}\n\nfunction _extends() {\n _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n return _extends.apply(this, arguments);\n}\n\nfunction _inheritsLoose(subClass, superClass) {\n subClass.prototype = Object.create(superClass.prototype);\n subClass.prototype.constructor = subClass;\n subClass.__proto__ = superClass;\n}\n\nvar propTypes = {\n /**\n * A render prop that returns the root dropdown element. The `props`\n * argument should spread through to an element containing _both_ the\n * menu and toggle in order to handle keyboard events for focus management.\n *\n * @type {Function ({\n * props: {\n * onKeyDown: (SyntheticEvent) => void,\n * },\n * }) => React.Element}\n */\n children: _propTypes.default.func.isRequired,\n\n /**\n * Determines the direction and location of the Menu in relation to it's Toggle.\n */\n drop: _propTypes.default.oneOf(['up', 'left', 'right', 'down']),\n\n /**\n * Controls the focus behavior for when the Dropdown is opened. Set to\n * `true` to always focus the first menu item, `keyboard` to focus only when\n * navigating via the keyboard, or `false` to disable completely\n *\n * The Default behavior is `false` **unless** the Menu has a `role=\"menu\"`\n * where it will default to `keyboard` to match the recommended [ARIA Authoring practices](https://www.w3.org/TR/wai-aria-practices-1.1/#menubutton).\n */\n focusFirstItemOnShow: _propTypes.default.oneOf([false, true, 'keyboard']),\n\n /**\n * A css slector string that will return __focusable__ menu items.\n * Selectors should be relative to the menu component:\n * e.g. ` > li:not('.disabled')`\n */\n itemSelector: _propTypes.default.string.isRequired,\n\n /**\n * Align the menu to the 'end' side of the placement side of the Dropdown toggle. The default placement is `top-start` or `bottom-start`.\n */\n alignEnd: _propTypes.default.bool,\n\n /**\n * Whether or not the Dropdown is visible.\n *\n * @controllable onToggle\n */\n show: _propTypes.default.bool,\n\n /**\n * A callback fired when the Dropdown wishes to change visibility. Called with the requested\n * `show` value, the DOM event, and the source that fired it: `'click'`,`'keydown'`,`'rootClose'`, or `'select'`.\n *\n * ```js\n * function(\n * isOpen: boolean,\n * event: SyntheticEvent,\n * ): void\n * ```\n *\n * @controllable show\n */\n onToggle: _propTypes.default.func\n};\nvar defaultProps = {\n itemSelector: '* > *'\n};\n/**\n * `Dropdown` is set of structural components for building, accessible dropdown menus with close-on-click,\n * keyboard navigation, and correct focus handling. As with all the react-overlay's\n * components its BYOS (bring your own styles). Dropdown is primarily\n * built from three base components, you should compose to build your Dropdowns.\n *\n * - `Dropdown`, which wraps the menu and toggle, and handles keyboard navigation\n * - `Dropdown.Toggle` generally a button that triggers the menu opening\n * - `Dropdown.Menu` The overlaid, menu, positioned to the toggle with PopperJs\n */\n\nvar Dropdown =\n/*#__PURE__*/\nfunction (_React$Component) {\n _inheritsLoose(Dropdown, _React$Component);\n\n Dropdown.getDerivedStateFromProps = function getDerivedStateFromProps(_ref, prevState) {\n var drop = _ref.drop,\n alignEnd = _ref.alignEnd,\n show = _ref.show;\n var lastShow = prevState.context.show;\n return {\n lastShow: lastShow,\n context: _extends({}, prevState.context, {\n drop: drop,\n show: show,\n alignEnd: alignEnd\n })\n };\n };\n\n function Dropdown(props, context) {\n var _this;\n\n _this = _React$Component.call(this, props, context) || this;\n\n _this.handleClick = function (event) {\n _this.toggleOpen(event);\n };\n\n _this.handleKeyDown = function (event) {\n var key = event.key,\n target = event.target; // Second only to https://github.com/twbs/bootstrap/blob/8cfbf6933b8a0146ac3fbc369f19e520bd1ebdac/js/src/dropdown.js#L400\n // in inscrutability\n\n var isInput = /input|textarea/i.test(target.tagName);\n\n if (isInput && (key === ' ' || key !== 'Escape' && _this.menu.contains(target))) {\n return;\n }\n\n _this._lastSourceEvent = event.type;\n\n switch (key) {\n case 'ArrowUp':\n {\n var next = _this.getNextFocusedChild(target, -1);\n\n if (next && next.focus) next.focus();\n event.preventDefault();\n return;\n }\n\n case 'ArrowDown':\n event.preventDefault();\n\n if (!_this.props.show) {\n _this.toggleOpen(event);\n } else {\n var _next = _this.getNextFocusedChild(target, 1);\n\n if (_next && _next.focus) _next.focus();\n }\n\n return;\n\n case 'Escape':\n case 'Tab':\n _this.props.onToggle(false, event);\n\n break;\n\n default:\n }\n };\n\n _this._focusInDropdown = false;\n _this.menu = null;\n _this.state = {\n context: {\n close: _this.handleClose,\n toggle: _this.handleClick,\n menuRef: function menuRef(r) {\n _this.menu = r;\n },\n toggleRef: function toggleRef(r) {\n var toggleNode = r && _reactDom.default.findDOMNode(r);\n\n _this.setState(function (_ref2) {\n var context = _ref2.context;\n return {\n context: _extends({}, context, {\n toggleNode: toggleNode\n })\n };\n });\n }\n }\n };\n return _this;\n }\n\n var _proto = Dropdown.prototype;\n\n _proto.componentDidUpdate = function componentDidUpdate(prevProps) {\n var show = this.props.show;\n var prevOpen = prevProps.show;\n\n if (show && !prevOpen) {\n this.maybeFocusFirst();\n }\n\n this._lastSourceEvent = null;\n\n if (!show && prevOpen) {\n // if focus hasn't already moved from the menu let's return it\n // to the toggle\n if (this._focusInDropdown) {\n this._focusInDropdown = false;\n this.focus();\n }\n }\n };\n\n _proto.getNextFocusedChild = function getNextFocusedChild(current, offset) {\n if (!this.menu) return null;\n var itemSelector = this.props.itemSelector;\n var items = (0, _querySelectorAll.default)(this.menu, itemSelector);\n var index = items.indexOf(current) + offset;\n index = Math.max(0, Math.min(index, items.length));\n return items[index];\n };\n\n _proto.hasMenuRole = function hasMenuRole() {\n return this.menu && (0, _matches.default)(this.menu, '[role=menu]');\n };\n\n _proto.focus = function focus() {\n var toggleNode = this.state.context.toggleNode;\n\n if (toggleNode && toggleNode.focus) {\n toggleNode.focus();\n }\n };\n\n _proto.maybeFocusFirst = function maybeFocusFirst() {\n var type = this._lastSourceEvent;\n var focusFirstItemOnShow = this.props.focusFirstItemOnShow;\n\n if (focusFirstItemOnShow == null) {\n focusFirstItemOnShow = this.hasMenuRole() ? 'keyboard' : false;\n }\n\n if (focusFirstItemOnShow === false || focusFirstItemOnShow === 'keyboard' && !/^key.+$/.test(type)) {\n return;\n }\n\n var itemSelector = this.props.itemSelector;\n var first = (0, _querySelectorAll.default)(this.menu, itemSelector)[0];\n if (first && first.focus) first.focus();\n };\n\n _proto.toggleOpen = function toggleOpen(event) {\n var show = !this.props.show;\n this.props.onToggle(show, event);\n };\n\n _proto.render = function render() {\n var _this$props = this.props,\n children = _this$props.children,\n props = _objectWithoutPropertiesLoose(_this$props, [\"children\"]);\n\n delete props.onToggle;\n\n if (this.menu && this.state.lastShow && !this.props.show) {\n this._focusInDropdown = this.menu.contains(document.activeElement);\n }\n\n return _react.default.createElement(_DropdownContext.default.Provider, {\n value: this.state.context\n }, _react.default.createElement(Popper.Manager, null, children({\n props: {\n onKeyDown: this.handleKeyDown\n }\n })));\n };\n\n return Dropdown;\n}(_react.default.Component);\n\nDropdown.displayName = 'ReactOverlaysDropdown';\nDropdown.propTypes = propTypes;\nDropdown.defaultProps = defaultProps;\nvar UncontrolledDropdown = (0, _uncontrollable.default)(Dropdown, {\n show: 'onToggle'\n});\nUncontrolledDropdown.Menu = _DropdownMenu.default;\nUncontrolledDropdown.Toggle = _DropdownToggle.default;\nvar _default = UncontrolledDropdown;\nexports.default = _default;\nmodule.exports = exports.default;\n\n/***/ }),\n/* 53 */\n/***/ (function(module, exports) {\n\nfunction _objectWithoutPropertiesLoose(source, excluded) {\n if (source == null) return {};\n var target = {};\n var sourceKeys = Object.keys(source);\n var key, i;\n\n for (i = 0; i < sourceKeys.length; i++) {\n key = sourceKeys[i];\n if (excluded.indexOf(key) >= 0) continue;\n target[key] = source[key];\n }\n\n return target;\n}\n\nmodule.exports = _objectWithoutPropertiesLoose;\n\n/***/ }),\n/* 54 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\n\nvar _react = __webpack_require__(1);\n\nvar _react2 = _interopRequireDefault(_react);\n\nvar _implementation = __webpack_require__(73);\n\nvar _implementation2 = _interopRequireDefault(_implementation);\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nexports.default = _react2.default.createContext || _implementation2.default;\nmodule.exports = exports['default'];\n\n/***/ }),\n/* 55 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = mapContextToProps;\n\nvar _react = _interopRequireDefault(__webpack_require__(1));\n\nvar _forwardRef = _interopRequireDefault(__webpack_require__(32));\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction _extends() {\n _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n return _extends.apply(this, arguments);\n}\n\nvar getDisplayName = function getDisplayName(Component) {\n var name = typeof Component === 'string' ? Component : Component.name || Component.displayName;\n return name ? \"ContextTransform(\" + name + \")\" : 'ContextTransform';\n};\n\nvar ensureConsumer = function ensureConsumer(c) {\n return c.Consumer || c;\n};\n\nfunction $mapContextToProps(_ref, Component) {\n var maybeArrayOfConsumers = _ref.consumers,\n mapToProps = _ref.mapToProps,\n displayName = _ref.displayName,\n _ref$forwardRefAs = _ref.forwardRefAs,\n forwardRefAs = _ref$forwardRefAs === void 0 ? 'ref' : _ref$forwardRefAs;\n var consumers = maybeArrayOfConsumers;\n\n if (!Array.isArray(maybeArrayOfConsumers)) {\n consumers = [maybeArrayOfConsumers];\n }\n\n var SingleConsumer = ensureConsumer(consumers[0]);\n\n function singleRender(props, ref) {\n var _extends2;\n\n var propsWithRef = _extends((_extends2 = {}, _extends2[forwardRefAs] = ref, _extends2), props);\n\n return _react.default.createElement(SingleConsumer, null, function (value) {\n return _react.default.createElement(Component, _extends({}, propsWithRef, mapToProps(value, props)));\n });\n }\n\n function multiRender(props, ref) {\n var _extends3;\n\n var propsWithRef = _extends((_extends3 = {}, _extends3[forwardRefAs] = ref, _extends3), props);\n\n return consumers.reduceRight(function (inner, Context) {\n return function () {\n for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {\n args[_key] = arguments[_key];\n }\n\n var Consumer = ensureConsumer(Context);\n return _react.default.createElement(Consumer, null, function (value) {\n return inner.apply(void 0, args.concat([value]));\n });\n };\n }, function () {\n for (var _len2 = arguments.length, contexts = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {\n contexts[_key2] = arguments[_key2];\n }\n\n return _react.default.createElement(Component, _extends({}, propsWithRef, mapToProps.apply(void 0, contexts.concat([props]))));\n })();\n }\n\n var contextTransform = consumers.length === 1 ? singleRender : multiRender;\n return (0, _forwardRef.default)(contextTransform, {\n displayName: displayName || getDisplayName(Component)\n });\n}\n\nfunction mapContextToProps(maybeOpts, mapToProps, Component) {\n if (arguments.length === 2) return $mapContextToProps(maybeOpts, mapToProps);\n return $mapContextToProps({\n consumers: maybeOpts,\n mapToProps: mapToProps\n }, Component);\n}\n\n/***/ }),\n/* 56 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = void 0;\n\nvar _activeElement = _interopRequireDefault(__webpack_require__(79));\n\nvar _contains = _interopRequireDefault(__webpack_require__(22));\n\nvar _inDOM = _interopRequireDefault(__webpack_require__(10));\n\nvar _listen = _interopRequireDefault(__webpack_require__(30));\n\nvar _propTypes = _interopRequireDefault(__webpack_require__(0));\n\nvar _componentOrElement = _interopRequireDefault(__webpack_require__(20));\n\nvar _elementType = _interopRequireDefault(__webpack_require__(28));\n\nvar _react = _interopRequireDefault(__webpack_require__(1));\n\nvar _reactDom = _interopRequireDefault(__webpack_require__(6));\n\nvar _ModalManager = _interopRequireDefault(__webpack_require__(37));\n\nvar _Portal = _interopRequireDefault(__webpack_require__(48));\n\nvar _getContainer = _interopRequireDefault(__webpack_require__(50));\n\nvar _ownerDocument = _interopRequireDefault(__webpack_require__(45));\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction _extends() {\n _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n return _extends.apply(this, arguments);\n}\n\nfunction _objectWithoutPropertiesLoose(source, excluded) {\n if (source == null) return {};\n var target = {};\n var sourceKeys = Object.keys(source);\n var key, i;\n\n for (i = 0; i < sourceKeys.length; i++) {\n key = sourceKeys[i];\n if (excluded.indexOf(key) >= 0) continue;\n target[key] = source[key];\n }\n\n return target;\n}\n\nfunction _inheritsLoose(subClass, superClass) {\n subClass.prototype = Object.create(superClass.prototype);\n subClass.prototype.constructor = subClass;\n subClass.__proto__ = superClass;\n}\n\nfunction _assertThisInitialized(self) {\n if (self === void 0) {\n throw new ReferenceError(\"this hasn't been initialised - super() hasn't been called\");\n }\n\n return self;\n}\n\nvar modalManager = new _ModalManager.default();\n\nfunction omitProps(props, propTypes) {\n var keys = Object.keys(props);\n var newProps = {};\n keys.map(function (prop) {\n if (!Object.prototype.hasOwnProperty.call(propTypes, prop)) {\n newProps[prop] = props[prop];\n }\n });\n return newProps;\n}\n/**\n * Love them or hate them, `` provides a solid foundation for creating dialogs, lightboxes, or whatever else.\n * The Modal component renders its `children` node in front of a backdrop component.\n *\n * The Modal offers a few helpful features over using just a `` component and some styles:\n *\n * - Manages dialog stacking when one-at-a-time just isn't enough.\n * - Creates a backdrop, for disabling interaction below the modal.\n * - It properly manages focus; moving to the modal content, and keeping it there until the modal is closed.\n * - It disables scrolling of the page content while open.\n * - Adds the appropriate ARIA roles are automatically.\n * - Easily pluggable animations via a `` component.\n *\n * Note that, in the same way the backdrop element prevents users from clicking or interacting\n * with the page content underneath the Modal, Screen readers also need to be signaled to not to\n * interact with page content while the Modal is open. To do this, we use a common technique of applying\n * the `aria-hidden='true'` attribute to the non-Modal elements in the Modal `container`. This means that for\n * a Modal to be truly modal, it should have a `container` that is _outside_ your app's\n * React hierarchy (such as the default: document.body).\n */\n\n\nvar Modal =\n/*#__PURE__*/\nfunction (_React$Component) {\n _inheritsLoose(Modal, _React$Component);\n\n function Modal() {\n var _this;\n\n for (var _len = arguments.length, _args = new Array(_len), _key = 0; _key < _len; _key++) {\n _args[_key] = arguments[_key];\n }\n\n _this = _React$Component.call.apply(_React$Component, [this].concat(_args)) || this;\n _this.state = {\n exited: !_this.props.show\n };\n\n _this.onPortalRendered = function () {\n if (_this.props.onShow) {\n _this.props.onShow();\n } // autofocus after onShow, to not trigger a focus event for previous\n // modals before this one is shown.\n\n\n _this.autoFocus();\n };\n\n _this.onShow = function () {\n var doc = (0, _ownerDocument.default)(_assertThisInitialized(_assertThisInitialized(_this)));\n var container = (0, _getContainer.default)(_this.props.container, doc.body);\n\n _this.props.manager.add(_assertThisInitialized(_assertThisInitialized(_this)), container, _this.props.containerClassName);\n\n _this.removeKeydownListener = (0, _listen.default)(doc, 'keydown', _this.handleDocumentKeyDown);\n _this.removeFocusListener = (0, _listen.default)(doc, 'focus', // the timeout is necessary b/c this will run before the new modal is mounted\n // and so steals focus from it\n function () {\n return setTimeout(_this.enforceFocus);\n }, true);\n };\n\n _this.onHide = function () {\n _this.props.manager.remove(_assertThisInitialized(_assertThisInitialized(_this)));\n\n _this.removeKeydownListener();\n\n _this.removeFocusListener();\n\n if (_this.props.restoreFocus) {\n _this.restoreLastFocus();\n }\n };\n\n _this.setDialogRef = function (ref) {\n _this.dialog = ref;\n };\n\n _this.setBackdropRef = function (ref) {\n _this.backdrop = ref && _reactDom.default.findDOMNode(ref);\n };\n\n _this.handleHidden = function () {\n _this.setState({\n exited: true\n });\n\n _this.onHide();\n\n if (_this.props.onExited) {\n var _this$props;\n\n (_this$props = _this.props).onExited.apply(_this$props, arguments);\n }\n };\n\n _this.handleBackdropClick = function (e) {\n if (e.target !== e.currentTarget) {\n return;\n }\n\n if (_this.props.onBackdropClick) {\n _this.props.onBackdropClick(e);\n }\n\n if (_this.props.backdrop === true) {\n _this.props.onHide();\n }\n };\n\n _this.handleDocumentKeyDown = function (e) {\n if (_this.props.keyboard && e.keyCode === 27 && _this.isTopModal()) {\n if (_this.props.onEscapeKeyDown) {\n _this.props.onEscapeKeyDown(e);\n }\n\n _this.props.onHide();\n }\n };\n\n _this.enforceFocus = function () {\n if (!_this.props.enforceFocus || !_this._isMounted || !_this.isTopModal()) {\n return;\n }\n\n var currentActiveElement = (0, _activeElement.default)((0, _ownerDocument.default)(_assertThisInitialized(_assertThisInitialized(_this))));\n\n if (_this.dialog && !(0, _contains.default)(_this.dialog, currentActiveElement)) {\n _this.dialog.focus();\n }\n };\n\n _this.renderBackdrop = function () {\n var _this$props2 = _this.props,\n renderBackdrop = _this$props2.renderBackdrop,\n Transition = _this$props2.backdropTransition;\n var backdrop = renderBackdrop({\n ref: _this.setBackdropRef,\n onClick: _this.handleBackdropClick\n });\n\n if (Transition) {\n backdrop = _react.default.createElement(Transition, {\n appear: true,\n in: _this.props.show\n }, backdrop);\n }\n\n return backdrop;\n };\n\n return _this;\n }\n\n Modal.getDerivedStateFromProps = function getDerivedStateFromProps(nextProps) {\n if (nextProps.show) {\n return {\n exited: false\n };\n } else if (!nextProps.transition) {\n // Otherwise let handleHidden take care of marking exited.\n return {\n exited: true\n };\n }\n\n return null;\n };\n\n var _proto = Modal.prototype;\n\n _proto.getSnapshotBeforeUpdate = function getSnapshotBeforeUpdate(prevProps) {\n if (_inDOM.default && !prevProps.show && this.props.show) {\n this.lastFocus = (0, _activeElement.default)();\n }\n\n return null;\n };\n\n _proto.componentDidMount = function componentDidMount() {\n this._isMounted = true;\n\n if (this.props.show) {\n this.onShow();\n }\n };\n\n _proto.componentDidUpdate = function componentDidUpdate(prevProps) {\n var transition = this.props.transition;\n\n if (prevProps.show && !this.props.show && !transition) {\n // Otherwise handleHidden will call this.\n this.onHide();\n } else if (!prevProps.show && this.props.show) {\n this.onShow();\n }\n };\n\n _proto.componentWillUnmount = function componentWillUnmount() {\n var _this$props3 = this.props,\n show = _this$props3.show,\n transition = _this$props3.transition;\n this._isMounted = false;\n\n if (show || transition && !this.state.exited) {\n this.onHide();\n }\n };\n\n _proto.autoFocus = function autoFocus() {\n if (!this.props.autoFocus) return;\n var currentActiveElement = (0, _activeElement.default)((0, _ownerDocument.default)(this));\n\n if (this.dialog && !(0, _contains.default)(this.dialog, currentActiveElement)) {\n this.lastFocus = currentActiveElement;\n this.dialog.focus();\n }\n };\n\n _proto.restoreLastFocus = function restoreLastFocus() {\n // Support: <=IE11 doesn't support `focus()` on svg elements (RB: #917)\n if (this.lastFocus && this.lastFocus.focus) {\n this.lastFocus.focus();\n this.lastFocus = null;\n }\n };\n\n _proto.isTopModal = function isTopModal() {\n return this.props.manager.isTopModal(this);\n };\n\n _proto.render = function render() {\n var _this$props4 = this.props,\n show = _this$props4.show,\n container = _this$props4.container,\n children = _this$props4.children,\n renderDialog = _this$props4.renderDialog,\n _this$props4$role = _this$props4.role,\n role = _this$props4$role === void 0 ? 'dialog' : _this$props4$role,\n Transition = _this$props4.transition,\n backdrop = _this$props4.backdrop,\n className = _this$props4.className,\n style = _this$props4.style,\n onExit = _this$props4.onExit,\n onExiting = _this$props4.onExiting,\n onEnter = _this$props4.onEnter,\n onEntering = _this$props4.onEntering,\n onEntered = _this$props4.onEntered,\n props = _objectWithoutPropertiesLoose(_this$props4, [\"show\", \"container\", \"children\", \"renderDialog\", \"role\", \"transition\", \"backdrop\", \"className\", \"style\", \"onExit\", \"onExiting\", \"onEnter\", \"onEntering\", \"onEntered\"]);\n\n if (!(show || Transition && !this.state.exited)) {\n return null;\n }\n\n var dialogProps = _extends({\n role: role,\n ref: this.setDialogRef,\n // apparently only works on the dialog role element\n 'aria-modal': role === 'dialog' ? true : undefined\n }, omitProps(props, Modal.propTypes), {\n style: style,\n className: className,\n tabIndex: '-1'\n });\n\n var dialog = renderDialog ? renderDialog(dialogProps) : _react.default.createElement(\"div\", dialogProps, _react.default.cloneElement(children, {\n role: 'document'\n }));\n\n if (Transition) {\n dialog = _react.default.createElement(Transition, {\n appear: true,\n unmountOnExit: true,\n in: show,\n onExit: onExit,\n onExiting: onExiting,\n onExited: this.handleHidden,\n onEnter: onEnter,\n onEntering: onEntering,\n onEntered: onEntered\n }, dialog);\n }\n\n return _react.default.createElement(_Portal.default, {\n container: container,\n onRendered: this.onPortalRendered\n }, _react.default.createElement(_react.default.Fragment, null, backdrop && this.renderBackdrop(), dialog));\n };\n\n return Modal;\n}(_react.default.Component);\n\nModal.propTypes = {\n /**\n * Set the visibility of the Modal\n */\n show: _propTypes.default.bool,\n\n /**\n * A Node, Component instance, or function that returns either. The Modal is appended to it's container element.\n *\n * For the sake of assistive technologies, the container should usually be the document body, so that the rest of the\n * page content can be placed behind a virtual backdrop as well as a visual one.\n */\n container: _propTypes.default.oneOfType([_componentOrElement.default, _propTypes.default.func]),\n\n /**\n * A callback fired when the Modal is opening.\n */\n onShow: _propTypes.default.func,\n\n /**\n * A callback fired when either the backdrop is clicked, or the escape key is pressed.\n *\n * The `onHide` callback only signals intent from the Modal,\n * you must actually set the `show` prop to `false` for the Modal to close.\n */\n onHide: _propTypes.default.func,\n\n /**\n * Include a backdrop component.\n */\n backdrop: _propTypes.default.oneOfType([_propTypes.default.bool, _propTypes.default.oneOf(['static'])]),\n\n /**\n * A function that returns the dialog component. Useful for custom\n * rendering. **Note:** the component should make sure to apply the provided ref.\n *\n * ```js\n * renderDialog={props => }\n * ```\n */\n renderDialog: _propTypes.default.func,\n\n /**\n * A function that returns a backdrop component. Useful for custom\n * backdrop rendering.\n *\n * ```js\n * renderBackdrop={props => }\n * ```\n */\n renderBackdrop: _propTypes.default.func,\n\n /**\n * A callback fired when the escape key, if specified in `keyboard`, is pressed.\n */\n onEscapeKeyDown: _propTypes.default.func,\n\n /**\n * A callback fired when the backdrop, if specified, is clicked.\n */\n onBackdropClick: _propTypes.default.func,\n\n /**\n * A css class or set of classes applied to the modal container when the modal is open,\n * and removed when it is closed.\n */\n containerClassName: _propTypes.default.string,\n\n /**\n * Close the modal when escape key is pressed\n */\n keyboard: _propTypes.default.bool,\n\n /**\n * A `react-transition-group@2.0.0` `` component used\n * to control animations for the dialog component.\n */\n transition: _elementType.default,\n\n /**\n * A `react-transition-group@2.0.0` `` component used\n * to control animations for the backdrop components.\n */\n backdropTransition: _elementType.default,\n\n /**\n * When `true` The modal will automatically shift focus to itself when it opens, and\n * replace it to the last focused element when it closes. This also\n * works correctly with any Modal children that have the `autoFocus` prop.\n *\n * Generally this should never be set to `false` as it makes the Modal less\n * accessible to assistive technologies, like screen readers.\n */\n autoFocus: _propTypes.default.bool,\n\n /**\n * When `true` The modal will prevent focus from leaving the Modal while open.\n *\n * Generally this should never be set to `false` as it makes the Modal less\n * accessible to assistive technologies, like screen readers.\n */\n enforceFocus: _propTypes.default.bool,\n\n /**\n * When `true` The modal will restore focus to previously focused element once\n * modal is hidden\n */\n restoreFocus: _propTypes.default.bool,\n\n /**\n * Callback fired before the Modal transitions in\n */\n onEnter: _propTypes.default.func,\n\n /**\n * Callback fired as the Modal begins to transition in\n */\n onEntering: _propTypes.default.func,\n\n /**\n * Callback fired after the Modal finishes transitioning in\n */\n onEntered: _propTypes.default.func,\n\n /**\n * Callback fired right before the Modal transitions out\n */\n onExit: _propTypes.default.func,\n\n /**\n * Callback fired as the Modal begins to transition out\n */\n onExiting: _propTypes.default.func,\n\n /**\n * Callback fired after the Modal finishes transitioning out\n */\n onExited: _propTypes.default.func,\n\n /**\n * A ModalManager instance used to track and manage the state of open\n * Modals. Useful when customizing how modals interact within a container\n */\n manager: _propTypes.default.object.isRequired\n};\nModal.defaultProps = {\n show: false,\n role: 'dialog',\n backdrop: true,\n keyboard: true,\n autoFocus: true,\n enforceFocus: true,\n restoreFocus: true,\n onHide: function onHide() {},\n manager: modalManager,\n renderBackdrop: function renderBackdrop(props) {\n return _react.default.createElement(\"div\", props);\n }\n};\nModal.Manager = _ModalManager.default;\nvar _default = Modal;\nexports.default = _default;\nmodule.exports = exports.default;\n\n/***/ }),\n/* 57 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = void 0;\n\nvar _propTypes = _interopRequireDefault(__webpack_require__(0));\n\nvar _elementType = _interopRequireDefault(__webpack_require__(28));\n\nvar _componentOrElement = _interopRequireDefault(__webpack_require__(20));\n\nvar _react = _interopRequireDefault(__webpack_require__(1));\n\nvar _reactDom = _interopRequireDefault(__webpack_require__(6));\n\nvar _Portal = _interopRequireDefault(__webpack_require__(48));\n\nvar _RootCloseWrapper = _interopRequireDefault(__webpack_require__(42));\n\nvar _reactPopper = __webpack_require__(31);\n\nvar _forwardRef = _interopRequireDefault(__webpack_require__(46));\n\nvar _WaitForContainer = _interopRequireDefault(__webpack_require__(49));\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction _extends() {\n _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n return _extends.apply(this, arguments);\n}\n\nfunction _objectWithoutPropertiesLoose(source, excluded) {\n if (source == null) return {};\n var target = {};\n var sourceKeys = Object.keys(source);\n var key, i;\n\n for (i = 0; i < sourceKeys.length; i++) {\n key = sourceKeys[i];\n if (excluded.indexOf(key) >= 0) continue;\n target[key] = source[key];\n }\n\n return target;\n}\n\nfunction _inheritsLoose(subClass, superClass) {\n subClass.prototype = Object.create(superClass.prototype);\n subClass.prototype.constructor = subClass;\n subClass.__proto__ = superClass;\n}\n\nfunction _assertThisInitialized(self) {\n if (self === void 0) {\n throw new ReferenceError(\"this hasn't been initialised - super() hasn't been called\");\n }\n\n return self;\n}\n/**\n * Built on top of `` and ``, the overlay component is\n * great for custom tooltip overlays.\n */\n\n\nvar Overlay =\n/*#__PURE__*/\nfunction (_React$Component) {\n _inheritsLoose(Overlay, _React$Component);\n\n function Overlay(props, context) {\n var _this;\n\n _this = _React$Component.call(this, props, context) || this;\n\n _this.handleHidden = function () {\n _this.setState({\n exited: true\n });\n\n if (_this.props.onExited) {\n var _this$props;\n\n (_this$props = _this.props).onExited.apply(_this$props, arguments);\n }\n };\n\n _this.state = {\n exited: !props.show\n };\n _this.onHiddenListener = _this.handleHidden.bind(_assertThisInitialized(_assertThisInitialized(_this)));\n _this._lastTarget = null;\n return _this;\n }\n\n Overlay.getDerivedStateFromProps = function getDerivedStateFromProps(nextProps) {\n if (nextProps.show) {\n return {\n exited: false\n };\n } else if (!nextProps.transition) {\n // Otherwise let handleHidden take care of marking exited.\n return {\n exited: true\n };\n }\n\n return null;\n };\n\n var _proto = Overlay.prototype;\n\n _proto.componentDidMount = function componentDidMount() {\n this.setState({\n target: this.getTarget()\n });\n };\n\n _proto.componentDidUpdate = function componentDidUpdate(prevProps) {\n if (this.props === prevProps) return;\n var target = this.getTarget();\n\n if (target !== this.state.target) {\n this.setState({\n target: target\n });\n }\n };\n\n _proto.getTarget = function getTarget() {\n var target = this.props.target;\n target = typeof target === 'function' ? target() : target;\n return target && _reactDom.default.findDOMNode(target) || null;\n };\n\n _proto.render = function render() {\n var _this2 = this;\n\n var _this$props2 = this.props,\n _0 = _this$props2.target,\n container = _this$props2.container,\n containerPadding = _this$props2.containerPadding,\n placement = _this$props2.placement,\n rootClose = _this$props2.rootClose,\n children = _this$props2.children,\n flip = _this$props2.flip,\n _this$props2$popperCo = _this$props2.popperConfig,\n popperConfig = _this$props2$popperCo === void 0 ? {} : _this$props2$popperCo,\n Transition = _this$props2.transition,\n props = _objectWithoutPropertiesLoose(_this$props2, [\"target\", \"container\", \"containerPadding\", \"placement\", \"rootClose\", \"children\", \"flip\", \"popperConfig\", \"transition\"]);\n\n var target = this.state.target; // Don't un-render the overlay while it's transitioning out.\n\n var mountOverlay = props.show || Transition && !this.state.exited;\n\n if (!mountOverlay) {\n // Don't bother showing anything if we don't have to.\n return null;\n }\n\n var child = children;\n var _popperConfig$modifie = popperConfig.modifiers,\n modifiers = _popperConfig$modifie === void 0 ? {} : _popperConfig$modifie;\n\n var popperProps = _extends({}, popperConfig, {\n placement: placement,\n referenceElement: target,\n enableEvents: props.show,\n modifiers: _extends({}, modifiers, {\n preventOverflow: _extends({\n padding: containerPadding || 5\n }, modifiers.preventOverflow),\n flip: _extends({\n enabled: !!flip\n }, modifiers.preventOverflow)\n })\n });\n\n child = _react.default.createElement(_reactPopper.Popper, popperProps, function (_ref) {\n var arrowProps = _ref.arrowProps,\n style = _ref.style,\n ref = _ref.ref,\n popper = _objectWithoutPropertiesLoose(_ref, [\"arrowProps\", \"style\", \"ref\"]);\n\n _this2.popper = popper;\n\n var innerChild = _this2.props.children(_extends({}, popper, {\n // popper doesn't set the initial placement\n placement: popper.placement || placement,\n show: props.show,\n arrowProps: arrowProps,\n props: {\n ref: ref,\n style: style\n }\n }));\n\n if (Transition) {\n var onExit = props.onExit,\n onExiting = props.onExiting,\n onEnter = props.onEnter,\n onEntering = props.onEntering,\n onEntered = props.onEntered;\n innerChild = _react.default.createElement(Transition, {\n in: props.show,\n appear: true,\n onExit: onExit,\n onExiting: onExiting,\n onExited: _this2.onHiddenListener,\n onEnter: onEnter,\n onEntering: onEntering,\n onEntered: onEntered\n }, innerChild);\n }\n\n return innerChild;\n });\n\n if (rootClose) {\n child = _react.default.createElement(_RootCloseWrapper.default, {\n onRootClose: props.onHide,\n event: props.rootCloseEvent,\n disabled: props.rootCloseDisabled\n }, child);\n }\n\n return _react.default.createElement(_Portal.default, {\n container: container\n }, child);\n };\n\n return Overlay;\n}(_react.default.Component);\n\nOverlay.propTypes = _extends({}, _Portal.default.propTypes, {\n /**\n * Set the visibility of the Overlay\n */\n show: _propTypes.default.bool,\n\n /** Specify where the overlay element is positioned in relation to the target element */\n placement: _propTypes.default.oneOf(_reactPopper.placements),\n\n /**\n * A Node, Component instance, or function that returns either. The `container` will have the Portal children\n * appended to it.\n */\n container: _propTypes.default.oneOfType([_componentOrElement.default, _propTypes.default.func]),\n\n /**\n * Enables the Popper.js `flip` modifier, allowing the Overlay to\n * automatically adjust it's placement in case of overlap with the viewport or toggle.\n * Refer to the [flip docs](https://popper.js.org/popper-documentation.html#modifiers..flip.enabled) for more info\n */\n flip: _propTypes.default.bool,\n\n /**\n * A render prop that returns an element to overlay and position. See\n * the [react-popper documentation](https://github.com/FezVrasta/react-popper#children) for more info.\n *\n * @type {Function ({\n * show: boolean,\n * placement: Placement,\n * outOfBoundaries: ?boolean,\n * scheduleUpdate: () => void,\n * props: {\n * ref: (?HTMLElement) => void,\n * style: { [string]: string | number },\n * aria-labelledby: ?string\n * },\n * arrowProps: {\n * ref: (?HTMLElement) => void,\n * style: { [string]: string | number },\n * },\n * }) => React.Element}\n */\n children: _propTypes.default.func.isRequired,\n\n /**\n * A set of popper options and props passed directly to react-popper's Popper component.\n */\n popperConfig: _propTypes.default.object,\n\n /**\n * Specify whether the overlay should trigger `onHide` when the user clicks outside the overlay\n */\n rootClose: _propTypes.default.bool,\n\n /**\n * Specify event for toggling overlay\n */\n rootCloseEvent: _RootCloseWrapper.default.propTypes.event,\n\n /**\n * Specify disabled for disable RootCloseWrapper\n */\n rootCloseDisabled: _RootCloseWrapper.default.propTypes.disabled,\n\n /**\n * A Callback fired by the Overlay when it wishes to be hidden.\n *\n * __required__ when `rootClose` is `true`.\n *\n * @type func\n */\n onHide: function onHide(props) {\n var propType = _propTypes.default.func;\n\n if (props.rootClose) {\n propType = propType.isRequired;\n }\n\n for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {\n args[_key - 1] = arguments[_key];\n }\n\n return propType.apply(void 0, [props].concat(args));\n },\n\n /**\n * A `react-transition-group@2.0.0` `` component\n * used to animate the overlay as it changes visibility.\n */\n transition: _elementType.default,\n\n /**\n * Callback fired before the Overlay transitions in\n */\n onEnter: _propTypes.default.func,\n\n /**\n * Callback fired as the Overlay begins to transition in\n */\n onEntering: _propTypes.default.func,\n\n /**\n * Callback fired after the Overlay finishes transitioning in\n */\n onEntered: _propTypes.default.func,\n\n /**\n * Callback fired right before the Overlay transitions out\n */\n onExit: _propTypes.default.func,\n\n /**\n * Callback fired as the Overlay begins to transition out\n */\n onExiting: _propTypes.default.func,\n\n /**\n * Callback fired after the Overlay finishes transitioning out\n */\n onExited: _propTypes.default.func\n});\n\nvar _default = (0, _forwardRef.default)(function (props, ref) {\n return (// eslint-disable-next-line react/prop-types\n _react.default.createElement(_WaitForContainer.default, {\n container: props.container\n }, function (container) {\n return _react.default.createElement(Overlay, _extends({}, props, {\n ref: ref,\n container: container\n }));\n })\n );\n}, {\n displayName: 'withContainer(Overlay)'\n});\n\nexports.default = _default;\nmodule.exports = exports.default;\n\n/***/ }),\n/* 58 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n/**\n * Copyright (c) 2013-present, Facebook, Inc.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\n\nvar ReactPropTypesSecret = __webpack_require__(59);\n\nfunction emptyFunction() {}\n\nfunction emptyFunctionWithReset() {}\n\nemptyFunctionWithReset.resetWarningCache = emptyFunction;\n\nmodule.exports = function () {\n function shim(props, propName, componentName, location, propFullName, secret) {\n if (secret === ReactPropTypesSecret) {\n // It is still safe when called from React.\n return;\n }\n\n var err = new Error('Calling PropTypes validators directly is not supported by the `prop-types` package. ' + 'Use PropTypes.checkPropTypes() to call them. ' + 'Read more at http://fb.me/use-check-prop-types');\n err.name = 'Invariant Violation';\n throw err;\n }\n\n ;\n shim.isRequired = shim;\n\n function getShim() {\n return shim;\n }\n\n ; // Important!\n // Keep this list in sync with production version in `./factoryWithTypeCheckers.js`.\n\n var ReactPropTypes = {\n array: shim,\n bool: shim,\n func: shim,\n number: shim,\n object: shim,\n string: shim,\n symbol: shim,\n any: shim,\n arrayOf: getShim,\n element: shim,\n elementType: shim,\n instanceOf: getShim,\n node: shim,\n objectOf: getShim,\n oneOf: getShim,\n oneOfType: getShim,\n shape: getShim,\n exact: getShim,\n checkPropTypes: emptyFunctionWithReset,\n resetWarningCache: emptyFunction\n };\n ReactPropTypes.PropTypes = ReactPropTypes;\n return ReactPropTypes;\n};\n\n/***/ }),\n/* 59 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n/**\n * Copyright (c) 2013-present, Facebook, Inc.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\n\nvar ReactPropTypesSecret = 'SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED';\nmodule.exports = ReactPropTypesSecret;\n\n/***/ }),\n/* 60 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nvar _interopRequireDefault = __webpack_require__(5);\n\nexports.__esModule = true;\nexports.default = hyphenateStyleName;\n\nvar _hyphenate = _interopRequireDefault(__webpack_require__(61));\n/**\n * Copyright 2013-2014, Facebook, Inc.\n * All rights reserved.\n * https://github.com/facebook/react/blob/2aeb8a2a6beb00617a4217f7f8284924fa2ad819/src/vendor/core/hyphenateStyleName.js\n */\n\n\nvar msPattern = /^ms-/;\n\nfunction hyphenateStyleName(string) {\n return (0, _hyphenate.default)(string).replace(msPattern, '-ms-');\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 61 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = hyphenate;\nvar rUpper = /([A-Z])/g;\n\nfunction hyphenate(string) {\n return string.replace(rUpper, '-$1').toLowerCase();\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 62 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nvar _interopRequireDefault = __webpack_require__(5);\n\nexports.__esModule = true;\nexports.default = _getComputedStyle;\n\nvar _camelizeStyle = _interopRequireDefault(__webpack_require__(40));\n\nvar rposition = /^(top|right|bottom|left)$/;\nvar rnumnonpx = /^([+-]?(?:\\d*\\.|)\\d+(?:[eE][+-]?\\d+|))(?!px)[a-z%]+$/i;\n\nfunction _getComputedStyle(node) {\n if (!node) throw new TypeError('No Element passed to `getComputedStyle()`');\n var doc = node.ownerDocument;\n return 'defaultView' in doc ? doc.defaultView.opener ? node.ownerDocument.defaultView.getComputedStyle(node, null) : window.getComputedStyle(node, null) : {\n //ie 8 \"magic\" from: https://github.com/jquery/jquery/blob/1.11-stable/src/css/curCSS.js#L72\n getPropertyValue: function getPropertyValue(prop) {\n var style = node.style;\n prop = (0, _camelizeStyle.default)(prop);\n if (prop == 'float') prop = 'styleFloat';\n var current = node.currentStyle[prop] || null;\n if (current == null && style && style[prop]) current = style[prop];\n\n if (rnumnonpx.test(current) && !rposition.test(prop)) {\n // Remember the original values\n var left = style.left;\n var runStyle = node.runtimeStyle;\n var rsLeft = runStyle && runStyle.left; // Put in the new values to get a computed value out\n\n if (rsLeft) runStyle.left = node.currentStyle.left;\n style.left = prop === 'fontSize' ? '1em' : current;\n current = style.pixelLeft + 'px'; // Revert the changed values\n\n style.left = left;\n if (rsLeft) runStyle.left = rsLeft;\n }\n\n return current;\n }\n };\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 63 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = removeStyle;\n\nfunction removeStyle(node, key) {\n return 'removeProperty' in node.style ? node.style.removeProperty(key) : node.style.removeAttribute(key);\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 64 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = isTransform;\nvar supportedTransforms = /^((translate|rotate|scale)(X|Y|Z|3d)?|matrix(3d)?|perspective|skew(X|Y)?)$/i;\n\nfunction isTransform(property) {\n return !!(property && supportedTransforms.test(property));\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 65 */\n/***/ (function(module, __webpack_exports__, __webpack_require__) {\n\n\"use strict\";\n__webpack_require__.r(__webpack_exports__);\n/* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, \"polyfill\", function() { return polyfill; });\n/**\n * Copyright (c) 2013-present, Facebook, Inc.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n */\nfunction componentWillMount() {\n // Call this.constructor.gDSFP to support sub-classes.\n var state = this.constructor.getDerivedStateFromProps(this.props, this.state);\n\n if (state !== null && state !== undefined) {\n this.setState(state);\n }\n}\n\nfunction componentWillReceiveProps(nextProps) {\n // Call this.constructor.gDSFP to support sub-classes.\n // Use the setState() updater to ensure state isn't stale in certain edge cases.\n function updater(prevState) {\n var state = this.constructor.getDerivedStateFromProps(nextProps, prevState);\n return state !== null && state !== undefined ? state : null;\n } // Binding \"this\" is important for shallow renderer support.\n\n\n this.setState(updater.bind(this));\n}\n\nfunction componentWillUpdate(nextProps, nextState) {\n try {\n var prevProps = this.props;\n var prevState = this.state;\n this.props = nextProps;\n this.state = nextState;\n this.__reactInternalSnapshotFlag = true;\n this.__reactInternalSnapshot = this.getSnapshotBeforeUpdate(prevProps, prevState);\n } finally {\n this.props = prevProps;\n this.state = prevState;\n }\n} // React may warn about cWM/cWRP/cWU methods being deprecated.\n// Add a flag to suppress these warnings for this special case.\n\n\ncomponentWillMount.__suppressDeprecationWarning = true;\ncomponentWillReceiveProps.__suppressDeprecationWarning = true;\ncomponentWillUpdate.__suppressDeprecationWarning = true;\n\nfunction polyfill(Component) {\n var prototype = Component.prototype;\n\n if (!prototype || !prototype.isReactComponent) {\n throw new Error('Can only polyfill class components');\n }\n\n if (typeof Component.getDerivedStateFromProps !== 'function' && typeof prototype.getSnapshotBeforeUpdate !== 'function') {\n return Component;\n } // If new component APIs are defined, \"unsafe\" lifecycles won't be called.\n // Error if any of these lifecycles are present,\n // Because they would work differently between older and newer (16.3+) versions of React.\n\n\n var foundWillMountName = null;\n var foundWillReceivePropsName = null;\n var foundWillUpdateName = null;\n\n if (typeof prototype.componentWillMount === 'function') {\n foundWillMountName = 'componentWillMount';\n } else if (typeof prototype.UNSAFE_componentWillMount === 'function') {\n foundWillMountName = 'UNSAFE_componentWillMount';\n }\n\n if (typeof prototype.componentWillReceiveProps === 'function') {\n foundWillReceivePropsName = 'componentWillReceiveProps';\n } else if (typeof prototype.UNSAFE_componentWillReceiveProps === 'function') {\n foundWillReceivePropsName = 'UNSAFE_componentWillReceiveProps';\n }\n\n if (typeof prototype.componentWillUpdate === 'function') {\n foundWillUpdateName = 'componentWillUpdate';\n } else if (typeof prototype.UNSAFE_componentWillUpdate === 'function') {\n foundWillUpdateName = 'UNSAFE_componentWillUpdate';\n }\n\n if (foundWillMountName !== null || foundWillReceivePropsName !== null || foundWillUpdateName !== null) {\n var componentName = Component.displayName || Component.name;\n var newApiName = typeof Component.getDerivedStateFromProps === 'function' ? 'getDerivedStateFromProps()' : 'getSnapshotBeforeUpdate()';\n throw Error('Unsafe legacy lifecycles will not be called for components using new component APIs.\\n\\n' + componentName + ' uses ' + newApiName + ' but also contains the following legacy lifecycles:' + (foundWillMountName !== null ? '\\n ' + foundWillMountName : '') + (foundWillReceivePropsName !== null ? '\\n ' + foundWillReceivePropsName : '') + (foundWillUpdateName !== null ? '\\n ' + foundWillUpdateName : '') + '\\n\\nThe above lifecycles should be removed. Learn more about this warning here:\\n' + 'https://fb.me/react-async-component-lifecycle-hooks');\n } // React <= 16.2 does not support static getDerivedStateFromProps.\n // As a workaround, use cWM and cWRP to invoke the new static lifecycle.\n // Newer versions of React will ignore these lifecycles if gDSFP exists.\n\n\n if (typeof Component.getDerivedStateFromProps === 'function') {\n prototype.componentWillMount = componentWillMount;\n prototype.componentWillReceiveProps = componentWillReceiveProps;\n } // React <= 16.2 does not support getSnapshotBeforeUpdate.\n // As a workaround, use cWU to invoke the new lifecycle.\n // Newer versions of React will ignore that lifecycle if gSBU exists.\n\n\n if (typeof prototype.getSnapshotBeforeUpdate === 'function') {\n if (typeof prototype.componentDidUpdate !== 'function') {\n throw new Error('Cannot polyfill getSnapshotBeforeUpdate() for components that do not define componentDidUpdate() on the prototype');\n }\n\n prototype.componentWillUpdate = componentWillUpdate;\n var componentDidUpdate = prototype.componentDidUpdate;\n\n prototype.componentDidUpdate = function componentDidUpdatePolyfill(prevProps, prevState, maybeSnapshot) {\n // 16.3+ will not execute our will-update method;\n // It will pass a snapshot value to did-update though.\n // Older versions will require our polyfilled will-update value.\n // We need to handle both cases, but can't just check for the presence of \"maybeSnapshot\",\n // Because for <= 15.x versions this might be a \"prevContext\" object.\n // We also can't just check \"__reactInternalSnapshot\",\n // Because get-snapshot might return a falsy value.\n // So check for the explicit __reactInternalSnapshotFlag flag to determine behavior.\n var snapshot = this.__reactInternalSnapshotFlag ? this.__reactInternalSnapshot : maybeSnapshot;\n componentDidUpdate.call(this, prevProps, prevState, snapshot);\n };\n }\n\n return Component;\n}\n\n\n\n/***/ }),\n/* 66 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.classNamesShape = exports.timeoutsShape = void 0;\n\nvar _propTypes = _interopRequireDefault(__webpack_require__(0));\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nvar timeoutsShape = false ? undefined : null;\nexports.timeoutsShape = timeoutsShape;\nvar classNamesShape = false ? undefined : null;\nexports.classNamesShape = classNamesShape;\n\n/***/ }),\n/* 67 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nObject.defineProperty(exports, \"__esModule\", {\n value: true\n});\nexports.default = deprecated;\n\nvar _warning = __webpack_require__(68);\n\nvar _warning2 = _interopRequireDefault(_warning);\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nvar warned = {};\n\nfunction deprecated(validator, reason) {\n return function validate(props, propName, componentName, location, propFullName) {\n var componentNameSafe = componentName || '<>';\n var propFullNameSafe = propFullName || propName;\n\n if (props[propName] != null) {\n var messageKey = componentName + '.' + propName;\n (0, _warning2.default)(warned[messageKey], 'The ' + location + ' `' + propFullNameSafe + '` of ' + ('`' + componentNameSafe + '` is deprecated. ' + reason + '.'));\n warned[messageKey] = true;\n }\n\n for (var _len = arguments.length, args = Array(_len > 5 ? _len - 5 : 0), _key = 5; _key < _len; _key++) {\n args[_key - 5] = arguments[_key];\n }\n\n return validator.apply(undefined, [props, propName, componentName, location, propFullName].concat(args));\n };\n}\n/* eslint-disable no-underscore-dangle */\n\n\nfunction _resetWarned() {\n warned = {};\n}\n\ndeprecated._resetWarned = _resetWarned;\n/* eslint-enable no-underscore-dangle */\n\nmodule.exports = exports['default'];\n\n/***/ }),\n/* 68 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n/**\n * Copyright 2014-2015, Facebook, Inc.\n * All rights reserved.\n *\n * This source code is licensed under the BSD-style license found in the\n * LICENSE file in the root directory of this source tree. An additional grant\n * of patent rights can be found in the PATENTS file in the same directory.\n */\n\n/**\n * Similar to invariant but only logs a warning if the condition is not met.\n * This can be used to log issues in development environments in critical\n * paths. Removing the logging code for production environments will keep the\n * same logic and follow the same code paths.\n */\n\nvar warning = function () {};\n\nif (false) {}\n\nmodule.exports = warning;\n\n/***/ }),\n/* 69 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nif (true) {\n module.exports = __webpack_require__(70);\n} else {}\n\n/***/ }),\n/* 70 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n/** @license React v16.8.6\n * react-is.production.min.js\n *\n * Copyright (c) Facebook, Inc. and its affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\n\nObject.defineProperty(exports, \"__esModule\", {\n value: !0\n});\nvar b = \"function\" === typeof Symbol && Symbol.for,\n c = b ? Symbol.for(\"react.element\") : 60103,\n d = b ? Symbol.for(\"react.portal\") : 60106,\n e = b ? Symbol.for(\"react.fragment\") : 60107,\n f = b ? Symbol.for(\"react.strict_mode\") : 60108,\n g = b ? Symbol.for(\"react.profiler\") : 60114,\n h = b ? Symbol.for(\"react.provider\") : 60109,\n k = b ? Symbol.for(\"react.context\") : 60110,\n l = b ? Symbol.for(\"react.async_mode\") : 60111,\n m = b ? Symbol.for(\"react.concurrent_mode\") : 60111,\n n = b ? Symbol.for(\"react.forward_ref\") : 60112,\n p = b ? Symbol.for(\"react.suspense\") : 60113,\n q = b ? Symbol.for(\"react.memo\") : 60115,\n r = b ? Symbol.for(\"react.lazy\") : 60116;\n\nfunction t(a) {\n if (\"object\" === typeof a && null !== a) {\n var u = a.$$typeof;\n\n switch (u) {\n case c:\n switch (a = a.type, a) {\n case l:\n case m:\n case e:\n case g:\n case f:\n case p:\n return a;\n\n default:\n switch (a = a && a.$$typeof, a) {\n case k:\n case n:\n case h:\n return a;\n\n default:\n return u;\n }\n\n }\n\n case r:\n case q:\n case d:\n return u;\n }\n }\n}\n\nfunction v(a) {\n return t(a) === m;\n}\n\nexports.typeOf = t;\nexports.AsyncMode = l;\nexports.ConcurrentMode = m;\nexports.ContextConsumer = k;\nexports.ContextProvider = h;\nexports.Element = c;\nexports.ForwardRef = n;\nexports.Fragment = e;\nexports.Lazy = r;\nexports.Memo = q;\nexports.Portal = d;\nexports.Profiler = g;\nexports.StrictMode = f;\nexports.Suspense = p;\n\nexports.isValidElementType = function (a) {\n return \"string\" === typeof a || \"function\" === typeof a || a === e || a === m || a === g || a === f || a === p || \"object\" === typeof a && null !== a && (a.$$typeof === r || a.$$typeof === q || a.$$typeof === h || a.$$typeof === k || a.$$typeof === n);\n};\n\nexports.isAsyncMode = function (a) {\n return v(a) || t(a) === l;\n};\n\nexports.isConcurrentMode = v;\n\nexports.isContextConsumer = function (a) {\n return t(a) === k;\n};\n\nexports.isContextProvider = function (a) {\n return t(a) === h;\n};\n\nexports.isElement = function (a) {\n return \"object\" === typeof a && null !== a && a.$$typeof === c;\n};\n\nexports.isForwardRef = function (a) {\n return t(a) === n;\n};\n\nexports.isFragment = function (a) {\n return t(a) === e;\n};\n\nexports.isLazy = function (a) {\n return t(a) === r;\n};\n\nexports.isMemo = function (a) {\n return t(a) === q;\n};\n\nexports.isPortal = function (a) {\n return t(a) === d;\n};\n\nexports.isProfiler = function (a) {\n return t(a) === g;\n};\n\nexports.isStrictMode = function (a) {\n return t(a) === f;\n};\n\nexports.isSuspense = function (a) {\n return t(a) === p;\n};\n\n/***/ }),\n/* 71 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = void 0;\n\nvar _react = __webpack_require__(1);\n\nfunction useCommittedRef(value) {\n var ref = (0, _react.useRef)(value);\n (0, _react.useEffect)(function () {\n ref.current = value;\n }, [value]);\n return ref;\n}\n\nvar _default = useCommittedRef;\nexports.default = _default;\n\n/***/ }),\n/* 72 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nvar _interopRequireDefault = __webpack_require__(5);\n\nexports.__esModule = true;\nexports.default = matches;\n\nvar _inDOM = _interopRequireDefault(__webpack_require__(10));\n\nvar _querySelectorAll = _interopRequireDefault(__webpack_require__(9));\n\nvar matchesCache;\n\nfunction matches(node, selector) {\n if (!matchesCache && _inDOM.default) {\n var body = document.body;\n var nativeMatch = body.matches || body.matchesSelector || body.webkitMatchesSelector || body.mozMatchesSelector || body.msMatchesSelector;\n matchesCache = nativeMatch ? function (node, selector) {\n return nativeMatch.call(node, selector);\n } : ie8MatchesSelector;\n }\n\n return matchesCache ? matchesCache(node, selector) : null;\n}\n\nfunction ie8MatchesSelector(node, selector) {\n var matches = (0, _querySelectorAll.default)(node.document || node.ownerDocument, selector),\n i = 0;\n\n while (matches[i] && matches[i] !== node) {\n i++;\n }\n\n return !!matches[i];\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 73 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\n\nvar _react = __webpack_require__(1);\n\nvar _react2 = _interopRequireDefault(_react);\n\nvar _propTypes = __webpack_require__(0);\n\nvar _propTypes2 = _interopRequireDefault(_propTypes);\n\nvar _gud = __webpack_require__(74);\n\nvar _gud2 = _interopRequireDefault(_gud);\n\nvar _warning = __webpack_require__(75);\n\nvar _warning2 = _interopRequireDefault(_warning);\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction _classCallCheck(instance, Constructor) {\n if (!(instance instanceof Constructor)) {\n throw new TypeError(\"Cannot call a class as a function\");\n }\n}\n\nfunction _possibleConstructorReturn(self, call) {\n if (!self) {\n throw new ReferenceError(\"this hasn't been initialised - super() hasn't been called\");\n }\n\n return call && (typeof call === \"object\" || typeof call === \"function\") ? call : self;\n}\n\nfunction _inherits(subClass, superClass) {\n if (typeof superClass !== \"function\" && superClass !== null) {\n throw new TypeError(\"Super expression must either be null or a function, not \" + typeof superClass);\n }\n\n subClass.prototype = Object.create(superClass && superClass.prototype, {\n constructor: {\n value: subClass,\n enumerable: false,\n writable: true,\n configurable: true\n }\n });\n if (superClass) Object.setPrototypeOf ? Object.setPrototypeOf(subClass, superClass) : subClass.__proto__ = superClass;\n}\n\nvar MAX_SIGNED_31_BIT_INT = 1073741823; // Inlined Object.is polyfill.\n// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/is\n\nfunction objectIs(x, y) {\n if (x === y) {\n return x !== 0 || 1 / x === 1 / y;\n } else {\n return x !== x && y !== y;\n }\n}\n\nfunction createEventEmitter(value) {\n var handlers = [];\n return {\n on: function on(handler) {\n handlers.push(handler);\n },\n off: function off(handler) {\n handlers = handlers.filter(function (h) {\n return h !== handler;\n });\n },\n get: function get() {\n return value;\n },\n set: function set(newValue, changedBits) {\n value = newValue;\n handlers.forEach(function (handler) {\n return handler(value, changedBits);\n });\n }\n };\n}\n\nfunction onlyChild(children) {\n return Array.isArray(children) ? children[0] : children;\n}\n\nfunction createReactContext(defaultValue, calculateChangedBits) {\n var _Provider$childContex, _Consumer$contextType;\n\n var contextProp = '__create-react-context-' + (0, _gud2.default)() + '__';\n\n var Provider = function (_Component) {\n _inherits(Provider, _Component);\n\n function Provider() {\n var _temp, _this, _ret;\n\n _classCallCheck(this, Provider);\n\n for (var _len = arguments.length, args = Array(_len), _key = 0; _key < _len; _key++) {\n args[_key] = arguments[_key];\n }\n\n return _ret = (_temp = (_this = _possibleConstructorReturn(this, _Component.call.apply(_Component, [this].concat(args))), _this), _this.emitter = createEventEmitter(_this.props.value), _temp), _possibleConstructorReturn(_this, _ret);\n }\n\n Provider.prototype.getChildContext = function getChildContext() {\n var _ref;\n\n return _ref = {}, _ref[contextProp] = this.emitter, _ref;\n };\n\n Provider.prototype.componentWillReceiveProps = function componentWillReceiveProps(nextProps) {\n if (this.props.value !== nextProps.value) {\n var oldValue = this.props.value;\n var newValue = nextProps.value;\n var changedBits = void 0;\n\n if (objectIs(oldValue, newValue)) {\n changedBits = 0; // No change\n } else {\n changedBits = typeof calculateChangedBits === 'function' ? calculateChangedBits(oldValue, newValue) : MAX_SIGNED_31_BIT_INT;\n\n if (false) {}\n\n changedBits |= 0;\n\n if (changedBits !== 0) {\n this.emitter.set(nextProps.value, changedBits);\n }\n }\n }\n };\n\n Provider.prototype.render = function render() {\n return this.props.children;\n };\n\n return Provider;\n }(_react.Component);\n\n Provider.childContextTypes = (_Provider$childContex = {}, _Provider$childContex[contextProp] = _propTypes2.default.object.isRequired, _Provider$childContex);\n\n var Consumer = function (_Component2) {\n _inherits(Consumer, _Component2);\n\n function Consumer() {\n var _temp2, _this2, _ret2;\n\n _classCallCheck(this, Consumer);\n\n for (var _len2 = arguments.length, args = Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {\n args[_key2] = arguments[_key2];\n }\n\n return _ret2 = (_temp2 = (_this2 = _possibleConstructorReturn(this, _Component2.call.apply(_Component2, [this].concat(args))), _this2), _this2.state = {\n value: _this2.getValue()\n }, _this2.onUpdate = function (newValue, changedBits) {\n var observedBits = _this2.observedBits | 0;\n\n if ((observedBits & changedBits) !== 0) {\n _this2.setState({\n value: _this2.getValue()\n });\n }\n }, _temp2), _possibleConstructorReturn(_this2, _ret2);\n }\n\n Consumer.prototype.componentWillReceiveProps = function componentWillReceiveProps(nextProps) {\n var observedBits = nextProps.observedBits;\n this.observedBits = observedBits === undefined || observedBits === null ? MAX_SIGNED_31_BIT_INT // Subscribe to all changes by default\n : observedBits;\n };\n\n Consumer.prototype.componentDidMount = function componentDidMount() {\n if (this.context[contextProp]) {\n this.context[contextProp].on(this.onUpdate);\n }\n\n var observedBits = this.props.observedBits;\n this.observedBits = observedBits === undefined || observedBits === null ? MAX_SIGNED_31_BIT_INT // Subscribe to all changes by default\n : observedBits;\n };\n\n Consumer.prototype.componentWillUnmount = function componentWillUnmount() {\n if (this.context[contextProp]) {\n this.context[contextProp].off(this.onUpdate);\n }\n };\n\n Consumer.prototype.getValue = function getValue() {\n if (this.context[contextProp]) {\n return this.context[contextProp].get();\n } else {\n return defaultValue;\n }\n };\n\n Consumer.prototype.render = function render() {\n return onlyChild(this.props.children)(this.state.value);\n };\n\n return Consumer;\n }(_react.Component);\n\n Consumer.contextTypes = (_Consumer$contextType = {}, _Consumer$contextType[contextProp] = _propTypes2.default.object, _Consumer$contextType);\n return {\n Provider: Provider,\n Consumer: Consumer\n };\n}\n\nexports.default = createReactContext;\nmodule.exports = exports['default'];\n\n/***/ }),\n/* 74 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n/* WEBPACK VAR INJECTION */(function(global) {// @flow\n\n\nvar key = '__global_unique_id__';\n\nmodule.exports = function () {\n return global[key] = (global[key] || 0) + 1;\n};\n/* WEBPACK VAR INJECTION */}.call(this, __webpack_require__(41)))\n\n/***/ }),\n/* 75 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n/**\n * Copyright (c) 2014-present, Facebook, Inc.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\n\nvar emptyFunction = __webpack_require__(76);\n/**\n * Similar to invariant but only logs a warning if the condition is not met.\n * This can be used to log issues in development environments in critical\n * paths. Removing the logging code for production environments will keep the\n * same logic and follow the same code paths.\n */\n\n\nvar warning = emptyFunction;\n\nif (false) { var printWarning; }\n\nmodule.exports = warning;\n\n/***/ }),\n/* 76 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n/**\n * Copyright (c) 2013-present, Facebook, Inc.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n * \n */\n\nfunction makeEmptyFunction(arg) {\n return function () {\n return arg;\n };\n}\n/**\n * This function accepts and discards inputs; it has no side effects. This is\n * primarily useful idiomatically for overridable function endpoints which\n * always need to be callable, since JS lacks a null-call idiom ala Cocoa.\n */\n\n\nvar emptyFunction = function emptyFunction() {};\n\nemptyFunction.thatReturns = makeEmptyFunction;\nemptyFunction.thatReturnsFalse = makeEmptyFunction(false);\nemptyFunction.thatReturnsTrue = makeEmptyFunction(true);\nemptyFunction.thatReturnsNull = makeEmptyFunction(null);\n\nemptyFunction.thatReturnsThis = function () {\n return this;\n};\n\nemptyFunction.thatReturnsArgument = function (arg) {\n return arg;\n};\n\nmodule.exports = emptyFunction;\n\n/***/ }),\n/* 77 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = mapContextToProps;\n\nvar _react = _interopRequireDefault(__webpack_require__(1));\n\nvar _forwardRef = _interopRequireDefault(__webpack_require__(46));\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction _extends() {\n _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n return _extends.apply(this, arguments);\n}\n\nvar getDisplayName = function getDisplayName(Component) {\n var name = typeof Component === 'string' ? Component : Component.name || Component.displayName;\n return name ? \"ContextTransform(\" + name + \")\" : 'ContextTransform';\n};\n\nvar ensureConsumer = function ensureConsumer(c) {\n return c.Consumer || c;\n};\n\nfunction $mapContextToProps(_ref, Component) {\n var maybeArrayOfConsumers = _ref.consumers,\n mapToProps = _ref.mapToProps,\n displayName = _ref.displayName,\n _ref$forwardRefAs = _ref.forwardRefAs,\n forwardRefAs = _ref$forwardRefAs === void 0 ? 'ref' : _ref$forwardRefAs;\n var consumers = maybeArrayOfConsumers;\n\n if (!Array.isArray(maybeArrayOfConsumers)) {\n consumers = [maybeArrayOfConsumers];\n }\n\n var SingleConsumer = ensureConsumer(consumers[0]);\n\n function singleRender(props, ref) {\n var _extends2;\n\n var propsWithRef = _extends((_extends2 = {}, _extends2[forwardRefAs] = ref, _extends2), props);\n\n return _react.default.createElement(SingleConsumer, null, function (value) {\n return _react.default.createElement(Component, _extends({}, propsWithRef, mapToProps(value, props)));\n });\n }\n\n function multiRender(props, ref) {\n var _extends3;\n\n var propsWithRef = _extends((_extends3 = {}, _extends3[forwardRefAs] = ref, _extends3), props);\n\n return consumers.reduceRight(function (inner, Context) {\n return function () {\n for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {\n args[_key] = arguments[_key];\n }\n\n var Consumer = ensureConsumer(Context);\n return _react.default.createElement(Consumer, null, function (value) {\n return inner.apply(void 0, args.concat([value]));\n });\n };\n }, function () {\n for (var _len2 = arguments.length, contexts = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {\n contexts[_key2] = arguments[_key2];\n }\n\n return _react.default.createElement(Component, _extends({}, propsWithRef, mapToProps.apply(void 0, contexts.concat([props]))));\n })();\n }\n\n var contextTransform = consumers.length === 1 ? singleRender : multiRender;\n return (0, _forwardRef.default)(contextTransform, {\n displayName: displayName || getDisplayName(Component)\n });\n}\n\nfunction mapContextToProps(maybeOpts, mapToProps, Component) {\n if (arguments.length === 2) return $mapContextToProps(maybeOpts, mapToProps);\n return $mapContextToProps({\n consumers: maybeOpts,\n mapToProps: mapToProps\n }, Component);\n}\n\n/***/ }),\n/* 78 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nvar _interopRequireDefault = __webpack_require__(5);\n\nexports.__esModule = true;\nexports.default = filterEvents;\n\nvar _contains = _interopRequireDefault(__webpack_require__(22));\n\nvar _querySelectorAll = _interopRequireDefault(__webpack_require__(9));\n\nfunction filterEvents(selector, handler) {\n return function filterHandler(e) {\n var top = e.currentTarget,\n target = e.target,\n matches = (0, _querySelectorAll.default)(top, selector);\n if (matches.some(function (match) {\n return (0, _contains.default)(match, target);\n })) handler.call(this, e);\n };\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 79 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nvar _interopRequireDefault = __webpack_require__(5);\n\nexports.__esModule = true;\nexports.default = activeElement;\n\nvar _ownerDocument = _interopRequireDefault(__webpack_require__(16));\n\nfunction activeElement(doc) {\n if (doc === void 0) {\n doc = (0, _ownerDocument.default)();\n }\n\n try {\n return doc.activeElement;\n } catch (e) {\n /* ie throws if no active element */\n }\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 80 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nvar _interopRequireDefault = __webpack_require__(5);\n\nexports.__esModule = true;\nexports.default = void 0;\n\nvar _addClass = _interopRequireDefault(__webpack_require__(81));\n\nexports.addClass = _addClass.default;\n\nvar _removeClass = _interopRequireDefault(__webpack_require__(82));\n\nexports.removeClass = _removeClass.default;\n\nvar _hasClass = _interopRequireDefault(__webpack_require__(47));\n\nexports.hasClass = _hasClass.default;\nvar _default = {\n addClass: _addClass.default,\n removeClass: _removeClass.default,\n hasClass: _hasClass.default\n};\nexports.default = _default;\n\n/***/ }),\n/* 81 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nvar _interopRequireDefault = __webpack_require__(5);\n\nexports.__esModule = true;\nexports.default = addClass;\n\nvar _hasClass = _interopRequireDefault(__webpack_require__(47));\n\nfunction addClass(element, className) {\n if (element.classList) element.classList.add(className);else if (!(0, _hasClass.default)(element, className)) if (typeof element.className === 'string') element.className = element.className + ' ' + className;else element.setAttribute('class', (element.className && element.className.baseVal || '') + ' ' + className);\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 82 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nfunction replaceClassName(origClass, classToRemove) {\n return origClass.replace(new RegExp('(^|\\\\s)' + classToRemove + '(?:\\\\s|$)', 'g'), '$1').replace(/\\s+/g, ' ').replace(/^\\s*|\\s*$/g, '');\n}\n\nmodule.exports = function removeClass(element, className) {\n if (element.classList) element.classList.remove(className);else if (typeof element.className === 'string') element.className = replaceClassName(element.className, className);else element.setAttribute('class', replaceClassName(element.className && element.className.baseVal || '', className));\n};\n\n/***/ }),\n/* 83 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = isOverflowing;\n\nvar _isWindow = _interopRequireDefault(__webpack_require__(84));\n\nvar _ownerDocument = _interopRequireDefault(__webpack_require__(16));\n\nfunction _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n}\n\nfunction isBody(node) {\n return node && node.tagName.toLowerCase() === 'body';\n}\n\nfunction bodyIsOverflowing(node) {\n var doc = (0, _ownerDocument.default)(node);\n var win = (0, _isWindow.default)(doc);\n return doc.body.clientWidth < win.innerWidth;\n}\n\nfunction isOverflowing(container) {\n var win = (0, _isWindow.default)(container);\n return win || isBody(container) ? bodyIsOverflowing(container) : container.scrollHeight > container.clientHeight;\n}\n\nmodule.exports = exports.default;\n\n/***/ }),\n/* 84 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.default = getWindow;\n\nfunction getWindow(node) {\n return node === node.window ? node : node.nodeType === 9 ? node.defaultView || node.parentWindow : false;\n}\n\nmodule.exports = exports[\"default\"];\n\n/***/ }),\n/* 85 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\"use strict\";\n\n\nexports.__esModule = true;\nexports.ariaHidden = ariaHidden;\nexports.hideSiblings = hideSiblings;\nexports.showSiblings = showSiblings;\nvar BLACKLIST = ['template', 'script', 'style'];\n\nvar isHidable = function isHidable(_ref) {\n var nodeType = _ref.nodeType,\n tagName = _ref.tagName;\n return nodeType === 1 && BLACKLIST.indexOf(tagName.toLowerCase()) === -1;\n};\n\nvar siblings = function siblings(container, exclude, cb) {\n exclude = [].concat(exclude);\n [].forEach.call(container.children, function (node) {\n if (exclude.indexOf(node) === -1 && isHidable(node)) {\n cb(node);\n }\n });\n};\n\nfunction ariaHidden(show, node) {\n if (!node) return;\n\n if (show) {\n node.setAttribute('aria-hidden', 'true');\n } else {\n node.removeAttribute('aria-hidden');\n }\n}\n\nfunction hideSiblings(container, _ref2) {\n var root = _ref2.root,\n backdrop = _ref2.backdrop;\n siblings(container, [root, backdrop], function (node) {\n return ariaHidden(true, node);\n });\n}\n\nfunction showSiblings(container, _ref3) {\n var root = _ref3.root,\n backdrop = _ref3.backdrop;\n siblings(container, [root, backdrop], function (node) {\n return ariaHidden(false, node);\n });\n}\n\n/***/ }),\n/* 86 */\n/***/ (function(module, __webpack_exports__, __webpack_require__) {\n\n\"use strict\";\n__webpack_require__.r(__webpack_exports__);\n\n// CONCATENATED MODULE: ./node_modules/@babel/runtime/helpers/esm/extends.js\nfunction _extends() {\n _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n return _extends.apply(this, arguments);\n}\n// CONCATENATED MODULE: ./node_modules/@babel/runtime/helpers/esm/objectWithoutPropertiesLoose.js\nfunction _objectWithoutPropertiesLoose(source, excluded) {\n if (source == null) return {};\n var target = {};\n var sourceKeys = Object.keys(source);\n var key, i;\n\n for (i = 0; i < sourceKeys.length; i++) {\n key = sourceKeys[i];\n if (excluded.indexOf(key) >= 0) continue;\n target[key] = source[key];\n }\n\n return target;\n}\n// EXTERNAL MODULE: ./node_modules/classnames/index.js\nvar classnames = __webpack_require__(2);\nvar classnames_default = /*#__PURE__*/__webpack_require__.n(classnames);\n\n// EXTERNAL MODULE: external {\"root\":\"React\",\"commonjs2\":\"react\",\"commonjs\":\"react\",\"amd\":\"react\"}\nvar external_root_React_commonjs2_react_commonjs_react_amd_react_ = __webpack_require__(1);\nvar external_root_React_commonjs2_react_commonjs_react_amd_react_default = /*#__PURE__*/__webpack_require__.n(external_root_React_commonjs2_react_commonjs_react_amd_react_);\n\n// EXTERNAL MODULE: ./node_modules/prop-types/index.js\nvar prop_types = __webpack_require__(0);\nvar prop_types_default = /*#__PURE__*/__webpack_require__.n(prop_types);\n\n// EXTERNAL MODULE: ./node_modules/uncontrollable/hook.js\nvar hook = __webpack_require__(15);\nvar hook_default = /*#__PURE__*/__webpack_require__.n(hook);\n\n// CONCATENATED MODULE: ./node_modules/@babel/runtime/helpers/esm/inheritsLoose.js\nfunction _inheritsLoose(subClass, superClass) {\n subClass.prototype = Object.create(superClass.prototype);\n subClass.prototype.constructor = subClass;\n subClass.__proto__ = superClass;\n}\n// EXTERNAL MODULE: ./node_modules/@restart/context/forwardRef.js\nvar forwardRef = __webpack_require__(32);\nvar forwardRef_default = /*#__PURE__*/__webpack_require__.n(forwardRef);\n\n// CONCATENATED MODULE: ./src/ThemeProvider.js\n\n\nvar _jsxFileName = \"/Users/jason/src/react-bootstrap/src/ThemeProvider.js\";\n\n\n\nvar ThemeContext = external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createContext(new Map());\nvar Consumer = ThemeContext.Consumer,\n Provider = ThemeContext.Provider;\n\nvar ThemeProvider_ThemeProvider =\n/*#__PURE__*/\nfunction (_React$Component) {\n _inheritsLoose(ThemeProvider, _React$Component);\n\n function ThemeProvider() {\n var _this;\n\n for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {\n args[_key] = arguments[_key];\n }\n\n _this = _React$Component.call.apply(_React$Component, [this].concat(args)) || this;\n _this.prefixes = new Map();\n Object.keys(_this.props.prefixes).forEach(function (key) {\n _this.prefixes.set(key, _this.props.prefixes[key]);\n });\n return _this;\n }\n\n var _proto = ThemeProvider.prototype;\n\n _proto.render = function render() {\n return external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(Provider, {\n value: this.prefixes,\n __source: {\n fileName: _jsxFileName,\n lineNumber: 22\n },\n __self: this\n }, this.props.children);\n };\n\n return ThemeProvider;\n}(external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.Component);\n\nThemeProvider_ThemeProvider.propTypes = {\n prefixes: prop_types_default.a.object.isRequired\n};\nfunction useBootstrapPrefix(prefix, defaultPrefix) {\n var prefixes = Object(external_root_React_commonjs2_react_commonjs_react_amd_react_[\"useContext\"])(ThemeContext);\n return prefix || prefixes.get(defaultPrefix) || defaultPrefix;\n}\n\nfunction createBootstrapComponent(Component, opts) {\n if (typeof opts === 'string') opts = {\n prefix: opts\n };\n var isClassy = Component.prototype && Component.prototype.isReactComponent; // If it's a functional component make sure we don't break it with a ref\n\n var _opts = opts,\n prefix = _opts.prefix,\n _opts$forwardRefAs = _opts.forwardRefAs,\n forwardRefAs = _opts$forwardRefAs === void 0 ? isClassy ? 'ref' : 'innerRef' : _opts$forwardRefAs;\n return forwardRef_default()(function (_ref, ref) {\n var props = _extends({}, _ref);\n\n props[forwardRefAs] = ref;\n var prefixes = Object(external_root_React_commonjs2_react_commonjs_react_amd_react_[\"useContext\"])(ThemeContext);\n return external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(Component, _extends({}, props, {\n // eslint-disable-next-line react/prop-types\n bsPrefix: props.bsPrefix || prefixes.get(prefix) || prefix,\n __source: {\n fileName: _jsxFileName,\n lineNumber: 42\n },\n __self: this\n }));\n }, {\n displayName: \"Bootstrap(\" + (Component.displayName || Component.name) + \")\"\n });\n}\n\n\n/* harmony default export */ var src_ThemeProvider = (ThemeProvider_ThemeProvider);\n// CONCATENATED MODULE: ./src/SelectableContext.js\n\nvar SelectableContext = external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createContext();\nvar makeEventKey = function makeEventKey(eventKey, href) {\n if (eventKey != null) return String(eventKey);\n return href || null;\n};\n/* harmony default export */ var src_SelectableContext = (SelectableContext);\n// CONCATENATED MODULE: ./src/AccordionToggle.js\n\n\nvar AccordionToggle_jsxFileName = \"/Users/jason/src/react-bootstrap/src/AccordionToggle.js\";\n\n\n\nvar propTypes = {\n /** Set a custom element for this component */\n as: prop_types_default.a.elementType,\n\n /**\n * A key that corresponds to the collapse component that gets triggered\n * when this has been clicked.\n */\n eventKey: prop_types_default.a.string.isRequired,\n\n /** A callback function for when this component is clicked */\n onClick: prop_types_default.a.func,\n\n /** Children prop should only contain a single child, and is enforced as such */\n children: prop_types_default.a.element\n};\nvar AccordionToggle_defaultProps = {\n as: 'button'\n};\nvar AccordionToggle = external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.forwardRef(function (_ref, ref) {\n var Component = _ref.as,\n children = _ref.children,\n eventKey = _ref.eventKey,\n _onClick = _ref.onClick,\n props = _objectWithoutPropertiesLoose(_ref, [\"as\", \"children\", \"eventKey\", \"onClick\"]);\n\n var onSelect = Object(external_root_React_commonjs2_react_commonjs_react_amd_react_[\"useContext\"])(src_SelectableContext);\n return external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(Component, _extends({\n ref: ref,\n onClick: function onClick(e) {\n onSelect(eventKey, e);\n if (_onClick) _onClick(e);\n }\n }, props, {\n __source: {\n fileName: AccordionToggle_jsxFileName,\n lineNumber: 31\n },\n __self: this\n }), children);\n});\nAccordionToggle.propTypes = propTypes;\nAccordionToggle.defaultProps = AccordionToggle_defaultProps;\n/* harmony default export */ var src_AccordionToggle = (AccordionToggle);\n// EXTERNAL MODULE: ./node_modules/dom-helpers/style/index.js\nvar dom_helpers_style = __webpack_require__(11);\nvar style_default = /*#__PURE__*/__webpack_require__.n(dom_helpers_style);\n\n// EXTERNAL MODULE: ./node_modules/dom-helpers/transition/end.js\nvar end = __webpack_require__(23);\nvar end_default = /*#__PURE__*/__webpack_require__.n(end);\n\n// EXTERNAL MODULE: ./node_modules/react-transition-group/Transition.js\nvar react_transition_group_Transition = __webpack_require__(12);\nvar Transition_default = /*#__PURE__*/__webpack_require__.n(react_transition_group_Transition);\n\n// CONCATENATED MODULE: ./src/utils/triggerBrowserReflow.js\n// reading a dimension prop will cause the browser to recalculate,\n// which will let our animations work\nfunction triggerBrowserReflow(node) {\n node.offsetHeight; // eslint-disable-line no-unused-expressions\n}\n// CONCATENATED MODULE: ./src/utils/createChainedFunction.js\n/**\n * Safe chained function\n *\n * Will only create a new function if needed,\n * otherwise will pass back existing functions or null.\n *\n * @param {function} functions to chain\n * @returns {function|null}\n */\nfunction createChainedFunction() {\n for (var _len = arguments.length, funcs = new Array(_len), _key = 0; _key < _len; _key++) {\n funcs[_key] = arguments[_key];\n }\n\n return funcs.filter(function (f) {\n return f != null;\n }).reduce(function (acc, f) {\n if (typeof f !== 'function') {\n throw new Error('Invalid Argument Type, must only provide functions, undefined, or null.');\n }\n\n if (acc === null) return f;\n return function chainedFunction() {\n for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {\n args[_key2] = arguments[_key2];\n }\n\n acc.apply(this, args);\n f.apply(this, args);\n };\n }, null);\n}\n\n/* harmony default export */ var utils_createChainedFunction = (createChainedFunction);\n// CONCATENATED MODULE: ./src/Collapse.js\n\n\n\n\nvar _collapseStyles,\n Collapse_jsxFileName = \"/Users/jason/src/react-bootstrap/src/Collapse.js\";\n\n\n\n\n\n\n\n\n\nvar MARGINS = {\n height: ['marginTop', 'marginBottom'],\n width: ['marginLeft', 'marginRight']\n};\n\nfunction getDimensionValue(dimension, elem) {\n var offset = \"offset\" + dimension[0].toUpperCase() + dimension.slice(1);\n var value = elem[offset];\n var margins = MARGINS[dimension];\n return value + parseInt(style_default()(elem, margins[0]), 10) + parseInt(style_default()(elem, margins[1]), 10);\n}\n\nvar collapseStyles = (_collapseStyles = {}, _collapseStyles[react_transition_group_Transition[\"EXITED\"]] = 'collapse', _collapseStyles[react_transition_group_Transition[\"EXITING\"]] = 'collapsing', _collapseStyles[react_transition_group_Transition[\"ENTERING\"]] = 'collapsing', _collapseStyles[react_transition_group_Transition[\"ENTERED\"]] = 'collapse show', _collapseStyles);\nvar Collapse_propTypes = {\n /**\n * Show the component; triggers the expand or collapse animation\n */\n in: prop_types_default.a.bool,\n\n /**\n * Wait until the first \"enter\" transition to mount the component (add it to the DOM)\n */\n mountOnEnter: prop_types_default.a.bool,\n\n /**\n * Unmount the component (remove it from the DOM) when it is collapsed\n */\n unmountOnExit: prop_types_default.a.bool,\n\n /**\n * Run the expand animation when the component mounts, if it is initially\n * shown\n */\n appear: prop_types_default.a.bool,\n\n /**\n * Duration of the collapse animation in milliseconds, to ensure that\n * finishing callbacks are fired even if the original browser transition end\n * events are canceled\n */\n timeout: prop_types_default.a.number,\n\n /**\n * Callback fired before the component expands\n */\n onEnter: prop_types_default.a.func,\n\n /**\n * Callback fired after the component starts to expand\n */\n onEntering: prop_types_default.a.func,\n\n /**\n * Callback fired after the component has expanded\n */\n onEntered: prop_types_default.a.func,\n\n /**\n * Callback fired before the component collapses\n */\n onExit: prop_types_default.a.func,\n\n /**\n * Callback fired after the component starts to collapse\n */\n onExiting: prop_types_default.a.func,\n\n /**\n * Callback fired after the component has collapsed\n */\n onExited: prop_types_default.a.func,\n\n /**\n * The dimension used when collapsing, or a function that returns the\n * dimension\n *\n * _Note: Bootstrap only partially supports 'width'!\n * You will need to supply your own CSS animation for the `.width` CSS class._\n */\n dimension: prop_types_default.a.oneOfType([prop_types_default.a.oneOf(['height', 'width']), prop_types_default.a.func]),\n\n /**\n * Function that returns the height or width of the animating DOM node\n *\n * Allows for providing some custom logic for how much the Collapse component\n * should animate in its specified dimension. Called with the current\n * dimension prop value and the DOM node.\n *\n * @default element.offsetWidth | element.offsetHeight\n */\n getDimensionValue: prop_types_default.a.func,\n\n /**\n * ARIA role of collapsible element\n */\n role: prop_types_default.a.string\n};\nvar Collapse_defaultProps = {\n in: false,\n timeout: 300,\n mountOnEnter: false,\n unmountOnExit: false,\n appear: false,\n dimension: 'height',\n getDimensionValue: getDimensionValue\n};\n\nvar Collapse_Collapse =\n/*#__PURE__*/\nfunction (_React$Component) {\n _inheritsLoose(Collapse, _React$Component);\n\n function Collapse() {\n var _this;\n\n for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {\n args[_key] = arguments[_key];\n }\n\n _this = _React$Component.call.apply(_React$Component, [this].concat(args)) || this;\n\n _this.handleEnter = function (elem) {\n elem.style[_this.getDimension()] = '0';\n };\n\n _this.handleEntering = function (elem) {\n var dimension = _this.getDimension();\n\n elem.style[dimension] = _this._getScrollDimensionValue(elem, dimension);\n };\n\n _this.handleEntered = function (elem) {\n elem.style[_this.getDimension()] = null;\n };\n\n _this.handleExit = function (elem) {\n var dimension = _this.getDimension();\n\n elem.style[dimension] = _this.props.getDimensionValue(dimension, elem) + \"px\";\n triggerBrowserReflow(elem);\n };\n\n _this.handleExiting = function (elem) {\n elem.style[_this.getDimension()] = '0';\n };\n\n return _this;\n }\n\n var _proto = Collapse.prototype;\n\n _proto.getDimension = function getDimension() {\n return typeof this.props.dimension === 'function' ? this.props.dimension() : this.props.dimension;\n }\n /* -- Expanding -- */\n ;\n\n // for testing\n _proto._getScrollDimensionValue = function _getScrollDimensionValue(elem, dimension) {\n var scroll = \"scroll\" + dimension[0].toUpperCase() + dimension.slice(1);\n return elem[scroll] + \"px\";\n };\n\n _proto.render = function render() {\n var _this2 = this;\n\n var _this$props = this.props,\n onEnter = _this$props.onEnter,\n onEntering = _this$props.onEntering,\n onEntered = _this$props.onEntered,\n onExit = _this$props.onExit,\n onExiting = _this$props.onExiting,\n className = _this$props.className,\n children = _this$props.children,\n props = _objectWithoutPropertiesLoose(_this$props, [\"onEnter\", \"onEntering\", \"onEntered\", \"onExit\", \"onExiting\", \"className\", \"children\"]);\n\n delete props.dimension;\n delete props.getDimensionValue;\n var handleEnter = utils_createChainedFunction(this.handleEnter, onEnter);\n var handleEntering = utils_createChainedFunction(this.handleEntering, onEntering);\n var handleEntered = utils_createChainedFunction(this.handleEntered, onEntered);\n var handleExit = utils_createChainedFunction(this.handleExit, onExit);\n var handleExiting = utils_createChainedFunction(this.handleExiting, onExiting);\n return external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(Transition_default.a, _extends({\n addEndListener: end_default.a\n }, props, {\n \"aria-expanded\": props.role ? props.in : null,\n onEnter: handleEnter,\n onEntering: handleEntering,\n onEntered: handleEntered,\n onExit: handleExit,\n onExiting: handleExiting,\n __source: {\n fileName: Collapse_jsxFileName,\n lineNumber: 200\n },\n __self: this\n }), function (state, innerProps) {\n return external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.cloneElement(children, _extends({}, innerProps, {\n className: classnames_default()(className, children.props.className, collapseStyles[state], _this2.getDimension() === 'width' && 'width')\n }));\n });\n };\n\n return Collapse;\n}(external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.Component);\n\nCollapse_Collapse.propTypes = Collapse_propTypes;\nCollapse_Collapse.defaultProps = Collapse_defaultProps;\n/* harmony default export */ var src_Collapse = (Collapse_Collapse);\n// CONCATENATED MODULE: ./src/AccordionContext.js\n\n/* harmony default export */ var AccordionContext = (external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createContext(null));\n// CONCATENATED MODULE: ./src/AccordionCollapse.js\n\n\nvar AccordionCollapse_jsxFileName = \"/Users/jason/src/react-bootstrap/src/AccordionCollapse.js\";\n\n\n\n\nvar AccordionCollapse_propTypes = {\n /**\n * A key that corresponds to the toggler that triggers this collapse's expand or collapse.\n */\n eventKey: prop_types_default.a.string.isRequired,\n children: prop_types_default.a.element.isRequired\n};\nvar AccordionCollapse = external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.forwardRef(function (_ref, ref) {\n var children = _ref.children,\n eventKey = _ref.eventKey,\n props = _objectWithoutPropertiesLoose(_ref, [\"children\", \"eventKey\"]);\n\n var contextEventKey = Object(external_root_React_commonjs2_react_commonjs_react_amd_react_[\"useContext\"])(AccordionContext);\n return external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(src_Collapse, _extends({\n ref: ref,\n in: contextEventKey === eventKey\n }, props, {\n __source: {\n fileName: AccordionCollapse_jsxFileName,\n lineNumber: 21\n },\n __self: this\n }), external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(\"div\", {\n __source: {\n fileName: AccordionCollapse_jsxFileName,\n lineNumber: 22\n },\n __self: this\n }, external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.Children.only(children)));\n});\nAccordionCollapse.propTypes = AccordionCollapse_propTypes;\n/* harmony default export */ var src_AccordionCollapse = (AccordionCollapse);\n// CONCATENATED MODULE: ./src/Accordion.js\n\n\nvar Accordion_jsxFileName = \"/Users/jason/src/react-bootstrap/src/Accordion.js\";\n\n\n\n\n\n\n\n\n\nvar Accordion_propTypes = {\n /** Set a custom element for this component */\n as: prop_types_default.a.elementType,\n\n /** @default 'accordion' */\n bsPrefix: prop_types_default.a.string,\n\n /** The current active key that corresponds to the currently expanded card */\n activeKey: prop_types_default.a.string,\n\n /** The default active key that is expanded on start */\n defaultActiveKey: prop_types_default.a.string\n};\nvar Accordion_defaultProps = {\n as: 'div'\n};\nvar Accordion = external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.forwardRef(function (props, ref) {\n var _useUncontrolled = hook_default()(props, {\n activeKey: 'onSelect'\n }),\n Component = _useUncontrolled.as,\n activeKey = _useUncontrolled.activeKey,\n bsPrefix = _useUncontrolled.bsPrefix,\n children = _useUncontrolled.children,\n className = _useUncontrolled.className,\n onSelect = _useUncontrolled.onSelect,\n controlledProps = _objectWithoutPropertiesLoose(_useUncontrolled, [\"as\", \"activeKey\", \"bsPrefix\", \"children\", \"className\", \"onSelect\"]);\n\n bsPrefix = useBootstrapPrefix(bsPrefix, 'accordion');\n return external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(AccordionContext.Provider, {\n value: activeKey,\n __source: {\n fileName: Accordion_jsxFileName,\n lineNumber: 45\n },\n __self: this\n }, external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(src_SelectableContext.Provider, {\n value: onSelect,\n __source: {\n fileName: Accordion_jsxFileName,\n lineNumber: 46\n },\n __self: this\n }, external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(Component, _extends({\n ref: ref\n }, controlledProps, {\n className: classnames_default()(className, bsPrefix),\n __source: {\n fileName: Accordion_jsxFileName,\n lineNumber: 47\n },\n __self: this\n }), children)));\n});\nAccordion.propTypes = Accordion_propTypes;\nAccordion.defaultProps = Accordion_defaultProps;\nAccordion.Toggle = src_AccordionToggle;\nAccordion.Collapse = src_AccordionCollapse;\n/* harmony default export */ var src_Accordion = (Accordion);\n// EXTERNAL MODULE: ./node_modules/prop-types-extra/lib/index.js\nvar lib = __webpack_require__(19);\n\n// EXTERNAL MODULE: ./node_modules/@restart/hooks/useEventCallback.js\nvar useEventCallback = __webpack_require__(8);\nvar useEventCallback_default = /*#__PURE__*/__webpack_require__.n(useEventCallback);\n\n// EXTERNAL MODULE: ./node_modules/dom-helpers/util/camelize.js\nvar camelize = __webpack_require__(33);\nvar camelize_default = /*#__PURE__*/__webpack_require__.n(camelize);\n\n// CONCATENATED MODULE: ./src/utils/createWithBsPrefix.js\n\n\nvar createWithBsPrefix_jsxFileName = \"/Users/jason/src/react-bootstrap/src/utils/createWithBsPrefix.js\";\n\n\n\n\n\nvar createWithBsPrefix_pascalCase = function pascalCase(str) {\n return str[0].toUpperCase() + camelize_default()(str).slice(1);\n};\n\nfunction createWithBsPrefix(prefix, _temp) {\n var _ref = _temp === void 0 ? {} : _temp,\n _ref$displayName = _ref.displayName,\n displayName = _ref$displayName === void 0 ? createWithBsPrefix_pascalCase(prefix) : _ref$displayName,\n _ref$Component = _ref.Component,\n Component = _ref$Component === void 0 ? 'div' : _ref$Component,\n defaultProps = _ref.defaultProps;\n\n var BsComponent = external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.forwardRef( // eslint-disable-next-line react/prop-types\n function (_ref2, ref) {\n var className = _ref2.className,\n bsPrefix = _ref2.bsPrefix,\n _ref2$as = _ref2.as,\n Tag = _ref2$as === void 0 ? Component : _ref2$as,\n props = _objectWithoutPropertiesLoose(_ref2, [\"className\", \"bsPrefix\", \"as\"]);\n\n var resolvedPrefix = useBootstrapPrefix(bsPrefix, prefix);\n return external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(Tag, _extends({\n ref: ref,\n className: classnames_default()(className, resolvedPrefix)\n }, props, {\n __source: {\n fileName: createWithBsPrefix_jsxFileName,\n lineNumber: 18\n },\n __self: this\n }));\n });\n BsComponent.defaultProps = defaultProps;\n BsComponent.displayName = displayName;\n return BsComponent;\n}\n// CONCATENATED MODULE: ./src/utils/divWithClassName.js\n\nvar divWithClassName_jsxFileName = \"/Users/jason/src/react-bootstrap/src/utils/divWithClassName.js\";\n\n\n/* harmony default export */ var divWithClassName = (function (className) {\n return external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.forwardRef(function (p, ref) {\n return external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(\"div\", _extends({}, p, {\n ref: ref,\n className: classnames_default()(p.className, className),\n __source: {\n fileName: divWithClassName_jsxFileName,\n lineNumber: 6\n },\n __self: this\n }));\n });\n});\n// CONCATENATED MODULE: ./src/Fade.js\n\n\n\n\nvar _fadeStyles,\n Fade_jsxFileName = \"/Users/jason/src/react-bootstrap/src/Fade.js\";\n\n\n\n\n\n\n\nvar Fade_propTypes = {\n /**\n * Show the component; triggers the fade in or fade out animation\n */\n in: prop_types_default.a.bool,\n\n /**\n * Wait until the first \"enter\" transition to mount the component (add it to the DOM)\n */\n mountOnEnter: prop_types_default.a.bool,\n\n /**\n * Unmount the component (remove it from the DOM) when it is faded out\n */\n unmountOnExit: prop_types_default.a.bool,\n\n /**\n * Run the fade in animation when the component mounts, if it is initially\n * shown\n */\n appear: prop_types_default.a.bool,\n\n /**\n * Duration of the fade animation in milliseconds, to ensure that finishing\n * callbacks are fired even if the original browser transition end events are\n * canceled\n */\n timeout: prop_types_default.a.number,\n\n /**\n * Callback fired before the component fades in\n */\n onEnter: prop_types_default.a.func,\n\n /**\n * Callback fired after the component starts to fade in\n */\n onEntering: prop_types_default.a.func,\n\n /**\n * Callback fired after the has component faded in\n */\n onEntered: prop_types_default.a.func,\n\n /**\n * Callback fired before the component fades out\n */\n onExit: prop_types_default.a.func,\n\n /**\n * Callback fired after the component starts to fade out\n */\n onExiting: prop_types_default.a.func,\n\n /**\n * Callback fired after the component has faded out\n */\n onExited: prop_types_default.a.func\n};\nvar Fade_defaultProps = {\n in: false,\n timeout: 300,\n mountOnEnter: false,\n unmountOnExit: false,\n appear: false\n};\nvar fadeStyles = (_fadeStyles = {}, _fadeStyles[react_transition_group_Transition[\"ENTERING\"]] = 'show', _fadeStyles[react_transition_group_Transition[\"ENTERED\"]] = 'show', _fadeStyles);\n\nvar Fade_Fade =\n/*#__PURE__*/\nfunction (_React$Component) {\n _inheritsLoose(Fade, _React$Component);\n\n function Fade() {\n var _this;\n\n for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {\n args[_key] = arguments[_key];\n }\n\n _this = _React$Component.call.apply(_React$Component, [this].concat(args)) || this;\n\n _this.handleEnter = function (node) {\n triggerBrowserReflow(node);\n if (_this.props.onEnter) _this.props.onEnter(node);\n };\n\n return _this;\n }\n\n var _proto = Fade.prototype;\n\n _proto.render = function render() {\n var _this$props = this.props,\n className = _this$props.className,\n children = _this$props.children,\n props = _objectWithoutPropertiesLoose(_this$props, [\"className\", \"children\"]);\n\n return external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(Transition_default.a, _extends({\n addEndListener: end_default.a\n }, props, {\n onEnter: this.handleEnter,\n __source: {\n fileName: Fade_jsxFileName,\n lineNumber: 89\n },\n __self: this\n }), function (status, innerProps) {\n return external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.cloneElement(children, _extends({}, innerProps, {\n className: classnames_default()('fade', className, children.props.className, fadeStyles[status])\n }));\n });\n };\n\n return Fade;\n}(external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.Component);\n\nFade_Fade.propTypes = Fade_propTypes;\nFade_Fade.defaultProps = Fade_defaultProps;\n/* harmony default export */ var src_Fade = (Fade_Fade);\n// CONCATENATED MODULE: ./src/CloseButton.js\nvar CloseButton_jsxFileName = \"/Users/jason/src/react-bootstrap/src/CloseButton.js\";\n\n\nvar CloseButton_propTypes = {\n label: prop_types_default.a.string.isRequired,\n onClick: prop_types_default.a.func\n};\nvar CloseButton_defaultProps = {\n label: 'Close'\n};\nvar CloseButton = external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.forwardRef(function (_ref, ref) {\n var label = _ref.label,\n onClick = _ref.onClick;\n return external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(\"button\", {\n ref: ref,\n type: \"button\",\n className: \"close\",\n onClick: onClick,\n __source: {\n fileName: CloseButton_jsxFileName,\n lineNumber: 14\n },\n __self: this\n }, external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(\"span\", {\n \"aria-hidden\": \"true\",\n __source: {\n fileName: CloseButton_jsxFileName,\n lineNumber: 15\n },\n __self: this\n }, \"\\xD7\"), external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(\"span\", {\n className: \"sr-only\",\n __source: {\n fileName: CloseButton_jsxFileName,\n lineNumber: 16\n },\n __self: this\n }, label));\n});\nCloseButton.displayName = 'CloseButton';\nCloseButton.propTypes = CloseButton_propTypes;\nCloseButton.defaultProps = CloseButton_defaultProps;\n/* harmony default export */ var src_CloseButton = (CloseButton);\n// CONCATENATED MODULE: ./node_modules/@babel/runtime/helpers/esm/assertThisInitialized.js\nfunction _assertThisInitialized(self) {\n if (self === void 0) {\n throw new ReferenceError(\"this hasn't been initialised - super() hasn't been called\");\n }\n\n return self;\n}\n// CONCATENATED MODULE: ./src/SafeAnchor.js\n\n\n\n\nvar SafeAnchor_jsxFileName = \"/Users/jason/src/react-bootstrap/src/SafeAnchor.js\";\n\n\n\nvar SafeAnchor_propTypes = {\n href: prop_types_default.a.string,\n onClick: prop_types_default.a.func,\n onKeyDown: prop_types_default.a.func,\n disabled: prop_types_default.a.bool,\n role: prop_types_default.a.string,\n tabIndex: prop_types_default.a.oneOfType([prop_types_default.a.number, prop_types_default.a.string]),\n\n /**\n * this is sort of silly but needed for Button\n */\n as: prop_types_default.a.elementType,\n\n /** @private */\n innerRef: prop_types_default.a.any\n};\nvar SafeAnchor_defaultProps = {\n as: 'a'\n};\n\nfunction isTrivialHref(href) {\n return !href || href.trim() === '#';\n}\n/**\n * There are situations due to browser quirks or Bootstrap CSS where\n * an anchor tag is needed, when semantically a button tag is the\n * better choice. SafeAnchor ensures that when an anchor is used like a\n * button its accessible. It also emulates input `disabled` behavior for\n * links, which is usually desirable for Buttons, NavItems, DropdownItems, etc.\n */\n\n\nvar SafeAnchor_SafeAnchor =\n/*#__PURE__*/\nfunction (_React$Component) {\n _inheritsLoose(SafeAnchor, _React$Component);\n\n function SafeAnchor(props, context) {\n var _this;\n\n _this = _React$Component.call(this, props, context) || this;\n _this.handleClick = _this.handleClick.bind(_assertThisInitialized(_this));\n _this.handleKeyDown = _this.handleKeyDown.bind(_assertThisInitialized(_this));\n return _this;\n }\n\n var _proto = SafeAnchor.prototype;\n\n _proto.handleClick = function handleClick(event) {\n var _this$props = this.props,\n disabled = _this$props.disabled,\n href = _this$props.href,\n onClick = _this$props.onClick;\n\n if (disabled || isTrivialHref(href)) {\n event.preventDefault();\n }\n\n if (disabled) {\n event.stopPropagation();\n return;\n }\n\n if (onClick) {\n onClick(event);\n }\n };\n\n _proto.handleKeyDown = function handleKeyDown(event) {\n if (event.key === ' ') {\n event.preventDefault();\n this.handleClick(event);\n }\n };\n\n _proto.render = function render() {\n var _this$props2 = this.props,\n Component = _this$props2.as,\n disabled = _this$props2.disabled,\n onKeyDown = _this$props2.onKeyDown,\n innerRef = _this$props2.innerRef,\n props = _objectWithoutPropertiesLoose(_this$props2, [\"as\", \"disabled\", \"onKeyDown\", \"innerRef\"]);\n\n if (isTrivialHref(props.href)) {\n props.role = props.role || 'button'; // we want to make sure there is a href attribute on the node\n // otherwise, the cursor incorrectly styled (except with role='button')\n\n props.href = props.href || '#';\n }\n\n if (disabled) {\n props.tabIndex = -1;\n props['aria-disabled'] = true;\n }\n\n if (innerRef) props.ref = innerRef;\n return external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(Component, _extends({}, props, {\n onClick: this.handleClick,\n onKeyDown: utils_createChainedFunction(this.handleKeyDown, onKeyDown),\n __source: {\n fileName: SafeAnchor_jsxFileName,\n lineNumber: 92\n },\n __self: this\n }));\n };\n\n return SafeAnchor;\n}(external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.Component);\n\nSafeAnchor_SafeAnchor.propTypes = SafeAnchor_propTypes;\nSafeAnchor_SafeAnchor.defaultProps = SafeAnchor_defaultProps;\n/* harmony default export */ var src_SafeAnchor = (SafeAnchor_SafeAnchor);\n// CONCATENATED MODULE: ./src/Alert.js\n\n\nvar Alert_jsxFileName = \"/Users/jason/src/react-bootstrap/src/Alert.js\";\n\n\n\n\n\n\n\n\n\n\n\n\nvar Alert_propTypes = {\n /**\n * @default 'alert'\n */\n bsPrefix: prop_types_default.a.string,\n\n /**\n * The Alert visual variant\n *\n * @type {'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info' | 'dark' | 'light'}\n */\n variant: prop_types_default.a.string,\n\n /**\n * Renders a properly aligned dismiss button, as well as\n * adding extra horizontal padding to the Alert.\n */\n dismissible: prop_types_default.a.bool,\n\n /**\n * Controls the visual state of the Alert.\n *\n * @controllable onClose\n */\n show: prop_types_default.a.bool,\n\n /**\n * Callback fired when alert is closed.\n *\n * @controllable show\n */\n onClose: prop_types_default.a.func,\n\n /**\n * Sets the text for alert close button.\n */\n closeLabel: prop_types_default.a.string,\n\n /** A `react-transition-group` Transition component used to animate the Alert on dismissal. */\n transition: lib[\"elementType\"]\n};\nvar Alert_defaultProps = {\n show: true,\n transition: src_Fade,\n closeLabel: 'Close alert'\n};\nvar controllables = {\n show: 'onClose'\n};\nvar Alert = external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.forwardRef(function (uncontrolledProps, ref) {\n var _useControllable = hook_default()(uncontrolledProps, controllables),\n bsPrefix = _useControllable.bsPrefix,\n show = _useControllable.show,\n closeLabel = _useControllable.closeLabel,\n className = _useControllable.className,\n children = _useControllable.children,\n variant = _useControllable.variant,\n onClose = _useControllable.onClose,\n dismissible = _useControllable.dismissible,\n Transition = _useControllable.transition,\n props = _objectWithoutPropertiesLoose(_useControllable, [\"bsPrefix\", \"show\", \"closeLabel\", \"className\", \"children\", \"variant\", \"onClose\", \"dismissible\", \"transition\"]);\n\n var prefix = useBootstrapPrefix(bsPrefix, 'alert');\n var handleClose = useEventCallback_default()(function (e) {\n onClose(false, e);\n });\n var alert = external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(\"div\", _extends({\n role: \"alert\"\n }, Transition ? props : undefined, {\n className: classnames_default()(className, prefix, variant && prefix + \"-\" + variant, dismissible && prefix + \"-dismissible\"),\n __source: {\n fileName: Alert_jsxFileName,\n lineNumber: 87\n },\n __self: this\n }), dismissible && external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(src_CloseButton, {\n onClick: handleClose,\n label: closeLabel,\n __source: {\n fileName: Alert_jsxFileName,\n lineNumber: 97\n },\n __self: this\n }), children);\n if (!Transition) return show ? alert : null;\n return external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(Transition, _extends({\n unmountOnExit: true,\n ref: ref\n }, props, {\n in: show,\n __source: {\n fileName: Alert_jsxFileName,\n lineNumber: 105\n },\n __self: this\n }), alert);\n});\nvar DivStyledAsH4 = divWithClassName('h4');\nDivStyledAsH4.displayName = 'DivStyledAsH4';\nAlert.displayName = 'Alert';\nAlert.propTypes = Alert_propTypes;\nAlert.defaultProps = Alert_defaultProps;\nAlert.Link = createWithBsPrefix('alert-link', {\n Component: src_SafeAnchor\n});\nAlert.Heading = createWithBsPrefix('alert-heading', {\n Component: DivStyledAsH4\n});\n/* harmony default export */ var src_Alert = (Alert);\n// CONCATENATED MODULE: ./src/Badge.js\n\n\nvar Badge_jsxFileName = \"/Users/jason/src/react-bootstrap/src/Badge.js\";\n\n\n\n\nvar Badge_propTypes = {\n /** @default 'badge' */\n bsPrefix: prop_types_default.a.string,\n\n /**\n * The visual style of the badge\n *\n * @type {('primary'|'secondary'|'success'|'danger'|'warning'|'info'|'light'|'dark')}\n */\n variant: prop_types_default.a.string,\n\n /**\n * Add the `pill` modifier to make badges more rounded with\n * some additional horizontal padding\n */\n pill: prop_types_default.a.bool.isRequired\n};\nvar Badge_defaultProps = {\n pill: false\n};\nvar Badge = external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.forwardRef(function (_ref, ref) {\n var bsPrefix = _ref.bsPrefix,\n variant = _ref.variant,\n pill = _ref.pill,\n className = _ref.className,\n props = _objectWithoutPropertiesLoose(_ref, [\"bsPrefix\", \"variant\", \"pill\", \"className\"]);\n\n var prefix = useBootstrapPrefix(bsPrefix, 'badge');\n return external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(\"span\", _extends({\n ref: ref\n }, props, {\n className: classnames_default()(className, prefix, pill && prefix + \"-pill\", variant && prefix + \"-\" + variant),\n __source: {\n fileName: Badge_jsxFileName,\n lineNumber: 33\n },\n __self: this\n }));\n});\nBadge.displayName = 'Badge';\nBadge.propTypes = Badge_propTypes;\nBadge.defaultProps = Badge_defaultProps;\n/* harmony default export */ var src_Badge = (Badge);\n// CONCATENATED MODULE: ./src/BreadcrumbItem.js\n\n\nvar BreadcrumbItem_jsxFileName = \"/Users/jason/src/react-bootstrap/src/BreadcrumbItem.js\";\n\n\n\n\n\nvar BreadcrumbItem_propTypes = {\n /**\n * @default 'breadcrumb-item'\n */\n bsPrefix: prop_types_default.a.string,\n\n /**\n * Adds a visual \"active\" state to a Breadcrumb\n * Item and disables the link.\n */\n active: prop_types_default.a.bool,\n\n /**\n * `href` attribute for the inner `a` element\n */\n href: prop_types_default.a.string,\n\n /**\n * `title` attribute for the inner `a` element\n */\n title: prop_types_default.a.node,\n\n /**\n * `target` attribute for the inner `a` element\n */\n target: prop_types_default.a.string,\n as: prop_types_default.a.elementType\n};\nvar BreadcrumbItem_defaultProps = {\n active: false,\n as: 'li'\n};\nvar BreadcrumbItem = external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.forwardRef(function (_ref, ref) {\n var bsPrefix = _ref.bsPrefix,\n active = _ref.active,\n className = _ref.className,\n Component = _ref.as,\n props = _objectWithoutPropertiesLoose(_ref, [\"bsPrefix\", \"active\", \"className\", \"as\"]);\n\n var prefix = useBootstrapPrefix(bsPrefix, 'breadcrumb-item');\n\n var href = props.href,\n title = props.title,\n target = props.target,\n elementProps = _objectWithoutPropertiesLoose(props, [\"href\", \"title\", \"target\"]);\n\n var linkProps = {\n href: href,\n title: title,\n target: target\n };\n return external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(Component, {\n ref: ref,\n className: classnames_default()(prefix, className, {\n active: active\n }),\n \"aria-current\": active ? 'page' : undefined,\n __source: {\n fileName: BreadcrumbItem_jsxFileName,\n lineNumber: 47\n },\n __self: this\n }, active ? external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(\"span\", _extends({}, elementProps, {\n className: classnames_default()({\n active: active\n }),\n __source: {\n fileName: BreadcrumbItem_jsxFileName,\n lineNumber: 53\n },\n __self: this\n })) : external_root_React_commonjs2_react_commonjs_react_amd_react_default.a.createElement(src_SafeAnchor, _extends({}, elementProps, linkProps, {\n __source: {\n fileName: BreadcrumbItem_jsxFileName,\n lineNumber: 55\n },\n __self: this\n })));\n});\nBreadcrumbItem.displayName = 'BreadcrumbItem';\nBreadcrumbItem.propTypes = BreadcrumbItem_propTypes;\nBreadcrumbItem.defaultProps = BreadcrumbItem_defaultProps;\n/* harmony default export */ var src_BreadcrumbItem = (BreadcrumbItem);\n// CONCATENATED MODULE: ./src/Breadcrumb.js\n\n\nvar Breadcrumb_jsxFileName = \"/Users/jason/src/react-bootstrap/src/Breadcrumb.js\";\n\n\n\n\n\nvar Breadcrumb_propTypes = {\n /**\n * @default 'breadcrumb'\n */\n bsPrefix: prop_types_default.a.string,\n\n /**\n * ARIA label for the nav element\n * https://www.w3.org/TR/wai-aria-practices/#breadcrumb\n */\n label: prop_types_default.a.string,\n\n /**\n * Additional props passed as-is to the underlying `